qTemp na NF-e: quantidade de combustível à temperatura ambiente
<qTemp>det › prod › comb › qTempRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
qTemp informa a quantidade de combustível faturada à temperatura ambiente quando a quantidade comercial prod/qCom foi ajustada para uma temperatura diferente. O campo fica em /nfeProc/NFe/infNFe/det/prod/comb/qTemp.
Apesar do nome, não é uma temperatura em graus. É uma quantidade. A comparação central é entre a quantidade ambiente documentada e a quantidade comercial ajustada, sem presumir que sejam iguais.
Quando a informação se aplica
O MOC 7, p.24, LA05 vincula qTemp ao ajuste térmico de qCom. O XSD PL 010f v1.04 permite no máximo uma ocorrência, opcional na estrutura de comb.
Não há indicação nessa definição para preencher o campo em toda venda de combustível. Se não houve ajuste de qCom, a condição documentada não surge apenas porque o produto é combustível. Tampouco a ausência de informação sobre ajuste significa que o sistema possa assumir igualdade ou zero.
Confirme nos registros de medição e faturamento qual quantidade foi medida à condição ambiente, qual foi usada em qCom e qual referência térmica motivou o ajuste. O XML não fornece aqui um fator universal de conversão.
Quantidade, temperatura e base são dados diferentes
qCom representa a quantidade comercial do item. qTemp preserva a quantidade ambiente na condição descrita. A temperatura em si e o procedimento de conversão são evidências da medição; não devem ser gravados em qTemp como se o campo aceitasse graus Celsius.
Também não confunda qTemp com CIDE/qBCProd, com quantidade tributável qTrib ou com quantidades de tributação monofásica. Esses campos possuem finalidades próprias. Não substitua uma base fiscal por qTemp nem calcule imposto apenas pela diferença entre as quantidades.
O formato real do XSD
O tipo é TDec_1204temperatura. Seu padrão efetivo admite inteiros positivos com até 12 dígitos; se houver parte decimal, exige quatro casas. Também admite frações positivas menores que 1 com quatro casas. Zero, negativos e frações com apenas duas casas não atendem à expressão desse tipo.
| Representação | Resultado estrutural |
|---|---|
10100.2500 |
Quantidade positiva com quatro casas |
10100 |
Inteiro positivo |
0.2500 |
Fração positiva com quatro casas |
0 ou 0.0000 |
Não atende ao padrão |
10100.25 |
Não atende às quatro casas decimais |
Essa leitura vem da expressão do XSD, não do nome abreviado do tipo. A aceitação estrutural não confirma a medição ou a metodologia de conversão.
Exemplo de duas quantidades documentadas
Hipótese exclusivamente didática: o registro de medição informa 10100,2500 unidades à condição ambiente e o faturamento registra qCom=10000.0000 após um ajuste documentado. O campo ambiente seria:
<qTemp xmlns="http://www.portalfiscal.inf.br/nfe">10100.2500</qTemp>
O trecho é parcial e sintético; não é nota pronta para transmissão. A diferença aritmética é 100,2500 unidades. Isso mostra a distinção entre os dados, sem ensinar ou validar um fator de conversão. Não conclua que uma diferença positiva, negativa ou percentual semelhante seja esperada em outras operações.
Como investigar inconsistência
Confira a existência de ajuste no registro de faturamento, a origem da quantidade ambiente, a unidade usada e a associação ao mesmo item. Depois compare medição, cadastro e XML. Procure valor em graus no campo, repetição automática de qCom, vírgula decimal, quatro casas ausentes ou zero usado como ausência.
Corrija o mapeamento ou a representação comprovadamente incorretos. Se faltar a memória de medição/conversão, a pendência é obter esses dados com o responsável técnico. A escolha da quantidade fiscalmente aplicável e da base de tributação exige fundamento da operação; o artigo não determina esses parâmetros.
Referência técnica para integração
- XPath completo
/nfeProc/NFe/infNFe/det/prod/comb/qTemp- Namespace
http://www.portalfiscal.inf.br/nfe- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 0–1 no contexto do elemento pai
- Tipo
- TDec_1204temperatura · string
- Preenchimento no catálogo
- Condicional
A ocorrência vale dentro da estrutura XML: um campo obrigatório em um grupo opcional não torna esse grupo obrigatório. A aplicação fiscal depende da operação e da versão da regra.
- pattern
0\.[1-9]{1}[0-9]{3}|0\.[0-9]{3}[1-9]{1}|0\.[0-9]{2}[1-9]{1}[0-9]{1}|0\.[0-9]{1}[1-9]{1}[0-9]{2}|[1-9]{1}[0-9]{0,11}(\.[0-9]{4})?- whiteSpace
preserve