Module Ultimateline ES
Resumen
Información
| Module name | UltimateLine |
| Editor / Editeur | 
|
| Download or buy page / Page achat ou téléchargement | External module - www.dolistore.com |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | Dolibarr 25.0, PHP 8.2
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-3 |
| Note / Nota | ⬆ Volver al resumen |
Funcionalidades
UltimateLine añade automáticamente una línea final (ecotasa, extensión de garantía, gastos fijos, descuento...) justo debajo de una línea de producto o de servicio, en presupuestos, pedidos y facturas. La línea final es un servicio del catálogo, calculado como porcentaje del importe de la línea padre o como importe fijo por unidad. Un mismo producto puede generar varias líneas finales.
Ejemplo: un servicio «Extensión de garantía» al 5 % y un servicio «Ecotasa RAEE» de 3,50 € por unidad, asociados a una ventana vendida a 2 × 389,00 €, añaden debajo de la ventana una línea de 38,90 € y una línea de 7,00 €.
Comportamiento en los documentos
- La línea final se inserta automáticamente justo debajo de su línea de producto padre, con una cantidad de 1 y el tipo de IVA del servicio.
- Se recalcula cuando cambian la cantidad o el precio de la línea padre, y se elimina con ella.
- En la interfaz, la línea final aparece sangrada y agrupada visualmente con su línea padre.
- En los PDF de los modelos UltimatePDF, la línea final se imprime con un icono «└» que indica su vínculo con la línea padre, y se añade una línea De los cuales [nombre del servicio]: [importe sin IVA] por servicio debajo del Total (Base imp.).
- Con los modelos estándar de Dolibarr (cyan, eratosthene, sponge...), un recuadro Incluido: debajo de los totales indica el total de cada servicio de línea final, en el idioma del documento.
Compatibilidad con el módulo Milestone
UltimateLine es compatible con el módulo Milestone, que organiza las líneas de los documentos en hitos. Cuando una línea de producto pertenece a un hito:
- en la interfaz, la línea final se muestra dentro del bloque del hito, justo después de su línea de producto padre, antes del subtotal del hito;
- el importe de la línea final se incluye en el subtotal del hito;
- en los PDF, la línea final conserva el icono «└» (y no el icono de línea hija del hito);
- las conversiones presupuesto → pedido, presupuesto → factura y pedido → factura conservan el vínculo entre la línea final y su línea de producto padre.
Requisitos
- Dolibarr 25.x;
- PHP 8.2 o superior (probado hasta PHP 8.5);
- módulos Servicios y Facturas, activados automáticamente con UltimateLine.
Para Dolibarr 18 a 24, utilice la versión 24.0 del módulo.
⚙️ Procedimiento de instalación
⚙️ Instalación desde la interfaz
- Vaya a Inicio → Configuración → Módulos/Aplicaciones, pestaña Implementar/instalar un módulo externo.
- Elija el archivo
module_ultimateline-25.0.0.zipy haga clic en Enviar archivo.
⚙️ Instalación manual
- Descargue el archivo comprimido del módulo (.zip).
- Descomprima el archivo:
unzip module_ultimateline-25.0.0.zip -d /tmp/ultimateline_zip - Copie la carpeta del módulo:
cp -r /tmp/ultimateline_zip/htdocs/ultimateline /ruta/a/dolibarr/htdocs/custom/ - Compruebe que el módulo se encuentra en
htdocs/custom/ultimateline. - El módulo ya está disponible y puede activarse desde Dolibarr.
Actualización desde una versión anterior: sustituya la carpeta ultimateline y luego desactive y vuelva a activar el módulo. Los servicios de línea final y sus asociaciones se conservan.
Configuración
Conectado con una cuenta de administrador, vaya a Inicio → Configuración → Módulos/Aplicaciones. El módulo aparece en la familia AtooNet: haga clic en el botón de activación y luego en la rueda dentada al final de la línea para abrir la página de configuración del módulo.
Cree primero, en el módulo Productos/Servicios, el servicio o los servicios que se usarán como líneas finales (por ejemplo «Ecotasa RAEE»). Su tipo de IVA se aplica a las líneas finales.
La página de configuración tiene cuatro pestañas: Configuración de los servicios de línea final, Guía del usuario, Acerca de y Registro de cambios.
Guía de inicio
En la primera apertura, la ventana ¡Bienvenido a UltimateLine! presenta los tres pasos de la puesta en marcha (crear un servicio de línea final, asociar productos al servicio, consultar la guía del usuario) y marca los que ya están hechos. El enlace No volver a mostrar esta guía la oculta definitivamente.
Definir un servicio como línea final
En el bloque Definir un servicio como línea final:
- Seleccione un servicio para usarlo como servicio de línea final: elija uno de los servicios creados anteriormente.
- Asociado a los productos/servicios como: elija el tipo de cálculo:
- Tasa sobre el precio (en porcentaje): la línea final es un porcentaje del importe sin IVA de la línea padre;
- Importe fijo añadido al precio: la línea final es este importe multiplicado por la cantidad de la línea padre.
- Valor a aplicar: introduzca el porcentaje o el importe.
- Haga clic en Asignar.
Asociar productos al servicio
En el bloque Selección de un servicio de línea final, elija el servicio en Seleccione un servicio de línea final y haga clic en Mostrar.
El panel Configuración del servicio de línea final muestra la referencia, la Etiqueta del servicio, el Tipo de servicio y el Valor del servicio, y después dos listas:
- Productos asociados (a la izquierda): los productos y servicios que ya generan esta línea final;
- Productos disponibles (a la derecha): los productos y servicios que se pueden añadir.
Seleccione productos en una lista (o use Seleccionar todo / Deseleccionar todo), muévalos con las flechas ← y → y haga clic en Aplicar para guardar.
Debajo de las listas, Eliminar las asociaciones seleccionadas quita únicamente los productos marcados de la lista de productos asociados.
Eliminar un servicio de línea final
El botón Eliminar el servicio abre un cuadro de confirmación de Dolibarr. Tras la confirmación, se eliminan el servicio de línea final y todas sus asociaciones de productos; el servicio en sí permanece en el catálogo.
Para ver una formación en línea en YouTube: https://www.youtube.com/watch?v=OBwRoyuBrPk
Uso
- Cuando se añade o modifica una línea de producto, las líneas finales correspondientes se crean o recalculan automáticamente.
- Cuando se elimina una línea de producto, sus líneas finales se eliminan con ella.
- Las líneas libres (sin producto del catálogo) no generan ninguna línea final.
- Conversiones: al convertir un presupuesto en pedido, un presupuesto en factura o un pedido en factura, las líneas se copian tal cual y siguen vinculadas a su línea de producto, sin añadirse una segunda vez.
- Con el módulo Milestone: las líneas finales permanecen dentro de su bloque de hito tras la conversión, y su importe se incluye en el subtotal del hito.
Novedades de la versión 25.0.0
Compatibilidad
- Requiere Dolibarr 25 y PHP 8.2, probado hasta PHP 8.5. La comprobación de actualizaciones lee
versionmodules/ultimateline/v25/ultimateline.txt.
Correcciones
- El recuadro Incluido: debajo de los totales de los modelos PDF estándar ya no se imprimía: vuelve a encontrar las líneas finales, las agrupa por servicio, usa el idioma y la moneda del documento y ya no se imprime por duplicado con los modelos UltimatePDF y UltimatePDFLight.
- La eliminación de un servicio pide una confirmación en un cuadro de diálogo de Dolibarr, protegido por un token de seguridad.
- Página de configuración: título de la pestaña del navegador, hoja de estilos del módulo, etiqueta «Referencia de servicio» y texto de búsqueda de las listas de productos traducidos.
Traducciones y documentación
- Interfaz, guía del usuario y página wiki en francés, inglés, alemán, español e italiano, con nuevas capturas de pantalla.
- Biblioteca Markdown integrada eliminada: Dolibarr muestra él mismo la guía y el registro de cambios.
- Pruebas automáticas (PHPUnit, PHPStan) y paquete DoliStore más ligero.
Versiones anteriores
- 24.0.1 (no publicada, incluida en la 25.0.0): token CSRF en los formularios de administración, pestañas Guía del usuario y Registro de cambios.
- 24.0.0: versión compatible con Dolibarr 24.
- Versiones 18 a 23: consulte el archivo
ChangeLog.mdincluido en el módulo.
Preguntas frecuentes
No se añade ninguna línea final
Compruebe que el producto figura en Productos asociados del servicio de línea final y que la línea usa un producto del catálogo: las líneas libres se ignoran.
El importe de la línea final parece incorrecto
Compruebe el tipo de cálculo (porcentaje o importe fijo) y el valor mostrados en el panel Configuración del servicio de línea final. Un importe fijo se multiplica por la cantidad de la línea padre.
Las asociaciones no se guardan
Haga clic en Aplicar después de mover productos de una lista a otra.
¿Aparecen dos veces los importes «De los cuales» en el PDF?
No. Los modelos UltimatePDF y UltimatePDFLight imprimen sus propias líneas «De los cuales ...» debajo del Total (Base imp.); el recuadro Incluido: de UltimateLine solo se añade con los modelos estándar de Dolibarr.
¿El módulo modifica el núcleo de Dolibarr?
No. UltimateLine funciona con triggers y hooks, sin modificar los archivos de Dolibarr.