A decisão
Uma integração conecta operações, não apenas endpoints. Defina registros, autoridade por campo, autenticação, prazos e responsável por interrupções. Uma requisição bem-sucedida verifica só uma parte.
Um exemplo concreto
Num envio fictício, acompanhe pedido, correção de endereço, despacho e cancelamento. Vincule identificadores interno e da transportadora. Preveja etiqueta criada com resposta perdida: repetir pode duplicar envio.
Alternativas a considerar
Chamada direta atende resposta imediata; fila persistente, trabalho posterior; conciliação agendada, registros ausentes. Podem coexistir com estados claros.
Onde o plano falha
Isole campos do fornecedor em um mapeamento e valide entradas. Separe falha temporária de endereço inválido; reenviar informação errada não corrige.
Escreva o contrato do registro em linguagem de negócio
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.
Documente campos ausentes, fusos, unidades e valores opcionais. Uma instrução vazia pode significar nenhuma instrução; sua omissão pode conservar a anterior. Teste o contrato real. Pergunte por rotação de credenciais, limites, versões e ambiente de testes. Respostas não verificadas permanecem dependências abertas, não datas certas.
Dê responsável à transferência interrompida
Se a etiqueta é criada mas a resposta se perde, idempotência suportada ou busca pela sua referência pode resolver. Sem esses recursos, retenha o caso para investigação, em vez de duplicar a remessa. Demonstre com serviço local fictício ou ambiente autorizado, não com pedidos reais.
Uma ferramenta privada deve mostrar referência, erro seguro e último estado confirmado. Reprocessamento preserva identidade lógica e validação inicial. Atribua credenciais, mudanças de mapeamento e exceções diárias. Exemplos versionados e testes de contrato detectam alterações do fornecedor, mas o significado operacional ainda exige decisão responsável.
Antes de contratar o projeto
Quem possui a conta? Há testes representativos? Operadores localizam e repetem um registro com segurança? Combine aceite de sucesso e falha com o parceiro de integração.