Integração de APIs e sistemas

Para transporte, descreva espera, aceitação pela transportadora, despacho, cancelamento e necessidade de atenção. Defina identificador comum e transições. Uma resposta de rede pode confirmar apenas recebimento; a conclusão operacional pode vir depois. Não transforme todo HTTP bem-sucedido em envio concluído.

Preserve versão e origem quando portal e vendedor alteram e-mail e telefone. Mantenha ambas se a propriedade permitir. Se mudam o mesmo campo desde a mesma versão, guarde candidatos e aplique regra explícita. Horários sozinhos não expressam autoridade, especialmente quando os relógios diferem.

Pare o worker após receber, após aceitar de forma durável e durante a alteração de negócio. Confira caixa de entrada e registro depois do reinício. Um efeito externo pode ter sido aceito antes de salvar o resultado local. Use idempotência ou conciliação quando disponíveis; um estado local não garante entrega exatamente uma vez.

Comece com leituras comparadas a relatórios conhecidos. Investigue item ausente, variante desconhecida e unidade inesperada com operadores. Só depois adicione escritas suportadas com permissões, referência persistente e confirmação do sistema antigo. Upload bem-sucedido não é pedido concluído; indique o trabalho pendente.