cana na NF-e: fornecimentos, safra, quantidades e deduções

cana é o grupo da NF-e para informações do registro de aquisições de cana. Fica diretamente em infNFe, fora dos itens det. Ele reúne safra, referência mensal, fornecimentos diários, quantidades totais, deduções e valores dos fornecimentos. Não é uma tag genérica para qualquer produto derivado de cana nem substitui a descrição e os tributos dos itens.

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

Quando o grupo aparece e o que precisa conter

O grupo cana é opcional no XSD compartilhado, mas a regra ZC01-10 do MOC relaciona sua presença em NFC-e, modelo 65, à rejeição 763. O contexto deste conteúdo é a NF-e modelo 55 de registro de aquisição de cana. Passar no XSD não dispensa a regra por modelo. MOC 7.0, p. 64–65 e 128.

Quando presente, cana exige safra, ref, pelo menos um forDia, os três totais de quantidade e os três valores finais. deduc pode ser omitido quando não há deduções aplicáveis. A condição 0–1 do grupo não torna seus filhos obrigatórios opcionais: um grupo vazio não corresponde ao leiaute.

A origem dos dados é o demonstrativo da aquisição, com pesagens e liquidação identificadas para a mesma safra e referência. A obrigatoriedade material em uma operação particular depende de sua documentação e regras aplicáveis; não se deduz do simples fato de o produto ser cana.

Como ler os campos sem misturar unidades

safra identifica o ciclo; o MOC indica AAAA ou AAAA/AAAA. ref identifica mês e ano em MM/AAAA. forDia ocorre de 1 a 31 vezes, com atributo dia e filho qtde; essa quantidade é peso líquido em quilogramas.

qTotMes, qTotAnt e qTotGer são quantidades: total do mês, anterior e geral. Não são valores em reais. O MOC nomeia os três, mas não define nessa tabela uma fórmula de rejeição ou todos os critérios de corte do acumulado anterior; confira esses critérios no demonstrativo correspondente, sem misturar safras ou fornecedores.

Cada deduc, até 10 ocorrências, contém descrição xDed e valor vDed. vFor é o valor dos fornecimentos, vTotDed o total das deduções e vLiqFor o líquido. Esses valores são monetários, diferentes dos pesos.

Exemplo completo do grupo, parcial da nota

Os números abaixo são sintéticos: dois dias fornecem 1.250,5 kg e 749,5 kg; o mês soma 2.000 kg. O demonstrativo do exemplo traz 5.000 kg anteriores no mesmo recorte, totalizando 7.000 kg. Os fornecimentos valem R$ 500,00, com dedução documentada fictícia de R$ 25,00 e líquido R$ 475,00. A dedução não é uma sugestão de cobrança.

<cana xmlns="http://www.portalfiscal.inf.br/nfe">
  <safra>2026/2027</safra>
  <ref>10/2026</ref>
  <forDia dia="1"><qtde>1250.5</qtde></forDia>
  <forDia dia="2"><qtde>749.5</qtde></forDia>
  <qTotMes>2000</qTotMes>
  <qTotAnt>5000</qTotAnt>
  <qTotGer>7000</qTotGer>
  <deduc><xDed>Taxa contratual demonstrativa</xDed><vDed>25.00</vDed></deduc>
  <vFor>500.00</vFor>
  <vTotDed>25.00</vTotDed>
  <vLiqFor>475.00</vLiqFor>
</cana>

O grupo está completo em sua declaração, mas é apenas um fragmento da NF-e, sem documento completo, assinatura ou protocolo. A sequência é relevante: os fornecimentos diários vêm antes dos totais de quantidade; as deduções, antes dos valores finais. Não mova os campos para infCpl esperando a mesma função estrutural.

Conferência do demonstrativo antes da geração

Separe os lançamentos do mês pela safra e referência confirmadas. Compare o peso líquido de cada dia com as pesagens que o compõem, verificando unidade e duplicidades. Some os dias para reconciliar qTotMes; compare o anterior com o fechamento histórico do mesmo recorte e confira se o geral incorpora o mês exatamente uma vez.

Na parte financeira, relacione cada dedução ao seu documento, confira a soma com vTotDed e a diferença entre fornecimentos e deduções com o líquido. Essas são conferências aritméticas do demonstrativo, não regras de rejeição numérica atribuídas ao MOC. Se a conciliação falhar, identifique qual registro ou critério de corte divergiu antes de substituir um total.

Erros que exigem diagnósticos diferentes

Erro de schema pode vir de grupo incompleto, ordem, mais de 31 grupos diários, atributo dia ausente, mês fora do formato ou descrição além do limite. Rejeição 763 é outra situação: o grupo apareceu em modelo 65. Examine ide/mod e a espécie documental correta da operação antes de alterar qualquer conteúdo.

Se o XML passa no schema e diverge da pesagem, isso é um problema de dados ou mapeamento, não prova de rejeição da SEFAZ. Confira quilogramas versus toneladas, peso líquido versus bruto, períodos e possíveis registros duplicados. Corrija a causa documentada no sistema de origem antes da assinatura. Não remova informações verdadeiras de uma nota apenas para contornar uma mensagem.

Fontes oficiais

• Leiaute NF-e/NFC-e — PL_010f_v1.04: cana l6364–6476; tipos TDec_1110v/TDec_1302
• 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