qCom: quantidade comercial na NF-e e NFC-e

qCom registra a quantidade do item na unidade de comercialização indicada em uCom. Ele fica em NFe/infNFe/det/prod/qCom e é obrigatório em cada produto. Não representa automaticamente peças: 2 pode significar duas caixas ou dois quilogramas, dependendo da unidade. A definição está no MOC 7.0, Anexo I, I10, página 18.

Nesta página: formato e zero, bruto e preço, quantidade tributável, exportação indireta, diagnóstico.

Quantidade fracionada, formato e zero

O tipo TDec_1104v admite zero ou número positivo com até 11 dígitos inteiros e até quatro casas decimais. No XML, use ponto como separador decimal e não use separador de milhares, sinal positivo, sinal negativo ou notação científica. Exemplos lexicais válidos são 2, 2.0000, 0.7500 e 12.3456. 2,5, -2, 1.000,00, 02 e 1.23456 não respeitam esse padrão. As casas decimais não precisam ser sempre quatro; o máximo é quatro. Confira TDec_1104v no pacote oficial PL_010c.

O limite de 11 dígitos inteiros não significa que o maior valor seja somente 99999999999: o formato também admite parte fracionária, por exemplo 99999999999.9999. Esse é um limite de representação, não uma quantidade recomendada.

O schema aceitar 0 não prova que quantidade zero seja adequada à operação. Uma tag vazia também não é igual a zero. Se o documento representa mercadoria efetivamente faturada, confira a quantidade real na origem. Não preencha zero como substituto de um dado faltante nem use uma quantidade artificial para eliminar uma rejeição. Com qCom=0, a divisão vProd/qCom não está definida; a integração precisa tratar o cenário concreto antes de calcular um unitário.

Como qCom se relaciona com o valor do item

vUnCom é o preço por unidade comercial e vProd é o bruto do item. Para documentos normais (finNFe=1), a regra facultativa I11-10/629 compara vProd com qCom × vUnCom. A nota (*4) determina arredondar o resultado a duas casas e considerar tolerância de R$ 0,01 para mais ou para menos nessa validação. Não é uma autorização para alterar a quantidade, nem uma tolerância universal para todos os totais da nota. MOC, página 93 e nota (*4), página 140.

Exemplo sintético de produto vendido por peso: uCom=KG, qCom=0.7500, vUnCom=20.00. O bruto é 0,75 × R$ 20,00 = R$ 15,00. Se o XML informar vProd=20.00, investigue quantidade, preço e mapeamento do bruto; não troque qCom para 1 sem evidência de que um quilograma foi vendido.

O bruto do item não se confunde com o total da nota nem com o valor líquido após desconto. Desconto é uma informação própria: reduzir qCom para representar desconto muda a quantidade documentada. O total da nota reúne parcelas próprias e não substitui a conferência desse item.

Trecho parcial sintético, com os demais campos do produto omitidos:

<prod xmlns="http://www.portalfiscal.inf.br/nfe">
  <uCom>KG</uCom>
  <qCom>0.7500</qCom>
  <vUnCom>20.00</vUnCom>
  <vProd>15.00</vProd>
</prod>

qCom e qTrib não são sempre a mesma quantidade

qTrib mede o item na unidade tributável uTrib. Quando a unidade comercial é diferente da tributável, uma conversão pode produzir números distintos sem produzir uma diferença no bruto.

Assuma, apenas neste exemplo, uma venda de duas caixas com seis unidades em cada caixa e unidade tributável individual já definida: qCom=2, uCom=CX, vUnCom=60.00; qTrib=12, uTrib=UN, vUnTrib=10.00. As duas contas chegam a R$ 120,00. O fator seis precisa corresponder ao produto e à embalagem, não ao nome genérico “caixa”. Esse exemplo não define unidade tributável ou classificação para outras operações.

A regra I11-20/630 verifica a multiplicação tributável em documento normal; 629 verifica a comercial. Um erro de qTrib não se resolve automaticamente alterando qCom. Confira os dois trios e seu fator de conversão. MOC, campos I13/I14/I14a, página 19, e regras I11-10/I11-20, página 93.

A conferência específica da exportação indireta

Quando há grupo exportInd, qExport informa a quantidade vinculada àquela exportação indireta. O MOC define sua unidade como a unidade de comercialização do item. No caso documentado de operação com CFOP 3.503, I55 orienta informar em qExport a quantidade de mercadoria devolvida; o nome do campo não permite interpretar esse valor como uma nova exportação nesse cenário. Essa observação explica o conteúdo da tag quando a operação já está documentada com esse CFOP, sem recomendar sua escolha. A regra facultativa I55-10, código 346, compara o somatório de qExport com qCom e registra implementação opcional por UF. MOC, I55, página 20, e I55-10, página 96.

Suponha um item com qCom=10, com duas informações de exportação indireta de qExport=4 e qExport=6, todas na mesma unidade comercial. O somatório é 4 + 6 = 10. Se a segunda for 5, o total será 9 e faltará uma unidade para a igualdade dessa conferência. Compare os registros de exportação e o item de origem para identificar o dado incorreto; não inclua uma quantidade fictícia para completar dez. Não some qExport em quilogramas a qCom em caixas sem verificar a unidade documentada.

Essa comparação não decide se a operação deve usar exportação indireta ou qual CFOP aplicar. Tais parâmetros exigem a documentação da operação; o diagnóstico técnico parte do grupo e da regra efetivamente aplicáveis.

Como investigar uma quantidade divergente

Localize o det correto pelo atributo nItem, código e descrição. Compare a quantidade do pedido ou medição com uCom; procure transformações de caixa para unidade, importação de vírgula como texto e redução de precisão. Depois compare o preço na mesma unidade e recalcule o bruto usando valores decimais, sem arredondar prematuramente o preço.

Se o retorno for 629, examine a multiplicação comercial do item apontado e a finalidade do documento. Se for 630, examine a tributável. Se for 346, examine os registros exportInd e seu somatório. Erro de formato exige conferir o schema e a serialização; não prova erro fiscal de quantidade.

Corrija a causa comprovada no cadastro, pedido ou integração e confira o XML novamente antes da ação fiscal. Não edite um XML assinado para alterar a quantidade. Para aprofundar, consulte uCom e vUnCom.