Skip to content

Cadastro de unidades

A unidade é a medida em que o produto é vendido: UN, KG, CX, PC, LT… Todo produto precisa de uma unidade, e o código cadastrado aqui é exatamente o que sai na nota e na DANFE.

O sistema não vem com unidades prontas — antes de cadastrar o primeiro produto, crie ao menos uma.

Cadastrar uma unidade

Tela Unidades

  • Acesse Cadastros > Unidades.
  • Clique em Novo.
  • Preencha os dois campos e clique em Salvar.

São só dois campos, ambos obrigatórios:

  • Codigo da Unidade — a sigla, com até 6 caracteres. É o que vai para a nota e aparece na DANFE, então use as siglas usuais: UN, KG, CX, MT, LT, PC.
  • Descrição — o nome por extenso, até 20 caracteres (ex.: "Unidade", "Quilograma", "Caixa"). Serve para você achar a unidade na busca; não é enviada à SEFAZ.

O código não pode se repetir dentro da mesma empresa.

Onde a unidade é usada

Link Nova unidade no cadastro de produto

  • No cadastro do produto, no campo Unidade tributavel — digite parte do código ou da descrição para buscar. Se a unidade ainda não existir, clique em Nova unidade 1 e cadastre ali mesmo, sem sair do formulário do produto. Veja Cadastro de produtos.
  • Na emissão da nota: ao adicionar o produto, o item já vem com a unidade do cadastro. Se aquela venda for em outra medida, troque o campo Unidade na ficha do item — o cadastro do produto não é alterado.
  • Quando a unidade tributável for diferente da unidade de venda, marque Informar Unidade Tributável no item e preencha Unidade Tributável, Vlr Unit. Tributável e Qtd Tributável.

Alterar ou excluir

  • A busca no topo da lista procura por Código e Descrição.
  • Clique sobre a linha para abrir a ficha, ajuste e clique em Salvar.
  • Para apagar, clique no ícone de lixeira na linha e confirme em Excluir.

Uma unidade usada por algum produto ou por alguma nota não pode ser excluída — troque a unidade nesses produtos antes.

Alterar o código de uma unidade muda o que será enviado nas notas ainda não transmitidas que a utilizam. Notas já autorizadas não mudam: o XML delas já foi gerado e guardado.

🛠️ Resolução de problemas

  • "Registro duplicado. Esse registro já existe no sistema.": já existe outra unidade sua com esse mesmo código. Localize-a pela busca e use a que já está cadastrada.
  • "Campo obrigatório": Codigo da Unidade e Descrição precisam estar preenchidos — os dois são obrigatórios.
  • Erro ao excluir ("Internal Server Error"): a unidade está em uso por um produto ou por um item de nota, e o sistema não permite apagá-la. Edite os produtos que a utilizam, aponte-os para outra unidade e tente de novo.
  • "Nenhum registro encontrado.": nenhuma unidade corresponde ao que você digitou — a busca considera apenas Código e Descrição. Limpe o campo para ver a lista completa.
  • "Nenhuma unidade de medida cadastrada para associar aos itens da nota.": aparece ao duplicar uma nota sem ter nenhuma unidade cadastrada. Cadastre a unidade nesta tela e duplique de novo. Ao duplicar, o sistema procura a unidade pelo código que estava na nota original; se não encontrar, usa a primeira unidade cadastrada — confira o item antes de transmitir.
  • A unidade não aparece na busca do produto: ela ainda não foi cadastrada. Use o link Nova unidade no próprio formulário do produto ou cadastre em Cadastros > Unidades.
  • "Você tem alterações não salvas. Deseja sair sem salvar?": você fechou a ficha sem salvar. Clique em Continuar editando para voltar e salvar, ou em Descartar para perder o que foi digitado.

Atualizado em: