Module UltimateInvoice ES

Índice

Información

Module name	UltimateInvoice
Editor / Editeur
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Módulo Facturas activado - PHP 7.4 mínimo Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2026-07-28
Note / Nota	⬆ Volver al índice

Funcionalidades

UltimateInvoice sustituye la plantilla PDF nativa de Dolibarr para las facturas por una plantilla totalmente personalizable, denominada ultimate_invoice. Auténtica navaja suiza de la factura PDF, permite definir su identidad gráfica (logotipo, colores, márgenes, fondo de página, anchos de columna), decidir con precisión qué se imprime en el documento, adjuntar sus CGV u otros PDF, añadir códigos de barras y códigos QR, y firmar digitalmente el archivo generado.

UltimateInvoice es la edición ligera del módulo UltimatePDF: cubre únicamente las facturas. Para presupuestos, pedidos, contratos, expediciones, informes de gastos, intervenciones, proyectos, productos/LdM o documentos de proveedor, se necesita la edición completa UltimatePDF.

Dos niveles de configuración

El módulo se articula en torno a dos nociones que no deben confundirse :

El Diseño (pestaña Models) define qué aspecto tiene el documento : colores, márgenes, logotipo, alias de empresa, fondo de página, ancho de las columnas. Pueden coexistir varios Diseños, solo uno está activo por defecto (constante ULTIMATE_DESIGN), y un selector en la parte superior derecha de la aplicación permite cambiarlo al instante.
Las páginas Opciones y Facturas deciden qué se muestra en el documento : columnas visibles, bloques de direcciones, menciones legales, firmas impresas, etc. No afectan a la presentación gráfica.

Personalización gráfica (Diseños)

Fondo de página : imagen de fondo o PDF de fondo (papel con membrete ya maquetado), con transparencia y posicionamiento X/Y.
Encabezado : alto y ancho del logotipo, segundo logotipo (colaborador, certificación), ancho del bloque del remitente con vista previa arrastrar y soltar y preajuste sobre con ventanilla según norma postal francesa.
Alias de empresa : permite imprimir en el documento una razón social, una dirección, un capital social o un NIF/IVA distintos de los de la entidad jurídica real — útil para una marca comercial o una filial.
Márgenes y columnas : márgenes del PDF y ancho de cada columna de la tabla de líneas (referencia, imagen, fecha, tipo, proyecto, IVA, precio unitario, cantidad, unidad, descuento), cada una redimensionable con el ratón sobre una vista previa gráfica.
Pie de página : tamaño de fuente, altura reservada al texto libre, colores del texto y del fondo.
Fuente : elección de la fuente del documento (DejaVuSans para juegos de caracteres extendidos o cirílicos).

Cada bloque del formulario dispone de su propio botón Grabar : usted valida bloque a bloque sin perder lo introducido en los demás.

Contenido de la factura

Columnas de líneas : numeración, foto del producto, precio unitario sin IVA, descuento, precio unitario tras descuento, cantidad, peso y peso total, unidad.
Bloques de direcciones : datos del destinatario, del cliente y del comercial asignado, identificadores profesionales (CIF/NIF, registro mercantil...), NIF-IVA intracomunitario, apilado vertical de los bloques de contacto.
Maquetación : encabezado no repetido en cada página, marca de plegado, texto junto a la fecha, formato de papel.
Específico de facturas : expediciones vinculadas, condiciones de pago, factura de situación (certificación de obra), enlace de pago en línea, riesgo/saldo pendiente del cliente, importe en letras, línea de total con IVA, generación sin columna de IVA.
Firmas impresas : firma del responsable en el documento y firma del comercial asignado en la nota. Son imágenes añadidas al PDF, que no deben confundirse con la firma criptográfica descrita más abajo.

Fusión de PDF y CGV

CGV : un archivo PDF con las condiciones generales de venta se sube desde la página Opciones y se añade a continuación de la factura, con posibilidad de preselección por defecto.
Archivos adicionales : tras activar la opción correspondiente en la página Facturas, uno o varios PDF cualesquiera pueden fusionarse con el documento directamente desde la ficha de la factura.

Firma electrónica de las facturas (PAdES)

UltimateInvoice puede aplicar una firma digital al PDF en el momento de generarlo. Esta firma garantiza al destinatario la autenticidad (el documento procede realmente de usted) y la integridad (no ha sido modificado desde su generación). Adobe Acrobat Reader la muestra en su panel Firmas, y se dibuja un recuadro de firma visible en la parte inferior derecha de la última página.

Aspecto	Detalle
Lo que hace la funcionalidad	Firma criptográfica PKCS#7 separada, equivalente a PAdES-B-B, integrada de forma nativa en el PDF, con recuadro visible y pulsable
Lo que no hace	Sin sello de tiempo cualificado (RFC 3161), sin LTV/archivado a largo plazo, sin valor probatorio cualificado eIDAS
Lo que no sustituye	Ni la facturación electrónica (Factur-X / Facturae, PDF/A-3), ni una firma cualificada emitida por un prestador de servicios de confianza

Formatos de certificado admitidos : .pem, .crt, .p12, .pfx. El archivo debe contener el certificado y la clave privada. Se almacena en el directorio documents de Dolibarr, fuera de la carpeta web del módulo : por tanto no puede descargarse desde un navegador.

Limitación importante : la fusión de archivos adicionales reescribe el PDF después de generarlo, lo que rompería la firma. En una factura con archivos fusionados, la firma se omite automáticamente (se escribe un aviso en el registro de Dolibarr) en lugar de generarse inválida. La fusión de las CGV, en cambio, sigue siendo compatible.

Códigos de barras, códigos QR y factura QR suiza

Códigos de barras de productos (EAN13 con dígito de control, CODE128, CODE39) y de terceros, en la parte superior o inferior de la página.
Códigos QR de la empresa (MyCompany), del tercero o de la factura.
Código QR de pago SEPA (norma EPC069-12) y factura QR suiza (Swiss QR-bill), incluido el recibo de pago completo en una página dedicada. Atención : ambos ajustes pertenecen al núcleo de Dolibarr (Inicio - Configuración - PDF - pestaña Parámetros específicos, sección Facturas) y no al módulo, que se limita a respetarlos al generar el documento.

Para el recibo de pago suizo completo, la forma de pago debe ser transferencia bancaria, debe haber una cuenta bancaria indicada en la factura, la dirección de su empresa debe estar completa y el IBAN ser válido (los QR-IBAN aún no están soportados). El recuadro de firma electrónica se dibuja deliberadamente en la última página de la factura, antes de añadir el recibo, cuya maquetación es normativa.

Compatibilidad con el módulo Milestone

UltimateInvoice reconoce las líneas de hito del módulo Milestone (product_type = 9) : no se tratan como líneas de producto normales en el cálculo del peso de línea y del precio unitario tras descuento, y conservan su propio formato en el PDF.

Guía de uso integrada

Una guía completa, en francés y en inglés, puede consultarse directamente desde la configuración del módulo, pestaña User guide. Se actualiza en cada versión y detalla todas las opciones.

⬆ Volver al índice

Requisitos previos

Dolibarr : Versiones soportadas :

23.x
24.x

PHP : versión 7.4 como mínimo. El recibo de pago suizo completo en página dedicada requiere PHP 8.1 o superior.

Módulos Dolibarr : el módulo Facturas debe estar activado.

⚙️ Procedimiento de instalación

⚙️ Instalación manual

Descargar el archivo comprimido del módulo (.zip).
Colocar el archivo en el directorio raíz de Dolibarr.
Descomprimir el archivo zip con el comando :

unzip module_ultimateinvoice-X.0.0.zip

Comprobar que la ubicación correcta del módulo es :

htdocs/custom/ultimateinvoice

El módulo ya está disponible y puede activarse desde Dolibarr.

⬆ Volver al índice

Configuración

Para utilizar este módulo, primero debe activarlo. Para ello, tras conectarse con una cuenta de administrador, vaya a la página "Inicio - Configuración - Módulos". El módulo aparece en la pestaña "Atoo-Net", haga clic en "Activar". Al final de la línea del módulo aparece un icono ; haga clic en él para acceder a las páginas de configuración propias del módulo.

Todas las páginas de administración del módulo están protegidas por el permiso ultimateinvoice -> config : solo los usuarios que dispongan de él (habitualmente los administradores) pueden acceder. El resto de usuarios simplemente ve la plantilla ultimate_invoice en la lista desplegable "Plantilla documento" de la ficha de la factura.

La configuración consta de cinco pestañas : Models (plantillas), Opciones, Facturas, User guide (guía de uso) y Acerca de.

Pestaña Models (Diseños)

Aquí se crea la presentación gráfica común a todos sus documentos.

- La lista muestra todos los Diseños existentes : etiqueta, descripción, tipo de borde, colores, estado y distintivo "Por defecto" para el que se está utilizando.

- Haga clic en Añadir un diseño para crear uno nuevo, o en el lápiz para modificar un diseño existente.

- Rellene bloque a bloque : información de la plantilla y fuente, fondo de página, encabezado y logotipos, alias de empresa, bloque central, márgenes y anchos de columna, pie de página. Cada bloque dispone de su propio botón Grabar.

- Un Diseño desactivado deja de aparecer en las listas de selección. La "Plantilla maestra" y el Diseño por defecto no pueden eliminarse, para no romper nunca la generación de documentos.

Importante : tras modificar un Diseño, si el documento generado no parece haber cambiado, compruebe que ese Diseño es el que lleva el distintivo "Por defecto".

Pestaña Opciones (ajustes globales)

Estos ajustes se aplican a todos los documentos, sea cual sea el Diseño elegido : logotipos, bloques de direcciones e identificadores profesionales, fondo de página, contenido de las líneas, CGV, datos bancarios, certificado de firma, formato de papel.

La mayoría de los ajustes son interruptores de encendido/apagado que se aplican de inmediato ; el formato de papel y los identificadores profesionales se validan con un botón Grabar específico.

Subida de las CGV

En el bloque correspondiente, seleccione su archivo PDF de condiciones generales de venta y envíelo. Aparecerá después en una lista desplegable junto al botón Generar de la ficha de la factura, y puede preseleccionarse por defecto.

Puesta en marcha de la firma electrónica

En el bloque Certificado de firma, al final de la página Opciones :

Suba su archivo de certificado (.pem, .crt, .p12 o .pfx) que contenga el certificado y la clave privada.
Indique el motivo de la firma (texto libre visible en las propiedades de firma del PDF, por ejemplo "Factura certificada conforme").
Indique la contraseña de la clave privada si está protegida, y grabe.
Active el interruptor "Firmar electrónicamente el PDF de la factura".
Genere una factura y ábrala en Acrobat Reader : el panel Firmas debe mostrar la firma y el recuadro visible aparece en la parte inferior derecha de la última página.

Solo se tiene en cuenta un certificado a la vez : elimine el anterior antes de subir uno nuevo.

Para probar, basta con un certificado autofirmado :

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout signature.key -out signature.crt

cat signature.crt signature.key > signature.pem

Acrobat mostrará entonces la firma como "presente pero no fiable" : es normal, ya que la autoridad no está reconocida. En producción, utilice un certificado emitido por una autoridad de certificación.

A tener en cuenta antes de desplegar : la contraseña de la clave privada se almacena en texto claro en la tabla de constantes de Dolibarr, al no existir un almacén de secretos nativo. Restrinja en consecuencia el acceso a la base de datos y a las copias de seguridad, y aplique permisos de archivo estrictos sobre el directorio donde se guarda el certificado.

Pestaña Facturas

Esta página reúne los ajustes propios del contenido de la factura : direcciones, códigos de barras y códigos QR, proyecto vinculado, encabezado y maquetación, columnas de líneas, firmas impresas, fusión de PDF y ajustes específicos de las facturas (expediciones vinculadas, factura de situación, enlace de pago en línea, saldo pendiente del cliente, importe en letras...).

Pestaña User guide (guía de uso)

Muestra la guía completa del módulo en el idioma de la interfaz (francés o inglés). Es la documentación de referencia, más detallada que esta página.

⬆ Volver al índice

Utilización

- Abra la ficha de la factura y, en el bloque Documentos de la parte inferior, elija la plantilla ultimate_invoice en la lista desplegable "Plantilla documento" y haga clic en Generar.

- El PDF aparece en la lista de archivos adjuntos : puede descargarse, previsualizarse o enviarse por correo electrónico.

- Cambiar de Diseño rápidamente : utilice el selector específico del menú superior derecho de la aplicación, sin volver a la configuración completa.

- Añadir las CGV : seleccione el archivo de CGV en la lista desplegable situada junto al botón Generar.

- Fusionar un PDF adicional : tras activar la opción en la página Facturas, seleccione el o los archivos a fusionar desde la ficha de la factura. En esas facturas, la firma electrónica se omite automáticamente.

Resolución de problemas

Síntoma	Causa probable
La plantilla `ultimate_invoice` no aparece en la lista	El módulo UltimateInvoice o el módulo Facturas no está activado
El documento no refleja los cambios de un Diseño	Ese Diseño no es el que lleva el distintivo "Por defecto"
Ninguna firma ni recuadro visible en el PDF	Ningún certificado subido, o extensión no reconocida
Registro : skipped: additional files merging is active	Se están fusionando archivos adicionales en esa factura, ambas funciones se excluyen
Acrobat muestra "firma no válida"	Certificado autofirmado : normal en pruebas, use un certificado de una autoridad reconocida en producción
Registro : Error getting private key	Falta la contraseña de la clave privada o es incorrecta, o el archivo no contiene la clave privada
El recibo de pago suizo no aparece	Consulte los mensajes `SwissQr*` en el registro de Dolibarr : forma de pago distinta de la transferencia, dirección o IBAN no conformes, QR-IBAN no soportado

El registro de Dolibarr (Inicio - Configuración - Otro - Registros) deja constancia de cada generación y de cada intento de firma.

⬆ Volver al índice

Otros idiomas

⬆ Volver al índice