Module Jalon ES

Tabla de contenidos

Retour index
Documentation développeur

Retour index
Documentation Utilisateur

Información

Module name	Milestone
Editor / Editeur	- http://www.atoo-net.com
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2026-04-19
Note / Nota	⬆ Volver al inicio

Funcionalidades

Este módulo permite asociar/agrupar productos/servicios en un hito y mostrar el subtotal. Es posible añadir líneas de comentario sin detalles (impuesto, precio, etc.), así como forzar saltos de página en los documentos comerciales.

El módulo es compatible con los siguientes tipos de documentos:

- Propuestas comerciales
- Pedidos de clientes
- Facturas de clientes
- Pedidos de proveedores
- Facturas de proveedores

Compatible con el módulo Multi-Company.

Funcionalidades principales:

- Agrupación de líneas: asociar productos/servicios a un hito para agruparlos visualmente y gestionarlos como un bloque.
- Subtotal automático: visualización del importe total por hito en el documento y en el PDF.
- Líneas de comentario: añadir líneas de texto sin importe ni IVA.
- Salto de página forzado: insertar un salto de página en cualquier posición del PDF.
- Mover una línea a un hito: asociar a posteriori una línea existente a un hito mediante un menú desplegable.
- Clonación de bloque: duplicar un hito y todas sus líneas hijas con un solo clic.
- Eliminación de bloque con opciones:

• • Opción 1 — Eliminar el hito y todas sus líneas.
  • Opción 2 — Eliminar solo el hito y desvincular sus líneas (permanecen en el documento).
  • Opción 3 — Eliminar el hito y migrar sus líneas a otro hito existente.

- Diccionario de hitos: guardar hitos reutilizables desde la página de configuración.

Requisitos previos

Dolibarr 20.0.0 - 23.0.0

⚙️ Instalación

⚙️ Instalación manual

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

unzip module_milestone-X.0.0.zip

1. Verificar que el módulo se encuentra en la ubicación correcta:

htdocs/custom/milestone

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

---

⚙️ Instalación desde la interfaz de Dolibarr

También puede desplegar e instalar el módulo directamente desde la interfaz de Dolibarr:

1. Acceda al menú Configuración > Módulos/Aplicaciones.
2. Abra la pestaña Desplegar/Instalar un módulo externo.
3. Haga clic en Seleccionar archivo y elija el archivo .zip del módulo.
4. Haga clic en Enviar archivo para iniciar la instalación.
5. Active el módulo una vez completada la instalación.

✅ ¡El módulo ya está operativo y listo para usar! ⬆ Volver al inicio

Configuración

Para utilizar este módulo, primero debe activarlo. Para ello, conéctese con una cuenta de administrador y vaya a "Inicio - Configuración - Módulos". El módulo aparece en "Módulos adicionales/Herramientas multimodulares". Haga clic en "Activar". Al final de la línea del módulo aparece un icono de configuración — haga clic en él para acceder a la página de parámetros específicos del módulo.

El módulo estará entonces operativo.

Configuración del módulo

Página de configuración propia del módulo:

La página de configuración contiene una pestaña:

• Pestaña Opciones

Las opciones disponibles son:

- Ocultar por defecto el detalle de los productos/servicios asociados a los hitos.
- Ocultar por defecto la descripción de los productos/servicios asociados a los hitos.
- Ocultar por defecto el importe de los hitos.
- Establecer el color de fondo de los hitos.

Puede guardar en un diccionario los hitos que desee reutilizar.

Uso

Fácil de usar, en pocos clics.

Compatibilidad y Sinergias

Milestone es compatible con:

- El módulo MultiCompany
- El módulo UltimatePdf
- Propuestas comerciales (propal)
- Pedidos de clientes (order)
- Facturas de clientes (invoice)
- Pedidos de proveedores (order_supplier) — soporte añadido en v23
- Facturas de proveedores (invoice_supplier) — soporte añadido en v23

Notas técnicas

Particularidades de los documentos de proveedores

Las clases ORM de Dolibarr para documentos de proveedores (CommandeFournisseur, FactureFournisseur) presentan limitaciones en comparación con sus equivalentes para clientes:

- El método fetch_lines() de CommandeFournisseur no asigna el campo label a los objetos de línea. El módulo evita este comportamiento mediante consultas SQL directas cuando la etiqueta está vacía.
- Los métodos updateline() y addline() de estas clases no gestionan el parámetro fk_parent_line. Cualquier escritura en este campo (asociación a un hito, clonación, eliminación) se realiza mediante un UPDATE SQL directo sobre la tabla de líneas correspondiente.

Estas soluciones alternativas están encapsuladas dentro del módulo y son completamente transparentes para el usuario final.

Desarrollo

Milestone está alojado en el repositorio Git de Framasoft: https://git.framasoft.org/inodbox/milestone