elemento · NFE4-28DB1584740F

`<qCom>` Quantidade comercial (qCom)

Registra a quantidade do produto na unidade de comercialização uCom.

Obrigatório

TDec_1104v

Ocorrência 1–1

O que é

qCom é obrigatório no produto e usa TDec_1104v: aceita zero ou valor positivo com até 11 dígitos inteiros e até quatro casas decimais. Em NF-e normal, a regra facultativa I11-10 compara vProd com vUnCom multiplicado por qCom, observada a tolerância definida pelo MOC.

Quando usar

Informe a quantidade comercial real do item na unidade declarada em uCom.

Quando não usar

Não use quantidade tributável por conveniência e não ajuste qCom artificialmente para fechar vProd.

Contrato XML

XPath: /nfeProc/NFe/infNFe/det/prod/qCom
Namespace: http://www.portalfiscal.inf.br/nfe
Layout: 4.00
Versão: PL_010e_v1.02
Repetível: Sim
Condicional no XSD: Não
Tipo-base: string

pattern0|0\.[0-9]{1,4}|[1-9]{1}[0-9]{0,10}|[1-9]{1}[0-9]{0,10}(\.[0-9]{1,4})?
whiteSpacepreserve

O schema oficial contém uma anotação estrutural para esta variante.

Exemplo XML

projecao_contextual

<qCom xmlns="http://www.portalfiscal.inf.br/nfe">1.0000</qCom>

Trecho contextual de uma fixture sintética completa; não é um documento XML standalone.

Validado automaticamente com fontes oficiais. Lote bf050-30825852460-1 · validado em 03 de ago. de 2026 · publicado em 03 de ago. de 2026

Vigência editorialindeterminada

Última revisão02 de ago. de 2026

Responsável informadoredacao-assistida-fiscal-pro

Fontes e referências

Manual de Orientação do Contribuinte 7.0 — Anexo I — Leiaute e Regras de Validação da NF-e/NFC-ePortal Nacional da NF-e · Seção 2, Grupo I, campo I10 (qCom), p. 18; regra I11-10/629, p. 93.
Schemas XML NF-e 010e v1.02 — NT 2025.002 v1.40, NT 2026.002 v1.00 e NT 2026.003 v1.00Portal Nacional da NF-e · PL_010e_v1.02/NFe/leiauteNFe_v4.00.xsd, elemento prod/qCom obrigatório e tipo TDec_1104v, linhas 1048–1052.
Schemas XML NF-e 010d v1.03 — CNPJ Alfanumérico — NT 2026.004 v1.01Portal Nacional da NF-e · PL_010d_v1.03/NFe/leiauteNFe_v4.00.xsd, elemento prod/qCom obrigatório e tipo TDec_1104v, linhas 1019–1023.