Integrações na prática

Integração é o trabalho que parece simples de fora e consome mais tempo que qualquer outro por dentro. O pedido entra na loja e precisa aparecer no ERP: uma frase, e uma dúzia de decisões escondidas nela. Qual identificador manda, o que acontece quando o mesmo evento chega duas vezes, quem ganha quando os dois lados discordam do estoque.

Os textos desta categoria tratam do que a documentação da API não cobre. A documentação descreve o caminho feliz — o endpoint, o formato, o campo obrigatório. O que quebra em produção fica de fora dela: o webhook reenviado, o fornecedor fora do ar por vinte minutos, o limite de requisições que só aparece quando o volume dobra, o cadastro que vira dois clientes porque ninguém decidiu qual campo é a chave.

O critério de escrita aqui é ser específico o bastante para ser útil e genérico o bastante para valer além de um fornecedor. Cada texto termina com um teste concreto — uma coisa para fazer e observar —, porque desenho de integração que nunca foi exercitado não está pronto: está apenas ainda não tendo dado errado.