qUnid na NF-e: quantidade padrão no cálculo do IPI

qUnid informa a quantidade total na unidade padrão para tributação do IPI por quantidade. A conferência depende de saber qual é essa unidade e se ela corresponde à unidade do valor informado em vUnid. Copiar a quantidade comercial sem verificar essa relação pode mudar o imposto.

Quantidade para o IPI, diferente da quantidade comercial

O XPath é /nfeProc/NFe/infNFe/det/imposto/IPI/IPITrib/qUnid, no namespace http://www.portalfiscal.inf.br/nfe. O MOC identifica O11 como quantidade total na unidade padrão para tributação, somente para produtos tributados por unidade. MOC, p. 51

O campo pertence ao par qUnid+vUnid, dentro de IPITrib. Esse par é alternativa a vBC+pIPI; depois dele deve existir vIPI. A ocorrência obrigatória de qUnid vale quando a alternativa por quantidade é utilizada, sem exigir qUnid no cálculo percentual. XSD, TIpi

A tag contém um número, não a identificação textual da unidade. Portanto, o XML isolado de qUnid não informa se a quantidade está em unidades físicas, volume, massa ou outra unidade padrão. A definição deve ser rastreável à classificação, ao parâmetro fiscal aplicável e à documentação do produto.

A possível igualdade dos números não autoriza tratá-los como sinônimos em todas as operações. Confira unidades e eventual conversão antes de associá-los. O MOC descreve qCom e qTrib no grupo de produto; qUnid possui contexto próprio do IPI. MOC, I10/I14 e O11

qSelo, no pai IPI, também é outra quantidade: quantidade de selos de controle. Ela não substitui qUnid no cálculo.

Exemplo com caixas e unidades padrão

Suponha, apenas para ilustrar a conferência, que uma operação fictícia tenha sido definida para IPI por quantidade. A documentação do produto informa três caixas, com 12 unidades padrão do IPI em cada caixa. O parâmetro fictício de imposto é R$ 0,7500 por unidade padrão.

A conversão fornecida pelas premissas é:

3 caixas × 12 unidades padrão/caixa = 36 unidades padrão

A conta do imposto é:

36 unidades padrão × R$ 0.7500/unidade padrão = R$ 27.00

O fator 12 foi fornecido para esse produto fictício. Não é uma regra universal para caixas, nem uma indicação de unidade fiscal. A operação real precisa de seu fator e unidade definidos.

O fragmento abaixo assume CST 50 já definido, mostra apenas IPITrib e omite o pai IPI/cEnq. É parcial, sintético e não está pronto para transmissão.

<IPITrib xmlns="http://www.portalfiscal.inf.br/nfe">
  <CST>50</CST>
  <qUnid>36</qUnid>
  <vUnid>0.7500</vUnid>
  <vIPI>27.00</vIPI>
</IPITrib>

Usar qUnid=3 com o mesmo valor por unidade produziria 3 × 0.7500 = 2.25, pois calcularia sobre três unidades padrão, e não sobre 36. O formato de 3 continuaria válido, mas a quantidade não corresponderia às premissas.

Formato da quantidade e do valor por unidade

No XSD oficial arquivado PL 010d v1.03, qUnid usa TDec_1204v: até 12 dígitos inteiros e, se houver fração, de uma a quatro casas com ponto. Aceita 36, 36.0, 36.0000, 0 e 0.0000. Não aceita 36,0, 36.00000, valor negativo ou separador de milhar. Tipos básicos

A quantidade pode conter fração dentro da faceta; isso não decide se uma fração faz sentido na unidade fiscal da operação. A informação real e sua precisão precisam ser preservadas. Zero aceito no tipo não autoriza preencher uma quantidade desconhecida com zero.

Não aplique a mesma faceta a vUnid: no histórico, TDec_1104 exige quatro casas quando existe fração. 0.7500 atende ao tipo, enquanto 0.75 não atende. Já vIPI usa o formato monetário de duas casas quando há fração. Tipos básicos

A referência 010d é histórica, confrontada com NTs posteriores no corte de 27/09/2026, sem declarar vigência de pacote para transmissão.

Diagnóstico de unidade e modalidade

Quando o imposto divergir, identifique o item e confira a unidade padrão que foi definida, a quantidade de origem, o fator de conversão documentado e a unidade de vUnid. A correspondência dimensional deve ser explícita: quantidade na mesma unidade usada no imposto unitário.

Depois, confira se o gerador copiou qCom ou qTrib sem verificar essa correspondência, se aplicou a conversão duas vezes ou se usou um fator de outro produto. Recalcule apenas com os parâmetros efetivamente fornecidos, preservando precisão.

Se aparecerem vBC/pIPI junto de qUnid/vUnid, investigue mistura de modalidades. Se faltar vUnid, qUnid sozinho não completa o par. Se o valor unitário for preço de venda, a conta estará usando outro significado, mesmo que a multiplicação esteja aritmeticamente correta.

A página de vUnid desenvolve o parâmetro monetário e IPITrib mostra a sequência completa. A determinação da unidade, do fator real, da modalidade e do imposto por unidade cabe à definição fiscal da operação; este guia confere sua representação e coerência.