Skip to main content
POST
Gerar Arquivo

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

string
default:"application/json"
Tipo de conteúdo da requisição
string
required
Token de autenticação da API

Body Parameters

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

Exemplos de Requisição

Códigos de Resposta

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

Exemplos de Resposta

Como Baixar o Arquivo

Após receber a resposta com sucesso, use a downloadUrl retornada para fazer o download:

Estrutura do Arquivo ZIP

O arquivo ZIP gerado contém:

Organização

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.