Resposta direta
Todo valor registrado precisa carregar quatro informações junto do número: moeda ou unidade, escala, origem e data de referência. Sem isso, o campo é apenas um número e qualquer soma entre sistemas fica sujeita a interpretação. A implementação começa no cadastro, não na integração. O atributo de unidade entra obrigatório na origem, com lista fechada de opções, e o registro guarda a unidade original mesmo quando há conversão para uma unidade padrão. Conversão sem rastro da unidade de origem é o que produz divergência difícil de auditar depois.
- Objetivo
- Orientar implementação
- Formato indicado
- Projeto de implementação
- Atualizado em
O que esta página acrescenta: Trata o valor como atributo composto e define o que fazer na origem, em vez de corrigir a unidade na leitura ou no relatório.
Onde a unidade se perde na operação
Valor sem unidade costuma nascer em três pontos: campo livre no cadastro, planilha intermediária e conversão feita na leitura do relatório. Em todos, o número é gravado e a unidade fica implícita, no contexto de quem digitou.
O efeito aparece quando o mesmo campo é somado com valores de outra origem. O total não é necessariamente errado; é indefinido. Ninguém consegue dizer o que aquele número representa sem voltar ao registro original.
O que muda no cadastro e na leitura
Na origem, o atributo de unidade entra obrigatório e com lista fechada de opções. Campo livre não serve, porque aceita variações de escrita para a mesma unidade.
Quando existe conversão para uma unidade padrão, o registro guarda as duas informações: valor e unidade originais, valor e unidade convertidos, mais a data e o critério da conversão. Isso permite reconstruir o cálculo sem depender de quem operou.
Na leitura, relatório e tela exibem a unidade junto do número. Sem isso, o dado volta a circular sem contexto.
O que a padronização não resolve
Padronizar unidade não corrige valor lançado errado, cadastro duplicado nem campo preenchido por estimativa. Resolve o significado do número, não a sua exatidão.
Também não se aplica quando a unidade é única por natureza e já está no nome do campo, como quantidade de itens de um mesmo produto. Nesses casos, o esforço de padronizar não se paga.
E não dispensa conferência periódica. Mudança de moeda contratual, nova versão de sistema ou alteração de regra de conversão reintroduzem o problema pela entrada, não pela integração.
Recurso prático
Sequência para fechar a unidade na origem do valor
- Listar todos os campos de valor da operação e anotar, em cada um, se hoje existe moeda, unidade e escala declaradas.
- Definir a lista fechada de unidades aceitas por campo e marcar o atributo como obrigatório no cadastro de origem.
- Gravar a unidade original ao lado do valor convertido, com a taxa, o critério e a data de referência da conversão.
- Conferir, em amostra de registros de cada sistema, se o valor lido chega com a mesma unidade declarada na origem.
- Definir quem responde pela unidade quando um novo campo de valor for criado na operação.
O erro mais comum é aceitar a unidade padrão do sistema como verdade e não guardar a unidade original. Quando a regra de conversão muda ou a leitura passa a ser feita em outro sistema, não há como reconstruir o que foi registrado.
Sobre o que está escrito aqui
Conceitos relacionados: moeda de registro · unidade de medida · escala do valor · campo obrigatório de origem · data de referência da conversão. 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
- Falhas silenciosas em integrações: como perce… — falhas silenciosas
- Cadastros duplicados: como descobrir e consol… — cadastros duplicados
Páginas relacionadas
O mesmo problema em outro objetivo
- Valor sem unidade: como descobrir o que o número representa — Diagnosticar
- Valor sem unidade: o que registrar antes de somar — Organizar um processo
- Número sem unidade: o que comparar antes de tratar — Comparar alternativas
- Valor sem unidade: como medir o que o campo registra — Explicar medição
- Valores sem unidade: o que o contrato precisa definir — Orientar avaliação e contratação
Outras leituras em Integrações, sistemas e qualidade de dados
- Campo preenchido de formas diferentes: o que padronizar — Separa variação legítima de erro no preenchimento e mostra onde fixar a regra de um campo compartilhado entre sistemas.
- Campo de observação como status: como separar as funções — A convivência entre observação livre e status no mesmo campo: separação dos dois registros, responsável pela atualização e tratamento dos antigos.
- Planilha de apoio sem versão controlada: o que exigir — O que definir sobre dono, histórico e versão vigente antes de contratar uma solução que substitua a planilha de apoio sem controle de versão.
- Cadastros sem chave em comum: onde a ligação se perde — Como identificar o campo que falta para cruzar cadastros, testar candidatos em uma amostra e separar problema de dado, de processo e de responsabilidade.
- Contratar arquitetura: o que fica definido e por quem — O que precisa estar definido em um contrato de arquitetura: decisão, entregável, responsável e critério de aceite, antes de comparar propostas.