dfproforma — Generación automática de facturas proforma
Genere automáticamente facturas proforma en PDF en PrestaShop 8 según los estados de pedido, con adjunto por correo, descarga del cliente y gestión completa en el back office.
Presentación
dfproforma automatiza la generación de facturas proforma en PrestaShop 8. En cuanto un pedido alcanza un estado configurado, el módulo crea un PDF personalizado (logo, numeración, pie de página multilingüe) y lo pone a disposición del cliente desde su cuenta. La generación manual desde la ficha de pedido siempre está disponible independientemente del estado del pedido.
Instalación
- En el back office de PrestaShop, ir a Módulos > Gestor de módulos.
- Hacer clic en Subir un módulo y seleccionar el archivo
dfproforma.zip. - Hacer clic en Instalar. Las tablas SQL se crean automáticamente.
- El módulo aparece en la lista como Proforma Invoice Generator.
Configuración general
Accede a la configuración desde Módulos > Gestor de módulos > dfproforma > Configurar.
Estados desencadenantes
Marca los estados de pedido que deben desencadenar la generación automática de la proforma. En cuanto un pedido pasa a uno de estos estados, el PDF se crea y almacena en el servidor.
Logo del PDF
Sube un logo específico para las facturas proforma (formatos aceptados: PNG, JPG). Si este campo se deja vacío, se usa por defecto el logo de la tienda.
Adjunto por correo
Activa la opción Adjuntar la proforma a los correos de confirmación para que el PDF se adjunte automáticamente a los correos de pedido (order_conf, bankwire, cheque, payment).
Numeración de las proformas
La numeración es configurable por idioma instalado. Para cada idioma:
- Prefijo: texto añadido antes del número (ej.
PROFORMA,PRO). - Número de inicio: entero desde el que comienza el contador (ej.
1o1000). - Número de dígitos: longitud del contador con ceros de relleno (ej.
6→000001).
Ejemplo: prefijo PROFORMA, inicio 1, 6 dígitos → primera proforma numerada PROFORMA-000001.
proforma_number + id_shop garantiza la unicidad sin duplicados entre tiendas.
Pie de página del PDF
Introduce el texto del pie de página para cada idioma activo. Este texto aparece al pie de cada proforma generada en el idioma correspondiente.
Generación manual desde el back office
En cada ficha de pedido, aparece una tarjeta Factura proforma en el panel lateral:
- Si existe una proforma: enlace de descarga directa del PDF.
- Si no existe ninguna proforma: botón Generar la proforma para crearla inmediatamente, independientemente del estado del pedido.
Descarga del cliente
Los clientes acceden a sus proformas desde su cuenta:
- Página de detalle de pedido: aparece un botón Descargar la proforma directamente bajo la información del pedido.
- Historial de pedidos: los enlaces de proforma se integran mediante JavaScript sin solicitud AJAX adicional (añadido en v1.0.2).
El acceso está protegido por la clave segura del pedido (secure_key) — un cliente solo puede descargar sus propias proformas.
Estructura del PDF
Cada proforma generada contiene:
- Número de proforma (según la numeración configurada)
- Fecha de generación
- Logo de la tienda (o logo personalizado)
- Datos de contacto de la tienda y del comprador
- Tabla de productos con cantidades y precios unitarios (sin y con IVA)
- Totales (sin IVA, IVA, con IVA, gastos de envío)
- Pie de página personalizado en el idioma del pedido
Multitienda
dfproforma es compatible de forma nativa con el modo multitienda de PrestaShop 8:
- La configuración (estados, logo, numeración, pie de página) es independiente por tienda.
- Los archivos PDF se almacenan en una carpeta separada por tienda.
- La numeración es única por combinación número + tienda.
Desinstalación
La desinstalación elimina la tabla SQL df_proforma y todas las claves de configuración con el prefijo DFPROFORMA_. Los archivos PDF ya generados se conservan en el servidor.
Changelog
- v1.0.2 — Integración en el historial de pedidos mediante el hook
actionFrontControllerSetMedia; los enlaces se muestran sin solicitud AJAX adicional. - v1.0.1 — Correcciones menores de estabilidad.
- v1.0.0 — Versión inicial: generación por estado, PDF personalizable, adjunto por correo, descarga del cliente.