Uma migração pode terminar com a quantidade esperada de contatos e ainda deixar a operação incompleta. Negócios podem apontar para empresas erradas, anexos podem perder a associação e responsáveis podem desaparecer. Para evitar esse tipo de surpresa, o inventário deve representar entidades e relações, além dos campos. O trabalho começa antes da exportação e termina com uma conferência que explica o destino de cada categoria de informação.
Liste o que existe e como se conecta
Reúna representantes das áreas que usam o CRM e percorra situações concretas: abrir um contato, localizar sua empresa, consultar um negócio e encontrar um arquivo. Anote quais objetos participam da jornada. Depois, confronte a lista com os recursos de exportação e integração disponíveis. Uma informação visível na tela pode não estar incluída no arquivo que a equipe pretende usar.
| Entidade | Identificador de origem | Dependência | Evidência de migração |
|---|---|---|---|
| Empresa | empresa_id | Responsável e unidade | Nome, campos e chave correspondente |
| Contato | contato_id | Empresa quando aplicável | Dados e vínculo conferidos |
| Negócio | negocio_id | Empresa, contato e etapa | Histórico e relações preservados |
| Anexo | arquivo_id | Objeto ao qual pertence | Arquivo legível e associação válida |
A tabela é um ponto de partida, não um modelo universal de CRM. A operação pode usar atividades, produtos, múltiplos contatos por negócio ou entidades personalizadas. Registre também os itens que serão arquivados fora do destino e aqueles que não podem ser transferidos. A omissão precisa ser uma decisão conhecida, com alternativa de consulta quando necessária.
Construa a correspondência de identificadores
Suponha que a empresa fictícia emp_origem_42 receba o identificador emp_destino_901. Os contatos associados devem usar essa correspondência, e não buscar o vínculo pelo nome comercial. Nomes podem se repetir ou mudar. Mantenha uma tabela que associe entidade, chave de origem, chave de destino, lote e estado do processamento, com unicidade compatível com a regra da migração.
Em bancos relacionais, chaves primárias identificam registros e chaves estrangeiras expressam relações com registros de outra tabela. A documentação de restrições do PostgreSQL apresenta essas garantias e suas condições. Mesmo que o seu projeto não use esse banco, a distinção ajuda a formular uma pergunta de aceite: toda referência migrada aponta para um objeto válido no destino?
Ordene a carga pelas dependências
Desenhe as relações antes de escolher a sequência. Se um contato depende de uma empresa, essa referência deve existir ou ter tratamento planejado. Em relações circulares, pode ser necessário criar os objetos primeiro e vincular depois, caso as ferramentas permitam. Não remova validações indiscriminadamente para fazer o arquivo passar; explique a causa das rejeições e ajuste a estratégia de carga.
Separe transformação de conteúdo de transferência. Decisões sobre valores vazios, opções de listas, datas e responsáveis devem estar definidas no mapeamento de campos. Se a migração também corrigir cadastros, registre qual regra foi aplicada e permita comparar a origem com o resultado. Caso contrário, uma diferença legítima de normalização pode parecer perda de informação durante a conferência.
Prepare uma amostra que desafie o mapa
- Inclua empresas com nomes repetidos e identificadores distintos.
- Escolha contatos com e sem empresa, quando ambos forem válidos no processo.
- Inclua negócios com vários vínculos, histórico e arquivo anexado.
- Adicione um vínculo quebrado na origem para testar a fila de exceções.
- Repita o lote e confirme que a correspondência de IDs continua estável.
A conferência deve comparar quantidade, conteúdo e relações. Conte anexos e tente abri-los; examine registros com várias dependências; verifique se uma segunda carga atualiza ou duplica o objeto conforme a regra aprovada. Registre diferenças por identificador, classificando rejeição, transformação prevista e erro que exige correção. Um total agregado não substitui essas evidências.
Defina corte e retorno
Combine quando a origem poderá receber novas mudanças, como as alterações finais serão capturadas e em que condição a migração será suspensa. Preserve as exportações e o mapa de correspondência conforme o plano aprovado. Antes de ampliar a carga, revise o dicionário de dados, a deduplicação e o ensaio de restauração. A decisão de avançar deve se apoiar em resultados conferidos pela equipe que usará o destino.
Fontes e referências
Referências consultadas em 21/10/2026. Confira a documentação vigente do seu fornecedor antes de alterar uma integração.
