Como integrar o ERP com site e e-commerce

Integrar ERP e e-commerce é sincronizar quatro fluxos: catálogo e preço descem do ERP para a loja, estoque precisa refletir a realidade nos dois lados, pedido sobe da loja para o ERP e status e nota voltam para o cliente. Cada um tem um dono, uma frequência e um modo próprio de falhar. Quem trata os quatro como "uma integração" só descobre o problema quando vende o que não tem.

Quem é dono de cada dado

Antes de qualquer código, defina a fonte da verdade de cada informação. Sem isso, dois sistemas sobrescrevem um ao outro para sempre.

O cadastro de cliente é o campo de batalha mais comum. Se a loja permite compra sem login e o ERP exige CPF/CNPJ único, você vai acabar com clientes duplicados. Defina a chave de unicidade (documento, normalmente) e a regra de mesclagem antes de ligar o fluxo.

Estoque: onde a integração costuma quebrar

Estoque é o fluxo mais sensível porque o erro tem custo direto: ou você vende o que não tem, ou deixa de vender o que tem.

Não sincronize em lote longo. Uma carga de hora em hora significa que, no pior caso, a loja opera com 59 minutos de defasagem. Em item de giro rápido ou em campanha, isso é venda cancelada e cliente irritado.

O padrão que funciona:

1. Baixa por evento, toda movimentação no ERP dispara notificação para a loja
2. Reserva no momento do carrinho, não na confirmação do pagamento
3. Expiração da reserva, carrinho abandonado devolve o item ao estoque depois de um prazo
4. Reconciliação periódica, uma vez por dia, comparar totais e alertar divergência
5. Reserva de segurança, em SKUs críticos, esconder algumas unidades da loja como colchão

O ponto 4 é o que salva. Mesmo com evento, mensagens se perdem. Uma rotina noturna que compara o estoque dos dois lados e reporta as diferenças transforma um erro invisível em um alerta.

E há o caso do estoque multicanal: loja própria, marketplace, PDV físico. Vender o mesmo item em quatro canais sem um controlador central de reserva é garantia de overselling. Quando existem mais de dois canais, vale um intermediário (hub) que centralize o saldo disponível.

Pedido: idempotência é obrigatória

Quando a loja envia o pedido para o ERP, a rede pode falhar depois da gravação e antes da resposta. A loja não sabe se gravou, tenta de novo, e o ERP cria um segundo pedido.

A solução é chave de idempotência: a loja gera um identificador único do pedido e o envia junto. O ERP guarda essa chave; se receber a mesma de novo, devolve o resultado original em vez de gravar outro registro. Isso não é refinamento, é requisito básico, e é a causa número um de pedidos em dobro em integrações mal feitas.

O fluxo completo do pedido precisa também de:

• Fila com retentativa, se o ERP está fora, o pedido não se perde, fica na fila
• Backoff progressivo, tentar de novo em intervalos crescentes, não em loop
• Fila de falha definitiva, depois de N tentativas, o caso vai para revisão humana com o motivo registrado
• Correspondência de códigos, SKU da loja, código do ERP, EAN e código de marketplace precisam de uma tabela de/para clara

Nota fiscal: quem emite e o que volta

Na grande maioria dos casos, quem emite é o ERP. Ele já tem cadastro fiscal, NCM, CFOP, regime tributário e histórico contábil. Duplicar essa lógica na loja é criar duas verdades fiscais.

O que a loja precisa receber de volta:

• Número e série da nota
• Chave de acesso
• Link do DANFE ou do XML
• Status de autorização

E precisa lidar com rejeição da SEFAZ. A nota nem sempre é autorizada de primeira: cadastro incompleto, NCM inválido, inscrição estadual irregular. Se a loja não trata isso, o pedido fica preso num estado indefinido e ninguém percebe até o cliente ligar. O tratamento correto é status explícito de "nota rejeitada", com motivo legível e alerta para o time fiscal.

Como escolher a forma de integrar

Middleware próprio faz sentido quando existem regras que nenhum hub cobre, política de preço por canal, kits que consomem componentes diferentes, estoque por lote. Mas trate-o como um sistema: com log, monitoramento e alguém responsável.

O que monitorar depois de ligar

Integração é o tipo de coisa que funciona por meses e falha numa quinta-feira sem avisar. O painel mínimo:

• Pedidos pendentes de envio ao ERP, se o número cresce, algo travou
• Idade do item mais antigo na fila, mais reveladora que a contagem total
• Divergência de estoque na reconciliação diária
• Notas rejeitadas nas últimas 24 h
• Última sincronização bem-sucedida por fluxo

Esse último item é o que detecta a falha silenciosa: uma integração que parou de rodar não gera erro, gera ausência. Um alerta simples de "faz 3 horas que nenhum pedido entrou" pega problemas que nenhum log de exceção pegaria.