Skip to main content
GET
/
GuardaNFe
/
Visualizar
/
{fileName}
Visualizar NFe
curl --request GET \
  --url https://api.validanfe.com/GuardaNFe/Visualizar/{fileName} \
  --header 'X-API-KEY: <x-api-key>'
{
  "200": {},
  "401": {},
  "404": {},
  "500": {}
}

​
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

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

​
Headers

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

​
Exemplos de Requisição

curl -X GET "https://api.validanfe.com/GuardaNFe/Visualizar/35170608530528000184550000000154301000771561.xml" \
  -H "Accept: application/xml" \
  -H "X-API-KEY: SEU_TOKEN_AQUI"

​
Códigos de Resposta

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

​
Exemplos de Resposta

<?xml version="1.0" encoding="UTF-8"?>
<nfeProc versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe">
  <NFe xmlns="http://www.portalfiscal.inf.br/nfe">
    <infNFe versao="4.00" Id="NFe35170608530528000184550000000154301000771561">
      <ide>
        <cUF>35</cUF>
        <cNF>00077156</cNF>
        <natOp>VENDA</natOp>
        <mod>55</mod>
        <serie>0</serie>
        <nNF>15430</nNF>
        <dhEmi>2017-06-05T08:31:06-03:00</dhEmi>
        <tpNF>1</tpNF>
        <idDest>1</idDest>
        <cMunFG>3550308</cMunFG>
        <tpImp>1</tpImp>
        <tpEmis>1</tpEmis>
        <cDV>9</cDV>
        <tpAmb>1</tpAmb>
        <finNFe>1</finNFe>
        <indFinal>1</indFinal>
        <indPres>0</indPres>
        <procEmi>0</procEmi>
        <verProc>3.10.31</verProc>
      </ide>
      <emit>
        <CNPJ>56776378000136</CNPJ>
        <xNome>COMERCIO DE TESTE LTDA EPP</xNome>
        <!-- Mais dados do emitente -->
      </emit>
      <dest>
        <CPF>67879577696</CPF>
        <xNome>MARIA FICTICIA DOS SANTOS</xNome>
        <!-- Mais dados do destinatário -->
      </dest>
      <!-- Produtos, impostos, totais, etc. -->
    </infNFe>
  </NFe>
  <protNFe versao="4.00">
    <!-- Protocolo de autorização -->
  </protNFe>
</nfeProc>

​
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

// Usando DOMParser no navegador
const parser = new DOMParser();
const xmlDoc = parser.parseFromString(xmlContent, "text/xml");

// Extrair dados específicos
const nfe = xmlDoc.getElementsByTagName("NFe")[0];
const infNFe = nfe.getElementsByTagName("infNFe")[0];
const emit = infNFe.getElementsByTagName("emit")[0];

const nomeEmitente = emit.getElementsByTagName("xNome")[0].textContent;
console.log("Emitente:", nomeEmitente);

​
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.