Rejeição 397: valor do QR Code diferente do total vNF
Revisão editorial em 16 de out. de 2026. Confira as versões e condições das regras nas fontes do artigo.
A Rejeição 397/ZX02-276 indica que o valor total informado no QR Code off-line difere de total/ICMSTot/vNF da nota. O valor está presente, mas não coincide com a informação fiscal do mesmo documento. Não é uma validação da soma de pagamentos nem do troco.
Campo, posição e perfil de emissão
Leia NFe/infNFe/total/ICMSTot/vNF e compare com a quinta posição de NFe/infNFeSupl/qrCode. A regra atual exige QR informado, versão 2 ou 3 e contingência off-line (tpEmis=9). Abrange NFC-e e NF-e no contexto DANFE Simplificado Tipo 2, tpImp=6; para NF-e, confirme QR 3 por ZX02-220. NT 2026.002 v1.11, pp. 20 e 22
O parâmetro total não existe no QR online. Nas versões 2 e 3 off-line ele fica após o dia. O Manual 6.0 determina ponto como separador decimal, sem milhar ou sinais; a apresentação visual “R$1.250,30” não é a representação que deve ser copiada para o parâmetro. Manual 6.0, pp. 22 e 30
Não confunda vNF com outras somas
O total de pagamentos em pag/detPag/vPag, o troco e o valor de um item não substituem vNF. Se o gerador de QR consulta uma dessas propriedades, pode gerar uma diferença apesar de a tela financeira parecer correta. Também confira se o QR foi montado antes do total final ou se ficou armazenado após uma alteração do rascunho.
Não ajuste impostos, descontos, pagamentos ou o total verdadeiro para coincidir com o QR. A rejeição demonstra a diferença entre as representações; a causa exige comparar a origem de cada valor. Eventual cálculo incorreto de vNF deve ser investigado em seu próprio fluxo e com os parâmetros da operação.
Exemplo: total e pagamento com troco
Num cenário sintético, a nota contém vNF=1250.30, enquanto o pagamento recebido é 1300.00. Se o QR usa 1300.00 como quinto parâmetro, ele representa o pagamento, não o total da nota. O diagnóstico identifica a propriedade incorreta no gerador, sem decidir nenhum tratamento tributário.
Em outro cenário, o QR usa 1250.03. A diferença pode ser transcrição, cálculo antigo ou conversão inadequada; a comparação sozinha não identifica qual. Compare o texto gravado antes da impressão e a origem do número. Se o quinto parâmetro estiver vazio, investigue 396/ZX02-272, ausência, em vez de divergência.
Os exemplos são textuais porque a URL completa exige chave e autenticação do documento; esses dados protegidos não são necessários para demonstrar a comparação de valores.
Verifique a etapa que introduziu a diferença
Confronte XML efetivamente assinado, texto de qrCode e URL extraída da imagem. Se o texto está correto e a imagem diverge, investigue cache ou impressão de outra nota. Se o texto já diverge, investigue a montagem e a versão do total usada. Não arredonde novamente um valor já representado no XML para “aproximar” o resultado.
Vigência e preservação do documento
A extensão Tipo 2 tem calendário de testes 01/07/2026 e produção 03/08/2026. A postergação 14/12/2026 de outras regras não atinge ZX02-276 e o cronograma não comprova implantação individual. Preserve documentos autorizados e arquivos assinados. Esclareça uma tentativa de resultado incerto antes de novo envio e confira o retorno oficial associado ao documento corrigido quando houver uma nova tentativa cabível. NT 2026.002 v1.11, p. 3