Visualizar

Objetivo do Endpoint

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 a chave de acesso da NF-e.

Observação: a consulta é restrita às NF-e armazenadas em sua conta. NF-e que não pertençam ao seu CNPJ não serão retornadas.

Endpoint:

GET /GuardaNFe/Visualizar/{fileName}

Parâmetros:

Nome	Tipo	Obrigatório	Descrição
fileName	string	✅ Sim	Nome do arquivo XML da NF-e armazenado no GuardaNFe

Exemplo 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"

Respostas possíveis:

Código	Descrição
200 OK	Retorna o conteúdo XML da NF-e
404 Not Found	Arquivo não encontrado
500 Internal Server Error	Erro interno ao processar a requisição

Exemplo de Resposta - Sucesso (200)

<?xml version="1.0" encoding="UTF-8"?>
<NFe>
    <!-- Conteúdo da NF-e -->
</NFe>

Exemplo de Resposta - Arquivo Não Encontrado (404)

{
    "message": "Arquivo não encontrado."
}