UltimateInvoice v24.0

📌 Versión del módulo: 24.0.2 📅 Última actualización: 28/07/2026 👤 Editor/Licencia: Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Idiomas de la interfaz: 📧 Soporte: por correo electrónico en contact@atoo-net.com ✅ Compatibilidad Dolibarr: Dolibarr 23.0 y 24.0 ✅ Módulo necesario: Facturas ✅ Versión de PHP necesaria: PHP 7.4 o superior 💡 Actualizaciones gratuitas durante 1 año dentro de la misma versión, y después un 50 % de descuento sobre la versión siguiente.

Dé a sus facturas de Dolibarr la imagen de su empresa con UltimateInvoice

El módulo 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 archivos PDF, añadir códigos de barras y códigos QR, y firmar digitalmente el archivo generado.

No hace falta programar: todo se configura desde las páginas de administración del módulo, con vistas previas gráficas y tiradores para ajustar los anchos con el ratón.

UltimateInvoice es la versión reducida del módulo UltimatePDF: solo cubre las facturas. Para presupuestos, pedidos, contratos, expediciones, informes de gastos, intervenciones, proyectos, productos/escandallos o documentos de proveedor se necesita la versión completa UltimatePDF.

🎨 Qué puede personalizar

🧩 Dos niveles de configuración que no hay que confundir

El módulo se articula en torno a dos nociones distintas:

1. El Diseño (pestaña Models) define qué aspecto tiene el documento: colores, márgenes, logotipo, alias de empresa, fondo de página, anchos de columna.

2. Las páginas Opciones y Facturas deciden qué se imprime en el documento: columnas visibles, bloques de direcciones, menciones legales, firmas impresas.

Pueden coexistir varios Diseños. Solo uno está activo por defecto, y un selector situado en la parte superior derecha de la aplicación permite cambiar de uno a otro al instante, sin pasar de nuevo por la configuración.

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

🖌️ Personalización gráfica (Diseños)

• Fondo de página: imagen de fondo o PDF de fondo, para reutilizar un papel con membrete ya maquetado, con ajuste de transparencia y posición X/Y.

• Encabezado: alto y ancho del logotipo, segundo logotipo para un socio o una certificación, ancho del bloque del remitente con vista previa de arrastrar y soltar y preajuste para sobres con ventana según la norma postal francesa.

• Alias de empresa: muestre una razón social, una dirección, un capital social o un NIF/IVA distintos de los de la entidad jurídica real, 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), redimensionables con el ratón sobre una vista previa gráfica.

• Pie de página: tamaño de la tipografía, altura reservada al texto libre, colores del texto y del fondo.

• Tipografía: elección de la fuente del documento, con DejaVuSans para juegos de caracteres ampliados o cirílicos.

📄 Contenido de la factura

Las opciones se activan de forma independiente entre sí, mediante simples casillas de verificación:

• Columnas de las líneas: numeración, foto del producto, precio unitario sin impuestos, 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, NIF/IVA intracomunitario, apilado vertical de los bloques de contactos.

• 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 pendiente del cliente, importe en letra, línea de total con impuestos, generación sin la 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 condiciones generales de venta

🔏 Firma electrónica de las facturas (PAdES)

UltimateInvoice puede aplicar una firma digital al PDF en el momento de generarlo. Garantiza al destinatario la autenticidad del documento (procede realmente de usted) y su integridad (no ha sido modificado desde entonces). 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.

Esta funcionalidad se describe aquí sin ambigüedad, para que su alcance quede claro antes de la compra:

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

Limitación importante: la fusión de archivos adicionales reescribe el PDF después de generarlo y rompería la firma. En una factura en la que se fusionan archivos, la firma se omite automáticamente, dejando un aviso en el registro de Dolibarr, en lugar de generarse inválida. La incorporació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 su empresa, de terceros 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.

Estos dos últimos 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 la 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. Esta página dedicada requiere PHP 8.1 o superior.

🧱 Compatibilidad con el módulo Milestone

UltimateInvoice reconoce las líneas de hitos del módulo Milestone: no se tratan como líneas de producto corrientes 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.

Detalla cada opción pantalla por pantalla, con un mismo hilo conductor de principio a fin: creación de un Diseño, ajuste de las opciones, generación de una factura. Se actualiza con cada versión.

⚙️ Requisitos

⚙️ Instalación

1. Descargue el archivo comprimido del módulo (.zip).

2. Coloque el archivo en el directorio raíz de Dolibarr.

3. Descomprima el archivo y compruebe que el módulo se encuentra en htdocs/custom/ultimateinvoice.

4. Active el módulo desde Inicio → Configuración → Módulos, pestaña Atoo-Net.

5. Seleccione la plantilla ultimate_invoice en la lista desplegable Plantilla documento de la ficha de la factura.

🧭 Casos de uso habituales

• Alinear las facturas con su identidad corporativa: reutilizar colores, logotipo y papel con membrete existentes sin encargar el desarrollo de una plantilla PDF a medida.

• Facturar bajo una marca comercial: utilizar el alias de empresa para mostrar una razón social o una dirección distintas de las de la entidad jurídica.

• Enviar las facturas por correo postal: utilizar el preajuste de sobre con ventana y la marca de plegado para un envío sin ajustes manuales.

• Adjuntar siempre sus CGV: añadir automáticamente el mismo documento contractual a cada factura.

• Facilitar el pago: añadir un código QR de pago SEPA, o el recibo de pago suizo para una clientela helvética.

• Dar confianza sobre el origen del documento: firmar digitalmente las facturas enviadas por correo electrónico para que el destinatario pueda comprobar que no han sido modificadas.

❓ Preguntas frecuentes

• ¿Cuál es la diferencia con el módulo UltimatePDF?
  UltimateInvoice es la versión reducida de UltimatePDF, limitada a las facturas. Si también necesita personalizar presupuestos, pedidos, contratos, expediciones, informes de gastos, intervenciones o documentos de proveedor, la elección correcta es UltimatePDF.

• ¿El módulo modifica el núcleo de Dolibarr?
  No. UltimateInvoice añade una plantilla de documento adicional y se apoya en los hooks estándar. La plantilla PDF nativa sigue disponible: puede volver atrás en cualquier momento seleccionándola de nuevo en la ficha de la factura.

• ¿Puedo tener varias maquetaciones distintas?
  Sí. Cree tantos Diseños como necesite. Solo uno está activo por defecto, y un selector en la parte superior derecha de la aplicación permite pasar de uno a otro.

• ¿Se requieren conocimientos técnicos?
  No. Toda la configuración se realiza desde las pantallas de administración, con vistas previas gráficas. No hay que modificar ningún archivo.

• ¿La firma electrónica tiene valor legal?
  Se trata de una firma básica de tipo PAdES-B-B: acredita la integridad y el origen del archivo, pero no tiene el valor probatorio de una firma cualificada eIDAS y no incluye ni sellado de tiempo cualificado ni archivado a largo plazo.

• ¿La firma electrónica sustituye a Facturae o a Factur-X?
  No. Son dos temas distintos. La firma garantiza la integridad de un PDF; la facturación electrónica exige un formato estructurado (Facturae, Factur-X, PDF/A-3) que UltimateInvoice no genera.

• ¿Dónde se almacena la contraseña de la clave privada?
  En la tabla de constantes de Dolibarr (llx_const), en claro, ya que Dolibarr no dispone de un almacén de secretos nativo. Restrinja el acceso a la base de datos en consecuencia. El archivo de certificado se sitúa fuera de la carpeta web del módulo, pero sigue siendo legible por el servidor web: aplique permisos estrictos a ese directorio.

• ¿Por qué mi factura no está firmada?
  El caso más frecuente es la fusión de archivos adicionales en esa factura: ambas funciones se excluyen entre sí, y la firma se omite deliberadamente, con un aviso en el registro de Dolibarr.

• ¿El código QR de pago lo genera el módulo?
  El código QR SEPA y la factura QR suiza son ajustes del núcleo de Dolibarr, en Configuración → PDF → Parámetros específicos. UltimateInvoice los respeta al generar el documento.

• ¿Es compatible con los hitos del módulo Milestone?
  Sí. Las líneas de hitos se reconocen y conservan su propio formato en el PDF.

• ¿Se modifican mis facturas anteriores?
  No. Solo los documentos regenerados tras seleccionar la plantilla utilizan la nueva maquetación. Los PDF ya emitidos permanecen intactos.

¿Por qué utilizar UltimateInvoice?

• Obtener facturas con su imagen sin encargar el desarrollo de una plantilla PDF a medida

• Ajustar la maquetación desde pantallas de administración, con vistas previas y redimensionado con el ratón

• Crear varios Diseños y cambiar de uno a otro con un clic

• Reutilizar un papel con membrete existente como fondo de página, en imagen o en PDF

• Facturar bajo una marca comercial gracias al alias de empresa

• Elegir con precisión qué columnas y qué bloques se imprimen en el documento

• Adjuntar automáticamente sus CGV y otros archivos PDF

• Añadir códigos de barras, códigos QR, código QR SEPA y factura QR suiza

• Firmar digitalmente las facturas enviadas por correo electrónico

• Mantener disponible en todo momento la plantilla nativa de Dolibarr

⚠️ Recomendación importante

Como con cualquier módulo que modifique el aspecto de los documentos comerciales, pruebe UltimateInvoice en una instancia de pruebas antes de utilizarlo en producción.

Antes de empezar, realice una copia de seguridad completa de:

• La base de datos de Dolibarr

• El directorio de documentos de Dolibarr

Una vez configurado, genere una factura corta y otra larga de varias páginas, y compruebe los bloques de direcciones, los totales, el pie de página y la ausencia de páginas en blanco antes de generalizar la plantilla.

📖 Documentación

La documentación completa del módulo está disponible en el wiki oficial de Dolibarr:

👉 Wiki Dolibarr – Módulo UltimateInvoice (ES)

Documentación en otros idiomas:

👉 Wiki Dolibarr – Módulo UltimateInvoice (FR)

👉 Wiki Dolibarr – Módulo UltimateInvoice (EN)

👉 Wiki Dolibarr – Módulo UltimateInvoice (DE)

👉 Wiki Dolibarr – Módulo UltimateInvoice (IT)

El módulo incorpora además una guía de uso completa, en la pestaña User guide de su página de configuración.

Más módulos