Exportação em massa — NF-e / CT-e Inbound
Para baixar muitos documentos de uma vez (guarda fiscal, conciliação, BI), use a exportação em massa. A mecânica do job assíncrono é a mesma da NFS-e — veja Bulk export NFS-e para o fluxo completo (criar job → polling → link de download válido por 7 dias). Esta página foca no que é específico de NF-e/CT-e.
Formatos e resource
| Formato | resource | Uso |
|---|---|---|
| XML | company-nfe-inbound-xml | Guarda fiscal (arquivo autorizado) |
| PDF (DANFE) | company-nfe-inbound-pdf | Visualização |
| CSV analítico | company-nfe-inbound-analytical-csv | Planilha / BI |
Disponibilidade por documento
| Documento | XML | CSV | |
|---|---|---|---|
| NF-e | ✅ | ✅ (DANFE) | ✅ |
| CT-e | ⚠️ individual | ⚠️ individual (DACTe) | ❌ (roadmap) |
A exportação em massa de CT-e ainda não está disponível. Por enquanto, baixe cada CT-e individualmente pelos endpoints
/xmle
O parâmetro language aceita pt-BR (padrão) e en-US (apenas via API, não exposto no console).
Esquema do CSV analítico de NF-e (18 colunas)
Os nomes de resource, o esquema de 18 colunas e a disponibilidade por documento vêm da documentação oficial da API. O gerador do CSV vive no serviço de exportação (shared-usage-api), não no backend de inbound — trate esta seção como referência documental.
Cada linha = uma NF-e. Ordem fixa. Codificação ISO-8859-1, separador ;, quebra CRLF.
| # | Coluna | Descrição |
|---|---|---|
| 1 | NSU | Número Sequencial Único da SEFAZ |
| 2 | Access_Key | Chave de acesso (44 dígitos) |
| 3 | Nfe_Number | Número sequencial da NF-e |
| 4 | Nfe_Serial_Number | Série da NF-e |
| 5 | Issued_Date | Data/hora de emissão |
| 6 | Created_At | Data de criação do registro na NFE.io |
| 7 | Operation_Type | Tipo de operação (Outgoing/Incoming) |
| 8 | Environment_Type | Production / Test |
| 9 | Total_Invoice_Amount | Valor total da NF-e |
| 10 | Sender_Federal_Tax_Number | CNPJ do emitente |
| 11 | Sender_Name | Razão social do emitente |
| 12 | Company_Federal_Tax_Number | CNPJ da sua empresa |
| 13 | Company_State | UF da sua empresa |
| 14 | Description | Status descritivo (geralmente vazio para a nota) |
| 15 | Event_Access_Key | Chave do evento primário (se houver) |
| 16 | Event_Issued_On | Data do evento |
| 17 | Event_Description | Texto descritivo do evento |
| 18 | Event_Type | Tipo (productInvoice / productInvoiceEvent) |
Evento primário (NF-e)
Diferente da NFS-e, o domínio NF-e não expõe um EventCode numérico. O evento primário "achatado" nas colunas 15-18 é simplesmente o mais recente por data de emissão, com desempate pela chave de acesso.
Veja também
- Bulk export NFS-e — fluxo do job assíncrono
- Consultar no painel
- Endpoints CT-e