Skip to main content
POST
/
GuardaNFe
/
GerarArquivo
Gerar Arquivo
curl --request POST \
  --url https://api.validanfe.com/GuardaNFe/GerarArquivo \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "ChavesNFe": [
    {}
  ]
}
'
{
  "200": {},
  "400": {},
  "401": {},
  "500": {}
}

​
Objetivo

Este endpoint permite a geração de um arquivo .zip contendo os arquivos XML das NF-e correspondentes às chaves de acesso informadas. Você pode enviar uma ou múltiplas chaves na mesma requisição.
Para Operações em Larga EscalaEste endpoint é indicado para consultas pontuais ou pequenos volumes. Para recuperação de todo seu acervo fiscal, entre em contato com nosso suporte.

​
Endpoint

​
Headers

​
Content-Type
string
default:"application/json"
Tipo de conteúdo da requisição
​
X-API-KEY
string
required
Token de autenticação da API

​
Body Parameters

​
ChavesNFe
array
required
Lista de chaves de acesso das NF-e para incluir no arquivo ZIPExemplo: ["35170608530528000184550000000154301000771561"]

​
Exemplos de Requisição

curl -X POST "https://api.validanfe.com/GuardaNFe/GerarArquivo" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-API-KEY: SEU_TOKEN_AQUI" \
  -d '{
    "ChavesNFe": [
      "35170608530528000184550000000154301000771561",
      "22210841816302000110550000000000012824578529"
    ]
  }'

​
Códigos de Resposta

​
200
Success
ZIP gerado com sucesso, retorna URL para download
​
400
Bad Request
Nenhuma chave NFe foi fornecida
​
401
Unauthorized
Token de autenticação ausente ou inválido
​
500
Internal Server Error
Erro ao processar a requisição ou gerar o ZIP

​
Exemplos de Resposta

{
    "downloadUrl": "https://api.validanfe.com/GuardaNFe/Download/NFe_123456_abcdef123456.zip"
}

​
Como Baixar o Arquivo

Após receber a resposta com sucesso, use a downloadUrl retornada para fazer o download: 
curl -L -H "X-API-KEY: SEU_TOKEN_AQUI" \
  "https://api.validanfe.com/GuardaNFe/Download/NFe_123456_abcdef123456.zip" \
  --output nfe-arquivos.zip

​
Estrutura do Arquivo ZIP

O arquivo ZIP gerado contém:

Organização

NFe_123456_abcdef123456.zip
├── 35170608...71561.xml
├── 22210841...78529.xml
└── ...

Formato dos Arquivos

  • Nome: Chave da NFe + .xml
  • Conteúdo: XML completo da NFe
  • Encoding: UTF-8

​
Limitações e Considerações

  • Máximo: 100 chaves por requisição
  • Tamanho: Arquivos ZIP podem ter até 50MB
  • Timeout: Requisições com timeout de 60 segundos
  • Tempo de geração varia com a quantidade de NFe
  • Processo assíncrono para grandes volumes
  • Arquivos ficam em cache por 1 hora
Dica de UsoPara volumes maiores que 100 NFe, divida em múltiplas requisições ou entre em contato com o suporte para uma solução personalizada.
Verificação PréviaUse o endpoint Verificar NFe antes de gerar arquivos para confirmar quais NFe estão disponíveis.