TecnologiaArtigo
ERP, marketplaces e loja virtual conversando: um roteiro para integrar os sistemas sem vender o que não tem

Em resumo
Estoque que não bate com o sistema, pedido digitado duas vezes e nota emitida à mão são sintomas de sistemas que não conversam. O ConnectWeek organiza a integração de uma operação de e-commerce em etapas: qual sistema é a fonte de cada dado, como o fluxo de pedido deve correr, o papel do hub de integração e os testes antes de pôr a integração em uso.
Toda loja virtual começa com uma planilha e alguém atento. Enquanto os pedidos cabem numa tarde, dá para copiar dados de um lado para o outro. O problema aparece quando o negócio passa a vender em dois ou três marketplaces, além da loja própria: o mesmo item vende duas vezes com uma unidade no estoque, o preço muda num canal e não no outro, e a nota fiscal atrasa porque o pedido precisou ser redigitado. Este roteiro organiza a integração em etapas, na ordem em que as decisões precisam ser tomadas.
Sintomas de que os sistemas não conversam
- venda cancelada por falta de estoque que o painel dizia existir;
- alguém da equipe dedicado a copiar pedidos dos marketplaces para o sistema de gestão;
- preço diferente do planejado em algum canal, descoberto pelo cliente;
- atraso na expedição porque a nota só é emitida depois de conferir tudo à mão;
- cliente que compra em canais diferentes aparece como várias pessoas no cadastro.
Cada um desses sintomas tem custo. Venda cancelada, em particular, pode derrubar a reputação da conta no marketplace, e isso afeta a exposição dos anúncios.
Qual sistema manda em cada dado?
A decisão mais importante vem antes de qualquer ferramenta: definir, para cada tipo de informação, qual sistema é a fonte única da verdade. Os outros apenas leem. Uma divisão comum:
- Cadastro de produto, custo e estoque: ERP, o sistema de gestão que também emite nota e controla o financeiro;
- Preço por canal: ERP ou uma ferramenta de precificação, nunca editado direto no painel de cada marketplace;
- Conteúdo de vitrine (fotos, descrição rica): plataforma da loja ou um sistema de gestão de catálogo;
- Relacionamento com o cliente: CRM, alimentado pelos pedidos de todos os canais.
Quando duas pontas podem alterar o mesmo dado, a integração vira disputa: o último a gravar vence, e ninguém sabe qual foi.
O caminho de um pedido
Com os papéis definidos, desenhe o fluxo de um pedido do clique à entrega. Uma sequência típica:
- o cliente compra no marketplace ou na loja;
- o pedido entra no ERP automaticamente, com canal de origem identificado;
- o ERP baixa o estoque e publica o novo saldo para todos os canais;
- a nota é emitida e a etiqueta de envio é gerada;
- o código de rastreio volta ao canal de origem, que avisa o cliente;
- o CRM recebe o histórico para pós-venda e recompra.
Cancelamentos e devoluções precisam do caminho inverso, com estorno de estoque. É aí que muitas integrações falham, porque só o fluxo feliz foi testado. Se a falha já gerou uma venda sem saldo, veja como tratar o pedido vendido sem estoque.
Conexão direta ou hub
Os grandes marketplaces oferecem interfaces de programação abertas — a documentação da API do Mercado Livre, por exemplo, descreve como sistemas externos publicam anúncios, atualizam estoque e recebem notificações de pedidos. Há três formas de usar esse tipo de recurso:
- Integração nativa do ERP: muitos sistemas de gestão voltados ao e-commerce já trazem conectores prontos para os marketplaces mais usados. É o caminho mais simples, quando cobre todos os canais.
- Hub de integração: um intermediário que conecta vários marketplaces a um ponto só e conversa com o ERP. Faz sentido quando os canais se multiplicam ou quando o ERP não tem conector para algum deles.
- Integração sob medida: desenvolvimento próprio sobre as APIs. Dá controle total, mas exige equipe para manter, porque as plataformas mudam regras e versões com frequência.
Para a maioria das operações pequenas e médias, as duas primeiras opções resolvem. Sob medida é caminho para quem tem volume e time técnico.
Estoque de segurança e frequência de atualização
Mesmo integrado, o estoque leva algum tempo para se propagar entre sistemas. Em dia de pico, dois clientes podem comprar a última unidade em canais diferentes no intervalo entre uma atualização e outra. Duas proteções simples:
- Estoque de segurança por canal: publicar nos marketplaces um saldo um pouco menor que o real para itens de giro alto;
- Atualização por evento: preferir integrações que avisam a cada venda, em vez de sincronizar por lote a cada tantas horas.
Na prática, "avisar a cada venda" é o que as plataformas chamam de notificação. Pela documentação do Mercado Livre, o sistema integrado recebe um aviso por HTTP POST sempre que uma venda confirmada é criada ou alterada (tópico orders_v2) e deve responder HTTP 200 em até 500 milissegundos — quem demora corre o risco de ter os avisos desativados. Aviso não confirmado é reenviado durante 1 hora e, depois disso, descartado. O token de acesso à API expira 6 horas depois de gerado e precisa ser renovado com o refresh token. Por isso as integrações que funcionam trabalham com fila: confirmam o aviso na hora, processam em seguida e renovam o acesso sem ninguém intervir. Pergunte ao fornecedor do conector como ele trata cada um desses pontos.
Os testes antes de ligar tudo
Antes de virar a chave para o catálogo inteiro, rode um roteiro com poucos itens reais e confira o resultado em todos os sistemas:
- criar um pedido em cada canal;
- cancelar um pedido antes do envio;
- registrar uma devolução depois da entrega;
- alterar o preço no sistema-fonte e ver se todos os canais refletem;
- zerar o estoque de um item e confirmar que ele sai de venda em todo lugar;
- conferir se a nota e o rastreio chegam ao cliente.
Documente quem é responsável por monitorar erros de integração no dia a dia. Uma fila de pedidos travados que ninguém olha anula o investimento.
Se a operação ainda é pequena
Nem toda loja precisa de hub e três marketplaces no primeiro ano. Para quem vende em um canal só, o passo mais valioso costuma ser escolher um sistema de gestão que já conecte loja e emissão de nota, e abandonar a planilha paralela de estoque. O segundo passo é padronizar o cadastro: código interno único para cada variação de produto (cor, tamanho), porque é por esse código que qualquer integração futura vai casar os dados.
Esse código interno é o SKU, e cada variação tem o seu. Quando o produto tem código de barras, cadastre também o GTIN, o número padronizado pela GS1 (no Brasil, pela GS1 Brasil) para identificar o mesmo item em qualquer sistema, do caixa da loja ao catálogo dos marketplaces. O GTIN tem 8, 12, 13 ou 14 dígitos: o GTIN-13, sinônimo do EAN-13, é o mais usado fora da América do Norte; o GTIN-12 é o do código UPC-A; o GTIN-8 serve a itens pequenos; e o GTIN-14 identifica caixas e fardos com várias unidades, não o item vendido no caixa, segundo a GS1 US.
Ao abrir o segundo canal, a regra de ouro é não cadastrar os produtos à mão no painel do marketplace. Publicar a partir do sistema de gestão dá mais trabalho no início e evita, depois, a divergência de preço e estoque que motivou este texto. Crescer com a base arrumada custa bem menos do que arrumar a base com a operação rodando.
Custo, contrato e saída
Ferramentas de integração costumam cobrar mensalidade, por volume de pedidos ou por canal conectado. Ao comparar, pergunte também como exportar os dados se for preciso trocar de fornecedor, qual o suporte em data de pico e como são tratadas as mudanças de API dos marketplaces. As perguntas para a demonstração e o que observar no período de teste estão em hub de integração de marketplace: o que conferir antes de contratar. Para a loja com mais de um estoque, as regras que escolhem de onde sai cada pedido estão em OMS: como o sistema decide de qual estoque sai o pedido.
Integração é a base para os ganhos de automação discutidos em onde a automação realmente gera eficiência e para usar o CRM de forma consultiva, como no texto sobre vendas consultivas com CRM. E, se a dúvida ainda for em quais canais estar, o guia marketplace ou loja própria ajuda a decidir antes de conectar tudo.
Comece por aqui Novo no assunto? Leia primeiro o que é e-commerce, o texto-base desta cobertura.
Fonte: Mercado Livre Developers
Perguntas frequentes
Qual sistema deve controlar o estoque?
Um só. Na maioria das operações, o ERP é a fonte do saldo de estoque e publica esse número para loja e marketplaces; os canais apenas leem e devolvem os pedidos.
Preciso de um hub de integração?
A partir de dois ou três canais de venda, costuma valer: o hub conecta os marketplaces a um ponto só e evita manter uma integração separada para cada canal.
Como testar a integração antes de ligar?
Com um produto de teste ou poucos SKUs reais: criar pedido, cancelar, devolver, alterar preço e zerar estoque, conferindo se cada evento aparece certo em todos os sistemas.





