A integração entre o ERP e a plataforma de e-commerce é o que sustenta a operação de venda online: o estoque que aparece no site vem do ERP, o pedido que o cliente faz precisa chegar na expedição, o preço e a promoção precisam estar consistentes nos dois lados. Quando essa integração falha, o cliente compra o que não existe, o pedido some entre os sistemas ou a nota fiscal sai errada.

A maioria dos problemas não aparece no dia a dia calmo — aparece no pico, na Black Friday, quando o volume multiplica e as falhas que estavam latentes viram incidente. Este artigo lista os erros mais comuns e o que os previne.

Erro 1: sincronizar só por horário fixo

Uma integração que roda “de hora em hora” deixa o estoque desatualizado durante todo o intervalo. Em um produto que vende rápido, isso significa vender unidades que já não existem, gerando cancelamento, reembolso e cliente insatisfeito. No pico, o intervalo fica ainda mais perigoso.

O ideal é reagir a eventos: quando uma venda acontece no site, o ERP é atualizado na hora; quando o estoque muda no ERP (uma entrada, um ajuste, uma venda em outro canal), o site é notificado. A sincronização por horário serve como rede de segurança para reconciliar, não como mecanismo principal.

Erro 2: não tratar as falhas

Toda chamada entre sistemas pode falhar — o ERP está fora, a rede caiu, a resposta demorou demais. Se a integração não trata isso, o pedido que não foi transmitido simplesmente desaparece, e ninguém percebe até o cliente reclamar que não recebeu.

O que resolve: uma fila entre os sistemas, onde cada operação fica registrada até ser confirmada; novas tentativas automáticas com espaçamento crescente; e um alerta quando algo falha repetidamente. Nada pode se perder silenciosamente.

Erro 3: assumir que o ERP aguenta a carga

O ERP foi dimensionado para a operação interna — alguns usuários, um ritmo previsível. Um e-commerce em promoção pode gerar centenas de pedidos por minuto e milhares de consultas de estoque. Jogar essa carga direto no ERP costuma derrubá-lo, e com ele a operação inteira.

A solução é colocar uma camada no meio: um serviço de integração que mantém uma cópia do estoque e do catálogo para servir o site rapidamente, e que envia para o ERP em um ritmo que ele suporta, enfileirando quando necessário.

Erro 4: falta de idempotência

Idempotência é a propriedade de uma operação poder ser executada várias vezes com o mesmo efeito de uma vez só. Sem ela, uma nova tentativa de enviar um pedido que na verdade já tinha sido recebido cria um pedido duplicado — e a expedição manda o produto duas vezes.

Cada operação precisa carregar um identificador único, e o sistema receptor precisa reconhecer quando já processou aquele identificador e ignorar a repetição. É um detalhe técnico que evita um tipo de erro caro e difícil de rastrear.

Erro 5: não registrar o que foi sincronizado

Quando o estoque do site e o do ERP divergem — e uma hora divergem —, é preciso conseguir auditar: o que foi enviado, quando, com qual resposta. Sem esse registro, a reconciliação vira adivinhação e o problema se repete.

Um log estruturado de cada operação de integração, com data, conteúdo e resultado, é barato de manter e paga-se na primeira investigação de divergência.

Erro 6: mapeamento de dados frágil

ERP e e-commerce descrevem as mesmas coisas de formas diferentes: código de produto, unidade de medida, categoria fiscal, forma de pagamento, status de pedido. Um mapeamento feito às pressas quebra quando surge um produto com uma variação nova ou uma condição de pagamento que não estava prevista.

O mapeamento precisa ser explícito, documentado e ter um comportamento definido para o caso não previsto — parar e alertar, em vez de adivinhar e seguir.

Erro 7: ignorar os outros canais

Muitas operações vendem em mais de um lugar — a loja própria, marketplaces, uma força de vendas. Se cada canal integra com o ERP de forma isolada, o estoque vira uma disputa: dois canais vendem a última unidade ao mesmo tempo. Uma camada central de gestão de estoque, que todos os canais consultam e atualizam, resolve.

O que dá estabilidade a uma integração de e-commerce

  • Reação a eventos como mecanismo principal, com sincronização periódica como reconciliação.
  • Fila entre os sistemas, com novas tentativas e alertas.
  • Camada intermediária que protege o ERP da carga do site.
  • Idempotência em todas as operações que criam ou alteram dados.
  • Log estruturado de tudo que trafega.
  • Mapeamento de dados explícito, com tratamento definido para o caso não previsto.
  • Um painel simples para a operação ver o que passou e o que ficou preso.
  • Testes de carga antes das datas de pico.

Preparação para datas de pico

Antes de Black Friday, Natal ou uma campanha grande, vale um roteiro: simular o volume esperado, verificar se a fila e a camada intermediária aguentam, confirmar que os alertas estão funcionando e que alguém vai estar de plantão, e ter um plano para o caso de o ERP ficar indisponível — o site pode continuar vendendo com a integração enfileirando, e reconciliar depois.

O que sincronizar além de estoque e pedido

A integração estoque-pedido é a mais visível, mas uma operação completa costuma precisar sincronizar mais:

  • Catálogo — cadastro de produtos, descrições, atributos, imagens, geridos no ERP ou em um PIM e publicados no site.
  • Preços e promoções — tabelas por canal, por cliente, por data, com regras que precisam ser consistentes.
  • Clientes — dados cadastrais, histórico, limite de crédito, para não ter dois cadastros do mesmo cliente.
  • Status logístico — nota fiscal emitida, pedido faturado, código de rastreio, entregue, devolvido — para o cliente acompanhar e o SAC responder.
  • Financeiro — conciliação de pagamentos, estornos, antifraude.

Cada um desses fluxos tem sua direção (quem é a fonte da verdade) e sua frequência. Definir isso de forma explícita, em um documento, evita a maior parte das divergências.

Reconciliação: aceitar que vai divergir

Nenhuma integração é perfeita o tempo todo. Uma chamada perdida, um sistema fora do ar por minutos, um erro de mapeamento — e os dois lados divergem. O que separa uma operação estável de uma caótica não é nunca divergir, é detectar e corrigir rápido.

Um processo de reconciliação periódica — comparar o estoque dos dois lados, identificar pedidos sem correspondência, apontar divergências de preço — roda automaticamente e gera uma lista curta para a operação resolver. Sem ele, as divergências se acumulam até virar um problema grande.

Middleware pronto ou integração sob medida

Existem plataformas de integração (hubs, iPaaS, conectores prontos) que ligam ERPs e e-commerces populares com configuração mínima. Para operações padronizadas, com sistemas comuns e regras simples, elas entregam valor rápido e barato. Vale sempre avaliá-las primeiro.

A integração sob medida se justifica quando há um ERP customizado ou legado, regras de negócio específicas (tabelas de preço complexas, reservas de estoque, políticas por canal), volume que exige controle fino de performance, ou a necessidade de orquestrar mais de dois sistemas. Nesses casos, o conector pronto ou não cobre, ou cobre com gambiarras que custam mais do que uma solução própria.

Quem é dono da integração

Um problema recorrente é a integração não ter dono. O fornecedor do e-commerce aponta para o do ERP, que aponta de volta. Quando algo quebra, ninguém assume. Definir explicitamente quem é responsável pela camada de integração — construir, monitorar, corrigir — e dar a essa pessoa ou fornecedor acesso e visibilidade dos dois lados é o que evita que um pedido perdido fique dias sem solução.

Como a Jumps implementa

A Jumps implementa integrações entre ERP, e-commerce e demais sistemas com esse conjunto de cuidados: arquitetura orientada a eventos, fila com reprocessamento, camada de proteção do ERP, idempotência e observabilidade. O objetivo é que o pico de vendas seja um evento comercial, não um evento de infraestrutura.

Se a sua integração entre loja e ERP dá sustos, especialmente perto das datas de maior volume, fale com a Jumps.