EasySubtotals - Títulos, Subtotales y Bloques en Presupuestos, Pedidos y Facturas

EasySubtotals para Dolibarr — Presupuestos y Facturas Estructurados por Bloques

EasySubtotals es el módulo Dolibarr que convierte tus listados planos de líneas en documentos comerciales profesionalmente estructurados. Inserta títulos para agrupar conceptos, cierra cada bloque con un subtotal que se calcula automáticamente y aprovecha los bloques de texto libre reutilizables para cláusulas, notas o separadores narrativos.

Compatible con presupuestos, pedidos y facturas tanto de cliente como de proveedor, incluyendo facturas recurrentes y facturas de situación. Los subtotales funcionan en las plantillas PDF estándar (Crabe, Einstein, Azur) y — lo más demandado — también en plantillas ODT personalizadas mediante tags listos para usar.

🎯 Problema que resuelve

Las facturas y presupuestos largos con decenas de líneas de productos y servicios son difíciles de leer para tus clientes. Sin agrupación, cada línea parece igual de importante, y el cliente pierde el contexto de qué forma parte de qué. Si encima ofreces varios bloques (mano de obra, licencias, hardware, mantenimiento), el resultado es una pared de texto donde es imposible negociar "por partes".

EasySubtotals soluciona esto dividiendo el documento en bloques visuales con título y subtotal. El cliente ve por fin un documento legible, negociable y profesional.

🧩 Comparativa con el subtotal estándar de Dolibarr

📝 Tipos de bloque que puedes insertar

• 🟦 Título — abre un bloque y agrupa las líneas siguientes. Hasta 9 niveles jerárquicos (título, subtítulo, sub-subtítulo...).
• 💰 Subtotal — cierra un bloque y muestra automáticamente el total acumulado (base imponible, IVA y TTC).
• 📝 Texto libre — párrafo narrativo sin impacto en los cálculos. Ideal para cláusulas, condiciones de pago, notas al cliente o separadores.
• 📐 Snippets reutilizables — crea un diccionario de textos prefabricados (condiciones, garantías, introducciones) y reutilízalos con un desplegable.

🎨 Integración con plantillas ODT personalizadas

La característica más demandada del módulo. EasySubtotals se engancha al proceso estándar de generación ODT de Dolibarr y expone un conjunto de placeholders adaptados al tipo de fila que puedes usar dentro del segmento [!-- BEGIN row.lines --] ... [!-- END row.lines --] de tu plantilla:

El motor ODT de Dolibarr (Odtphp) no evalúa condicionales, por lo que el hook rellena los propios placeholders con valores adaptados al tipo de fila. Una única fila plana cubre productos, títulos y subtotales:

[!-- BEGIN row.lines --]
{line_desc}    {line_qty}    {line_up}    {line_price_ht}
[!-- END row.lines --]

En títulos {line_desc} llega prefijado como "▶ Servicios"; en subtotales como "Subtotal: Servicios", con {line_price_ht} ya calculado como total del bloque. La pestaña Variables ODT del panel de administración lista todos los marcadores disponibles con ejemplos.

⚙️ Elementos Dolibarr soportados

• ✅ Presupuestos (clientes y proveedores)
• ✅ Pedidos (clientes y proveedores)
• ✅ Facturas (clientes y proveedores)
• ✅ Facturas recurrentes
• ✅ Facturas de situación (cálculo automático del situation_percent)

🛠️ Opciones de configuración

• 🔢 Niveles jerárquicos (títulos anidados hasta 9 niveles)
• ➕ Permitir añadir / editar / eliminar / duplicar bloques por separado
• 🧱 Plantillas de bloque reutilizables (v1.1) — crea plantillas con título + líneas + subtotal y expándelas en un clic
• 💸 Descuento de bloque (v1.2) — línea informativa con el porcentaje en la etiqueta, sin efecto en los cálculos
• 🟡 Bloques opcionales (v1.2) — marca un bloque para que no sume al total (ideal para alternativas en presupuestos)
• 🔢 Auto-numeración de títulos (v1.2) — numeración automática al renderizar
• 📄 PDF compacto (v1.2) — solo títulos y subtotales, perfecto para resúmenes ejecutivos
• 📊 Resumen ejecutivo PDF (v1.1) — tabla recapitulativa sobre la tabla principal
• 🎨 Colores PDF configurables por nivel de título y subtotales
• 🖼️ Dashboard del módulo con KPIs y accesos rápidos
• 🔌 API REST — endpoints para consultar bloques e insertar plantillas
• 🎨 Estilo PDF de títulos y subtotales (negrita, cursiva, subrayado)
• 📄 Salto de página controlable por línea
• 🔀 Cascada orden → factura: un bloque título + subtotal por cada pedido facturado (con marcadores __REFORDER__ y __REFCUSTOMER__)
• ❌ Flag "NC" (No Contar): excluye un bloque del total general
• 📚 Diccionario de textos libres administrado desde Admin → Diccionarios

📦 Casos de uso habituales

• 🏗️ Construcción y obra: presupuestos con bloques por fase (cimentación, estructura, acabados) y subtotal por fase.
• 💻 Desarrollo software / consultoría: separar horas de análisis, desarrollo, testing y licencias. Subtotal por apartado = negociación más fácil con el cliente.
• 🏭 Industria y distribución: una factura con varios pedidos del mes, un bloque por pedido con su subtotal.
• 📋 Servicios profesionales: presupuestos con bloques opcionales (cliente elige qué acepta).
• 🔧 Mantenimiento técnico: albaranes con bloques de mano de obra + materiales separados.
• 🎓 Formación y eventos: presupuestos con bloques por módulo o jornada.

🧩 Qué incluye el módulo

• 🏗️ Descriptor de módulo con permisos (leer/escribir/eliminar) y 15 constantes de configuración.
• 🎛️ Panel de administración con 4 pestañas: Configuración, Licencia, Acerca de, Historial de cambios.
• 🧠 3 sobrescrituras de PDF: Crabe (facturas), Einstein (pedidos), Azur (presupuestos).
• 🎨 Integración ODT — el hook rellena los placeholders con valores adaptados al tipo de fila (Odtphp no admite condicionales).
• ⚙️ Trigger automático para cascada orden → factura y gestión de facturas de situación.
• 📚 Diccionario de textos libres reutilizables por entidad.
• 🧱 Arquitectura limpia: servicios especializados, handlers de hook separados, refactor profundo.
• 🌍 8 idiomas completos: ES, EN, FR, DE, IT, PT, CA, GL.
• 🏢 Compatible Multiempresa (Multisociété) con datos aislados por entidad.

⚙️ Compatibilidad y requisitos

• 📦 Dolibarr V16+ (compatible hasta V23+)
• ⚙️ PHP 7.4 – 8.3+
• 🗄️ MySQL 5.7+ / MariaDB 10.2+ / PostgreSQL 10+
• 🌐 Navegador moderno con JavaScript activado
• ⚠️ No compatible con el antiguo módulo subtotal (declarado en conflictwith) — elige uno de los dos.

💰 Precio y licencia

El módulo es software libre bajo licencia GPL v3. Puedes usarlo, modificarlo y redistribuirlo libremente respetando los términos de la licencia. Acceso a actualizaciones durante 24 meses desde la compra en Dolistore. Soporte técnico directo por email.

✉️ Soporte

✉️ info@easysoft.es | 🌐 www.easysoft.es