Guía de uso de DescargarDocsZIP

DescargarDocsZIP es una utilidad de YAST TELECOM SL que añade un botón Descargar ZIP en los listados de documentos de FacturaScripts para descargar, en un único archivo comprimido, los PDF individuales de cada documento. Está pensada para quien necesita exportar en bloque facturas, presupuestos, pedidos o albaranes.

1. Instalación

Descarga el ZIP de DescargarDocsZIP.
En FacturaScripts, ve a Administrador → Plugins, pulsa Añadir y sube el ZIP.
Actívalo y pulsa Reconstruir.

Requisitos: FacturaScripts 2025/2026 o superior y PHP 8.1+ con la extensión zip habilitada. No crea tablas ni modifica el núcleo: solo añade extensiones de controlador y recursos (assets).

2. Configuración inicial

No requiere configuración. Tras reconstruir, el botón aparece automáticamente en los listados de documentos. El registro es dinámico: la extensión se aplica al listado de la petición actual siempre que su modelo sea un documento de negocio (BusinessDocument), por lo que el botón está disponible incluso en listados de documentos de otros plugins o de versiones futuras, sin necesidad de configurarlo.

3. Dónde aparece el botón

Ruta de menú: el botón Descargar ZIP se muestra junto a los botones de gestión (arriba, con las opciones del listado) en cualquier lista de documentos, por ejemplo:

Ventas → Facturas (Facturas de cliente) y también Presupuestos, Pedidos y Albaranes de cliente.
Compras → Facturas (Facturas de proveedor) y sus Presupuestos, Pedidos y Albaranes.
Cualquier otro listado cuyo modelo sea un documento de negocio.

4. Cómo descargar los documentos en ZIP

Entra en el listado de documentos que quieras exportar (por ejemplo, Ventas → Facturas).
Opcional: aplica los filtros y la búsqueda que necesites para acotar los documentos.
Elige qué se incluye en el ZIP:
- Con documentos marcados: activa las casillas (checkbox) de las filas que quieras. El ZIP incluirá solo los PDF de los documentos seleccionados.
- Sin ninguno marcado: el ZIP incluirá los PDF de todos los documentos del listado, respetando los filtros aplicados y recorriendo todas las páginas.
Pulsa Descargar ZIP. Se abre una ventana flotante con una barra de progreso que informa del avance.
Al terminar, el archivo ZIP se descarga automáticamente. Cada PDF del interior es idéntico al que genera el botón "Imprimir" de FacturaScripts.

5. Cómo funciona por dentro

Procesamiento por lotes: los documentos se generan en tandas (20 por petición) para soportar grandes volúmenes sin agotar la memoria ni el tiempo de ejecución del servidor.
Acciones internas sobre el propio listado: dgzip-init (inicia el trabajo), dgzip-chunk (procesa cada lote) y dgzip-download (entrega el ZIP final).
Archivos temporales: se guardan en MyFiles/DescargarDocsZIP/<token>/, quedan asociados al usuario que lanza el trabajo y se eliminan tras la descarga.
Multiidioma: disponible en español, inglés, catalán, francés, alemán, italiano, portugués, euskera y gallego.

Preguntas frecuentes

No veo el botón Descargar ZIP. Ve a Administrador → Plugins y pulsa Reconstruir. El botón solo aparece en listados cuyo contenido son documentos de negocio (facturas, presupuestos, pedidos, albaranes).
La descarga falla o no se genera el ZIP. Comprueba que el servidor tiene habilitada la extensión PHP zip. Sin ella el plugin registra un error y no puede comprimir.
He marcado solo unas facturas pero se descargan todas. Revisa que las casillas quedaron activas: si no hay ninguna marcada, el plugin exporta todo el listado filtrado.
Tengo miles de documentos, ¿se descargan todos? Sí. El proceso trabaja por lotes y recorre todas las páginas del listado respetando los filtros; espera a que la barra de progreso llegue al final.

Soporte: soporte@adelantia.com