Integração com MercadoPhone
Como conectar o MercadoPhone à Verbix — token de API + webhook de venda pra baixa de estoque em tempo real.
Loja que gerencia estoque no MercadoPhone conecta à Verbix e para de cadastrar produto duas vezes — com um bônus: o webhook de venda elimina a janela entre vender no balcão e o robô ficar sabendo.
Conectar — passo a passo
Vai em Configurações → Sistema de Gestão
Escolhe MercadoPhone na lista de sistemas.
Preenche o Token de API
Gerado no painel do MercadoPhone. O campo de código de autenticação do webhook (mp-auth-code) entra junto — ele valida os avisos de venda que o ERP vai mandar.
Conecta e sincroniza
O sistema valida o token e roda a primeira sincronização. Acompanha o progresso na tela — e força uma rodada com Sincronizar agora quando quiser.
Configura o webhook de venda
Na tela de Configurar webhook, a Verbix mostra a URL do webhook. No painel do MercadoPhone, vai em Ferramentas → Webhooks e cadastra essa URL com o código de autenticação. Pronto: cada venda salva no ERP avisa a Verbix na hora.
O que muda com o webhook
| Sem webhook (só sync) | Com webhook |
|---|---|
| Venda no balcão some da Verbix no próximo ciclo de sync (poucos minutos) | Venda no balcão some da Verbix em tempo real |
Na prática: a janela em que a Fernanda poderia oferecer um aparelho que acabou de sair no balcão cai pra perto de zero. (E se ainda assim um PIX cair de item vendido, o fluxo de troca cobre.)
Quem manda no preço
Igual ao Fone Ninja — você escolhe em Configurações → Integração e Pedidos:
- Preço do ERP — a Verbix lê os preços do MercadoPhone; a Tabela de Preços fica bloqueada
- Preço na Verbix — o ERP serve pro estoque, e os preços você administra na Tabela de Preços
O estoque vem sempre do ERP.
Troubleshooting rápido
- Token não valida — gera um token novo no painel do MercadoPhone e atualiza na Verbix (Sistema de Gestão → Reconectar).
- Venda no balcão não sumiu na hora — confere se o webhook está cadastrado em Ferramentas → Webhooks com a URL e o código corretos. Sem webhook, a baixa vem no ciclo de sync normal.
- Banner de instabilidade — mesmo comportamento do Fone Ninja: amarelo = problema do lado do ERP (aguarda), vermelho = credencial inválida (reconecta). Ver Fone Ninja instável — o diagnóstico vale igual.
FAQ
Posso ter Fone Ninja e MercadoPhone ao mesmo tempo?
A loja conecta um sistema de gestão por vez — o que for a fonte da verdade do seu estoque.
Vendi pela Verbix — o MercadoPhone fica sabendo?
Sim: a venda confirmada é enviada pro ERP, que dá baixa no aparelho. Sem digitação dupla, nos dois sentidos.
Meu ERP não é Fone Ninja nem MercadoPhone
A tela de Sistema de Gestão mostra os próximos da fila como "em breve". Sinaliza o seu pro suporte — a demanda das lojas prioriza o roadmap.
Próximo passo
Como o estoque espelhado funciona: Gestão de estoque.
Integração com ERP Fone Ninja
Como conectar seu Fone Ninja e deixar a Verbix sincronizar estoque e preços automaticamente — com e-mail, senha e identificador da loja.
Conceitos
Como a plataforma da Verbix se organiza e protege os dados da sua loja. Visão de alto nível pra quem quer entender por dentro.