Grandoc at 13:35, 28 July 2026

2026-07-28T13:35:29Z

@@ Line 1: / Line 1: @@
 =Índice=
 [[Category:Módulos complementarios]]
 {{TemplateDocDev}}
 {{TemplateDocUtil}}
@@ Line 226: / Line 225: @@
 ''[[#Índice|⬆ Volver al índice]]''

Grandoc: Created page with "=Índice= Category:Módulos complementarios Category:Ultimateinvoice {{TemplateDocDev}} {{TemplateDocUtil}} =Información= {{TemplateModuleInfo |modulename=UltimateInv..."

2026-07-28T13:19:40Z

Created page with "=Índice= Category:Módulos complementarios Category:Ultimateinvoice {{TemplateDocDev}} {{TemplateDocUtil}} =Información= {{TemplateModuleInfo |modulename=UltimateInv..."

New page

=Índice=
[[Category:Módulos complementarios]]
[[Category:Ultimateinvoice]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Información=
{{TemplateModuleInfo
|modulename=UltimateInvoice
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateinvoice}}
|status=stable
|prerequisites=Módulo ''Facturas'' activado - PHP 7.4 mínimo
|minversion=23.0.x - 24.0.x
|note=
''[[#Índice|⬆ Volver al índice]]''
}}

=Funcionalidades=
UltimateInvoice sustituye la plantilla PDF nativa de Dolibarr para las '''facturas''' por una plantilla totalmente personalizable, denominada '''<code>ultimate_invoice</code>'''. 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 [[Module_Ultimatepdf_EN|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 <code>ULTIMATE_DESIGN</code>), 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.

{| class="wikitable"
! 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 : '''<code>.pem</code>, <code>.crt</code>, <code>.p12</code>, <code>.pfx</code>'''. 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 [[Module_Milestone_EN|Milestone]] (<code>product_type = 9</code>) : 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.

''[[#Índice|⬆ 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 :

<code>unzip module_ultimateinvoice-X.0.0.zip</code>

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

<code>htdocs/custom/ultimateinvoice</code>

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

''[[#Índice|⬆ 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 <code>ultimateinvoice -> config</code> : solo los usuarios que dispongan de él (habitualmente los administradores) pueden acceder. El resto de usuarios simplemente ve la plantilla <code>ultimate_invoice</code> 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.

[[File:slide_01_invoice.png|800px]]

- 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.

[[File:slide_02_invoice.png|800px]]

- 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.

[[File:slide_03_invoice.png|800px]]

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 (<code>.pem</code>, <code>.crt</code>, <code>.p12</code> o <code>.pfx</code>) 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 :

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

<code>cat signature.crt signature.key > signature.pem</code>

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...).

[[File:slide_04_invoice.png|800px]]

==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.

[[File:slide_05_invoice.png|800px]]

''[[#Índice|⬆ Volver al índice]]''

=Utilización=

- Abra la ficha de la '''factura''' y, en el bloque '''Documentos''' de la parte inferior, elija la plantilla '''<code>ultimate_invoice</code>''' 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==

{| class="wikitable"
! Síntoma !! Causa probable
|-
| La plantilla <code>ultimate_invoice</code> 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 <code>SwissQr*</code> 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.

''[[#Índice|⬆ Volver al índice]]''

Module UltimateInvoice ES - Revision history

Grandoc at 13:35, 28 July 2026

Grandoc: Created page with "=Índice= Category:Módulos complementarios Category:Ultimateinvoice {{TemplateDocDev}} {{TemplateDocUtil}} =Información= {{TemplateModuleInfo |modulename=UltimateInv..."