DataFirefly Editor de facturas PDF para PrestaShop

Presentación

El módulo dfinvoiceeditor sustituye el diseño de las facturas PDF de PrestaShop 8 y 9 por el suyo, ajustado desde el back-office. No modifica ningún archivo .tpl ni instala overrides: cuando PrestaShop genera una factura, el módulo aporta su propia cabecera, cuerpo y pie. Al desactivar el módulo o su interruptor principal vuelve la factura original.

Los ajustes se aplican a todas las facturas que produce PrestaShop: la adjunta a los e-mails de pedido, la descargada desde la cuenta del cliente y las impresas una a una o en lote desde el back-office. De forma opcional, los albaranes adoptan la misma presentación.

Instalación

1. En Módulos > Gestor de módulos, pulse Subir un módulo y envíe el archivo dfinvoiceeditor.zip.
2. El módulo crea su tabla de ajustes, la carpeta img/dfinvoiceeditor para el logotipo y la página Pedidos > Editor de facturas.
3. Abra esa página. El diseño del módulo está activo desde la instalación con ajustes sobrios por defecto: genere una vista previa para verlo.

El editor

La página se divide en secciones listadas en la columna izquierda. Debajo, un esquema de página A4 resalta la zona de la factura que está ajustando. La barra inferior indica si hay cambios sin guardar y contiene el botón Guardar.

Los textos impresos existen en cada idioma de la tienda. Las pastillas de idioma bajo la cabecera eligen el idioma mostrado en todos los campos multiidioma.

Vista previa y comparación

Arriba de la página, elija una factura reciente de la tienda y luego Factura o Albarán:

• Vista previa abre el PDF en una pestaña nueva con los ajustes de la pantalla, aunque no estén guardados. Solo un logotipo recién subido espera al guardado.
• Comparar con la factura de PrestaShop abre el mismo documento con el diseño original.

Ajustes generales

• Usar este diseño para las facturas: el interruptor principal. Desactivado, PrestaShop vuelve a imprimir su factura, sin perder ajustes.
• Usar también este diseño para los albaranes: ver la sección Albaranes.
• Idioma de la factura: el del pedido (recomendado) o el del empleado que genera el PDF.
• Fuente: automática según el idioma, Helvetica, DejaVu Sans, Times o Courier. DejaVu Sans cubre también el polaco, el griego y el cirílico.
• Tamaño del texto de 7 a 12 pt y cuatro colores: acento (título, cabecera de la tabla, total a pagar, títulos de sección), texto, texto secundario y texto sobre el color de acento.

Cabecera y logotipo

Elija el logotipo de factura de la tienda, un logotipo propio para facturas o ninguno. El logotipo propio acepta PNG, JPG o GIF de hasta 2 MB; un PNG de al menos 600 px de ancho se imprime nítido. Ajuste su ancho de 10 a 90 mm y su posición a la izquierda o a la derecha. La altura se limita a 26 mm para que la cabecera nunca se superponga al contenido.

Direcciones y resumen

El bloque del vendedor es un texto libre con variables, por defecto {shop_name}, {shop_address} y {shop_details} (los datos de Parámetros de la tienda > Contacto). Las direcciones de facturación y de entrega usan el formato de dirección del país; la de entrega puede ocultarse cuando coincide con la de facturación. El NIF-IVA, el teléfono y el e-mail del cliente son opcionales.

La barra de resumen, una banda coloreada bajo las direcciones, muestra a elegir la referencia y fecha del pedido, el pago, el vencimiento, el transportista y el número de seguimiento, más los campos personalizados colocados en ella.

Líneas de productos

La tabla recoge las 12 columnas disponibles: imagen, referencia, nombre, EAN-13, referencia del proveedor, precio unitario sin IVA, precio unitario con IVA, descuento, tipo de IVA, cantidad, total sin IVA, total con IVA. Para cada una, marque la impresión, cambie el título en cada idioma, ajuste el ancho relativo y la alineación, y cambie el orden con las flechas. La franja superior muestra el reparto de anchos, que se ajustan para llenar la página.

• Las combinaciones («Talla: M, Color: Azul») pasan a una segunda línea más pequeña.
• Las personalizaciones introducidas por el cliente se imprimen bajo el nombre del producto.
• La miniatura del producto mide de 6 a 25 mm.
• Línea bajo cada fila, cuadrícula completa o sin bordes; filas alternas sombreadas opcionales.
• Los títulos de columna se repiten arriba de cada página en una factura larga.

Totales

• Desglose del IVA por tipo: base y cuota por tipo, con productos, envío, envoltorio de regalo y ecotasa agrupados.
• Ocultar las líneas a cero de descuento y envoltorio de regalo.
• Listar los pagos recibidos con método, importe y fecha.
• Contenido añadido por otros módulos: lo que otros módulos añaden a las facturas mediante el hook displayPDFInvoice se sigue imprimiendo, tras los totales, tras las líneas de productos, u oculto.

Pago y vencimiento

Vencimiento e importe pendiente

El plazo de pago en días tras la fecha de factura imprime la fecha de vencimiento en la barra de resumen y rellena la variable {due_date}. Deje 0 para no imprimir vencimiento.

Cuando una factura está pagada en parte, las líneas Ya pagado e Importe pendiente aparecen bajo el total con IVA. El importe pagado es la suma de los pagos vinculados a la factura en PrestaShop. El sello opcional Pagada se imprime bajo los totales cuando la factura está saldada.

Datos bancarios y código QR SEPA

Elija cuándo imprimir el bloque bancario: nunca, solo si queda un importe pendiente, o siempre. Rellene el titular (el nombre de la tienda si queda vacío), el banco, el IBAN, el BIC y el concepto, por defecto {invoice_number}. El IBAN se comprueba con sus dígitos de control: un IBAN erróneo se señala y bloquea el guardado.

El código QR SEPA (formato EPC069-12) contiene beneficiario, IBAN, BIC, importe pendiente y concepto. El cliente lo escanea con su app bancaria y la transferencia queda rellenada. Solo se imprime en facturas en euros y solo si queda un importe pendiente.

Campos personalizados

Añada tantos campos como necesite: número de pedido de compra, datos fiscales del cliente, condiciones de pago, mensaje del cliente. Cada campo tiene:

• una etiqueta y un contenido en cada idioma, con negrita, cursiva y subrayado;
• una ubicación: barra de resumen, bajo las direcciones, bajo las líneas de productos, bajo los totales o en el pie;
• la opción Imprimir en: facturas, albaranes o ambos;
• la opción Ocultar cuando sus variables están vacías;
• condiciones de impresión (ver más abajo).

El panel Variables inserta una variable en el último campo editado. Las variables cubren la tienda (nombre, dirección, e-mail, teléfono, datos), el pedido y la factura (número, fechas, vencimiento, importe pendiente, pago, transportista, seguimiento, número de albarán, moneda) y el cliente (nombre, empresa, e-mail, NIF-IVA, SIRET, APE, DNI, teléfonos, mensaje del pedido).

Menciones legales por país

Cada regla contiene un texto por idioma y unas condiciones. Todas las reglas que corresponden a la factura se imprimen, en el orden de la lista, en un recuadro bajo los totales o en el pie.

Condiciones

• Destino: todos los países, país de la tienda, Unión Europea, UE salvo el país de la tienda, fuera de la UE, o una lista de países. Haga clic en un país para seleccionarlo o quitarlo.
• Cliente: cualquiera, con o sin NIF-IVA, empresa o particular.
• Impuestos en la factura: con o sin impuestos.

El país usado para las reglas es por defecto el de la dirección que PrestaShop usa para calcular los impuestos; puede forzar la dirección de facturación o de entrega.

Reglas de ejemplo

Se instalan tres reglas inactivas: entrega intracomunitaria exenta (artículo 138 de la Directiva 2006/112/CE, con el NIF-IVA del cliente), exportación fuera de la UE (artículo 146) y condiciones de demora B2B en Francia (penalizaciones e indemnización fija de 40 EUR). Pida a su asesor que valide el texto antes de activarlas.

Pie de página

El texto del pie se imprime al final de cada página, por defecto {shop_name}, {shop_address_inline}. Limítelo a tres líneas: PrestaShop reserva poco espacio al pie, los textos largos van en un campo personalizado bajo los totales. Pueden añadirse el texto legal libre y el texto de pie de Pedidos > Facturas.

Textos

La sección Textos lista cada palabra impresa en la factura: título, número, fechas, títulos de direcciones, totales, desglose del IVA, vencimiento, datos bancarios, textos de los albaranes. Vienen rellenados en español, inglés, francés, alemán, italiano, neerlandés, polaco y portugués, y se editan en cada idioma.

Albaranes

Active Usar también este diseño para los albaranes en los ajustes generales. El albarán reutiliza logotipo, colores, direcciones, barra de resumen y líneas de productos, sin ningún precio: solo se imprimen las columnas imagen, referencia, nombre, EAN-13, referencia del proveedor y cantidad. Totales, datos bancarios, menciones legales y texto legal de factura no aparecen. La cabecera indica el número del albarán, su fecha y el número de factura.

Copia de seguridad y traspaso

Exportar los ajustes descarga un archivo JSON con todos los ajustes de la tienda, textos incluidos. Los textos se identifican por código de idioma, así que el archivo se importa en otra tienda o instalación aunque los identificadores de idioma cambien. El logotipo no se incluye. Importar sustituye todos los ajustes de la tienda actual tras confirmar.

Restablecer los ajustes por defecto, en la barra inferior, devuelve todos los ajustes y textos originales conservando el logotipo subido.

Solución de problemas

La vista previa indica que el editor no pudo tomar el control

El mensaje que sigue a esa frase da la causa, que también se registra en Parámetros avanzados > Registros/Logs. En ese caso PrestaShop produce su factura original: ninguna factura queda bloqueada.

Un empleado obtiene la factura original

PrestaShop no ejecuta los hooks de un módulo cuando el perfil del empleado conectado no tiene el permiso Ver sobre ese módulo. Concédalo en Parámetros avanzados > Equipo > Permisos > Módulos. Las facturas enviadas a los clientes y las descargadas desde su cuenta no se ven afectadas.

El pie de página se superpone al contenido

Acorte el texto del pie, pase las menciones largas a un campo personalizado bajo los totales o elija la ubicación «Enmarcadas bajo los totales» para las menciones legales.

El código QR no aparece

Compruebe que el bloque bancario está activo, que el IBAN está guardado, que la factura es en euros y que queda un importe pendiente. En modo «Siempre», una factura saldada muestra los datos bancarios sin código QR.

Los abonos conservan el diseño anterior

La versión 1.0.0 cubre facturas y albaranes. Los abonos conservan el diseño de PrestaShop.