Module Ultimateline DE
Übersicht
Informationen
| 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 | ⬆ Zurück zur Übersicht |
Funktionen
UltimateLine fügt automatisch eine Schlusszeile (Öko-Beitrag, Garantieverlängerung, feste Gebühren, Rabatt...) direkt unter einer Produkt- oder Leistungszeile in Angeboten, Aufträgen und Rechnungen ein. Die Schlusszeile ist eine Leistung aus dem Katalog, berechnet als Prozentsatz des Betrags der übergeordneten Zeile oder als fester Betrag pro Einheit. Ein Produkt kann mehrere Schlusszeilen auslösen.
Beispiel: eine Leistung „Garantieverlängerung“ zu 5 % und eine Leistung „Öko-Beitrag WEEE“ zu 3,50 € pro Einheit, einem Fenster zugeordnet, das zu 2 × 389,00 € verkauft wird, fügen unter dem Fenster eine Zeile von 38,90 € und eine Zeile von 7,00 € ein.
Verhalten in Dokumenten
- Die Schlusszeile wird automatisch direkt unter ihrer übergeordneten Produktzeile eingefügt, mit der Menge 1 und dem MwSt.-Satz der Leistung.
- Sie wird neu berechnet, wenn sich Menge oder Preis der übergeordneten Zeile ändern, und mit ihr gelöscht.
- In der Oberfläche ist die Schlusszeile eingerückt und optisch mit ihrer übergeordneten Zeile gruppiert.
- In den PDF der UltimatePDF-Vorlagen wird die Schlusszeile mit einem Symbol „└“ gedruckt, das ihre Zugehörigkeit zur übergeordneten Zeile zeigt, und unter der Nettosumme wird pro Leistung eine Zeile Davon [Name der Leistung]: [Nettobetrag] hinzugefügt.
- Mit den Standardvorlagen von Dolibarr (cyan, eratosthene, sponge...) zeigt ein Kasten Davon: unter den Summen die Summe jeder Schlusszeilen-Leistung in der Sprache des Dokuments.
Kompatibilität mit dem Modul Milestone
UltimateLine ist kompatibel mit dem Modul Milestone, das die Dokumentzeilen in Meilensteine gliedert. Wenn eine Produktzeile zu einem Meilenstein gehört:
- erscheint die Schlusszeile in der Oberfläche innerhalb des Meilenstein-Blocks, direkt nach ihrer übergeordneten Produktzeile und vor der Zwischensumme des Meilensteins;
- wird der Betrag der Schlusszeile in die Zwischensumme des Meilensteins einbezogen;
- behält die Schlusszeile im PDF das Symbol „└“ (und nicht das Unterzeilen-Symbol des Meilensteins);
- behalten die Umwandlungen Angebot → Auftrag, Angebot → Rechnung und Auftrag → Rechnung die Verbindung zwischen der Schlusszeile und ihrer übergeordneten Produktzeile.
Voraussetzungen
- Dolibarr 25.x;
- PHP 8.2 oder höher (getestet bis PHP 8.5);
- Module Leistungen und Rechnungen, die mit UltimateLine automatisch aktiviert werden.
Für Dolibarr 18 bis 24 verwenden Sie die Version 24.0 des Moduls.
⚙️ Installationsverfahren
⚙️ Installation über die Oberfläche
- Gehen Sie zu Start → Einstellungen → Module/Anwendungen, Registerkarte Externes Modul bereitstellen/installieren.
- Wählen Sie die Datei
module_ultimateline-25.0.0.zipund klicken Sie auf Datei hochladen.
⚙️ Manuelle Installation
- Laden Sie die Archivdatei des Moduls (.zip) herunter.
- Entpacken Sie die Datei:
unzip module_ultimateline-25.0.0.zip -d /tmp/ultimateline_zip - Kopieren Sie den Modulordner:
cp -r /tmp/ultimateline_zip/htdocs/ultimateline /pfad/zu/dolibarr/htdocs/custom/ - Prüfen Sie, dass sich das Modul in
htdocs/custom/ultimatelinebefindet. - Das Modul ist nun verfügbar und kann in Dolibarr aktiviert werden.
Aktualisierung von einer früheren Version: ersetzen Sie den Ordner ultimateline, deaktivieren und aktivieren Sie dann das Modul erneut. Die Schlusszeilen-Leistungen und ihre Zuordnungen bleiben erhalten.
Konfiguration
Melden Sie sich mit einem Administratorkonto an und gehen Sie zu Start → Einstellungen → Module/Anwendungen. Das Modul erscheint in der Familie AtooNet: klicken Sie auf den Aktivierungsschalter und dann auf das Zahnrad am Zeilenende, um die Einstellungsseite des Moduls zu öffnen.
Legen Sie zuerst im Modul Produkte/Leistungen die Leistung(en) an, die als Schlusszeilen dienen sollen (zum Beispiel „Öko-Beitrag WEEE“). Ihr MwSt.-Satz wird für die Schlusszeilen übernommen.
Die Einstellungsseite hat vier Registerkarten: Einrichtung der Schlusszeilen-Leistungen, Benutzerhandbuch, Über und Änderungsprotokoll.
Einstiegsanleitung
Beim ersten Öffnen stellt das Fenster Willkommen bei UltimateLine! die drei Schritte der Einrichtung vor (eine Schlusszeilen-Leistung anlegen, Produkte der Leistung zuordnen, das Benutzerhandbuch lesen) und hakt die bereits erledigten ab. Der Link Diese Anleitung nicht mehr anzeigen blendet es dauerhaft aus.
Eine Leistung als Schlusszeile festlegen
Im Block Eine Leistung als Schlusszeile festlegen:
- Wählen Sie eine Leistung, die als Schlusszeilen-Leistung verwendet wird: wählen Sie eine der zuvor angelegten Leistungen.
- Den Produkten/Leistungen zugeordnet als: wählen Sie die Berechnungsart:
- Satz auf den Preis (in Prozent): die Schlusszeile beträgt einen Prozentsatz des Nettobetrags der übergeordneten Zeile;
- Fester Betrag zum Preis hinzugefügt: die Schlusszeile beträgt diesen Betrag multipliziert mit der Menge der übergeordneten Zeile.
- Anzuwendender Wert: geben Sie den Prozentsatz oder den Betrag ein.
- Klicken Sie auf Zuweisen.
Produkte der Leistung zuordnen
Wählen Sie im Block Auswahl einer Schlusszeilen-Leistung die Leistung unter Wählen Sie eine Schlusszeilen-Leistung und klicken Sie auf Anzeigen.
Das Feld Einrichtung der Schlusszeilen-Leistung zeigt die Referenz, die Bezeichnung der Leistung, die Art der Leistung und den Wert der Leistung, dann zwei Listen:
- Zugeordnete Produkte (links): die Produkte und Leistungen, die diese Schlusszeile bereits auslösen;
- Verfügbare Produkte (rechts): die Produkte und Leistungen, die hinzugefügt werden können.
Markieren Sie Produkte in einer Liste (oder verwenden Sie Alle wählen / Alle abwählen), verschieben Sie sie mit den Pfeilen ← und → und klicken Sie dann auf Übernehmen, um zu speichern.
Unter den Listen entfernt Ausgewählte Zuordnungen löschen nur die angehakten Produkte aus der Liste der zugeordneten Produkte.
Eine Schlusszeilen-Leistung löschen
Die Schaltfläche Leistung löschen öffnet ein Bestätigungsfenster von Dolibarr. Nach der Bestätigung werden die Schlusszeilen-Leistung und alle ihre Produktzuordnungen gelöscht; die Leistung selbst bleibt im Katalog.
Eine Online-Schulung auf YouTube ansehen: https://www.youtube.com/watch?v=OBwRoyuBrPk
Verwendung
- Wenn eine Produktzeile hinzugefügt oder geändert wird, werden die zugehörigen Schlusszeilen automatisch angelegt oder neu berechnet.
- Wenn eine Produktzeile gelöscht wird, werden ihre Schlusszeilen mit ihr gelöscht.
- Freie Zeilen (ohne Katalogprodukt) lösen keine Schlusszeile aus.
- Umwandlungen: bei der Umwandlung eines Angebots in einen Auftrag, eines Angebots in eine Rechnung oder eines Auftrags in eine Rechnung werden die Zeilen unverändert übernommen und bleiben mit ihrer Produktzeile verbunden, ohne ein zweites Mal hinzugefügt zu werden.
- Mit dem Modul Milestone: die Schlusszeilen bleiben nach der Umwandlung in ihrem Meilenstein-Block, und ihr Betrag ist in der Zwischensumme des Meilensteins enthalten.
Neuerungen der Version 25.0.0
Kompatibilität
- Erfordert Dolibarr 25 und PHP 8.2, getestet bis PHP 8.5. Die Update-Prüfung liest
versionmodules/ultimateline/v25/ultimateline.txt.
Korrekturen
- Der Kasten Davon: unter den Summen der Standard-PDF-Vorlagen wurde nicht mehr gedruckt: er findet die Schlusszeilen wieder, gruppiert sie nach Leistung, verwendet Sprache und Währung des Dokuments und wird mit den Vorlagen UltimatePDF und UltimatePDFLight nicht mehr doppelt gedruckt.
- Das Löschen einer Leistung verlangt eine Bestätigung in einem Dolibarr-Dialog, der durch ein Sicherheitstoken geschützt ist.
- Einstellungsseite: Titel der Browser-Registerkarte, Stylesheet des Moduls, Bezeichnung „Leistungs-Ref.“ und Suchtext der Produktlisten übersetzt.
Übersetzungen und Dokumentation
- Oberfläche, Benutzerhandbuch und Wiki-Seite auf Französisch, Englisch, Deutsch, Spanisch und Italienisch, mit neuen Bildschirmfotos.
- Eingebettete Markdown-Bibliothek entfernt: Dolibarr zeigt das Handbuch und das Änderungsprotokoll selbst an.
- Automatische Tests (PHPUnit, PHPStan) und schlankeres DoliStore-Paket.
Frühere Versionen
- 24.0.1 (nicht veröffentlicht, in 25.0.0 enthalten): CSRF-Token in den Verwaltungsformularen, Registerkarten Benutzerhandbuch und Änderungsprotokoll.
- 24.0.0: mit Dolibarr 24 kompatible Version.
- Versionen 18 bis 23: siehe die mit dem Modul gelieferte Datei
ChangeLog.md.
FAQ
Es wird keine Schlusszeile hinzugefügt
Prüfen Sie, dass das Produkt unter Zugeordnete Produkte der Schlusszeilen-Leistung steht und dass die Zeile ein Katalogprodukt verwendet: freie Zeilen werden ignoriert.
Der Betrag der Schlusszeile scheint falsch
Prüfen Sie Berechnungsart (Prozentsatz oder fester Betrag) und Wert im Feld Einrichtung der Schlusszeilen-Leistung. Ein fester Betrag wird mit der Menge der übergeordneten Zeile multipliziert.
Die Zuordnungen werden nicht gespeichert
Klicken Sie auf Übernehmen, nachdem Sie Produkte von einer Liste in die andere verschoben haben.
Erscheinen die „Davon“-Beträge zweimal im PDF?
Nein. Die Vorlagen UltimatePDF und UltimatePDFLight drucken ihre eigenen „Davon ...“-Zeilen unter der Nettosumme; der Kasten Davon: von UltimateLine wird nur mit den Standardvorlagen von Dolibarr hinzugefügt.
Ändert das Modul den Dolibarr-Kern?
Nein. UltimateLine arbeitet mit Triggern und Hooks, ohne die Dateien von Dolibarr zu ändern.