infNFeSupl: QR-Code e consulta por chave da NFC-e

infNFeSupl reúne as informações suplementares de consulta da NFC-e: qrCode e urlChave. Ele fica diretamente em NFe, como irmão de infNFe. Não é o grupo de observações infAdic/infCpl e não informa o protocolo de autorização.

Caminho desta página: /nfeProc/NFe/infNFeSupl. O prefixo nfeProc identifica a nota processada. infNFeSupl é filho de NFe, irmão de infNFe, e fica fora deste último grupo.

Posição e campos do grupo

No XSD, o grupo ocorre de zero a uma vez e aparece depois de infNFe e antes da assinatura XML externa. Quando presente, exige qrCode seguido de urlChave. O primeiro transporta a URL com os parâmetros codificados na imagem QR do DANFE NFC-e; o segundo informa o endereço da consulta por chave de acesso.

qrCode tem de 60 a 1.000 caracteres e padrões próprios de versão e forma de emissão. urlChave tem de 21 a 85 caracteres e não é intercambiável com a URL parametrizada do QR. A NT descreve o grupo como informação suplementar fora do conteúdo assinado de infNFe; isso não autoriza alterar livremente dados distribuídos ou desconsiderar sua coerência com a nota. XSD PL 010f e NT 2025.001 v1.03, p. 8.

NF-e 55, NFC-e 65 e exceções documentadas

O MOC ZX01-10/393 rejeita o grupo suplementar em NF-e modelo 55. Para NFC-e 65, ZX02-10/394 trata a ausência do QR-Code, com a exceção histórica de emissão anterior a 01/04/2016 em produção.

A NT 2021.002 v1.12 acrescenta a exceção para NFF (tpEmis=3) na ZX02-10 e apresenta a seção como previsão para quando for possível emitir NFC-e no fluxo NFF. A exceção documentada não prova que qualquer contribuinte já possa emitir NFC-e NFF. Identifique modelo, forma de emissão, ambiente e habilitação real antes de transportar a regra. MOC, p. 128 e NT NFF, p. 15.

Como as duas consultas diferem

O QR é uma rota parametrizada: na versão 3 online, leva chave, versão e tipo de ambiente. Em contingência offline, a versão 3 inclui ainda dia, valor total, identificação do destinatário e assinatura. urlChave fornece o endereço para consulta pela chave, apresentado também como alternativa no DANFE NFC-e.

Uma imagem QR legível não prova que a URL esteja correta; um endereço decodificado corretamente não prova autorização. Confira separadamente: imagem e texto; texto e parâmetros da nota; página oficial e situação consultada. O ambiente da consulta precisa corresponder ao documento: trocar o endereço de homologação pelo de produção não transforma a nota em uma emissão de produção.

Exemplo parcial sem inventar chave

O fragmento abaixo demonstra somente um dos filhos, com domínio didático não operacional:

<urlChave xmlns="http://www.portalfiscal.inf.br/nfe">https://consulta.example.invalid/nfce</urlChave>

Não é um endereço de SEFAZ, XML completo ou grupo completo: qrCode também é obrigatório quando infNFeSupl existe. Em uma emissão, os endereços devem vir da tabela oficial da UF e corresponder ao ambiente. Para qrCode, a chave e os parâmetros devem vir do documento efetivo; não se cria uma chave para completar um exemplo.

Roteiro para ausência, posição ou consulta quebrada

Se houver 393, confira ide/mod e o papel do grupo antes de qualquer remoção. Se houver 394, confira se o gerador produziu qrCode e se aplica alguma exceção documentada. Em erro de schema, examine infNFeSupl como irmão de infNFe, ordem dos filhos e formatos; colocá-lo dentro de infAdic não atende à estrutura.

Para consulta quebrada, decodifique a imagem, confirme UF e ambiente e compare os parâmetros com o XML original. Não trate erro de URL como rejeição fiscal sem ler o retorno correspondente. A correção deve ocorrer na origem comprovada, preservando o documento e seu estado real.

Fontes oficiais

• Leiaute NF-e/NFC-e — PL_010f_v1.04: infNFeSupl/qrCode/urlChave, linhas 6641–6681
• Tipos básicos NF-e/NFC-e — PL_010f_v1.04: TString, linhas 519–527: restrição textual utilizada em urlChave.
• NT 2025.001 — QR-Code e simplificação operacional — 1.03 corrigida, setembro/2025: Informações suplementares, p. 8; formato QR v3, p. 13–14; histórico das revisões, p. 2–3.
• MOC 7.0 — Anexo I — 7.00, novembro/2020: Grupo ZX, p. 66; ZX01-10/393 e ZX02-10/394, p. 128.
• NT 2021.002 — Nota Fiscal Fácil — 1.12, janeiro/2025: Exceção documentada de QR-Code na futura NFC-e NFF, p. 15.
• Manual de Padrões Técnicos do DANFE NFC-e e QR-Code — 6.0, março/2025: Endereços por UF/ambiente e funções das consultas, p. 28–29; consulta por chave de acesso, p. 34.