“Cliente ativo” parece um campo simples até duas equipes usarem definições diferentes. O comercial pode considerar ativo quem possui uma negociação aberta. O financeiro pode usar a mesma expressão para quem tem contrato vigente. O relatório junta as duas interpretações e produz uma discussão que nenhuma fórmula consegue resolver sozinha.
Um dicionário de dados registra o significado dos campos e as regras que permitem preenchê-los. Ele pode começar em uma tabela compartilhada. O valor está no acordo entre as pessoas que produzem e utilizam a informação, não no tamanho do documento ou na ferramenta usada para guardar as definições.
Escolha os campos que afetam decisões
Comece por identificadores, situação de cadastro, responsável, unidade, datas relevantes e campos presentes em relatórios recorrentes. Pergunte qual decisão depende de cada um. Um campo sem uso conhecido pode merecer revisão antes de se tornar obrigatório e consumir tempo de toda a equipe.
Em uma assistência técnica fictícia, “data de entrada” pode significar chegada do equipamento, criação do cadastro ou recebimento do primeiro contato. Esses são acontecimentos diferentes. Separar os nomes evita que um indicador de prazo compare eventos que não medem a mesma etapa da operação.
Use uma ficha que caiba em uma linha
| Item | Definição ilustrativa |
|---|---|
| Nome técnico | data_recebimento_equipamento |
| Rótulo visível | Recebido na unidade em |
| Significado | Instante em que a unidade confirma a posse do equipamento |
| Tipo e formato | Data e hora com fuso informado |
| Responsável | Coordenação da recepção |
| Ausência | Equipamento ainda não recebido |
| Correção | Permitida com motivo registrado |
Acrescente valores permitidos, origem, regra de atualização e sistemas consumidores. Evite definições circulares como “data de recebimento é a data em que foi recebido”. Indique o evento observável e quem o confirma. Dessa forma, pessoas novas conseguem preencher o cadastro sem depender de uma explicação informal.
A especificação Table Schema, do Frictionless Data, oferece uma referência para descrever campos, tipos, restrições, valores ausentes e chaves. É útil para organizar a estrutura. As definições de negócio e os responsáveis do exemplo são decisões operacionais que cada empresa precisa estabelecer.
Separe desconhecido, não aplicável e zero
Um valor de orçamento igual a zero pode indicar serviço sem cobrança. Um valor desconhecido pode indicar avaliação ainda pendente. “Não aplicável” pode existir em um atendimento que não gera orçamento. Misturar essas situações obriga relatórios e integrações a adivinhar o significado do dado.
Defina como cada ausência será representada no CRM e nos arquivos de troca. Não invente números especiais, como 999, para representar desconhecimento sem documentação. Eles podem entrar em somas ou ser confundidos com valores reais. Quando o sistema impuser limitações, registre a convenção e inclua sua tradução nas integrações.
Registre os valores de uma situação
Para um campo de situação, liste cada opção com uma frase de entrada e uma de saída. “Aguardando peça” começa quando a peça necessária foi identificada e solicitada. Termina quando a peça chega, o diagnóstico muda ou o atendimento é encerrado. A equipe precisa saber o que fazer em cada transição.
Também defina quem pode alterar o campo. Uma situação calculada a partir do ERP não deveria receber correções manuais sem regra de exceção. Se uma área precisa apresentar uma interpretação própria, considere um campo separado em vez de substituir o significado usado por todas as outras.
Revise o documento com registros de verdade
Selecione uma amostra autorizada ou utilize dados fictícios representativos. Peça a duas pessoas que interpretem os mesmos campos usando apenas o dicionário. Compare as respostas. Cada divergência mostra uma definição que precisa de exemplo, limite ou esclarecimento adicional.
Antes de mudar um nome ou significado, confira relatórios, filtros, importações e integrações que dependem dele. Marque a versão da definição e a data em que passa a valer. Se o histórico não puder ser comparado com a regra nova, registre essa quebra para evitar conclusões enganosas.
O dicionário deve acompanhar o cadastro ao longo do tempo. Use suas definições no contrato entre CRM e ERP e inclua a revisão dos campos no processo de mudança. A manutenção fica mais simples quando cada informação possui um significado claro e alguém responsável por defendê-lo.
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.
