Registro de cada troca
Toda mensagem que entra e sai fica gravada. Quando alguém pergunta "esse pedido chegou?", a resposta é um log, não um palpite.
Quando o dado precisa atravessar de um sistema para outro e hoje atravessa por alguém exportando, conferindo e redigitando. É trabalho invisível que custa hora, gera erro e some quando a pessoa tira férias.
Integração não é conectar dois logotipos. É acertar o que acontece quando o pedido chega fora de ordem, quando a outra ponta demora a responder e quando a mesma informação volta duas vezes — que é onde as integrações improvisadas quebram.
A diferença entre uma integração e um script agendado está aqui — e é aqui que aparece a conta, meses depois, quando ninguém olhava.
Toda mensagem que entra e sai fica gravada. Quando alguém pergunta "esse pedido chegou?", a resposta é um log, não um palpite.
API de terceiro cai — é fato da vida, não exceção. A integração espera e tenta de novo, em intervalos maiores, em vez de perder o dado no primeiro erro.
Falha isolada se resolve sozinha. Falha repetida vira aviso para gente de verdade, antes de o cliente ligar reclamando.
Reenviar o que falhou não pode gerar dois pedidos nem duas notas. Cada evento carrega identificação própria, e o que já entrou é reconhecido e ignorado.
Integração que ninguém monitora não está funcionando — está funcionando até segunda ordem, e você descobre qual das duas pelo telefone do cliente.
Quase sempre dá, por outro caminho: exportação agendada de arquivo, banco de dados acessível, importação por planilha ou robô que opera a interface quando não sobra alternativa. O levantamento diz qual caminho existe e o que cada um custa em confiabilidade — e essa parte vai escrita na proposta.
Se ele funciona e alguém entende como, não troque. O que costuma faltar é o entorno: log do que passou, retentativa quando a outra ponta cai, alerta quando falha e alguém que saiba mexer. Script sem isso funciona até o dia em que não funciona — e ninguém percebe até o cliente ligar.
Depende inteiramente da outra ponta: API documentada e estável é um cenário, sistema fechado sem documentação é outro. Por isso a primeira etapa é sempre um levantamento das duas pontas, e o prazo só vira compromisso depois dele.