dia em forDia: atributo do fornecimento de cana
@diacana › forDia › @diaRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
dia é o atributo obrigatório de cana/forDia que informa o número do dia do fornecimento de cana. No XPath, o caractere @ identifica essa natureza: forDia/@dia. Criar um elemento filho chamado dia não produz a mesma estrutura.
Caminho desta página: /nfeProc/NFe/infNFe/cana/forDia/@dia. O prefixo nfeProc identifica a nota processada; a informação estudada pertence ao conteúdo da NF-e, dentro de NFe/infNFe.
Sintaxe e valores aceitos
O padrão do XSD admite os números de 1 a 31 como texto: 1 a 9, 10 a 29, 30 e 31. Zero, números negativos, 32 e representações com zero inicial como 01 não correspondem ao padrão. O atributo é obrigatório em cada forDia.
O número não é uma data completa e não identifica a carga. Para interpretá-lo, leia cana/ref, que fornece mês e ano. A safra pode ser diferente do ano isolado, portanto não use somente safra para reconstruir a data do fornecimento. XSD PL 010f, forDia/@dia.
Exemplo correto e diferença para elemento
Fragmento sintético, parcial em relação a cana e à NF-e:
<forDia xmlns="http://www.portalfiscal.inf.br/nfe" dia="7">
<qtde>500</qtde>
</forDia>
O dia é 7; a quantidade é 500 kg líquidos. Com ref=10/2026, o lançamento pertence ao dia 7 daquele mês de referência. A informação de data não está no texto de qtde e não deve ser colocada como filho dia. O fragmento não é um XML completo para transmissão.
Bibliotecas de serialização precisam diferenciar atributo e elemento explicitamente. Se um objeto de integração recebe {dia:7, qtde:500}, confirme qual opção do serializador escreve dia="7", em vez de presumir que todo membro do objeto vira tag filha.
O padrão não valida o calendário completo
O XSD admite 31 como número do atributo, mas isso não cria um dia 31 em fevereiro. Considere ref=02/2026: uma origem que associa um fornecimento ao dia 31 contém uma inconsistência de calendário, mesmo que o padrão isolado do atributo aceite 31. Confira o comprovante da pesagem e a referência correta.
Não converta automaticamente 31 para 28 nem mova a entrega para outro mês para satisfazer a geração. Primeiro identifique se o erro comprovado está no dia, no mês ou no agrupamento dos lançamentos. O número também não deve ser usado para enumerar cargas; duas pesagens podem pertencer ao mesmo dia real e exigem consolidação coerente com o demonstrativo.
Roteiro para falha de importação
Leia a mensagem de schema e inspecione o início de cada forDia: atributo ausente, zero inicial e elemento no lugar do atributo são falhas distintas. Depois confira se o importador extraiu o dia do fornecimento, e não da emissão, vencimento ou sequência da carga. Compare com a referência mensal e a safra da mesma aquisição.
O grupo pai deve respeitar o contexto da NF-e: o MOC relaciona cana no modelo 65 à rejeição 763. Essa validação não é uma rejeição específica do número do dia. Corrija a origem comprovada antes de assinar, preservando a data real e a quantidade correspondente. MOC 7.0, p. 128.
Fontes oficiais
- Leiaute NF-e/NFC-e — PL_010f_v1.04: cana/forDia/@dia l6403–6413; pattern1–31
- 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/@dia- Namespace
Não informado- Leiaute
- 4.00 · PL_010e_v1.02
- Ocorrências no XSD
- 1–1 no contexto do elemento pai
- Tipo
- inline:xs:string · 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
[1-9]|[1][0-9]|[2][0-9]|[3][0-1]- whiteSpace
preserve