Rejeição 397: ambiente do QR Code diferente de tpAmb
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-244 significa que o tipo de ambiente informado no QR Code difere do ide/tpAmb da nota. O ambiente ocupa a terceira posição nos perfis QR 2 e QR 3, online ou off-line. A comparação é entre duas representações do mesmo documento, e não uma autorização para converter uma tentativa de homologação em produção.
Qual informação precisa coincidir
No XML, localize NFe/infNFe/ide/tpAmb: 1 é produção e 2 é homologação. Depois leia o terceiro parâmetro do texto em NFe/infNFeSupl/qrCode. A NT 2026.002 v1.11 aplica ZX02-244 quando o QR é informado e sua versão é 2 ou 3, nos modelos 55/65. Para NF-e em contingência off-line, o contexto permitido é DANFE Simplificado Tipo 2, tpImp=6; o QR da NF-e é restringido à versão 3 por ZX02-220. NT 2026.002 v1.11, pp. 20–21
Endereço e ambiente não são a mesma conferência
O endereço de consulta pode ser diferente por ambiente ou compartilhado, conforme a UF. O Manual 6.0 admite que a mesma URL atenda produção e homologação; nesse caso o parâmetro do ambiente orienta a aplicação de consulta. Por isso, ver o domínio esperado não prova que o terceiro parâmetro está correto. Manual DANFE/QR 6.0, pp. 21 e 28–30
O endpoint usado para autorizar também precisa corresponder ao ambiente real, mas isso é uma conferência separada. Não altere tpAmb nem direcione um XML de teste à produção apenas para fazê-lo coincidir com um QR montado incorretamente.
Exemplo: configuração compartilhada entre ambientes
Considere um XML de homologação com tpAmb=2, enquanto a função de QR insere 1 por uma configuração fixa. A divergência está comprovada comparando os dois valores da mesma tentativa. Se o parâmetro estiver ausente, a regra relacionada é 396/ZX02-240; se a URL da UF estiver incorreta, investigue 395/ZX02-20. O código 397 por si só não identifica todos esses problemas.
A comparação é textual porque uma URL completa exigiria a chave do documento e outros parâmetros derivados de assinatura ou CSC. Os valores de ambiente bastam para demonstrar a divergência sem fabricar uma chave fiscal.
Como corrigir a origem comprovada
Confira a configuração de ambiente efetiva da empresa e da tentativa, a origem de tpAmb, o texto gravado em qrCode e a URL lida da imagem impressa. Se o XML e o QR gravado coincidem, mas a imagem mostra outro ambiente, procure reutilização de QR ou cache de impressão. Se o XML já diverge do QR gravado, investigue o mapeamento do gerador. A correção deve preservar o ambiente verdadeiro, a empresa e os dados da operação.
Calendário e resultado fiscal
A ampliação do Tipo 2 consta na linha da versão 1.00: testes em 1 de julho de 2026 e produção em 3 de agosto de 2026. A postergação de três outras regras para 14 de dezembro não se estende a ZX02-244. Essas datas não comprovam implantação individual. Preserve documentos autorizados e XML assinado; esclareça a situação de uma tentativa incerta antes de novo envio. Confira o retorno oficial vinculado à tentativa após qualquer correção técnica. NT 2026.002 v1.11, p. 3