GerarArquivo

Objetivo do Endpoint

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, conforme demonstrado no exemplo abaixo.

Importante: este endpoint é indicado para consultas pontuais ou em pequenos volumes. Para operações em larga escala, como a recuperação de todo o seu acervo fiscal, entre em contato com nosso time de suporte para uma solução personalizada e mais eficiente.

Endpoint

POST /GuardaNFe/GerarArquivo

Parâmetros da Requisição

O endpoint espera um JSON no corpo da requisição com a seguinte estrutura:

{
  "ChavesNFe": [
    "35170608530528000184550000000154301000771561",
    "22210841816302000110550000000000012824578529"
  ]
}

Exemplo de Requisição

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

Respostas Possíveis

Código	Descrição
200 OK	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

Exemplo de Resposta - Sucesso (200)

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

Exemplo de Resposta - Erro (400)

{
    "error": "Nenhuma chave NFe foi fornecida."
}

Exemplo de Resposta - Erro Interno (500)

{
    "error": "Erro ao gerar o ZIP."
}