Defina a fonte oficial de cada informação
Comece por uma tabela simples: quais dados nascem no Salesforce, quais nascem no ERP e quais podem ser alterados nos dois lados. Cliente, produto, preço, pedido, pagamento e contrato frequentemente têm donos diferentes. Sem essa definição, a integração pode sobrescrever uma correção válida ou apresentar duas versões da mesma informação.
Também é preciso decidir como identificar registros equivalentes. Nome e e-mail podem mudar ou se repetir; uma chave estável e regras de deduplicação reduzem reconciliações manuais. Documente o que acontece quando a correspondência é incerta, em vez de aceitar uma associação automática sem revisão.
Escolha quando os dados precisam circular
Nem todo dado precisa chegar em tempo real. Uma mudança de disponibilidade que afeta uma proposta pode exigir atualização imediata; um indicador consolidado para análise pode aceitar processamento em lotes. Estabeleça a frequência a partir da decisão de negócio que depende do dado.
Descreva os eventos que iniciam cada fluxo, os campos enviados e o resultado esperado. Para cada evento, preveja repetição sem duplicar registros, ordem de processamento e tratamento de mensagens atrasadas. Esses pontos costumam aparecer apenas depois do primeiro incidente se não forem desenhados antes.
- Qual processo fica bloqueado se a integração atrasar?
- Quem recebe o alerta e pode corrigir uma falha?
- Como a equipe confirma que os dados voltaram a ficar consistentes?
Planeje a falha como parte da operação
Uma integração precisa tornar erros visíveis. Registre identificadores, horário, etapa, motivo da falha e possibilidade de reprocessamento sem expor dados pessoais desnecessários. Diferencie indisponibilidade temporária de erro de cadastro ou regra de negócio: cada caso pede uma resposta diferente.
Além do monitoramento técnico, defina uma rotina de conciliação. Ela compara o que foi enviado com o que realmente ficou registrado no sistema de destino. Assim a equipe encontra divergências silenciosas, que não aparecem como erro de API.
Faça uma entrega pequena que prove o desenho
Selecione um fluxo com valor claro, volume representativo e regras conhecidas. Valide dados reais anonimizados, duplicidades, correções, indisponibilidade e reprocessamento. Só então amplie para outros objetos e sistemas.
O resultado esperado não é apenas uma integração funcionando no dia da demonstração. É uma operação que sabe de onde veio cada dado, quando ele mudou e o que fazer quando os sistemas discordam.