O que é :

A <qCom> especifica a quantidade do produto ou serviço comercializado, de acordo com a unidade de medida indicada em <uCom>.

Função :

Informar a quantidade precisa do item na operação fiscal.
Garantir que o valor total do produto (<vProd>) seja consistente com a quantidade e o valor unitário (<vUnCom>).
Auxiliar no controle de estoque e na tributação correta.

Formato:

Tipo de dado: Numérico com até 15 inteiros e 4 decimais.
Exemplo: 10.0000, 1.2500, 0.5000.

Valores Permitidos:

Qualquer valor numérico maior que zero, com até 4 casas decimais.

Regras:

Deve corresponder à unidade de medida especificada em <uCom>.
Exemplo: Se <uCom> é "KG", <qCom> deve indicar o peso em quilogramas.
Deve ser maior que zero.
Deve ser consistente com o valor unitário (<vUnCom>) e o valor total (<vProd>), conforme a fórmula:
vProd = qCom * vUnCom.

Uso Comum:

Preenchido em todas as operações comerciais que envolvem a movimentação de produtos, como vendas, devoluções ou transferências.

Relação com outros campos:

Relaciona-se diretamente com:
- <uCom> (unidade de medida).
- <vUnCom> (valor unitário).
- <vProd> (valor total).

Exemplo Prático:

<det nItem="1">
    <prod>
        <cProd>ABC123</cProd>
        <xProd>Caneta Azul</xProd>
        <NCM>96081000</NCM>
        <uCom>UN</uCom>
        <qCom>10.0000</qCom>
        <vUnCom>1.50</vUnCom>
        <vProd>15.00</vProd>
    </prod>
    <!-- Informações tributárias -->
</det>

Neste exemplo, a quantidade comercializada é de 10 unidades de "Caneta Azul", representada em <qCom> como 10.0000. O valor total do produto (<vProd>) é calculado como 10 * 1.50 = 15.00.

Exemplo Prático:

<det nItem="2">
    <prod>
        <cProd>DEF456</cProd>
        <xProd>Arroz Branco</xProd>
        <NCM>10063021</NCM>
        <uCom>KG</uCom>
        <qCom>5.0000</qCom>
        <vUnCom>4.00</vUnCom>
        <vProd>20.00</vProd>
    </prod>
    <!-- Informações tributárias -->
</det>

Neste caso, a quantidade comercializada é de 5 quilogramas de "Arroz Branco". A tag <qCom> indica 5.0000, e o valor total (<vProd>) é calculado como 5 * 4.00 = 20.00.

Erros Relacionados:

Código do Erro: 816 - "Rejeição: Quantidade comercializada inválida."
Descrição: O valor informado é negativo, igual a zero ou contém um formato inválido.
Código do Erro: 817 - "Rejeição: Quantidade comercializada incompatível com a unidade comercial."
Descrição: A quantidade não é coerente com a unidade especificada em <uCom>.
Código do Erro: 818 - "Rejeição: Quantidade comercializada não corresponde ao valor total e unitário."
Descrição: O valor total (<vProd>) não é consistente com o cálculo baseado na quantidade (<qCom>) e no valor unitário (<vUnCom>).

Importância:

A tag <qCom> é fundamental para registrar a quantidade exata do item na operação, garantindo precisão na escrituração fiscal e no controle de estoque.

Boas Práticas:

Certifique-se de que a quantidade seja coerente com a unidade de medida indicada em <uCom>.
Valide os cálculos de valores no sistema emissor para garantir consistência entre <qCom>, <vUnCom> e <vProd>.
Utilize valores com até 4 casas decimais para produtos fracionados, como quilogramas ou litros.

Considerações FInais:

A tag <qCom> é indispensável para representar a quantidade dos produtos comercializados na NFe, sendo essencial para garantir conformidade fiscal, evitar rejeições e assegurar a precisão das operações comerciais.