ref em cana: mês e ano de referência no formato MM/AAAA

ref, dentro de cana, identifica o mês e o ano de referência do registro de aquisição. Seu formato é MM/AAAA, com dois algarismos de mês, barra e quatro de ano. Não é uma data completa nem o identificador da safra.

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

Formato aceito e exemplos que não correspondem

O padrão do XSD admite mês de 01 a 12 e ano de 2000 a 2999. Portanto, 10/2026 corresponde ao formato; 2026-10, 1/2026, 13/2026, 10/26 e uma data completa não correspondem. O tipo usa espaço preservado, de modo que acrescentar espaços não é uma alternativa ao valor exato.

O campo é obrigatório uma vez em cana, depois de safra e antes dos fornecimentos diários. A aceitação de um ano pelo padrão é estrutural: não prova que exista uma aquisição naquele período ou que aquela referência seja correta. XSD PL 010f, ref e MOC, ZC03, p. 65.

Exemplo do campo e leitura dos dias

Assuma um demonstrativo sintético referente a outubro de 2026:

<ref xmlns="http://www.portalfiscal.inf.br/nfe">10/2026</ref>

É um fragmento parcial do campo, sem XML completo. Com essa referência, forDia dia="7" identifica o dia 7 de outubro de 2026; o atributo sozinho não informa mês ou ano. Conferir ref evita que o mesmo número de dia seja associado a outra referência.

Em fevereiro, o padrão numérico de dia continua aceitando 31, mas o calendário real não possui esse dia. A validação do período e das datas dos comprovantes deve ocorrer na conferência da origem, sem inventar uma rejeição específica de calendário para ref.

Referência, safra e data de emissão

safra pode identificar um ciclo como 2026/2027; ref escolhe um mês dentro do demonstrativo. A emissão da NF-e tem seu próprio campo de data. Não se deve substituir automaticamente a referência pela data em que o operador gera ou importa o documento.

Campos de período em outros grupos, como competências no formato AAAA-MM, pertencem a contextos diferentes. O formato de ref é específico do grupo cana. Um conversor que normaliza todos os campos de período para o mesmo padrão pode quebrar a estrutura ou mudar o recorte documental.

Como investigar um mês incorreto

Compare a referência do demonstrativo com as datas dos fornecimentos e o filtro usado para calcular qTotMes. Se o campo veio do mês da emissão enquanto as pesagens pertencem a outro mês, identifique a regra de mapeamento que fez a substituição. Se o erro é apenas de schema, examine a ordem dia/mês/ano, zero inicial, barra e espaços.

Confirme o período real com os documentos antes de alterar valores ou transportar pesagens. Na conferência da aquisição, preserve empresa, fornecedor, safra e referência. O grupo cana continua sujeito à restrição de modelo 65 pela regra ZC01-10/763; corrigir o formato de ref não resolve uma incompatibilidade de modelo.

Fontes oficiais

• Leiaute NF-e/NFC-e — PL_010f_v1.04: cana/ref l6380–6390; pattern mês01–12 e ano2xxx
• MOC 7.0 — Anexo I — 7.00, novembro/2020: Grupo ZC, p. 64–65; regra ZC01-10 e rejeição 763, p. 128