Integração de E-commerce com ERP: Guia Prático

O que é a integração de e-commerce com ERP?

Integração de e-commerce com ERP é a conexão que mantém catálogo, preços, estoque, pedidos, faturamento e entrega coerentes entre a loja virtual e o sistema de gestão. Ela substitui redigitação e planilhas por fluxos rastreáveis, mas só funciona bem quando a empresa define qual sistema é responsável por cada informação, como os estados mudam e como as divergências serão corrigidas.

A API ou o conector é apenas o meio. O projeto também precisa traduzir identificadores, impostos, unidades, kits, promoções e status entre modelos diferentes. Precisa ainda tolerar indisponibilidade, eventos duplicados e atualizações fora de ordem sem criar outro pedido ou vender estoque inexistente.

O resultado esperado não é “sincronizar tudo em tempo real”. É entregar ao cliente informação confiável e permitir que operação, fiscal, logística e atendimento trabalhem sobre o mesmo fato. Uma solução de e-commerce deve incorporar essa integração desde o desenho, não tratá-la como ajuste final.

Quando integrar a loja virtual ao ERP?

A integração se torna prioritária quando o trabalho manual já afeta prazo, qualidade ou capacidade de crescimento. Alguns sinais:

• pedidos são digitados novamente no ERP;
• preço ou disponibilidade divergem entre loja e operação;
• vendas em vários canais disputam o mesmo estoque;
• faturamento e expedição dependem de planilhas;
• cancelamentos não devolvem saldo corretamente;
• o atendimento não enxerga nota fiscal ou rastreio;
• falhas só aparecem após reclamação do cliente;
• campanhas exigem uma força-tarefa para manter os sistemas alinhados.

Antes de desenvolver, confira se a plataforma e o ERP possuem um conector nativo adequado. Ele pode reduzir prazo e manutenção quando cobre as regras reais do negócio. Uma integração personalizada faz sentido quando há múltiplos canais, regras específicas, sistemas legados, alto volume ou lacunas importantes no conector.

Se a plataforma ainda não foi escolhida, o guia sobre como escolher uma plataforma de e-commerce ajuda a avaliar APIs, custos e capacidade de evolução antes de assumir uma dependência.

Defina a fonte de verdade de cada dado

Dois sistemas não devem decidir de forma independente o mesmo fato. Crie uma matriz de autoridade antes de mapear endpoints:

“Fonte de verdade” não significa que apenas um sistema armazena o dado. Significa que, em caso de conflito, existe uma autoridade e uma regra de correção.

A documentação de integração de back office da VTEX apresenta um fluxo típico: produtos, preços e inventário seguem para a plataforma, enquanto pedidos seguem para ERP ou WMS; nota e rastreio retornam depois. O desenho da sua empresa pode mudar, mas as direções devem ser explícitas.

Quais fluxos a integração de e-commerce com ERP deve cobrir?

Catálogo e identificadores

Produto e SKU são entidades diferentes. Uma camiseta pode ser o produto, enquanto cada combinação de cor e tamanho é um SKU com estoque próprio. Defina chaves estáveis e guarde o relacionamento entre o código interno e o identificador de cada plataforma.

O cadastro deve tratar:

• categoria, marca, variações e unidade;
• kits, componentes e brindes;
• imagens e descrições;
• produto inativo ou descontinuado;
• dimensões e peso para frete;
• regras fiscais necessárias à operação.

Não use nome ou descrição como chave. Eles mudam. O mapeamento precisa sobreviver a alterações editoriais e permitir reprocessamento sem criar duplicatas.

Preços e promoções

Modele preço-base, tabela por canal, período promocional, moeda, arredondamento e prioridade de regras. Defina se o ERP envia o preço final ou se a plataforma aplica promoções sobre uma base.

A especificação de produtos do Google Merchant Center exige que preço e disponibilidade enviados correspondam à página e ao checkout. A consistência da integração, portanto, afeta não apenas a venda, mas também a qualidade dos feeds e a presença do catálogo em experiências de busca.

Nunca atualize todos os SKUs quando apenas alguns mudaram sem considerar limites da API. Use lotes, delta de alterações e controle de versão conforme a plataforma permitir.

Estoque e disponibilidade

Saldo físico não é necessariamente saldo vendável. Reservas, pedidos pendentes, estoque de segurança, múltiplos depósitos, devoluções e itens danificados alteram o que pode ser prometido.

Defina uma fórmula de disponibilidade e quem a calcula. Em operações com vários canais, uma pequena reserva de segurança pode ser mais prudente que publicar todo o saldo quando existe latência. A documentação de inventário do Adobe Commerce diferencia quantidade disponível, reservas temporárias e baixa no envio, ilustrando por que “subtrair um item após a compra” é insuficiente.

O fluxo precisa responder:

• quando reservar;
• quando confirmar a baixa;
• quando liberar após cancelamento ou expiração;
• como tratar pedido parcial;
• como distribuir por depósito;
• como reconstruir o saldo após uma divergência.

Pedidos e seus estados

Um pedido não é apenas um registro. Ele passa por estados: criado, aguardando pagamento, aprovado, em separação, faturado, enviado, entregue, cancelado, devolvido ou reembolsado. Os nomes variam e nem todo sistema possui equivalência direta.

Crie uma máquina de estados permitidos. O ERP não deve faturar um pedido só porque recebeu um evento de criação se a regra exige pagamento aprovado. Também não deve aceitar uma regressão impossível causada por uma mensagem atrasada.

A orientação da VTEX para integração de pedidos alerta que eventos do feed podem se repetir. Por isso, use o identificador externo do pedido e uma chave idempotente: reprocessar a mesma mensagem deve manter o mesmo resultado, não gerar nova venda.

Faturamento, expedição e pós-venda

Depois que o ERP ou WMS processa o pedido, a loja precisa receber informações que o cliente e o atendimento consultam:

• número e dados permitidos do documento fiscal;
• itens efetivamente faturados;
• transportadora e código de rastreio;
• envio parcial;
• cancelamento aceito ou recusado;
• devolução, troca e reembolso.

O caminho inverso é tão importante quanto importar pedidos. Se a loja continua mostrando “em preparação” depois da expedição, a integração concluiu o processo interno, mas falhou na experiência do cliente.

Arquitetura: conector, middleware ou integração direta?

Conector nativo

É adequado quando os sistemas, o volume e as regras estão dentro do cenário suportado. Avalie documentação, atualização, fila de erros, reprocessamento, limites, suporte e responsabilidade por mudanças de API.

Integração direta

Conectar plataforma e ERP diretamente pode ser simples em um único fluxo. O acoplamento cresce quando catálogo, pedidos e estoque passam a depender de particularidades dos dois lados. Uma atualização pode exigir mudança coordenada.

Middleware ou hub

Uma camada intermediária normaliza modelos, controla filas, aplica regras, registra auditoria e desacopla indisponibilidades. Ela ajuda quando existem ERP, PIM, OMS, WMS, marketplaces e transportadoras. Porém, vira outro sistema crítico e precisa de operação, segurança e observabilidade.

Projetos de software sob medida podem implementar essa camada quando conectores prontos não cobrem o processo. Para operações com TOTVS, a consultoria Protheus pode apoiar o mapeamento entre pedidos, estoque, fiscal e integrações sem alterar o ERP de forma improvisada.

Como tornar a integração confiável

Combine eventos, APIs e reconciliação

Eventos ou webhooks reduzem latência; APIs consultam o estado atual; filas absorvem picos; cargas em lote atendem catálogos grandes; reconciliação detecta o que foi perdido. Normalmente, a solução usa mais de um mecanismo.

A documentação de webhooks da Shopify recomenda verificar assinaturas, ignorar entregas duplicadas e executar rotinas periódicas de reconciliação, pois eventos podem chegar fora de ordem ou não ser processados. O artigo sobre webhooks para integração de sistemas detalha esse padrão.

Registre antes de processar

Ao receber um pedido ou evento:

1. autentique a origem;
2. valide o contrato e o tamanho;
3. registre identificador, horário e payload protegido;
4. confirme o recebimento conforme o protocolo;
5. processe de forma assíncrona quando possível;
6. salve resultado, tentativas e correlação;
7. encaminhe falhas permanentes para análise.

Retentativas devem usar atraso crescente e limite. Um erro de autenticação ou um SKU inexistente não será resolvido por tentativas infinitas.

Reconcilie por fato de negócio

Não compare apenas contagem de requisições. Gere verificações como:

• pedidos pagos na loja e ausentes no ERP;
• pedidos faturados sem retorno de nota;
• SKUs com preço divergente;
• saldo vendável negativo;
• cancelamentos sem liberação de reserva;
• rastreios não enviados;
• mensagens presas acima do tempo esperado.

A reconciliação automática deve permitir correção segura ou abrir uma exceção com contexto suficiente para o time agir.

Segurança e privacidade

Use credenciais separadas por ambiente e integração, menor privilégio, rotação e armazenamento em cofre. Exija TLS, valide assinatura de webhooks e proteja endpoints contra repetição. Não exponha tokens em logs.

A OWASP API Security Top 10 destaca riscos como autorização incorreta, consumo irrestrito de recursos, inventário deficiente e uso inseguro de APIs de terceiros. Limites, validação de objeto, allowlists de campos e gestão de versões devem fazer parte do projeto.

Envie apenas os dados pessoais necessários para faturamento, entrega e atendimento. Defina retenção, acesso e mascaramento em logs. Dados completos de cartão não devem circular pelo middleware ou ERP; mantenha o processamento no provedor de pagamento e trafegue apenas referências e estados indispensáveis.

Testes que evitam falhas em produção

Além do “pedido feliz”, teste:

• SKU simples, variação e kit;
• cupom, desconto, frete e arredondamento;
• pagamento pendente, recusado e aprovado depois;
• evento duplicado e fora de ordem;
• indisponibilidade do ERP;
• pedido com múltiplos depósitos ou envios;
• cancelamento antes e depois do faturamento;
• devolução ou reembolso parcial;
• produto inativado durante uma campanha;
• alteração simultânea de preço e estoque;
• limite de API e pico de pedidos;
• reprocessamento após correção cadastral.

Use ambiente de homologação com dados não pessoais. Valide contratos automaticamente e execute testes de ponta a ponta com responsáveis de comércio, fiscal, logística, atendimento e tecnologia.

Implantação e métricas operacionais

Evite trocar todos os fluxos de uma vez. Faça carga inicial, valide amostras, libere um recorte de catálogo ou canal e mantenha um plano de retorno. Durante a estabilização, compare os sistemas e acompanhe a fila com frequência maior.

Métricas úteis incluem:

• tempo entre pagamento aprovado e pedido disponível no ERP;
• porcentagem de pedidos integrados sem intervenção;
• divergência de preço e estoque;
• mensagens com erro e idade da mensagem mais antiga;
• pedidos duplicados;
• cancelamentos por indisponibilidade;
• tempo entre faturamento e atualização do rastreio;
• sucesso da última reconciliação.

Disponibilidade técnica isolada não basta. Uma API pode responder enquanto os pedidos permanecem presos por regra fiscal ou mapeamento incorreto.

Checklist para integração de e-commerce com ERP

• Cada dado possui uma fonte de verdade?
• Produto, SKU, kit e identificadores estão mapeados?
• Preço, promoção e arredondamento têm regras explícitas?
• Estoque físico, reserva e saldo vendável estão separados?
• Estados de pedido e transições permitidas estão documentados?
• Eventos duplicados e fora de ordem são seguros?
• Existe fila, retentativa limitada e reprocessamento?
• A reconciliação cobre pedidos, preços, estoque e faturamento?
• Credenciais têm menor privilégio e rotação?
• Logs evitam segredos e dados pessoais excessivos?
• Exceções possuem responsável e procedimento?
• O rollout tem escopo gradual e plano de retorno?
• Métricas medem impacto operacional, não apenas chamadas?

Integre o processo, não apenas os sistemas

Uma integração de e-commerce com ERP confiável nasce do domínio: quem controla cada dado, quando um pedido pode avançar, como uma reserva volta ao estoque e como a operação corrige divergências. APIs, webhooks e middleware implementam essas decisões; não as substituem.

Comece pelos fluxos críticos, modele exceções, teste estados reais e mantenha reconciliação contínua. Se sua empresa precisa conectar loja virtual, ERP, estoque e faturamento com segurança, fale com a Mattos Tech Solutions.

Fontes e referências

• Back office integration guide — VTEX
• Set up order integration — VTEX
• About webhooks — Shopify
• Source algorithms and reservations — Adobe Commerce
• Product data specification — Google Merchant Center
• OWASP API Security Top 10 — OWASP