Resposta direta
Não existe chave perfeita. A escolha depende de qual identificador é estável no tempo, verificável na origem e barato de manter. Documento fiscal liga bem pessoa jurídica, mas falha em filiais e em cadastros antigos. Código interno liga o que nasceu no mesmo sistema e não atravessa fornecedor ou canal. E-mail é útil em contato, não em titularidade. Combinação de campos reduz ambiguidade e aumenta manutenção. Identificador externo só vale quando o emissor controla a unicidade e mantém a regra. A decisão precisa indicar quem corrige a chave, com que frequência e o que acontece com o registro que fica sem ligação.
- Objetivo
- Comparar alternativas
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Compara cinco tipos de chave de ligação pelo que exigem em verificação, manutenção e responsabilidade, em vez de tratar integração como problema de ferramenta.
O que uma chave precisa sustentar
Toda chave de ligação responde a três perguntas: identifica uma entidade só, continua a mesma ao longo do tempo e pode ser conferida na origem sem depender de quem digitou. Documento fiscal, código interno e e-mail falham em pelo menos uma delas em algum momento.
A comparação começa pelo conjunto de registros, não pelo campo. Uma chave que cobre a maior parte de uma base pequena pode ser inútil quando o volume está nos registros sem ela. Medir cobertura por tipo de cadastro e por origem mostra onde a ligação realmente se sustenta.
O comportamento de cada alternativa na operação
Documento fiscal tem alta confiança quando existe e está validado, mas exige tratamento de filiais, formatação e cadastros antigos. Código interno é estável dentro de um sistema e frágil fora dele. E-mail muda com frequência e não representa titularidade.
Combinação de campos, como nome mais data e mais unidade, reduz ambiguidade e aumenta o custo de manutenção: qualquer alteração em um campo quebra a ligação. Identificador externo funciona quando o emissor controla a unicidade e mantém o valor; quando o emissor muda a regra, a ligação inteira precisa ser revista.
O que nenhuma chave resolve
Nenhuma chave corrige cadastro incompleto na origem. Se o campo não é preenchido ou não é validado, a ligação falha independentemente do tipo escolhido. Também não resolve conflito de definição: dois cadastros podem ter o mesmo documento e representar relações comerciais diferentes.
Sempre haverá registros sem ligação. A decisão madura define o que fazer com eles: fila de conferência, responsável nomeado e critério para encerrar o caso sem ligar. Ignorar essa fila costuma custar mais do que a escolha da chave.
Recurso prático
Comparação entre tipos de chave de ligação
| Chave | Onde costuma funcionar | O que exige para se manter | Ponto fraco |
|---|---|---|---|
| Documento fiscal | Pessoa jurídica com cadastro validado na origem | Validação de formato, tratamento de filiais e atualização quando o cadastro muda | Registros antigos e vínculos com sócios ou filiais |
| Código interno | Registros que nasceram no mesmo sistema ou passaram pelo mesmo processo | Sequência única e regra clara de quem gera o código | Não atravessa fornecedor, canal ou sistema adquirido |
| Contato e histórico de relacionamento | Verificação de domínio, tratamento de aliases e baixa quando o endereço muda | Muda com frequência e não representa titularidade | |
| Combinação de campos | Bases em que nenhum campo isolado é confiável | Padronização de nome, data e unidade, além de conferência a cada alteração | Qualquer mudança em um campo quebra a ligação |
| Identificador externo | Relações em que o emissor controla a unicidade | Acordo com o emissor sobre formato e permanência do valor | Depende de terceiro e pode ser descontinuado |
O ponto mais ignorado é a manutenção: a chave é escolhida na implantação e ninguém define quem a corrige quando o cadastro de origem muda.
Sobre o que está escrito aqui
Conceitos relacionados: chave de ligação · documento fiscal · código interno · identificador externo · cadastro mestre. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Projeto de implementação, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.
Para continuar
- Integrações, sistemas e qualidade de dados — Página central do tema
- APIs e integração: o que perguntar antes de c… — sistema sem integração
- Dados desatualizados: o que precisa estar em dia — dados desatualizados
Páginas relacionadas
O mesmo problema em outro objetivo
- Cadastros sem chave em comum: onde a ligação se perde — Diagnosticar
- Chave ausente: como ligar cadastros sem identificador comum — Organizar um processo
- Chave de ligação ausente: o que medir antes de corrigir — Explicar medição
- Chave de ligação ausente: como construir a ponte — Orientar implementação
- Chave de ligação ausente: o que exigir do fornecedor — Orientar avaliação e contratação
Outras leituras em Integrações, sistemas e qualidade de dados
- Cadastros duplicados: como medir o volume real — Critérios operacionais e métricas para dimensionar a taxa de duplicidade na base de dados antes de iniciar projetos de consolidação ou limpeza.
- Cliente duplicado entre áreas: quando vale contratar solução — O que avaliar antes de contratar solução para cliente duplicado entre áreas, o que é decisão de dado e o que é decisão de responsabilidade.
- Cliente duplicado entre áreas: como achar a origem — Mostra por que o mesmo cliente aparece registrado de formas diferentes em cada área e o que comparar para localizar a origem da duplicidade.
- Cadastro preso ao sistema antigo: como separar dado de regra — Processo para separar dado de regra no cadastro, com dono de campo, critério de registro válido e histórico definidos antes de trocar o sistema.
- Cliente duplicado entre áreas: como medir a sobreposição — Define o que conta como cliente duplicado, qual base serve de referência e como acompanhar a sobreposição entre áreas ao longo do tempo