API e Webhooks

Integre o MeuEcomm ao ERP que você já usa

O MeuEcomm tem uma API REST aberta e webhooks: o seu sistema envia catálogo, preços e estoque, e recebe cada pedido no instante em que ele é fechado. O que não existe é integração nativa pronta com ERPs — e esta página explica exatamente o que isso significa antes de você contratar.

Como a integração funciona

O MeuEcomm não tem integração pronta com nenhum ERP. Ele entrega as duas pontas — uma API REST e webhooks — e a ponte entre os dois sistemas é construída uma vez.

São centenas de ERPs em uso no Brasil, cada um com o seu modelo de dados. Uma integração genérica atenderia mal quase todo mundo, e uma específica colocaria você numa fila esperando a sua vez.

Quem constrói a ponte é o seu desenvolvedor, a empresa do seu ERP ou uma ferramenta como o n8n. Depois de pronta, ela roda sozinha todos os dias — sem ninguém digitando pedido.

As duas metades de qualquer integração

Uma estrada de mão dupla. Elas resolvem problemas opostos e quase toda integração acaba usando as duas.

API · o seu sistema pergunta

Você chama o MeuEcomm na hora que quiser

O seu ERP decide o momento e faz a chamada. É o caminho para empurrar o que muda no seu sistema e precisa aparecer no portal.

  • Enviar e atualizar produtos, categorias, imagens e grades.
  • Publicar tabelas de preço por cliente e saldo de estoque.
  • Cadastrar clientes, endereços e formas de pagamento.
  • Buscar pedidos em lote, no ritmo que o seu sistema aguenta.
Webhook · o MeuEcomm avisa

Nós chamamos o seu sistema quando algo acontece

Você cadastra uma URL, escolhe os eventos e o MeuEcomm bate nela no instante do acontecimento. Ninguém fica perguntando se chegou pedido novo.

  • O pedido entra no ERP em segundos, não no próximo ciclo.
  • Sem varredura de minuto em minuto consumindo o seu servidor.
  • Cancelamento e alteração chegam junto, não só a criação.
  • Do seu lado basta uma rota HTTPS que aceite a chamada.

O que dá para sincronizar

O cadastro inteiro da plataforma, acessível de fora — cada recurso com os quatro verbos de sempre.

Clientes

Cadastrar · Listar · Alterar · Excluir

A carteira sai do ERP e vira acesso ao portal, cada um com a tabela de preço dele.

Endereços

Cadastrar · Listar · Alterar · Excluir

Endereços de entrega por cliente, com consulta de cidades e estados para casar os códigos.

Produtos

Cadastrar · Listar · Alterar · Excluir

O catálogo inteiro vindo do ERP, sem redigitar descrição e código.

Categorias

Cadastrar · Listar · Alterar · Excluir

A vitrine fica organizada igual ao seu sistema.

Imagens

Cadastrar · Listar · Atrelar ao produto · Excluir

Envie o arquivo ou passe a URL da imagem que já está hospedada.

Grades

Cabeçalho e itens: cadastrar · listar · alterar · excluir

Variações de tamanho e cor, para quem vende produto em grade.

Tabelas de preço

Cabeçalho e itens: cadastrar · listar · alterar · excluir

Cada cliente vê o preço que o seu ERP diz que é o dele.

Estoques

Cabeçalho e itens: cadastrar · listar · alterar · excluir

Saldo por depósito, para ninguém pedir o que não tem para entregar.

Formas de pagamento

Cadastrar · Listar · Alterar · Excluir

Do à vista ao parcelado em 30/60/90, como a sua empresa pratica.

Pedidos

Cadastrar · Listar · Alterar · Cancelar · Reativar · Excluir

A ponta que mais importa: o pedido montado pelo cliente entra no seu ERP.

Mensagens

Cadastrar · Listar · Excluir

Avisos para os clientes dentro do portal, publicados pelo seu sistema.

Importação CSV/XLSX

Importar arquivo

Para carga grande, o arquivo vence a requisição uma a uma.

A referência completa, com o corpo de cada requisição e cada resposta, está na documentação oficial no Postman.

Como a API funciona, em cinco pontos

REST e JSON, sem surpresa

URL base https://api.meuecomm.com/. GET consulta, POST cria, PUT altera, DELETE remove. Toda resposta traz status (success ou error) e data.

Token gerado por você, no painel

Em Configurações → Dados gerais você gera o token e o envia no header Authorization: Bearer. Não há processo de aprovação — gerou, já pode testar. Como ele altera os dados da conta, merece o cuidado de uma senha.

HTTPS obrigatório

Chamadas em HTTP simples falham, e sem autenticação também.

O campo "integrado", que evita retrabalho

Todo registro nasce com integrado=0 e o seu ERP marca 1 depois de processar. Assim ele pede só o que ainda falta, sem guardar data de sincronização e sem importar o mesmo pedido duas vezes.

Paginação e carga em massa

As listagens aceitam limit e offset. Para a carga inicial existe importação por CSV/XLSX, bem mais rápida que milhares de requisições.

Buscar os pedidos que ainda não entraram no ERP
curl "https://api.meuecomm.com/pedido/listar?limit=50&offset=0&integrado=0" \
  -H "Authorization: Bearer SEU_TOKEN"

{
  "status": "success",
  "data": [ ... ]
}

Webhooks: o MeuEcomm avisa, você não pergunta

Sem webhook, o seu ERP só descobre que chegou pedido perguntando de cinco em cinco minutos, quase sempre para ouvir “nada novo”. O webhook inverte isso: você cadastra uma URL, marca os eventos que interessam, e o MeuEcomm chama essa URL no instante em que o evento acontece.

URL do endpoint

https://seu-sistema.com/webhook

Apenas URLs com HTTPS são aceitas. O servidor deve ser acessível publicamente.

Eventos para assinar

Selecione os eventos que devem disparar este webhook. São 16 eventos em 5 grupos.

Pedidos
CriadoAtualizadoCanceladoExcluído
Produtos
CriadoAtualizadoExcluído
Clientes
CriadoAtualizadoExcluído
Estoque
CriadoAtualizadoExcluído
Tabela de Preço
CriadoAtualizadoExcluído

Do seu lado basta um endereço HTTPS acessível pela internet que aceite a chamada. Se o seu ERP roda dentro da empresa e não é acessível de fora, o webhook aponta para um intermediário exposto na internet — que é o papel do n8n no exemplo abaixo.

Quem constrói a ponte

Três caminhos, do mais técnico ao que dispensa programador. Nenhum deles depende da nossa fila de prioridades.

Seu desenvolvedor

Para quem tem time de TI ou um dev de confiança

O caminho mais direto. Documentação pública, token no próprio painel, nenhum processo de aprovação: dá para testar no mesmo dia.

A empresa do seu ERP

Para quem usa um ERP com equipe de customização

Boa parte dos ERPs tem time de integração ou rede de parceiros. Mande a documentação: REST com JSON e token é o feijão com arroz de qualquer integrador.

Uma ferramenta de automação

Para quem não tem programador à disposição

n8n, Make e Zapier montam a integração arrastando blocos: recebem o webhook, ajustam os campos e chamam a API do seu ERP. Sem abrir uma frente de desenvolvimento.

Um exemplo prático com n8n

No n8n você monta o fluxo arrastando blocos, na nuvem deles ou no seu próprio servidor. Ele cobre com blocos prontos exatamente o que a API e os webhooks oferecem: receber uma chamada, ajustar os campos e fazer outra chamada. Make e Zapier seguem a mesma lógica. Uma integração completa costuma virar dois fluxos, um em cada sentido.

Fluxo 1 · do MeuEcomm para o ERP

O pedido chega e entra sozinho

  1. 1

    Um nó de Webhook gera uma URL HTTPS. Você cola essa URL no MeuEcomm e marca o evento "Pedido criado".

  2. 2

    O cliente fecha o pedido no portal e o MeuEcomm chama essa URL, com os dados do pedido em mãos.

  3. 3

    Um nó de transformação converte os códigos: o produto no MeuEcomm vira o produto correspondente no ERP.

  4. 4

    Um nó de HTTP Request entrega o pedido ao ERP. Sem API do outro lado, esse nó grava num banco ou solta um arquivo na pasta de importação.

  5. 5

    Um último nó marca o pedido como integrado no MeuEcomm, fechando o ciclo.

Fluxo 2 · do ERP para o MeuEcomm

O catálogo e o estoque ficam em dia

  1. 1

    Um nó de agendamento dispara o fluxo de hora em hora, ou de madrugada — conforme a sua operação muda de preço e de saldo.

  2. 2

    Um nó de HTTP Request busca no ERP o que mudou: produtos novos, preços alterados, saldo de estoque.

  3. 3

    Um nó de transformação monta o JSON no formato que a documentação descreve.

  4. 4

    Um nó de HTTP Request chama a API do MeuEcomm, criando o que é novo e alterando o que mudou.

Montar isso continua exigindo alguém que entenda de dados. A diferença é não precisar escrever, hospedar e manter um servidor de integração do zero — por isso costuma ser o caminho mais rápido para quem não tem time de TI.

A API está no plano Business

O acesso à API e aos webhooks faz parte do plano Business. Os planos Free, Lite e Standard não incluem. Se você ainda está validando a operação, comece menor: integração com ERP compensa quando digitar pedido já virou trabalho diário.

Não confunda com o MeuEcomm Connect, que são integrações prontas de cobrança, frete e impressão, ligadas com um clique. Os dois estão no Business e não se substituem.

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.

Manda a documentação para quem vai integrar

A referência técnica é pública e não precisa de cadastro. Dúvidas que a documentação não resolve vão direto para o time de desenvolvimento, no e-mail [email protected].

Ainda não é cliente? Crie sua conta grátis para conhecer a plataforma antes de planejar a integração.