EasySubtotals - Titel, Zwischensummen & Freitextblöcke in Angeboten, Bestellungen und Rechnungen

EasySubtotals für Dolibarr — Block-strukturierte Angebote, Bestellungen und Rechnungen

EasySubtotals ist das Dolibarr-Modul, das flache Positionslisten in professionell strukturierte kommerzielle Dokumente verwandelt. Füge Titel ein, um Posten zu gruppieren, schließe jeden Block mit einer automatischen Zwischensumme und nutze wiederverwendbare Freitextblöcke für Klauseln, Hinweise oder narrative Trennzeichen.

Funktioniert mit Angeboten, Bestellungen, Kunden- und Lieferantenrechnungen — inklusive wiederkehrende Rechnungen und Teilrechnungen. Zwischensummen werden in den Standard-PDF-Vorlagen (Crabe, Einstein, Azur) sauber gerendert und — die am meisten nachgefragte Funktion — auch in eigenen ODT-Vorlagen über einsatzbereite Tags.

🎯 Das gelöste Problem

Lange Rechnungen und Angebote mit Dutzenden von Positionen sind für deine Kunden schwer lesbar. Ohne Gruppierung wirkt jede Zeile gleich wichtig und der Kunde verliert den Kontext. Wer zusätzlich mehrere Abschnitte anbietet (Arbeitsleistung, Lizenzen, Hardware, Wartung), produziert eine Textwand, in der eine blockweise Verhandlung unmöglich ist.

EasySubtotals teilt das Dokument in visuelle Blöcke mit Titel und Zwischensumme. Der Kunde bekommt endlich ein lesbares, verhandelbares und professionelles Dokument.

🧩 Vergleich mit dem Standard-Zwischensummen von Dolibarr

📝 Einfügbare Blocktypen

• 🟦 Titel — öffnet einen Block und gruppiert die folgenden Zeilen. Bis zu 9 hierarchische Ebenen (Titel, Untertitel, Unter-Untertitel...).
• 💰 Zwischensumme — schließt einen Block und zeigt automatisch die kumulierte Summe (Netto, MwSt., Brutto).
• 📝 Freitext — narrativer Absatz ohne Auswirkung auf die Berechnungen. Perfekt für Klauseln, Zahlungsbedingungen, Kundenhinweise oder Trennzeichen.
• 📐 Wiederverwendbare Bausteine — erstelle ein Wörterbuch mit vorbereiteten Texten (Bedingungen, Garantien, Einleitungen) und verwende sie per Dropdown.

🎨 Eigene ODT-Vorlagen integrieren

Die am meisten nachgefragte Funktion des Moduls. EasySubtotals klinkt sich in die Standard-ODT-Erzeugung von Dolibarr ein und stellt eine Reihe von zeilentypabhängigen Platzhaltern bereit, die du im Segment [!-- BEGIN row.lines --] ... [!-- END row.lines --] deiner Vorlage verwenden kannst:

Dolibarrs ODT-Engine (Odtphp) wertet keine Bedingungen aus, der Hook füllt daher die Platzhalter selbst mit zeilentypabhängigen Werten. Eine einzige flache Zeile deckt Produkte, Titel und Zwischensummen ab:

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

Bei Titelzeilen kommt {line_desc} mit dem Präfix "▶ Leistungen" an; bei Zwischensummen als "Subtotal: Leistungen", wobei {line_price_ht} bereits als Blocksumme berechnet ist. Der Admin-Tab ODT-Variablen listet alle Platzhalter mit konkreten Beispielen.

⚙️ Unterstützte Dolibarr-Elemente

• ✅ Angebote (Kunden und Lieferanten)
• ✅ Bestellungen (Kunden und Lieferanten)
• ✅ Rechnungen (Kunden und Lieferanten)
• ✅ Wiederkehrende Rechnungen
• ✅ Teilrechnungen (automatische Behandlung von situation_percent)

🛠️ Konfigurationsoptionen

• 🔢 Hierarchische Ebenen aktivieren (verschachtelte Titel bis zu 9 Ebenen)
• ➕ Hinzufügen / Bearbeiten / Löschen / Duplizieren der Blöcke unabhängig erlauben
• 🎨 PDF-Stil für Titel und Zwischensummen (fett, kursiv, unterstrichen)
• 📄 Seitenumbruch pro Zeile
• 🔀 Bestellung → Rechnung Kaskade: ein Titel + Zwischensumme pro fakturierter Bestellung (mit __REFORDER__ und __REFCUSTOMER__)
• ❌ "NI"-Markierung (Nicht Inbegriffen): schließt einen Block von der Gesamtsumme aus
• 📚 Freitext-Wörterbuch verwaltet über Admin → Wörterbücher

📦 Typische Anwendungsfälle

• 🏗️ Bau und Handwerk: Angebote mit Blöcken pro Phase (Fundament, Tragwerk, Ausbau) und Zwischensumme je Phase.
• 💻 Software / IT-Beratung: Analyse, Entwicklung, Tests und Lizenzen trennen. Zwischensummen je Block = einfachere Verhandlung mit dem Kunden.
• 🏭 Industrie und Vertrieb: Eine Rechnung mit allen Bestellungen des Monats, ein Block pro Bestellung mit eigener Zwischensumme.
• 📋 Professional Services: Angebote mit optionalen Blöcken (der Kunde wählt aus).
• 🔧 Technische Wartung: Lieferscheine mit separaten Blöcken Arbeit + Material.
• 🎓 Training und Veranstaltungen: Angebote mit einem Block pro Modul oder Tag.

🧩 Modulinhalt

• 🏗️ Moduldescriptor mit Berechtigungen (Lesen / Schreiben / Löschen) und 15 Konfigurationskonstanten.
• 🎛️ Admin-Panel mit 4 Tabs: Konfiguration, Lizenz, Über, Änderungsverlauf.
• 🧠 3 PDF-Overrides: Crabe (Rechnungen), Einstein (Bestellungen), Azur (Angebote).
• 🎨 ODT-Integration — der Hook befüllt die Platzhalter mit zeilentypabhängigen Werten (Odtphp unterstützt keine Bedingungen).
• ⚙️ Automatischer Trigger für Bestellung → Rechnung Kaskade und Teilrechnungsbehandlung.
• 📚 Wörterbuch mit wiederverwendbaren Freitextbausteinen, pro Entität isoliert.
• 🧱 Saubere Architektur: spezialisierte Services, getrennte Hook-Handler, tiefgreifendes Refactoring.
• 🌍 8 Sprachen vollständig: ES, EN, FR, DE, IT, PT, CA, GL.
• 🏢 Multicompany-kompatibel (Multisociété) mit pro Entität isolierten Daten.

⚙️ Kompatibilität und Anforderungen

• 📦 Dolibarr V16+ (kompatibel bis V23+)
• ⚙️ PHP 7.4 – 8.3+
• 🗄️ MySQL 5.7+ / MariaDB 10.2+ / PostgreSQL 10+
• 🌐 Moderner Browser mit aktiviertem JavaScript
• ⚠️ Nicht kompatibel mit dem alten subtotal-Modul (in conflictwith deklariert) — wähle eines von beiden.

💰 Preis und Lizenz

Das Modul ist freie Software unter der GPL v3-Lizenz. Du kannst es unter den Bedingungen dieser Lizenz nutzen, modifizieren und weitergeben. Zugriff auf Updates für 24 Monate nach Kauf auf Dolistore. Direkter E-Mail-Support.

✉️ Support

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