Skip to main content
GET
Visualizar NFe

Objetivo

Este endpoint permite consultar diretamente uma NF-e armazenada no GuardaNFe, retornando o XML completo do documento como resposta. Ideal para integrações que precisam acessar um documento específico de forma rápida e segura, utilizando apenas o nome do arquivo da NF-e.
Acesso RestritoA consulta é restrita às NF-e armazenadas em sua conta. NFe que não pertençam ao seu CNPJ não serão retornadas.

Endpoint

Parâmetros

string
required
Nome do arquivo XML da NF-e armazenado no GuardaNFeFormato: {chave_nfe}.xmlExemplo: 35170608530528000184550000000154301000771561.xml

Headers

string
default:"application/xml"
Tipo de conteúdo aceito na resposta (application/xml ou application/json)
string
required
Token de autenticação da API

Exemplos de Requisição

Códigos de Resposta

Success
Retorna o conteúdo XML completo da NF-e
Not Found
Arquivo não encontrado ou não pertence à sua conta
Unauthorized
Token de autenticação ausente ou inválido
Internal Server Error
Erro interno ao processar a requisição

Exemplos de Resposta

Como Formar o Nome do Arquivo

O parâmetro fileName deve seguir o padrão:
1

Pegue a Chave da NFe

Exemplo: 35170608530528000184550000000154301000771561
2

Adicione a Extensão

Resultado: 35170608530528000184550000000154301000771561.xml
3

Use na URL

/GuardaNFe/Visualizar/35170608530528000184550000000154301000771561.xml

Processando a Resposta XML

Casos de Uso

Verifique a integridade e autenticidade de NFe específicas comparando com os dados originais.
Extraia informações específicas como produtos, valores, ou dados do emitente para relatórios.
Acesse rapidamente documentos fiscais durante processos de auditoria ou compliance.
Integre com ERPs ou sistemas contábeis que precisam processar dados de NFe.
Formato do NomeCertifique-se de usar o nome correto do arquivo. Nomes incorretos resultarão em erro 404.
Verificação PréviaUse o endpoint Verificar NFe para confirmar se um arquivo está disponível antes de tentar visualizá-lo.