Pular para o conteúdo
Fiscal ProBiblioteca
NF-e e NFC-e · Informações complementares da operação

qTotAnt em cana: quantidade anterior e corte do acumulado

<qTotAnt>cana › qTotAnt

Revisã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

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