qLote na NF-e: quantidade por lote e unidade de conferência

qLote é a quantidade de produto na ocorrência de lote registrada em rastro. O caminho é /nfeProc/NFe/infNFe/det/prod/rastro/qLote. É obrigatória em cada ocorrência, junto a nLote, dFab e dVal. Não é o número de lotes nem uma repetição automática da quantidade comercial de todo o item.

O número precisa de contexto físico

O bloco rastro não possui uma tag própria para a unidade de qLote. Por isso, antes de comparar seu valor com qCom ou qTrib, confirme em que unidade a documentação e os controles do lote registram a quantidade. Dez caixas e dez unidades individuais não são a mesma quantidade, ainda que ambos apareçam como 10 no cadastro.

Use os lotes efetivamente associados à movimentação do item e a apresentação correspondente. A quantidade histórica total fabricada da partida não deve ser copiada automaticamente se o controle da movimentação registra apenas uma parcela. A relação entre documentação, quantidade e item precisa estar demonstrada; a tag por si só não define conversão ou método de estoque.

Dois lotes e conversão documentada

Num exercício em que duas caixas contêm doze unidades cada, o item representa vinte e quatro unidades individuais. Se a separação documentada é dez unidades do lote A e quatorze do lote B, qLote pode refletir essa divisão na unidade comum confirmada. A soma 10+14=24 relaciona-se a qTrib=24 nesse exercício, enquanto qCom=2 representa caixas. Igualar cada qLote a qCom=2 apagaria a divisão física.

Fragmento sintético e parcial. A unidade está explicada no exercício, não como nova tag de rastro. Os códigos e datas são fictícios; não é pronto para transmissão.

<prod xmlns="http://www.portalfiscal.inf.br/nfe">
  <!-- Campos comerciais e demais campos anteriores omitidos -->
  <rastro>
    <nLote>A-EXEMPLO</nLote><qLote>10.000</qLote>
    <dFab>2026-07-01</dFab><dVal>2027-07-31</dVal>
  </rastro>
  <rastro>
    <nLote>B-EXEMPLO</nLote><qLote>14.000</qLote>
    <dFab>2026-08-01</dFab><dVal>2027-08-31</dVal>
  </rastro>
</prod>

Esse exemplo não cria uma regra SEFAZ universal que some qLote e compare sempre com qTrib. As regras oficiais citadas para rastro tratam datas e presença nas condições próprias; o leitor precisa conferir a relação quantitativa de acordo com a unidade e os documentos reais.

Precisão, zero e forma lexical

O tipo TDec_0803v do pacote consultado admite até oito dígitos inteiros e até três casas decimais, com as formas lexicais específicas de seu padrão. Admite zero em 0 ou 0.000; uma fração abaixo de um deve usar três casas, por exemplo 0.125. Para inteiros positivos, as casas opcionais podem variar até três. Não aceita número negativo, vírgula decimal, separador de milhar ou notação científica. Schema consultado.

Aceitar zero estruturalmente não permite transformar quantidade desconhecida em zero. Do mesmo modo, reduzir quatro casas para três pode alterar uma quantidade física; confirme a unidade e a precisão documental antes de arredondar ou converter.

Como conferir divergência de quantidade

Reúna o XML e a separação dos lotes, identifique a apresentação e escreva a conversão com suas unidades. Compare todas as ocorrências: um bloco perdido, uma duplicação ou quantidade total repetida em cada lote pode multiplicar ou reduzir o registro.

Se o erro é apenas serialização, confira ponto decimal e limite do tipo. Se a divisão física não está documentada, obtenha essa informação antes de preencher. Corrija a origem demonstravelmente incorreta e confira o conjunto, sem inventar fator, lote ou quantidade e sem editar XML assinado.

Fontes oficiais

• MOC 7.0 — Anexo I — 7.00; p.21 I82; regras I83/I84.
• Schemas NF-e/NFC-e — PL_010c_NT2022_002v1.30; rastro/qLote TDec_0803v e padrão em tiposBasico.

Leitura relacionada

• qTrib: quantidade tributável
• nLote: identidade por ocorrência