Appearance
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

- 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

- 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.