O problema
Cada venda precisava existir no CRM para o time comercial trabalhar. Feito à mão, atrasava; feito por webhook direto, duplicava — dois webhooks chegando juntos criavam dois negócios para o mesmo pedido, e o time perdia confiança nos números.
O que foi construído
Um Worker isolado, no domínio do cliente, que recebe os webhooks, enfileira em vez de processar na hora, e um processo agendado consome a fila em série. Uma varredura periódica confere se algum pedido escapou ou duplicou. O refresh token do ERP — que rotaciona a cada uso — tem uma fonte única, porque é exatamente o tipo de detalhe que derruba integração no sábado à noite.
O que foi medido
- Validação ponta a ponta ao vivo no dia do deploy, com tag de rollback criada e conferida por diff antes.
- 77 testes cobrindo fila, varredura e as duas APIs.
- Uma revisão independente posterior encontrou um ponto real (cursor de importação que avançava mesmo com falha) — corrigido e documentado.
O que o cliente não precisou fazer
Mudar de ERP, de loja ou de CRM. A integração mora entre os três.