Glossário

Quantidade tributável na NF-e

Atualizado em · 4 min de leitura

Definição

Quantidade tributável na NF-e é o campo que informa quanto de um produto foi vendido na unidade usada para calcular os tributos, que pode ser diferente da unidade comercial. Ela aparece no XML como qTrib, acompanhada da unidade tributável (uTrib) e do valor unitário tributável (vUnTrib), e precisa ser coerente com o valor do item.

Também conhecido como: qTrib, Quantidade tributável, Quantidade na unidade tributável

O que é a quantidade tributável na NF-e?

Cada item de uma NF-e é descrito de duas formas: pela ótica comercial, ou seja, como o produto foi negociado com o cliente, e pela ótica tributária, ou seja, na unidade que o Fisco usa como referência. A quantidade tributável é a parte numérica dessa segunda forma.

Na prática, ela responde à pergunta: quantas unidades tributáveis existem nesta venda? Se uma empresa vende 10 caixas com 12 latas cada, a quantidade comercial pode ser 10 caixas, enquanto a quantidade tributável pode ser 120 unidades.

Quais campos do XML formam o grupo tributável?

No leiaute da NF-e, o item traz um conjunto de campos tributáveis que andam juntos: uTrib (unidade tributável, como UN, KG ou L), qTrib (quantidade tributável), vUnTrib (valor unitário na unidade tributável) e o GTIN da unidade tributável (cEANTrib), quando o produto tiver código de barras.

Esses campos espelham os comerciais: uCom, qCom, vUnCom e cEAN. A regra de coerência é que a quantidade multiplicada pelo valor unitário, tanto no lado comercial quanto no tributável, resulte no mesmo valor total do produto no item.

Qual a diferença entre quantidade comercial e quantidade tributável?

A quantidade comercial reflete a negociação: é o que aparece no pedido, na etiqueta de preço e no que o cliente entende ter comprado. A quantidade tributável reflete a unidade de referência para tributos e estatísticas, geralmente ligada à classificação fiscal do produto.

Quando as duas unidades são iguais, os valores se repetem e não há conversão. Quando são diferentes, é preciso aplicar um fator de conversão, assunto tratado no verbete sobre o quociente entre unidades comercial e tributável.

Quando a quantidade tributável faz diferença no cálculo de impostos?

Ela é especialmente relevante quando um tributo é calculado por unidade de medida, e não apenas por percentual sobre o valor. Situações com valores de pauta, tributação por litro, quilo ou unidade, e alguns cenários de substituição tributária dependem de informar corretamente quantas unidades tributáveis foram movimentadas.

Em operações de exportação, a unidade tributável costuma precisar corresponder à unidade estatística associada ao NCM do produto. Informar uma unidade incompatível pode gerar rejeição ou inconsistências nas informações de comércio exterior.

Como tratar a quantidade tributável em uma integração por API?

Em um sistema que emite NF-e por API, o ideal é que o cadastro de produtos já guarde a unidade comercial, a unidade tributável e o fator de conversão entre elas. Assim, o payload de emissão é montado automaticamente, sem cálculos manuais na hora da venda.

Também vale validar antes do envio se qTrib multiplicado por vUnTrib bate com o valor do produto, considerando arredondamentos e o número de casas decimais aceitas pelo leiaute. Isso reduz erros de validação e rejeições na SEFAZ.

Exemplos de Quantidade tributável na NF-e

  • Uma distribuidora de bebidas vende 5 fardos de refrigerante com 6 garrafas cada: a quantidade comercial é 5 (unidade FD) e a quantidade tributável é 30 (unidade UN), com o valor unitário tributável sendo o preço do fardo dividido por 6.
  • Um ERP de material de construção vende cimento em sacos de 50 kg: no item, qCom é 20 com uCom SC, enquanto qTrib é 1000 com uTrib KG, porque a unidade estatística do produto é o quilo.
  • Um posto de combustível emite NF-e para uma transportadora informando litros tanto na unidade comercial quanto na tributável, de modo que qCom e qTrib têm o mesmo valor.
  • Uma indústria que exporta peças configura no cadastro a unidade tributável conforme o NCM, e o sistema converte automaticamente as caixas vendidas para a unidade exigida antes de enviar o payload à API fiscal.

Perguntas frequentes

A quantidade tributável pode ser igual à quantidade comercial?

Sim. Quando o produto é vendido na mesma unidade usada como referência tributária, os campos comerciais e tributáveis repetem unidade, quantidade e valor unitário. Isso é comum em muitas vendas simples.

O que acontece se a quantidade tributável estiver errada?

A nota pode ser rejeitada por inconsistência de valores ou unidade, ou ser autorizada com informação tributária incorreta, o que pode afetar cálculos de impostos, obrigações acessórias e dados de exportação.

Quem define a unidade tributável de um produto?

A empresa deve escolhê-la conforme as regras fiscais aplicáveis, geralmente ligadas ao NCM e à forma de tributação do produto. Em caso de dúvida, o ideal é confirmar com a contabilidade.

Qual tag do XML corresponde à quantidade tributável?

A tag qTrib, dentro do grupo de produto de cada item. Ela é acompanhada de uTrib, que indica a unidade, e de vUnTrib, que indica o valor unitário tributável.

Atualizado em · Como produzimos este glossário