Comece definindo o evento de negócio que a integração precisa tratar. Identifique o que o sistema receptor deve fazer e qual fonte prevalece quando os registros divergem.
Escreva o contrato da interface a partir do evento
| Elemento do contrato | Pergunta a responder |
|---|---|
| Gatilho | O que aconteceu e qual sistema confirmou? |
| Identidade | Quais identificadores de conta e evento permanecem estáveis entre sistemas? |
| Dados da mensagem | Quais campos são obrigatórios, opcionais ou sensíveis? |
| Confirmação | Qual resposta comprova o recebimento ou a conclusão? |
| Falha | Quais ações repetem a tentativa, aguardam, param ou exigem análise? |
| Correção | Como uma mudança posterior faz referência ao evento original? |
Por exemplo, uma decisão de verificação precisa de mais do que um rótulo copiado para outro banco de dados. Defina o momento em que entra em vigor, a versão e a ação permitida por esse estado. Limite o acesso aos dados ao que o fluxo receptor exige.
Atribua a responsabilidade por um estado incerto de transação
Quando o tempo de resposta de uma solicitação se esgota, identifique quem determina se a ação ocorreu. Uma nova tentativa não deve criar uma duplicata indevida, e a ausência de confirmação não deve ser tratada como prova de falha sem verificar o contrato.
Especifique o monitoramento de eventos atrasados ou recusados e a equipe responsável por resolvê-los. O operador precisa de uma forma de distinguir uma fila acumulada na integração de uma decisão ainda aguardando análise humana.
Teste mudanças, além da conexão inicial
Use um evento válido, um campo obrigatório ausente, uma solicitação duplicada, uma correção fora de ordem e uma indisponibilidade temporária da fonte. Compare os registros resultantes nos dois sistemas. Mantenha identificadores e informações de estado suficientes para investigar cada resultado.
Depois, teste uma mudança de versão ou a inclusão de um campo opcional com as regras de compatibilidade acordadas. Defina o responsável pela publicação, os critérios de reversão de versão e o processo de notificação de mudanças dos fornecedores. Uma primeira conexão bem-sucedida é apenas uma parte do ciclo de vida de uma integração.
Prepare um briefing de integração útil
Forneça os sistemas, a documentação disponível, exemplos de eventos e o fluxo de trabalho que deve melhorar. Inclua o estado de falha que sua equipe não consegue explicar atualmente. Para a substituição do sistema central de contas, avalie também o escopo do PAM e o trabalho de migração.
Solicite uma análise da interface com essas informações. A proposta deve identificar entregas, dependências e evidências de aceite.