Skip to main content

Descarga masiva de PDFs de facturas

Facturear permite descargar el PDF de cada factura emitida, desde el dashboard o con la API. Esta guía cubre cómo descargar una factura y cómo armar una descarga masiva recorriendo tus facturas con la API.
Facturear no tiene un endpoint de exportación masiva (un ZIP por período). La descarga masiva se arma pidiendo el PDF de cada factura, como se muestra más abajo.

Descarga de un PDF individual

Desde el dashboard

En Facturas, abrí la factura y usá “Descargar PDF”. Desde la misma pantalla, “Enviar por email” se la manda a tu cliente desde Facturear, y en el celular “Compartir” te deja pasar el PDF por WhatsApp u otra app.

Con la API

Con el id de la factura en Facturear (el invoiceId que devuelve el resultado del lote, o el id de cada factura en GET /api/invoices), pedí el PDF con ?download=true para recibir el archivo directamente:
El archivo viene con Content-Type: application/pdf y un nombre del tipo factura-0001-00000145-production.pdf en el header Content-Disposition. Sin download=true, la API te devuelve una URL para descargar el PDF:
Si abrís ese mismo link (/api/invoices/{id}/pdf) en el navegador, con tu sesión iniciada, va directo al PDF en vez de mostrar el JSON. Pasa, por ejemplo, con el link que te devuelve un agente de IA. Si la factura no existe o no es tuya, la respuesta es 404.

Descarga masiva por período

Para descargar todas las facturas de un período:
  1. Listá tus facturas con GET https://www.facture.ar/api/invoices, filtrando por status=success y, si tenés varios CUITs, por cuit. La lista viene ordenada de la más nueva a la más vieja, hasta 100 por página
  2. Quedate con las que caen en el período según su fecha de creación (createdAt)
  3. Pedí el PDF de cada una con GET /api/invoices/{id}/pdf?download=true
Ver Buscar y consultar facturas para todos los filtros del listado.

Descarga masiva en Node.js

Cada PDF se genera al momento de pedirlo. Para lotes grandes, descargalos de a uno o con poca concurrencia.

Envío de facturas por e-mail

No hace falta descargar el PDF para mandárselo a tu cliente: Facturear lo envía por vos, desde noreply@facture.ar, con POST /api/invoices/{invoiceId}/email (hasta 5 destinatarios por envío). Desde el dashboard, en el detalle de la factura, usá “Enviar por email”. Ver Enviar una factura por email.

Estructura de la carpeta descargada

El script de ejemplo deja los PDFs en una carpeta por mes, nombrados por punto de venta y número:
Si necesitás un resumen, armalo con los datos del listado (voucherNumber, amount, invoiceType, y la respuesta de ARCA en feCabResp) y comprimí la carpeta en un ZIP con la herramienta que prefieras.

Recursos relacionados


Seguí estos pasos directamente en Facturear

Ir al dashboard de Facturear y descargar tus PDFs de facturas.