qtde em forDia: peso líquido diário de cana em kg
<qtde>cana › forDia › qtdeRevisã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
- Leiaute NF-e/NFC-e — PL_010f_v1.04: cana/forDia/qtde l6397–6401; TDec_1110v l247–256
- Tipos básicos NF-e/NFC-e — PL_010f_v1.04: TDec_1110v l247–256; TDec_1302; TString
- MOC 7.0 — Anexo I — 7.00, novembro/2020: Grupo ZC, p. 64–65; regra ZC01-10 e rejeição 763, p. 128
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