A integração Protheus e e-commerce se faz conectando o ERP TOTVS à plataforma de vendas por uma camada de mensageria assíncrona com idempotência, retry com backoff e Dead Letter Queue (DLQ), em vez de chamadas diretas e síncronas. É essa camada que impede os dois problemas clássicos: a fila de pedidos que trava quando o Protheus fica lento ou indisponível, e o estoque que "fura" quando as baixas chegam fora de ordem ou em duplicidade. Abaixo explicamos por que esses erros acontecem e como estruturar a integração para que não voltem.
Por que a fila trava e o estoque fura
A causa raiz quase sempre é a mesma: alguém integrou o e-commerce direto no ERP por chamadas síncronas. Quando o Protheus está sob carga (fechamento fiscal, rotina de faturamento, backup), a resposta demora, o timeout estoura e a plataforma acumula pedidos numa fila que não escoa. O cliente compra e não recebe confirmação; o time comercial descobre pelo SAC.
O estoque furado nasce de outro pecado: tratar cada evento como se fosse único e ordenado. Na prática, mensagens chegam duplicadas (o gateway reenviou), fora de ordem (a baixa chegou antes da reserva) ou parcialmente processadas (caiu no meio). Sem controle de idempotência e sem uma fonte única de verdade para o saldo, o número no site diverge do número no Protheus e você vende o que não tem.
A arquitetura que resolve: assíncrona, idempotente e reconciliada
A integração confiável entre ERP e loja não é um "conector" — é um contrato de dados desacoplado por eventos. Os pilares de engenharia que a CCX aplica em qualquer integração TOTVS Protheus REST/WS são:
- Mensageria assíncrona (Kafka ou RabbitMQ): a loja publica o pedido num tópico/fila e responde ao cliente na hora; o Protheus consome no seu ritmo. Se o ERP cai, as mensagens esperam — nada se perde, nada trava a vitrine.
- Idempotência: cada evento carrega uma chave única (idPedido, idMovimento). Reprocessar a mesma mensagem duas vezes produz o mesmo resultado — nunca uma segunda baixa de estoque.
- Retry com backoff + DLQ: falhas transitórias são reprocessadas com espera crescente; o que falha em definitivo vai para a Dead Letter Queue para inspeção, sem contaminar a fila principal.
- Outbox pattern: o evento é gravado na mesma transação do dado de negócio, garantindo que "pedido criado" e "mensagem publicada" nunca fiquem inconsistentes.
- Reconciliação: um processo periódico compara saldos e status entre Protheus e e-commerce, detecta divergências e as corrige antes que virem venda indevida.
Para quem quer se aprofundar no motor de mensageria por trás disso, vale ler Arquitetura event-driven com Kafka e RabbitMQ para varejo: quando usar, que detalha o critério de escolha entre as duas tecnologias.
Passo a passo para integrar Protheus e e-commerce
Um projeto de integração maduro segue etapas claras, com validação a cada fase em vez de um "big bang" no go-live:
- Mapeamento de domínio: definir os objetos que trafegam (produto, preço, estoque, pedido, status, nota) e o dono de cada dado — quem é a fonte de verdade do saldo, do preço, do cadastro.
- Contrato de API e eventos: modelar os endpoints TOTVS Protheus REST/WS a consumir e o schema dos eventos, com versionamento para não quebrar quando o payload evoluir.
- Camada de mensageria: subir os tópicos/filas em Kafka ou RabbitMQ, com idempotência, retry/backoff, DLQ e Outbox já embutidos — não como "melhoria futura".
- Sincronização de estoque e preço: implementar o fluxo de saldo com reserva e baixa idempotentes, para que a vitrine reflita o disponível real sem oversell.
- Fluxo de pedido de ponta a ponta: pedido do e-commerce vira pedido/nota no Protheus e devolve status (faturado, expedido) de volta à loja.
- Reconciliação e observabilidade: rotina de conferência de saldos e status, com métricas, alertas e dashboards para enxergar a DLQ e a latência antes que virem incidente.
- Go-live faseado e sustentação: subir por ondas (catálogo, depois estoque, depois pedido), monitorar e manter — a integração é um organismo vivo, não um entregável fechado.
Como a CCX conduz a integração
A CCX Company é consultoria enterprise multi-stack (VTEX Premium Partner, SAP Build Partner, Salesforce Commerce Partner) com mais de 200 projetos e integrações enterprise entregues no Brasil e na LATAM. Tratamos a conexão Protheus↔e-commerce como parte da nossa disciplina de integração de sistemas da CCX: nada de gambiarra síncrona, e sim mensageria com idempotência, retry com backoff, DLQ, Outbox e reconciliação — o mesmo padrão que aplicamos em Kafka, RabbitMQ, SAP CPI/BTP e MuleSoft Anypoint.
Na prática, começamos por um diagnóstico gratuito de 60 minutos em que mapeamos seu cenário e entregamos, em até 7 dias, um TCO e um cronograma por fase. Você sai da conversa sabendo o custo e o caminho, com honestidade sobre o que depende de escopo — o preço de uma integração varia conforme volume de pedidos, complexidade do catálogo e regras fiscais do seu Protheus.
Quanto custa e o que depende de escopo
Não existe número único: o investimento depende do escopo — quantidade de fluxos, volume transacional, quão customizado está o seu Protheus e o nível de SLA exigido. Como referência de ordem de grandeza, squads dedicados de integração partem de R$ 35 mil/mês, e projetos de commerce enterprise (como Salesforce Commerce) partem de R$ 250 mil, com licenças de plataforma cobradas à parte pelo fabricante.
O que reduz o custo total no médio prazo é justamente a engenharia correta: uma integração idempotente e reconciliada gera poucos incidentes, exige menos plantão e não te faz reprocessar estoque manualmente toda semana. Barato mesmo é não ter oversell nem SAC lotado de pedido sem confirmação.
Perguntas frequentes
Dá para integrar o Protheus sem parar a operação atual?
Sim. O go-live faseado sobe a integração por ondas — primeiro catálogo, depois estoque e por fim o fluxo de pedido — mantendo o processo antigo em paralelo até cada onda estar estável. Assim você valida em produção sem um "big bang" arriscado e sem interromper as vendas.
O que impede o estoque de furar durante a integração?
Três mecanismos combinados: idempotência (a mesma baixa nunca é aplicada duas vezes), processamento assíncrono ordenado com retry e DLQ (mensagens fora de ordem ou com falha não corrompem o saldo) e reconciliação periódica, que compara Protheus e e-commerce e corrige divergências antes que virem venda indevida.
Quanto tempo leva um projeto de integração Protheus e e-commerce?
Depende do escopo — número de fluxos, volume e customizações do ERP. No diagnóstico gratuito de 60 minutos montamos um cronograma por fase realista em até 7 dias, junto com o TCO. Fale com a CCX pelo WhatsApp +55 11 96140-1372 ou em /br/contato.