Perguntas frequentes sobre a API e os webhooks
Dúvidas de quem está avaliando a integração antes de contratar.
O MeuEcomm integra com o meu ERP?
+
Não existe integração nativa pronta com nenhum ERP específico. O que o MeuEcomm oferece é uma API REST aberta e webhooks, que funcionam com qualquer sistema capaz de fazer e receber chamadas HTTP. A ponte entre os dois sistemas é construída uma vez, pelo seu desenvolvedor, pela empresa que fornece o seu ERP ou por uma ferramenta de automação como o n8n. Depois disso ela roda sozinha.
Por que não existe integração pronta com os ERPs conhecidos?
+
Porque o mercado brasileiro tem centenas de ERPs, cada um com o seu modelo de dados, e mesmo duas empresas que usam o mesmo ERP costumam ter cadastros e regras diferentes. Uma integração genérica atenderia mal quase todo mundo. Preferimos entregar as duas pontas bem documentadas — API e webhooks — para a ponte ser feita do jeito que a sua operação precisa, sem você depender de a gente priorizar o seu ERP na fila.
Em qual plano a API está disponível?
+
O acesso à API faz parte do plano Business, o mesmo plano com o maior limite de produtos, pedidos e usuários. Os planos Free, Lite e Standard não incluem acesso à API. Se você ainda está validando a operação, comece por um plano menor e migre para o Business quando a integração entrar no seu planejamento.
Onde eu encontro o meu token de acesso?
+
No painel do MeuEcomm, em Configurações, submenu Dados gerais, existe a opção de gerar o seu token. Ele é usado no header Authorization, no formato "Bearer SEU_TOKEN", em todas as requisições. Guarde esse token com cuidado: quem tem ele em mãos consegue alterar os dados da sua conta, então ele nunca deve ficar em código versionado nem ser enviado por mensagem.
Qual a diferença entre a API e os webhooks?
+
A API é quando o seu sistema fala com o MeuEcomm: ele decide a hora e faz a chamada, para enviar produtos e preços ou buscar pedidos. O webhook é o contrário: o MeuEcomm avisa o seu sistema no instante em que algo acontece, chamando uma URL que você cadastrou. Sem webhook, o seu ERP precisaria ficar perguntando "tem pedido novo?" de minuto em minuto. Com webhook, ele fica quieto e é avisado. A maioria das integrações usa os dois: API para empurrar o catálogo, webhook para receber o pedido.
Quais eventos disparam um webhook?
+
São 16 eventos, organizados em cinco grupos. Pedidos avisa quando um pedido é criado, atualizado, cancelado ou excluído. Produtos, Clientes, Estoque e Tabela de Preço avisam quando o registro é criado, atualizado ou excluído. Ao cadastrar o webhook você marca quais desses eventos quer receber e ignora o resto, então o seu sistema não é chamado por coisa que não vai tratar.
O que é o campo "integrado" que aparece na documentação?
+
É o controle que evita processar o mesmo registro duas vezes. Todo cadastro nasce com integrado igual a 0, ou seja, ainda não foi levado para o outro sistema. Depois que o seu ERP processa o registro, ele marca como 1. Assim, o seu sistema pode simplesmente pedir a lista de pedidos com integrado=0 e receber só o que ainda falta — sem precisar guardar data da última sincronização nem correr o risco de importar o mesmo pedido de novo.
Dá para usar n8n, Make ou Zapier em vez de programar?
+
Dá, e é um caminho comum. Essas ferramentas trabalham exatamente com o que a API e os webhooks oferecem: uma URL que recebe o evento e chamadas HTTP com JSON e um header de autorização. No n8n, por exemplo, um nó de Webhook recebe o pedido do MeuEcomm, um nó de transformação ajusta os nomes dos campos e um nó de HTTP Request entrega o pedido ao seu ERP. Continua sendo um trabalho técnico, mas não exige montar e manter um servidor de integração.
O meu endpoint de webhook precisa ser HTTPS?
+
Precisa. O campo de URL só aceita endereços HTTPS e o servidor precisa estar acessível publicamente na internet, porque é o MeuEcomm que faz a chamada até ele. Um endereço em rede interna, em localhost ou atrás de VPN não recebe o aviso. Se o seu ERP roda dentro da empresa, o caminho é expor um endpoint intermediário — que é justamente o papel que uma ferramenta de automação hospedada costuma cumprir.
Quem ajuda se eu tiver uma dúvida técnica durante a integração?
+
A documentação oficial fica no Postman e cobre cada endpoint com exemplo de requisição e resposta. Para dúvidas que a documentação não resolve, existe um canal direto com o time de desenvolvimento no e-mail [email protected]. Questões de conta, plano e liberação continuam pelo suporte normal.