Pular para o conteúdo principal

Downloads (PDF/XML)

O formato do retorno depende do recurso. A NFS-e e a consulta de NF-e por chave devolvem os bytes do arquivo (Buffer); os demais devolvem um link para ele, e baixá-lo fica com a aplicação. Em todos, o download é de uma nota identificada.

import { writeFileSync } from 'node:fs';

// NFS-e: bytes
const pdf = await nfe.serviceInvoices.downloadPdf(companyId, invoiceId);
writeFileSync('nota.pdf', pdf);

const xml = await nfe.serviceInvoices.downloadXml(companyId, invoiceId);
writeFileSync('nota.xml', xml);

// NF-e: link para o arquivo
const { uri } = await nfe.productInvoices.downloadPdf(companyId, productInvoiceId);

Não existe download em lote por empresa. Até a versão 5.2.0 o invoiceId era opcional e a documentação prometia um ZIP com todas as notas. A rota não existe: /serviceinvoices/pdf responde 404 "service invoice with id (pdf) was not found", porque o servidor casa a rota /{id} e trata pdf como identificador. Medido em 2026-09-02; a rota também não está na spec nf-servico-v1. Para baixar várias notas, itere sobre os ids.

Disponibilidade por estado​

O PDF/XML só existe após a nota atingir um estado terminal (Issued/Cancelled). Antes disso, o download pode retornar 404 — use polling ou webhooks para aguardar a emissão.

Por recurso​

RecursoMétodosRetorno
serviceInvoicesdownloadPdf, downloadXmlBuffer
serviceInvoicesRtcdownloadCancellationXml (XML do evento de cancelamento)Buffer
productInvoicesdownloadPdf (force?), downloadXml, downloadRejectionXml, downloadEpecXml, downloadCorrectionLetterPdf, downloadCorrectionLetterXmlNfeFileResource ({ uri })
consumerInvoices (NFC-e)downloadPdf (force?), downloadXml, downloadRejectionXmlConsumerInvoiceFileResource ({ uri })
inboundProductInvoicesgetXml, getPdf, getEventXmlInboundFileResource ({ publicTemporaryUri })
transportationInvoicesdownloadXml, downloadEventXmlInboundFileResource ({ publicTemporaryUri })
productInvoiceQuerydownloadPdf, downloadXml, por chave de acessoBuffer

O publicTemporaryUri é um link pré-assinado e temporário. A consulta de cupom CFe-SAT (consumerInvoiceQuery) está descontinuada: a plataforma não serve a rota.

Memória

Os métodos que devolvem Buffer carregam o arquivo inteiro em memória. Para muitas notas, baixe uma a uma e grave em disco logo após cada retorno.

Próximos passos​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.