NCM Buscador

qCom

Quantidade Comercial do produto, alterado para aceitar de 0 a 4 casas decimais e 11 inteiros.

✓ Conferido · 02 de outubro de 2026Esquema XML da NF-e (leiaute) — enums oficiais de campo — Pacote de Liberação PL_010f_v1.04, publicado em 31/08/2026 (NT 2025.002 v1.50 e NT 2026.007 v1.00) · Receita Federal / ENCAT

Onde fica no arquivo

No documento

  • NFe/infNFe/det/prod/qCom

    Obrigatório, uma vez

O caminho até aqui, nível a nível

  1. NFe — Nota Fiscal Eletrônica
  2. └ infNFe — Informações da Nota Fiscal eletrônica
  3. └ det — Dados dos detalhes da NF-e
  4. └ prod — Dados dos produtos e serviços da NF-e
  5. └ qCom — você está aqui

Dentro do grupo prod , dados dos produtos e serviços da NF-e

O que o arquivo aceita neste campo

Ocorrência
1-1
Tamanho
—
Tipo no esquema
TDec_1104v
Formato base
string

Formato exigido: 0|0\.[0-9]{1,4}|[1-9]{1}[0-9]{0,10}|[1-9]{1}[0-9]{0,10}(\.[0-9]{1,4})? Expressão do próprio esquema. Valor que não casar com ela é recusado na validação do arquivo, antes de qualquer regra de negócio. ⚠ A leitura acima sai da EXPRESSÃO, não do nome do tipo: nome de tipo se expande por palpite e palpite publica regra errada.

As regras que verificam este campo — 1

O manual cita a tag pelo caminho no XML. Cada regra devolve um código de rejeição, e a ficha do código traz a mensagem que o autorizador exibe.

346 qCom

Se informado o grupo de Exportação Indireta, o somatório das quantidades informada (tag:qExport) deve corresponder a quantidade comercial informada para o item (tag:qCom) Observação: Implementação opcional por UF (NT 2013/005 v1.10)

Mensagem: Somatório das quantidades informadas na Exportação Indireta não corresponde a quantidade total do item

O mesmo nome em outros documentos fiscais — 1

qCom aparece no leiaute de outros documentos, e isso não quer dizer que seja o mesmo campo: cada um tem manual, regra e às vezes tipo próprios. Aplicar a regra de um documento no outro é o erro que esta lista existe para evitar. Cada linha traz o caminho no arquivo daquele documento, que é onde a diferença aparece primeiro.

Documento O que o leiaute dele diz Caminho lá
DC-e Quantidade DCe/infDCe/det/prod/qCom

Os campos dos doze documentos fiscais, com filtro →

Campos do mesmo grupo — 41

São os campos que ficam ao lado deste no arquivo, dentro de NFe/infNFe/det/prod. Quem preenche um costuma precisar dos outros na mesma passada.

arma Armamentos cBarra Codigo de barras diferente do padrão GTIN cBarraTrib Código de barras da unidade tributável diferente do padrão GTIN
cBenef —
cEAN GTIN (Global Trade Item Number) do produto, antigo código EAN ou código de barras cEANTrib GTIN (Global Trade Item Number) da unidade tributável, antigo código EAN ou código de… CEST Codigo especificador da Substuicao Tributaria - CEST, que identifica a mercadoria sujeita… CFOP Cfop CNPJFab CNPJ do Fabricante da Mercadoria, obrigatório para produto em escala NÃO relevante. comb Informar apenas para operações com combustíveis líquidos cProd Código do produto ou serviço. Preencher com CFOP caso se trate de itens não relacionados… detExport Detalhe da exportação DI Declaração de Importação (NT 2011/004) EXTIPI Código EX TIPI (3 posições) gCred Grupo de informações sobre o CréditoPresumido indBemMovelUsado Indicador de fornecimento de bem móvel usado: 1-Bem Móvel Usado
indEscala —
indTot Este campo deverá ser preenchido com: 0 – o valor do item (vProd) não compõe o valor… infProdEmb Informações mais detalhadas do produto (usada na NFF) infProdNFF Informações mais detalhadas do produto (usada na NFF) med grupo do detalhamento de Medicamentos e de matérias-primas farmacêuticas NCM Código NCM (8 posições), será permitida a informação do gênero (posição do capítulo do… nFCI Número de controle da FCI - Ficha de Conteúdo de Importação. nItemPed Número do Item do Pedido de Compra - Identificação do número do item do pedido de Compra nRECOPI Número do RECOPI NVE Nomenclatura de Valor aduaneio e Estatístico qTrib Quantidade Tributável - alterado para aceitar de 0 a 4 casas decimais e 11 inteiros
rastro —
tpCredPresIBSZFM Classificação para subapuração do IBS na ZFM uCom Unidade comercial uTrib Unidade Tributável vDesc Valor do desconto da fatura veicProd Veículos novos vFrete Valor Total do Frete vOutro Outras despesas acessórias vProd Valor bruto do produto ou serviço. vSeg Valor Total do Seguro vUnCom Valor unitário de comercialização - alterado para aceitar 0 a 10 casas decimais e 11… vUnTrib Valor unitário de tributação - alterado para aceitar 0 a 10 casas decimais e 11 inteiros xPed Informação do pedido

Perguntas frequentes

O que é o campo qCom do NF-e?

Quantidade Comercial do produto, alterado para aceitar de 0 a 4 casas decimais e 11 inteiros. No XML ele fica em NFe/infNFe/det/prod/qCom. Obrigatório, uma vez.

Que rejeição qCom pode causar no NF-e?

1 regra do manual cita este campo, disparando o código 346. ⚠ O número da rejeição não é único entre documentos fiscais: o mesmo código costuma existir na NF-e querendo dizer outra coisa.

qCom no NF-e é o mesmo campo dos outros documentos fiscais?

O nome se repete no leiaute de 1 outro documento (DC-e), e isso não quer dizer que seja o mesmo campo: cada documento tem manual próprio, regra própria e às vezes tipo diferente. Aplicar a regra de um no outro é erro comum e caro.

De onde vem esta descrição do NF-e?

Do esquema XML oficial (PL_010f_v1.04). O Buscador NCM lê a árvore do próprio arquivo: tipo, tamanho, ocorrência e domínio saem sem interpretação. O manual manda na REGRA de validação; o esquema manda no CAMPO.

Voltar ao topo