Um pedido foi enviado ao sistema de gestão, mas a resposta não chegou. A automação tenta novamente. Minutos depois, a equipe encontra dois registros para a mesma compra. O problema começou com uma dúvida: a primeira tentativa falhou ou apenas ficou sem confirmação?
Esse cenário ilustra por que uma integração precisa considerar o que acontece quando a comunicação sai do caminho esperado. Além de transportar dados, ela deve reconhecer operações já recebidas e permitir que alguém acompanhe os casos pendentes.
Uma resposta ausente não confirma uma falha
Quando uma chamada demora além do limite definido, quem enviou pode não saber se o destino concluiu a operação. Repetir o pedido sem esse contexto pode duplicar uma ação que já aconteceu. A AWS Builders’ Library descreve esse problema e o uso de identificadores de solicitação para tornar novas tentativas mais seguras.
No exemplo fictício deste artigo, uma loja envia o pedido PED-1042 ao seu sistema de gestão. O destino o registra, mas a conexão cai antes da confirmação. A integração precisa reenviar a mesma operação, com a mesma identidade, para que o destino possa reconhecer a repetição.
Dê uma identidade à operação de negócio
Idempotência é a propriedade que permite repetir uma operação sem produzir efeitos adicionais indevidos. Na prática, o contrato entre os sistemas precisa definir como uma solicitação será identificada e como uma repetição será tratada. Não basta acrescentar um código ao registro depois que o problema apareceu.
Mesmo pedido, mesma identidade
- 1 · ReceberPedido PED-1042 + identificação da operação
- 2 · VerificarConsultar e reservar a identidade de forma atômica
- 3 · DecidirNova operação: executar. Repetição concluída: recuperar resultado. Em andamento: consultar estado.
- 4 · ConfirmarResponder com o estado registrado, sem criar outro pedido
Sem confirmação? Consultar o estado ou tentar novamente com a mesma identidade. Dados divergentes e casos pendentes seguem para análise.
Duas chamadas simultâneas também precisam ser consideradas: uma consulta seguida de uma gravação separada pode permitir que ambas avancem. O projeto deve prever uma garantia de unicidade e uma transição de estado consistente. A identidade não deve ser reutilizada para uma compra diferente; se os dados mudarem, essa diferença precisa ser reconhecida.
Trate a exceção como parte do processo
Uma automação útil mostra o que está aguardando confirmação, o que foi recusado e o que exige revisão. Uma mensagem genérica de erro deixa a equipe sem orientação. Um registro com a identificação da operação, horário, etapa e motivo permite localizar o problema e decidir o próximo movimento.
Defina quais falhas admitem nova tentativa, quantas tentativas serão feitas e quando uma pessoa deve intervir. Evite repetir indefinidamente uma solicitação com dados inválidos. Também registre como o processo será retomado após uma indisponibilidade, para que a recuperação não dependa de recriar pedidos manualmente.
Ponto de atenção: cada sistema tem regras próprias para reconhecer repetições. Se o destino não oferece esse recurso, será necessário desenhar outra estratégia e explicitar suas limitações.
Teste os caminhos que costumam ficar de fora
Um primeiro teste pode ser pequeno e controlado. Use uma operação de teste e verifique o resultado em cada sistema. O objetivo é observar o comportamento completo, inclusive quando uma resposta demora ou quando dois eventos chegam juntos.
- Envie a mesma operação duas vezes e confira se há um único resultado de negócio.
- Simule a perda da resposta depois do processamento e observe a retomada.
- Envie duas tentativas simultâneas e verifique a proteção contra concorrência.
- Repita a identificação com dados diferentes e confira o tratamento do conflito.
- Confirme que um pedido realmente novo continua sendo aceito.
- Verifique se a equipe consegue localizar e resolver uma exceção pelos registros.
Comece por uma integração delimitada
Escolha um fluxo com início, resultado esperado e responsáveis claros. Documente o que significa “concluído” em cada sistema e quem acompanha uma pendência. Depois do piloto, o padrão de identificação, estados e acompanhamento pode orientar outras integrações, com as adaptações necessárias.
Na Yarih, este tema faz parte de integração e automação. Um diagnóstico pode delimitar o problema, as dependências e uma primeira entrega com escopo definido.
Continue a leitura: Indicadores confiáveis: por que dois relatórios discordam.
Referências e aprofundamento
- AWS Builders’ Library: Making retries safe with idempotent APIs — identidade da solicitação, repetição e efeitos de uma operação. Todas as situações apresentadas neste artigo são ilustrativas.
