Automação confiável: como evitar pedidos duplicados

Por Pietro Makhoul

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. 1 · ReceberPedido PED-1042 + identificação da operação
  2. 2 · VerificarConsultar e reservar a identidade de forma atômica
  3. 3 · DecidirNova operação: executar. Repetição concluída: recuperar resultado. Em andamento: consultar estado.
  4. 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.

Fluxo conceitual para um pedido fictício. O mecanismo de reserva, a concorrência e o prazo de retenção precisam ser definidos conforme a integração.

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