urlChave: endereço da consulta por chave da NFC-e

urlChave informa o endereço da consulta por chave de acesso da NFC-e, em infNFeSupl. A documentação do XSD determina a mesma URL informada no DANFE NFC-e para essa consulta. Não é a própria chave nem a URL completa do parâmetro p do QR-Code.

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

Qual endereço pertence ao campo

A origem é o endereço oficial de consulta por chave da UF e do ambiente correspondente. O usuário pode recorrer a essa consulta quando precisa informar a chave por outro meio, sem ler a imagem QR. O campo não é uma página do software emissor nem um endpoint genérico escolhido apenas por funcionar no navegador.

O XSD restringe o texto a 21–85 caracteres sobre TString. Essa declaração não consulta a SEFAZ, não verifica HTTP e não demonstra que o domínio seja oficial. O comprimento certo não substitui a confirmação do destino. XSD PL 010f.

Exemplo didático sem endereço fiscal inventado

Fragmento parcial, sem XML completo:

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

O domínio é didático e não é um serviço de consulta da SEFAZ. O exemplo mostra apenas representação textual, sem inventar chave, protocolo ou endereço operacional. Em uma emissão, use o destino oficial confirmado da UF e ambiente; não acrescente chave ou parâmetros de QR por inferência.

No grupo completo, qrCode precede urlChave, e ambos são obrigatórios quando infNFeSupl existe.

Diferença para qrCode e protocolo

qrCode armazena a URL parametrizada que a imagem representa; urlChave armazena o endereço de consulta pela chave. As duas jornadas podem pertencer ao mesmo portal, mas têm funções e formatos distintos. Copiar a URL longa do QR para urlChave pode exceder o limite e apontar para a rota errada.

Nenhum dos dois campos contém o resultado de autorização. Para confirmar status, consulte o documento no ambiente e com a identidade corretos e compare o protocolo correspondente. Um endereço acessível sem erro HTTP não prova que a NFC-e esteja autorizada.

Como investigar URL errada no DANFE

Compare o texto impresso com infNFeSupl/urlChave, depois confronte ambos com a tabela oficial da UF e ambiente. Se o XML está correto e a impressão usa outro endereço, investigue template ou cache do DANFE. Se ambos estão errados, confira seleção da UF e configuração de homologação ou produção no gerador.

Não encurte nem redirecione um endereço oficial para caber no limite sem confirmar o padrão correspondente. Não altere o ambiente da nota porque a consulta em outro portal não a encontrou. Corrija a origem comprovada e preserve os documentos já emitidos. O grupo suplementar é vedado em modelo 55 pela ZX01-10/393; essa regra é separada do valor da URL. MOC, p. 128.

Fontes oficiais

• Leiaute NF-e/NFC-e — PL_010f_v1.04: infNFeSupl/urlChave, linhas 6669–6680; TString de 21 a 85 caracteres
• 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: Grupo suplementar e urlChave, p. 8; histórico das revisões, p. 2–3. Revisões 1.02/1.03 não alteram a função de urlChave.
• MOC 7.0 — Anexo I — 7.00, novembro/2020: Grupo ZX, p. 66; ZX01-10/393 e ZX02-10/394, p. 128.
• 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.