Diferente do varejo tradicional (B2C), onde o catálogo possui preços únicos e o pagamento ocorre imediatamente por cartão ou Pix, uma operação de comércio eletrônico B2B depende de contratos personalizados, tabelas de preço por CNPJ, cálculo de tributação interestadual complexa e faturamento a prazo.
Por essas razões, uma integração de ERP com e-commerce B2B mal projetada cria problemas graves: divergência de impostos na emissão da NF-e, vendas de produtos com estoque zerado e sobrecarga nos servidores internos da empresa.
Neste guia, analisamos a arquitetura de dados indispensável para conectar o ERP (como TOTVS, SAP, Sankhya, Senior ou Omie) à sua plataforma de vendas online de maneira segura, resiliente e escalável.
Por que a integração B2B exige uma arquitetura diferente do B2C?
No comércio entre empresas no mercado brasileiro, cinco particularidades mudam as regras da integração:
- Preços dinâmicos por cliente e canal: Um mesmo SKU pode ter dezenas de preços distintos com base em contratos anuais, volume de caixas fechadas, regime tributário da empresa compradora e estado de entrega.
- Condições de pagamento e crédito: A maioria das compras corporativas é feita via boleto faturado (30/60/90 dias). A plataforma precisa checar o saldo de crédito disponível e títulos em atraso antes de concluir o pedido.
- Múltiplos centros de distribuição (CDs): O estoque precisa ser roteado conforme a filial responsável pelo atendimento logístico daquela região geográfica.
- Volume de dados e carga no ERP: Fazer consultas síncronas ("ao vivo") no banco de dados do ERP a cada clique de navegação do catálogo derruba o sistema de gestão corporativo.
- Legislação tributária brasileira: Regras como ICMS-ST, DIFAL, alíquotas internas e PIS/COFINS precisam ser validadas para que o valor total do pedido bata com a Nota Fiscal Eletrônica.
Os 5 fluxos essenciais de dados na integração
Para garantir a integridade entre o e-commerce B2B e o ERP, a comunicação deve ser dividida em cinco fluxos bem delimitados:
1. Catálogo de produtos e atributos fiscais (ERP → E-commerce)
O ERP atua como a fonte única da verdade cadastral. A sincronização deve carregar:
- Identificadores únicos (SKU, código de barras/EAN, código do fornecedor).
- Classificação fiscal (NCM, CEST, código de origem, tributação monofásica).
- Informações logísticas (peso cúbico, dimensões, embalagem master, múltiplos de venda).
- Status de linha (ativo, inativo, sob encomenda, descontinuado).
2. Matriz de tabelas de preço e políticas comerciais (ERP → E-commerce)
Em vez de calcular o preço via chamadas lentas por requisição HTTP, a integração replica a lógica comercial para a plataforma ou para um cache de alta velocidade (como Redis):
- Tabelas padrão por estado (UF).
- Exceções e acordos contratuais vinculados ao CNPJ raiz ou filial.
- Faixas de desconto progressivo por quantidade de itens.
3. Estoque físico vs. Estoque disponível (ERP ↔ E-commerce)
O estoque deve ser transmitido em duas modalidades:
- Carga delta periódica: Atualizações parciais enviadas a cada poucos minutos apenas para produtos que sofreram movimentação recente.
- Webhook de reserva imediata: No momento em que um pedido é submetido no e-commerce, uma mensagem de pré-reserva é registrada no ERP para evitar que a equipe de vendas interna venda o mesmo lote físico por telefone ou balcão.
4. Consulta de limite de crédito e dados financeiros (ERP ↔ E-commerce)
Quando o cliente inicia o checkout selecionando faturamento a prazo, o sistema dispara uma validação via API de integração:
- Confirmação do limite de crédito remanescente.
- Checagem de títulos vencidos e não compensados.
- Se o limite for insuficiente, o carrinho oferece opções alternativas (como pagamento antecipado via Pix ou divisão de pagamento).
5. Injeção e ciclo de vida do pedido (E-commerce → ERP → E-commerce)
O pedido criado no e-commerce entra como um Pré-Pedido ou Ordem de Venda no ERP:
- A injeção ocorre de forma assíncrona garantida (usando filas de mensageria).
- Quando o ERP fatura o pedido, ele envia de volta ao e-commerce o número da NF-e, chave de acesso da Danfe, link de rastreamento do transportador e boletos bancários em PDF gerados pelo banco.
Arquitetura recomendada: Síncrona vs. Assíncrona
Um dos erros mais comuns em integrações é tentar fazer todas as chamadas de forma síncrona. Se o ERP ficar lento por 10 segundos ou passar por uma manutenção noturna, o e-commerce sai do ar ou perde vendas.
A arquitetura robusta adota uma abordagem híbrida:
- Comunicação Assíncrona orientada a eventos (Message Queue): Pedidos gerados na plataforma entram em uma fila segura (usando RabbitMQ, Kafka ou Redis Streams). Um serviço intermediário consome a fila e faz a injeção no ERP com mecanismo de retentativas automáticas e controle de idempotência (impedindo que um pedido seja gravado duas vezes).
- Camada de Middleware (BFF / API Gateway): Uma camada intermediária desacopla o e-commerce do ERP. Essa camada normaliza os dados, monitora logs e converte formatos proprietários de ERPs legados em endpoints REST ou GraphQL rápidos e protegidos. Conheça as estratégias em integração de sistemas.
Tratamento de dados duplicados e idempotência
Para evitar que instabilidades de rede causem duplicidade de faturamento, toda transação financeira e injeção de pedido deve exigir uma chave de idempotência única (por exemplo, uma hash combinando o ID do pedido no e-commerce com a versão do checkout). Se a mesma requisição for enviada duas vezes pelo sistema web, o ERP apenas responde com o status do registro já existente, em vez de duplicar a ordem.
Como planejar a implementação
- Auditoria de APIs e acessos do ERP: Avalie se o ERP já possui endpoints documentados ou se será necessário criar conectores intermediários via banco de dados ou webhooks.
- Definição dos donos dos dados: Estabeleça formalmente qual sistema é a autoridade sobre cada dado (o ERP comanda estoque e cadastro de produtos; a plataforma comanda a sessão do usuário e o carrinho).
- Ambiente de homologação e massa de testes: Realize testes completos com cenários extremos de regras tributárias, cancelamento de pedidos e divergência de saldo de estoque.
- Monitoramento e alertas de divergência: Configure painéis de observabilidade para identificar filas paradas ou payloads rejeitados antes que impactem a entrega ao cliente.
Faça o diagnóstico gratuito e planeje a arquitetura de integração entre seu ERP e canais de vendas.
Perguntas frequentes sobre integração de ERP ao e-commerce B2B
O que acontece com as vendas no e-commerce B2B se o ERP ficar fora do ar temporariamente?
Com uma arquitetura assíncrona baseada em filas de mensageria, o e-commerce continua recebendo pedidos normalmente. O cliente finaliza a compra com base nos dados cacheados mais recentes, e o pedido é armazenado com segurança na fila. Assim que o ERP restabelecer a conexão, a fila descarrega e processa os pedidos pendentes automaticamente, sem perda de vendas.
É possível integrar ERPs legados que não possuem documentação de API moderna?
Sim. É comum encontrar ERPs corporativos sem APIs REST abertas. Nesses cenários, construímos um conector intermediário (middleware) que se conecta com segurança ao banco de dados relacional (SQL Server, Oracle, PostgreSQL), processa arquivos estruturados (XML/JSON) ou utiliza microsserviços dedicados para expor os dados ao e-commerce de forma padronizada.
Como funciona a validação de crédito para compras faturadas a prazo?
No momento do checkout, uma chamada rápida à API do ERP ou à base financeira sincronizada verifica três pontos: se o cliente tem limite de crédito aprovado superior ao valor total do pedido, se possui títulos pendentes há mais de X dias e se o CNPJ está ativo. Caso seja reprovado, o sistema orienta o comprador a regularizar pendências ou alterar a forma de pagamento.
Quanto tempo demora para desenvolver uma integração robusta entre ERP e e-commerce B2B?
Uma integração completa e testada — cobrindo catálogo, estoques multi-filial, tabelas de preço customizadas por CNPJ e injeção de pedidos com retorno fiscal — leva tipicamente entre 4 e 10 semanas de desenvolvimento e homologação, dependendo do grau de personalização das regras do ERP da empresa.