Conversões de unidade
v2/estoque/conversoes
9 min de leitura
O fornecedor vende em caixa, o estoque conta em unidade. Aqui você diz quanto vale cada embalagem da nota na unidade de estoque do produto (1 CX = 12 UN, 1 PAL = 480 UN), e a Entrada de NF usa esse fator para gravar o saldo certo.
Transcrição do vídeo
Neste vídeo, você vai ver as conversões de unidade do estoque: como dizer ao sistema quanto vale a caixa da nota fiscal na unidade em que o estoque é contado.
O fornecedor fatura em caixa, mas o estoque conta em unidade. Cada linha diz, para um produto, a unidade que vem na nota, a unidade de estoque e o fator. Aqui, a caixa de álcool tem doze unidades, a de máscara, vinte, e o pacote de conector, cem.
Como funciona mostra um exemplo pronto: cinco caixas de álcool na nota, com fator doze, entram como sessenta no saldo do estoque.
Para cadastrar, clique em Nova conversão. Busque o produto, aqui o detergente, e escolha na lista. A unidade de estoque já vem a do cadastro do produto: é ela que a Entrada de NF usa.
Na unidade da nota, escolha caixa. No fator, quantas unidades cabem numa caixa: quatro galões. A conta logo abaixo confere o resultado. Permite fracionar libera quantidade quebrada na nota, como meia caixa. Salvar.
A conversão nova aparece no topo da lista. O lápis abre a mesma janela para mudar o fator. O fator novo vale dali em diante: as notas já confirmadas não mudam.
Para excluir, a lixeira. Na V2 a exclusão pede confirmação, mostrando o produto e o par de unidades. Depois de excluir, a Entrada de NF deixa de converter essa unidade.
Com as conversões cadastradas, a nota chega na unidade do fornecedor e o saldo entra certo. O guia completo está na documentação do SNDesk. Até o próximo vídeo!
Antes de começar
| O que | Depende de |
|---|---|
| Abrir a tela, criar, editar e excluir conversões | a permissão Gestao de Estoque, atualizar |
| Ver Conversões de unidade no menu | parâmetro acesso_estoque = S e Gestao de Estoque, atualizar |
| Ter as unidades para escolher | as unidades cadastradas em Unidades de medida |
A tela funciona igual em todos os perfis do estoque (estoque_perfil). O nome "Produto" vem de Nomenclaturas e pode aparecer com outro nome na sua empresa (na base de demonstração, Categorias).
Para que serve
Cada produto tem uma unidade de estoque: a unidade em que o saldo é contado (UN, PCT, M, KG). A nota fiscal nem sempre vem nela: o fornecedor fatura em caixa, fardo, pacote ou palete.
A conversão diz, para um produto, quanto uma unidade da nota vale na unidade de estoque:
| Produto | Unidade na NF | Unidade de estoque | Fator | Na nota | Entra no saldo |
|---|---|---|---|---|---|
| Álcool 70% 1 L | CX | UN | 12 | 5 CX | 60 UN |
| Máscara PFF2 | CX | UN | 20 | 3 CX | 60 UN |
| Conector RJ45 Cat6 | PCT | UN | 100 | 2 PCT | 200 UN |
A Entrada de NF usa a conversão em cada item: a coluna Conversão do item mostra o fator e a quantidade que vai entrar. Sem a conversão, a nota só é aceita na unidade de estoque do produto; em qualquer outra unidade, o item é recusado com conversão de CX para UN não está cadastrada.
A conversão é por produto: a caixa de máscara e a caixa de álcool têm fatores diferentes, e cada uma tem a sua linha.
O que mudou em relação à V1: o formulário abre numa janela, e excluir pede confirmação; na V1 a conversão era excluída no clique.
Onde fica
- Menu moderno: seção Operação, item Estoque. No painel Telas do estoque do Dashboard, bloco Cadastros, clique em Conversões de unidade.
- Menu clássico: grupo Estoque, item Conversões de unidade.
Endereço: v2/estoque/conversoes.

O que você vê, de cima para baixo
- Título Conversões de unidade e o botão Como funciona?, que abre um exemplo pronto (Álcool 70%: 5 caixas × 12 = 60 frascos).
- A busca Pesquisar por produto, SKU ou unidade…, o total de resultados e o botão Nova conversão.
- A tabela, da conversão mais nova para a mais antiga, 10 por página: Produto (nome e SKU), Unidade na NF, Unidade de estoque, Fator, Fracionado (Sim ou Não) e as ações Editar (lápis) e Excluir (lixeira).
Sem nenhuma conversão, a tela mostra Nenhuma conversão cadastrada e o botão Criar a primeira.
Criar uma conversão
- Clique em Nova conversão.
- Em Buscar produto, digite parte do nome ou do SKU. A lista Produto logo abaixo mostra até 30 produtos que batem com a busca.
- Escolha o Produto.
- A Unidade de estoque (base) já vem preenchida com a unidade do cadastro do produto. É a única que a Entrada de NF usa, e por isso é a única da lista.
- Em Unidade informada na NF, escolha a unidade em que o fornecedor fatura (ex.: CX). A lista traz todas as unidades, menos a de estoque do produto.
- Em Fator, informe quantas unidades de estoque cabem em uma unidade da nota (ex.: 4 galões numa caixa de detergente). Aceita casas decimais; o mínimo é 0,0001.
- Marque Permite fracionar se a nota pode trazer quantidade quebrada nessa unidade (ex.: 2,5 CX).
- Confira a conta que aparece embaixo: 5 na unidade da NF × fator 4 = 20 na unidade de estoque.
- Clique em Salvar.

Recusas do formulário
| Mensagem | O que quer dizer |
|---|---|
| A unidade de origem deve ser diferente da unidade de destino. | A unidade da NF e a unidade de estoque são a mesma (só acontece numa conversão antiga). |
| Conversão já cadastrada. | Esse produto já tem conversão desse par de unidades. Edite a que existe. |
| Já existe uma conversão ativa com esse produto e par de unidades. | Na edição, você mudou para um par que já existe em outra linha. |
Nas recusas a janela continua aberta, com o que foi preenchido.
Conversão excluída antes. Cadastrar de novo um par que foi excluído reativa a conversão antiga com o fator novo: Conversão reativada e atualizada com sucesso.
Editar uma conversão
- Clique no lápis da linha. Abre Editar conversão com os dados preenchidos.
- Mude o Fator, o Permite fracionar ou a unidade da NF.
- Clique em Salvar. Aparece Conversão atualizada com sucesso.
Toda criação, alteração e exclusão do fator fica registrada (quem, quando, o fator de antes e o de depois), para explicar diferenças de quantidade no futuro. Esse registro ainda não tem tela de consulta: peça ao suporte se precisar.
Excluir uma conversão
- Clique na lixeira da linha.
- A janela Excluir conversão mostra o produto e o par (ex.: Álcool 70% 1 L · CX → UN) e avisa: A Entrada de NF deixa de converter essa unidade.
- Clique em Excluir para confirmar, ou em Cancelar para desistir.
Aparece Conversão excluída com sucesso.

Exemplos práticos
Situação: a Clean Max passou a faturar o detergente neutro em caixa com 4 galões, e o estoque conta em unidade. O que fazer: Nova conversão, produto Detergente neutro 5 L (a unidade de estoque UN já vem preenchida), unidade da NF CX, fator 4, Salvar. Resultado: na próxima nota, 3 CX entram como 12 UN.
Situação: o fornecedor de álcool trocou a caixa de 12 por uma de 6 frascos. O que fazer: lápis na linha Álcool 70% 1 L · CX → UN, fator 6, Salvar. Resultado: as notas novas convertem 1 CX em 6 UN. As já confirmadas continuam como estavam.
Situação: a nota trouxe 1,5 CX de um produto e foi recusada na Entrada de NF. O que fazer: edite a conversão e marque Permite fracionar, se a fração é real; senão, corrija a quantidade na nota. Resultado: com a fração liberada, 1,5 CX × 12 entram como 18.
Perguntas frequentes
Preciso cadastrar a conversão de UN para UN? Não. Quando a nota vem na unidade de estoque do produto, o fator é 1 e não precisa de conversão.
A nota vem com "CX" e o meu cadastro tem "CAIXA". Funciona? No XML, o sistema procura a unidade pelo símbolo. Se o símbolo cadastrado em Unidades de medida for diferente do que vem na nota, a unidade fica em branco no item e você escolhe à mão. Para não ter que escolher sempre, cadastre a unidade com o mesmo símbolo da nota.
Uma conversão de CX para UN serve para todos os produtos? Não. Cada produto tem a sua.
Limites e comportamentos que não são defeito
- A conversão é sempre para a unidade do cadastro do produto. Se a unidade do produto mudar depois, as conversões antigas continuam na lista com a unidade de antes, mas a Entrada de NF não as usa: cadastre de novo para a unidade nova.
- Não há conversão em cadeia (PAL → CX → UN). Cadastre direto PAL → UN.
- Sem Permite fracionar, a nota com quantidade quebrada nessa unidade é recusada.
- Excluir não mexe em notas confirmadas. Um rascunho que usa a conversão excluída passa a ser recusado ao salvar o item.