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 (elinvoiceId 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:
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:
/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:- Listá tus facturas con
GET https://www.facture.ar/api/invoices, filtrando porstatus=successy, si tenés varios CUITs, porcuit. La lista viene ordenada de la más nueva a la más vieja, hasta 100 por página - Quedate con las que caen en el período según su fecha de creación (
createdAt) - Pedí el PDF de cada una con
GET /api/invoices/{id}/pdf?download=true
Descarga masiva en Node.js
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, conPOST /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:voucherNumber, amount, invoiceType, y la respuesta de ARCA en feCabResp) y comprimí la carpeta en un ZIP con la herramienta que prefieras.
Recursos relacionados
- Buscar y consultar facturas
- Webhooks en Facturear
- Primera factura con Facturear
- Facturación en lotes
Seguí estos pasos directamente en Facturear
Ir al dashboard de Facturear y descargar tus PDFs de facturas.