Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Informações complementares da operação

qtde em forDia: peso líquido diário de cana em kg

<qtde>cana › forDia › qtde

Revisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.

qtde, dentro de cana/forDia, informa a quantidade diária em quilogramas de peso líquido. A tag é uma medida física do fornecimento, não o valor da aquisição nem a quantidade total da safra. A origem deve ser a pesagem documentada que compõe o registro diário.

Caminho desta página: /nfeProc/NFe/infNFe/cana/forDia/qtde. O prefixo nfeProc identifica a nota processada; a informação estudada pertence ao conteúdo da NF-e, dentro de NFe/infNFe.

Unidade e precisão da quantidade

O MOC identifica a quantidade em kg; o XSD especifica peso líquido em quilogramas. Assim, um número recebido em toneladas ou um peso bruto de balança não pode ser copiado sem conferir sua natureza. A tara e a apuração do líquido devem estar documentadas na origem, não presumidas pelo XML.

O tipo TDec_1110v permite até 11 algarismos inteiros e até 10 decimais, com ponto decimal, sem separador de milhar, sinal negativo ou notação exponencial. Um inteiro sem casas também pode ser representado. Precisão aceita pelo XML não substitui a precisão documentada na pesagem.

O campo é obrigatório uma vez em cada forDia. Valores aceitos pelo tipo, inclusive zero, não tornam um fornecimento desconhecido conhecido: é necessário confirmar a quantidade real e se existe um lançamento a representar. MOC, ZC06, p. 65 e XSD.

Conversão explícita e fragmento sintético

Assuma uma pesagem já confirmada como 1,25 tonelada de peso líquido. Somente por essa hipótese de unidade, a conversão aritmética é 1,25 × 1.000 = 1.250 kg. O campo pode representar:

<qtde xmlns="http://www.portalfiscal.inf.br/nfe">1250</qtde>

Este é um fragmento parcial, não uma NF-e completa. Na árvore real, o ancestral forDia precisa conter o atributo dia. Copiar 1.25 de uma coluna em toneladas para a tag em kg reduziria a quantidade por fator 1.000.

Em outro cenário, se a pesagem traz bruto e tara, a quantidade líquida depende dos registros desses componentes. Não se utiliza uma tara média inventada para preencher o campo. O exemplo de conversão não determina a quantidade tributável de um imposto.

Diferença para qTotMes e quantidades do produto

qtde pertence a um registro diário; qTotMes resume o mês; qTotAnt e qTotGer têm recortes acumulados documentados no demonstrativo. Um total mensal copiado em cada dia multiplica a quantidade. Some somente os registros da referência correta para reconciliar o mês.

det/prod/qCom e qTrib têm seus próprios contextos de unidade comercial e tributável. A semelhança com a quantidade diária não autoriza copiá-las automaticamente: confirme a correspondência documental, unidade e recorte. O demonstrativo de aquisição e o item da nota precisam ser coerentes, mas não são o mesmo campo.

Como investigar diferença de peso

Para divergência por fator 1.000, confira unidade de origem e conversão. Para diferença igual à tara, confira se foi usado bruto. Para diferença igual a uma carga, examine consolidação diária e duplicidades. Essas são hipóteses a comprovar confrontando pesagens e XML do mesmo dia, mês e safra.

Erro de schema exige outra conferência: ponto decimal, quantidade de casas, ausência de separador de milhar ou sinal. A rejeição 763 se refere à presença de cana na NFC-e 65, não a uma fórmula de peso. Não crie uma margem de tolerância não publicada pelo MOC; corrija o dado ou mapeamento demonstradamente errado antes da assinatura.

Fontes oficiais

Referência técnica para integração

XPath completo
/nfeProc/NFe/infNFe/cana/forDia/qtde
Namespace
http://www.portalfiscal.inf.br/nfe
Leiaute
4.00 · PL_010e_v1.02
Ocorrências no XSD
1–1 no contexto do elemento pai
Tipo
TDec_1110v · 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|0\.[0-9]{1,10}|[1-9]{1}[0-9]{0,10}|[1-9]{1}[0-9]{0,10}(\.[0-9]{1,10})?
whiteSpace
preserve