Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Produtos e serviços

qTemp na NF-e: quantidade de combustível à temperatura ambiente

<qTemp>det › prod › comb › qTemp

Revisã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