Module UltimatePropale ES

Índice

Retour index
Documentation développeur

Retour index
Documentation Utilisateur

Información

Module name	UltimatePropale
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 Presupuestos activado - PHP 8.2 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-10-7
Note / Nota	⬆ Volver al índice

Funcionalidades

UltimatePropale sustituye el modelo PDF nativo de los presupuestos (propuestas comerciales) de Dolibarr por un modelo totalmente personalizable: ultimatepropale_propal. Permite definir su identidad gráfica (logotipo, colores, márgenes, fondo de página, anchos de columna), elegir con precisión lo que se muestra en el presupuesto, adjuntar sus condiciones generales de venta (CGV) o PDF anexos, añadir códigos de barras y códigos QR, y hacer que su cliente firme el presupuesto en línea.

UltimatePropale es la edición del módulo UltimatePDF dedicada a los presupuestos. Para pedidos y facturas, consulte UltimatepdfLight o UltimateInvoice. Para contratos, envíos, albaranes, notas de gastos, intervenciones, proyectos, productos/listas de materiales o documentos de proveedores, se necesita la versió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 Modelos) define qué aspecto tiene el presupuesto: colores, márgenes, logotipo, alias de empresa, fondo de página, anchos de columna. 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 cambiar de uno a otro al instante.
• Las páginas Opciones y Presupuestos deciden qué se imprime en el presupuesto: columnas visibles, bloques de dirección, menciones legales, bloque de conformidad, firmas impresas, etc. No modifican el aspecto gráfico.

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: altura y anchura del logotipo, segundo logotipo (socio, certificación), anchura del bloque del remitente con vista previa de arrastrar y soltar y ajuste predefinido sobre con ventana según la norma postal francesa.
• Alias de empresa: muestra en el presupuesto una razón social, una dirección, un capital o un número de IVA distintos de la entidad jurídica real — útil para una marca comercial o una filial.
• Iconos vectoriales: los iconos de teléfono, móvil, fax, correo electrónico y sitio web de los bloques de dirección son iconos Font Awesome, nítidos con cualquier nivel de zoom, con un color ajustable por Diseño.
• Márgenes y columnas: márgenes del PDF y anchura de cada columna de la tabla de líneas (referencia, imagen, IVA, precio unitario, cantidad, unidad, descuento), cada una redimensionable con el ratón en 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).
• Exportación / importación: cada Diseño se exporta a un archivo JSON y se importa en el mismo Dolibarr o en otro, incluido un Diseño exportado desde UltimatePDF, UltimatepdfLight o UltimateInvoice. El Diseño importado se crea desactivado y se renombra si su etiqueta ya existe.
• Vista previa PDF real: un botón del formulario genera el PDF del presupuesto más reciente con los ajustes que se están introduciendo, sin guardarlos.

Cada bloque del formulario tiene su propio botón Guardar: valida bloque a bloque sin perder lo introducido en los demás. Los bloques se pliegan en acordeón.

Contenido del presupuesto

• Líneas: numeración, foto del producto, precio unitario sin IVA, descuento, precio unitario tras descuento, cantidad, peso y peso total, unidad, guiones entre líneas, descripción oculta por defecto.
• Encabezado y direcciones: datos del destinatario y del cliente, identificadores profesionales (SIRET...), número de IVA intracomunitario, proyecto vinculado, objetos vinculados, encabezado no repetido, texto asociado a la fecha, marca de plegado.
• Comercial: mención «Asunto gestionado por» con el nombre y el correo electrónico del comercial interno que sigue el presupuesto.
• Específico de los presupuestos: gestión de versiones, páginas de presentación adicionales antes del presupuesto, mención de inversión del sujeto pasivo (subcontratación en la construcción), ocultación de la fecha del presupuesto, la fecha de entrega o las referencias del cliente.
• Firma: bloque de conformidad, zona de firma del cliente en línea rellenada desde la página pública de firma de Dolibarr, firma del responsable y del comercial (imágenes).

Fusión de PDF y CGV

• CGV: se carga un archivo de condiciones generales de venta desde la página Opciones y se añade a continuación del presupuesto, con preselección por defecto opcional. Las CGV se añaden en cada generación, incluida la regeneración automática al validar y las acciones masivas.
• Archivos adicionales: tras activar la opción en la página Presupuestos, se pueden fusionar uno o varios PDF cualesquiera con el presupuesto desde su ficha, con renumeración de páginas opcional.
• PDF de productos: las fichas técnicas PDF de los productos pueden añadirse automáticamente a continuación del presupuesto.

Códigos de barras y códigos QR

• 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) o del tercero. Solo se permite un código QR a la vez en la parte superior del presupuesto, para evitar superposiciones.

Compatibilidad con el módulo Milestone

UltimatePropale reconoce las líneas de hito del módulo Milestone (product_type = 9): no se tratan como líneas de producto clásicas 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, inglés, alemán, español e italiano puede consultarse directamente desde la configuración del módulo, pestaña Guía de usuario, en el idioma de la interfaz. Se actualiza con cada versión y detalla cada opción.

⬆ Volver al índice

Requisitos previos

Dolibarr: Versiones compatibles:

• 25.x

PHP: versión 8.2 como mínimo, probado hasta PHP 8.5.

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

Módulos incompatibles: UltimatePropale no puede estar activo al mismo tiempo que UltimatePDF, UltimatepdfLight o UltimateInvoice.

⚙️ Procedimiento de instalación

Hay tres métodos, del más sencillo al más técnico. El zip de UltimatePropale pesa unos 1,5 MB: cabe dentro de los límites de subida por defecto de Dolibarr y PHP (2 MB), pero una instalación más restrictiva puede rechazarlo (ver más abajo).

⚙️ Método 1: instalación desde la interfaz de Dolibarr

1. Vaya a Inicio > Configuración > Módulos.
2. Abra la pestaña Instalar módulo externo.
3. Haga clic en Elegir archivo y seleccione el archivo .zip del módulo.
4. Haga clic en Enviar archivo para iniciar la instalación.
5. Active el módulo una vez terminada la instalación.

Comprobar el tamaño máximo de subida

A la subida del zip se aplican tres límites, y gana el más pequeño:

Límite	Dónde verlo / modificarlo	Valor habitual
Límite de Dolibarr (MAIN_UPLOAD_DOC)	Inicio > Configuración > Seguridad, pestaña Archivos, «Tamaño máximo de los documentos a subir» (en KB)	2048 KB (valor de instalación de Dolibarr)
upload_max_filesize (PHP)	archivo php.ini del servidor	2M (valor por defecto de PHP)
post_max_size (PHP)	archivo php.ini del servidor	8M

Cómo conocer los valores actuales:

• En la página Instalar módulo externo, pase el ratón por el icono de información a la derecha del botón Enviar archivo: Dolibarr muestra el límite de Dolibarr y el límite de PHP en Kb.
• Los parámetros de PHP se detallan en Herramientas de administración > Acerca de PHP (página admin/system/phpinfo.php): busque upload_max_filesize y post_max_size.

Si uno de los límites es inferior al tamaño del zip, Dolibarr rechaza el archivo con el mensaje «El tamaño del archivo es demasiado grande o no se ha proporcionado el archivo.».

Cómo aumentarlos:

1. Límite de Dolibarr: en Inicio > Configuración > Seguridad, pestaña Archivos, introduzca por ejemplo 10240 (10 MB) y guarde.
2. Límites de PHP: en php.ini (o en el panel de su alojamiento: Plesk, cPanel, «Configuración de PHP»…), defina por ejemplo:

upload_max_filesize = 10M
post_max_size = 12M

post_max_size debe seguir siendo mayor o igual que upload_max_filesize. Reinicie después el servidor web o PHP-FPM (innecesario en la mayoría de los alojamientos, que aplican el cambio al instante) y compruebe los nuevos valores en Acerca de PHP.

En un alojamiento compartido, los límites de PHP no siempre se pueden modificar. En ese caso, use el método 2 o 3.

⚙️ Método 2: instalación manual en el servidor (SSH)

El zip contiene una carpeta htdocs/ultimatepropale/; es la carpeta ultimatepropale la que debe quedar en el directorio custom de Dolibarr.

1. Copie el zip en el servidor, por ejemplo en /tmp.
2. Descomprima: unzip module_ultimatepropale-X.Y.Z.zip -d /tmp/ultimatepropale_zip
3. Copie la carpeta del módulo: cp -r /tmp/ultimatepropale_zip/htdocs/ultimatepropale /ruta/a/dolibarr/htdocs/custom/
4. Asigne la propiedad al servidor web si es necesario, por ejemplo: chown -R www-data:www-data /ruta/a/dolibarr/htdocs/custom/ultimatepropale
5. Compruebe que el módulo está en htdocs/custom/ultimatepropale (y no en htdocs/custom/htdocs/ultimatepropale).
6. Active el módulo desde Dolibarr.

⚙️ Método 3: subida por FTP / SFTP (último recurso)

Si no puede subir archivos en Dolibarr ni acceder al servidor por SSH:

1. Descomprima el archivo en su ordenador (clic derecho > «Extraer todo…» en Windows).
2. Abra la carpeta extraída: contiene htdocs, que a su vez contiene la carpeta ultimatepropale.
3. Conéctese al servidor con un cliente FTP/SFTP (por ejemplo FileZilla), con las credenciales que le facilita su proveedor de alojamiento.
4. Localice el directorio de Dolibarr: es el que contiene las carpetas admin, core, conf… y custom. Según el proveedor, se llama htdocs, httpdocs, www o public_html. Si custom no existe, créela.
5. Suba la carpeta ultimatepropale (no el zip, ni la carpeta htdocs que la contiene) dentro de custom.
6. Espere a que termine la transferencia y compruebe en el registro del cliente FTP que ningún archivo ha fallado: una transferencia interrumpida deja un módulo incompleto.
7. Compruebe que la ruta final es …/custom/ultimatepropale/core/modules/modUltimatePropale.class.php.
8. Active el módulo desde Inicio > Configuración > Módulos.

Para actualizar por FTP, reemplace la carpeta ultimatepropale existente (tras hacer una copia de seguridad) y después desactive y vuelva a activar el módulo para aplicar los posibles cambios en la base de datos. Sus plantillas y ajustes, guardados en la base de datos, se conservan.

Configuración

Para utilizar este módulo, primero debe activarlo. Para ello, inicie sesión con una cuenta de administrador y vaya a la página «Inicio - Configuración - Módulos». El módulo aparece en la pestaña «Atoo-Net», haga clic en «Activar». Aparece un icono al final de la línea del módulo; haga clic en él para acceder a las páginas de configuración específicas del módulo.

Todas las páginas de administración del módulo están protegidas por el derecho ultimatepropale -> config: solo los usuarios con este derecho (normalmente los administradores) pueden acceder a ellas. Los demás usuarios simplemente ven el modelo ultimatepropale_propal en la lista desplegable «Modelos» de las fichas de presupuesto.

La configuración consta de cinco pestañas: Modelos, Opciones, Presupuestos, Guía de usuario y Acerca de.

Pestaña Modelos (Diseños)

Aquí se crea el aspecto gráfico de sus presupuestos.

- La lista muestra todos los Diseños existentes: etiqueta, descripción, tipo de borde, colores, estado e insignia «Por defecto» para el que se utiliza actualmente.

- 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 del modelo 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 tiene su propio botón Guardar.

- Un Diseño desactivado deja de aparecer en las listas de selección. El «Modelo maestro» y el Diseño por defecto no se pueden eliminar, para no romper nunca la generación de documentos.

- Exportar este modelo descarga el Diseño en un archivo JSON, Importar un modelo lo recrea en el mismo Dolibarr o en otro. El Diseño importado se crea desactivado y se renombra si su etiqueta ya existe.

- El botón Vista previa PDF real del formulario genera el PDF del presupuesto más reciente, con el modelo ultimatepropale_propal y los ajustes que se están introduciendo, sin guardarlos. El PDF de este presupuesto se regenera de paso: vuelva a generarlo después de guardar el Diseño.

Importante: tras modificar un Diseño, si el presupuesto generado no parece haber cambiado, compruebe que ese Diseño lleva la insignia «Por defecto».

Pestaña Opciones (ajustes globales)

Estos ajustes se aplican al presupuesto con independencia del Diseño elegido: logotipos, bloques de dirección e identificadores profesionales, fondo de página, contenido de las líneas, CGV, datos bancarios, formato de papel.

La mayoría de los ajustes son interruptores on/off aplicados inmediatamente; el formato de papel y los identificadores profesionales se validan con un botón Guardar 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 del presupuesto, y puede preseleccionarse por defecto.

Pestaña Presupuestos

La página agrupa los ajustes propios del contenido del presupuesto: direcciones, comercial, códigos de barras y QR, proyecto y objetos vinculados, encabezado y maquetación, columnas de líneas, inversión del sujeto pasivo, opciones de ocultación, versiones de presupuesto, páginas de presentación, bloque de conformidad y zona de firma en línea, firmas impresas, fusión de PDF.

Las secciones de esta página se pliegan en acordeón.

Pestaña Guía de usuario

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

⬆ Volver al índice

Utilización

- Abra la ficha del presupuesto y, en el bloque Documentos de la parte inferior, elija el modelo ultimatepropale_propal en la lista desplegable «Modelos» y haga clic en Generar.

- Modelo por defecto: en Inicio - Configuración - Módulos, página Presupuestos, elija ultimatepropale_propal como modelo por defecto. Es el que utilizan la validación del presupuesto, las acciones masivas y los demás módulos. El antiguo modelo ultimate_propal de Ultimatepdf desaparece una vez desactivado ese módulo.

- 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 del menú de la parte superior derecha 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 anexo: tras activar la opción en la página Presupuestos, seleccione el o los archivos que desea fusionar desde la ficha.

- Hacer firmar el presupuesto en línea: active la zona de firma electrónica en la página Presupuestos y envíe al cliente el enlace a la página pública de firma de Dolibarr. Su firma se estampa en el marco previsto.

Páginas de presentación y firma en línea

Páginas de presentación y portada

Active Añadir una página de presentación antes del presupuesto (ULTIMATE_PDF_PROPAL_ADD_NEW_PRESENTATION_PAGES) en la página Presupuestos del módulo. El PDF del presupuesto se organiza entonces así:

Orden	Páginas	Dónde se configuran
1	Portada	Edición del Design, bloque Configura el cuerpo central
2	Páginas de presentación propias del presupuesto	Ficha del presupuesto, columna Posición = Antes del presupuesto (presentación)
3	El presupuesto: encabezado, líneas, totales y recuadro «conforme»	—
4	Anexos: archivos fusionados después del presupuesto, fichas técnicas de los productos, condiciones de venta	Ficha del presupuesto (Después del presupuesto), página Presupuestos, página Opciones

Elegir la portada. En la edición del Design, despliegue el bloque Configura el cuerpo central:

• la lista Color de fondo de la página de presentación del presupuesto ofrece los cuatro fondos suministrados (azul, cian, verde, naranja) y las portadas que haya subido;
• el campo Subir una portada personalizada para el presupuesto (imagen o PDF) añade una portada a esta lista. Un PDF se guarda en proposals/cover: solo se utiliza su primera página, estirada sobre toda la página.

El módulo imprime sobre la portada el logotipo de la empresa, el título del documento, el nombre del destinatario, la fecha del presupuesto y su fecha de fin de validez: elija una portada en la que estas zonas sigan siendo legibles.

Añadir páginas de presentación a un presupuesto.

1. Adjunte el PDF al presupuesto (pestaña Documentos).
2. En la ficha del presupuesto, en el bloque Documento(s) pdf fusionado(s) con el presupuesto, marque el archivo, elija Antes del presupuesto (presentación) en la columna Posición y haga clic en Grabar.
3. Vuelva a generar el PDF del presupuesto.

Varios archivos se insertan en el orden de la lista, es decir, el orden alfabético de sus nombres: añádales un prefijo (1-, 2-...) para imponer un orden. Cada página importada, antes o después del presupuesto, conserva su formato y su orientación y recibe el pie de página del presupuesto (datos de la empresa y número de página «n / total»).

Firma en línea del cliente

El cliente firma el presupuesto desde una página web, sin imprimirlo: su firma se coloca en el recuadro «conforme» del PDF y el presupuesto pasa al estado Firmado.

Puesta en marcha

1. En Configuración > Módulos > Presupuestos, active Permitir la firma en línea (opción del núcleo de Dolibarr, PROPOSAL_ALLOW_ONLINESIGN).
2. En la página Presupuestos del módulo, active Mostrar la zona : " Comprobante " (ULTIMATEPDF_PDF_PROPAL_USE_ELECTRONIC_SIGNING). El presupuesto imprime entonces, bajo los totales, un recuadro «Aceptación por escrito, sello de la empresa, fecha y firma».
3. Valide el presupuesto y genere su PDF con el modelo ultimatepropale_propal.

Enviar el enlace al cliente. La ficha del presupuesto validado muestra el bloque Enlace para la firma en línea. Cópielo en su correo, o utilice la variable __ONLINE_SIGN_URL__ en una plantilla de correo. El cliente abre la página, consulta el PDF, hace clic en Aceptar presupuesto, escribe su nombre, traza su firma y confirma. Dolibarr guarda entonces un nuevo archivo REF_signed-AAAAMMDDHHMMSS.pdf junto al PDF original, que no se modifica.

¿En qué página se coloca la firma? En la página que lleva el recuadro «conforme», y solo en ella. En cada generación, el modelo escribe el número de esa página en las propiedades del PDF (palabra clave PAGESIGN=n), que lee la página de firma de Dolibarr. La portada y las páginas de presentación colocadas antes del presupuesto se cuentan. Los anexos colocados después (archivos fusionados, fichas técnicas, condiciones de venta) nunca desplazan la firma. Ejemplo: una portada, dos páginas de presentación, un presupuesto de dos páginas, un anexo técnico y las condiciones de venta dan PAGESIGN=5, sea cual sea la longitud de los anexos.

Conviene saber

• Se firma el PDF presente en la ficha: vuelva a generarlo tras cualquier cambio del presupuesto, antes de enviar el enlace. Un PDF producido por una versión anterior del módulo, sin la palabra clave PAGESIGN, se firma en su última página.
• Las versiones anteriores escribían el número de páginas del último PDF generado en la constante PROPAL_SIGNATURE_ON_SPECIFIC_PAGE. Global a la entidad y prioritaria sobre PAGESIGN, enviaba la firma a los anexos, o incluso a una página de otro presupuesto. El módulo la elimina ahora en cada generación: no la vuelva a crear.
• La altura de la firma en la página procede de otra constante del núcleo, PROPAL_SIGNATURE_YFORIMGSTART, también global: el módulo escribe en ella la posición del recuadro en cada generación. Si entre la generación y la firma se genera otro presupuesto cuyo recuadro está a otra altura, la firma puede quedar desplazada verticalmente. En ese caso, vuelva a generar el PDF del presupuesto antes de reenviar el enlace.

Resolución de problemas

Síntoma	Causa probable
El modelo ultimatepropale_propal no aparece en la lista	El módulo UltimatePropale o el módulo Presupuestos no está activado, o el modelo no está activado en la configuración de los presupuestos
Las generaciones automáticas (validación, acciones masivas) utilizan otro modelo	ultimatepropale_propal no es el modelo por defecto de los presupuestos
No se puede activar UltimatePropale	UltimatePDF, UltimatepdfLight o UltimateInvoice está activo: desactívelo primero
El presupuesto no refleja los cambios de un Diseño	Ese Diseño no es el que lleva la insignia «Por defecto»
Dos códigos QR se superponen en la parte superior del presupuesto	Configuración anterior: desactive uno de los códigos QR, solo se permite uno a la vez
La firma en línea no está en la página correcta, o no a la altura correcta	PDF generado con una versión anterior (sin palabra clave PAGESIGN), constante PROPAL_SIGNATURE_ON_SPECIFIC_PAGE recreada por otro módulo, u otro presupuesto generado entretanto: regenere el PDF y vuelva a enviar el enlace
El enlace de firma en línea no aparece en la ficha del presupuesto	Presupuesto no validado, u opción Permitir la firma en línea desactivada en la configuración de los presupuestos
Las páginas de presentación no aparecen en el PDF	Opción de páginas de presentación desactivada, archivo no marcado en la ficha del presupuesto, o posición no guardada

El registro de Dolibarr (Inicio - Configuración - Otros - Registros) traza cada generación.

⬆ Volver al índice

Otros idiomas

• Documentation française du module UltimatePropale
• English documentation for the UltimatePropale module
• Deutsche Dokumentation für das Modul UltimatePropale
• Documentazione in italiano del modulo UltimatePropale

⬆ Volver al índice