qTotAnt em cana: quantidade anterior e corte do acumulado
<qTotAnt>cana › qTotAntRevisão editorial em 14 de out. de 2026. As versões e condições das regras estão indicadas ao longo do artigo.
qTotAnt é a quantidade total anterior informada em cana. É um valor físico, relacionado ao demonstrativo de aquisição, separado da quantidade do mês qTotMes e da quantidade geral qTotGer. “Anterior” não significa automaticamente quantidade do único mês imediatamente anterior.
Caminho desta página: /nfeProc/NFe/infNFe/cana/qTotAnt. O prefixo nfeProc identifica a nota processada; a informação estudada pertence ao conteúdo da NF-e, dentro de NFe/infNFe.
Qual período o valor representa
O MOC chama o campo de “Quantidade Total Anterior”, e o XSD o documenta como “Total Anterior”. Esses trechos não detalham todos os critérios de corte do acumulado nem dizem que o campo equivale sempre ao mês passado. A fonte de confirmação é o fechamento e o demonstrativo da aquisição vinculados à mesma safra, referência e partes.
Por isso, localize o recorte histórico efetivamente utilizado antes de comparar números. Misturar um acumulado da safra inteira com apenas o último mês produz uma divergência que não pode ser resolvida alterando o XML por tentativa. A definição do período e a validade documental do lançamento devem ser confirmadas com o responsável pelo demonstrativo. MOC, ZC08, p. 65.
Representação e exemplo do acumulado
Suponha um demonstrativo sintético cujo recorte confirmado registra 5.000 kg antes do mês corrente. Nesse cenário:
<qTotAnt xmlns="http://www.portalfiscal.inf.br/nfe">5000</qTotAnt>
O fragmento é parcial e não constitui XML completo da NF-e. Se o mês acrescenta 2.000 kg, uma conferência aritmética do total geral desse demonstrativo é 5.000 + 2.000 = 7.000 kg. Essa conta depende do mesmo recorte e não cria uma regra de rejeição numérica da SEFAZ.
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.
Zero deve representar histórico anterior confirmado como zero; não é substituto de histórico ausente no sistema.
Como localizar uma duplicidade de mês
Compare o histórico de fechamento com o campo antes de incluir o mês corrente. Se o anterior já incorpora os 2.000 kg deste mês e a geração acrescenta novamente 2.000 kg, o total geral ficará duplicado. Identifique datas de corte e lançamentos incorporados em cada memória.
Na virada de referência ou safra, não carregue automaticamente o último qTotGer sem conferir a continuidade documentada. Uma troca de empresa, fornecedor ou recorte também invalida uma comparação global. Preserve a identificação dos documentos no relatório de conciliação e não corrija um histórico de outra aquisição para fazer a nota atual fechar.
Obrigatoriedade e limites do diagnóstico
qTotAnt é obrigatório uma vez quando cana existe. O grupo cana é opcional no schema, mas o MOC o restringe no modelo 65 pela regra ZC01-10/763. Esse contexto é separado da existência de um acumulado anterior.
Se a falha é estrutural, confira campo presente, ordem depois de qTotMes e formato decimal. Se é documental, confirme o fechamento histórico e compare todos os registros que o compõem. O MOC citado não fornece tolerância ou rejeição específica por soma divergente de qTotAnt; não use um código de outro tributo para justificar o ajuste. A correção deve ocorrer na origem comprovadamente incorreta antes da assinatura.
Fontes oficiais
- Leiaute NF-e/NFC-e — PL_010f_v1.04: cana/qTotAnt l6425–6429; TDec_1110v
- 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/qTotAnt- 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