Unidades de Medida¶

Cadastros > Complementares > Unidades

O que é¶

Aqui você cadastra as siglas que representam como um produto é medido e vendido: UN (unidade), KG (quilo), PC (peça), L (litro), CX (caixa), MT (metro), e assim por diante.

Parece simples, mas é um dos cadastros mais críticos do sistema: a sigla cadastrada aqui vai direto para o XML da Nota Fiscal Eletrônica, e se estiver errada ou ausente, a nota é rejeitada pela SEFAZ. Além disso, nenhum produto pode ser salvo sem uma unidade válida cadastrada nesta tela.

Como acessar¶

No menu principal, clique em Cadastros → Complementares → Unidades.

Onde impacta o sistema¶

Este cadastro é usado em vários pontos do ERP — qualquer produto precisa de pelo menos uma unidade válida aqui:

Cadastro de Produtos — o campo "Unidade" do produto busca diretamente desta tabela. Se a sigla não estiver cadastrada, o sistema bloqueia o salvamento do produto com a mensagem "Unidade não Cadastrada".
Embalagem — o campo "Unidade de Embalagem" do produto (ex: produto vendido em UN mas embalado em caixa de 12 CX) também valida contra esta tabela.
Gôndola / PDV — produtos com unidade de gôndola definida (para supermercados e varejo) igualmente dependem deste cadastro.
Códigos de Barras — cada código de barras cadastrado no produto tem sua própria unidade, também validada aqui.
NF-e / NFC-e / SAT — a sigla aparece nas tags <uCom> (unidade comercial) e <uTrib> (unidade tributável) do XML. A SEFAZ valida o formato.
Alteração em Massa de Produtos — ao alterar unidades de embalagem em lote, o sistema valida cada sigla informada contra esta tabela.

Como cadastrar uma nova unidade¶

Clique em Novo (ou Alt+N).
No campo Unidade, digite a sigla — use apenas letras maiúsculas, sem acento, sem espaço (ex: KG, UN, CX). O sistema converte para maiúsculo automaticamente e remove caracteres especiais.
No campo Descrição, escreva o nome completo (ex: QUILOGRAMA, UNIDADE, CAIXA).
Clique em Gravar (ou Alt+G).

Atenção importante: depois de gravada, a sigla não pode ser alterada. O campo fica bloqueado. Se precisar corrigir, exclua e recadastre — mas antes verifique se algum produto já está usando essa sigla, pois precisará atualizar esses produtos também.

Campos desta tela¶

Campo	O que é	Observações
Unidade	A sigla — também é a chave do cadastro	Obrigatório. Só letras maiúsculas. Não pode ser alterado após gravar. Salvo em `UNIDADES.UN_UNIDADE`.
Descrição	Nome por extenso da unidade	Obrigatório. Não pode ser idêntico à sigla. Salvo em `UNIDADES.UN_DESCRICAO`.

Esta tela tem apenas esses dois campos — não há código numérico, não há campo "Inativo". A própria sigla identifica o registro.

Regras e comportamentos do sistema¶

Sigla e Descrição não podem ser iguais Se o usuário digitar o mesmo texto nos dois campos (ex: KG em ambos), o sistema bloqueia o salvamento e exibe: "Unidade e descrição não podem ser iguais. Verifique!". O objetivo é garantir que a sigla seja curta e a descrição seja o nome completo.

Sigla bloqueada após a primeira gravação O campo Unidade só pode ser preenchido na hora do cadastro. Depois de gravar, ele fica desabilitado — porque é a chave que conecta esta tabela a todos os produtos que a utilizam. Alterar a sigla quebraria essa ligação.

Limpeza automática de caracteres especiais Antes de salvar, o sistema remove automaticamente acentos, cedilhas e símbolos da sigla. Isso garante compatibilidade com o padrão da SEFAZ para documentos fiscais.

Produto não salva sem unidade válida No Cadastro de Produtos, ao tentar gravar sem uma unidade cadastrada aqui, o sistema exibe "Unidade não Cadastrada" e impede o salvamento. Isso vale para a unidade de venda, de embalagem e dos códigos de barras.

Dúvidas frequentes¶

Por que o campo Unidade está cinza e não deixa digitar? É o comportamento esperado do sistema. A sigla é a chave do cadastro e não pode ser alterada depois de gravada. Se a sigla estiver errada, a solução é excluir e criar novamente com a sigla correta — e então atualizar os produtos que usavam a sigla antiga.

Tentei gravar e apareceu "Unidade e descrição não podem ser iguais" Os dois campos estão com o mesmo conteúdo. Coloque só a sigla curta no campo Unidade (ex: KG) e o nome completo no campo Descrição (ex: QUILOGRAMA).

A unidade que cadastrei não aparece na lista do produto Verifique se a sigla foi gravada exatamente como esperado (sem espaços, sem caracteres estranhos). Use F3 no campo Unidade do produto para buscar e confirmar que está na lista.

Rejeição na SEFAZ relacionada à unidade de medida A sigla vai exatamente como está gravada para o XML da nota. Certifique-se de que está no formato aceito pela SEFAZ — siglas como UN, KG, PC, CX, L são as mais comuns e aceitas. Evite siglas com números, pontos ou caracteres especiais.

Preciso trocar a unidade de vários produtos de uma vez Use o módulo Utilitários > Alteração em Massa para trocar a unidade de embalagem em lote. Para a unidade principal de venda, a troca precisa ser feita produto a produto no Cadastro de Produtos.