Dolibarr ERP CRM Wiki

Module UltimateInvoice DE

Inhaltsverzeichnis

Retour index
Documentation développeur

 

Retour index
Documentation Utilisateur
 

Informationen

Module name UltimateInvoice
Editor / Editeur  
Download or buy page / Page achat ou téléchargement External module - www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis Modul Rechnungen aktiviert - PHP 7.4 mindestens

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2026-07-28
Note / Nota ⬆ Zurück zum Inhaltsverzeichnis

Funktionen

UltimateInvoice ersetzt die native PDF-Dokumentvorlage von Dolibarr für Rechnungen durch eine vollständig anpassbare Vorlage mit dem Namen ultimate_invoice. Als echtes Schweizer Taschenmesser der PDF-Rechnung erlaubt es, Ihr eigenes Erscheinungsbild festzulegen (Logo, Farben, Ränder, Seitenhintergrund, Spaltenbreiten), genau zu bestimmen, was auf dem Dokument erscheint, Ihre AGB oder weitere PDF-Dateien anzuhängen, Barcodes und QR-Codes hinzuzufügen und die erzeugte Datei digital zu signieren.

UltimateInvoice ist die abgespeckte Ausgabe des Moduls UltimatePDF: es deckt ausschließlich Rechnungen ab. Für Angebote, Aufträge, Verträge, Lieferungen, Spesenabrechnungen, Interventionen, Projekte, Artikel/Stücklisten oder Lieferantenbelege wird die vollständige Ausgabe UltimatePDF benötigt.

Zwei Konfigurationsebenen

Das Modul beruht auf zwei Begriffen, die nicht verwechselt werden sollten :

  • Das Design (Reiter Models) legt fest, wie das Dokument aussieht : Farben, Ränder, Logo, Firmen-Alias, Seitenhintergrund, Spaltenbreiten. Mehrere Designs können nebeneinander bestehen, nur eines ist standardmäßig aktiv (Konstante ULTIMATE_DESIGN), und ein Auswahlfeld oben rechts in der Anwendung erlaubt den sofortigen Wechsel.
  • Die Seiten Optionen und Rechnungen bestimmen, was angezeigt wird : sichtbare Spalten, Adressblöcke, Pflichtangaben, gedruckte Unterschriften usw. Sie verändern das grafische Erscheinungsbild nicht.

Grafische Anpassung (Designs)

  • Seitenhintergrund : Hintergrundbild oder Hintergrund-PDF (bereits gestaltetes Briefpapier), mit Transparenz und X/Y-Positionierung.
  • Kopfbereich : Höhe und Breite des Logos, zweites Logo (Partner, Zertifizierung), Breite des Absenderblocks mit Drag-and-drop-Vorschau und Voreinstellung Fensterumschlag nach französischer Postnorm.
  • Firmen-Alias : druckt einen Firmennamen, eine Anschrift, ein Stammkapital oder eine USt-IdNr., die von der tatsächlichen juristischen Einheit abweichen — nützlich für eine Handelsmarke oder eine Tochtergesellschaft.
  • Ränder und Spalten : PDF-Ränder und Breite jeder Spalte der Positionstabelle (Referenz, Bild, Datum, Typ, Projekt, MwSt., Einzelpreis, Menge, Einheit, Rabatt), jeweils mit der Maus auf einer grafischen Vorschau anpassbar.
  • Fußbereich : Schriftgröße, für den Freitext reservierte Höhe, Text- und Hintergrundfarben.
  • Schriftart : Auswahl der Dokumentschrift (DejaVuSans für erweiterte oder kyrillische Zeichensätze).

Jeder Block des Formulars besitzt eine eigene Schaltfläche Speichern : Sie bestätigen Block für Block, ohne Ihre Eingaben in den anderen Blöcken zu verlieren.

Inhalt der Rechnung

  • Positionsspalten : Nummerierung, Artikelbild, Einzelpreis netto, Rabatt, Einzelpreis nach Rabatt, Menge, Gewicht und Gesamtgewicht, Einheit.
  • Adressblöcke : Angaben zu Empfänger, Kunde und zuständigem Vertriebsmitarbeiter, betriebliche Identifikationsnummern (Handelsregister usw.), USt-IdNr., senkrechtes Stapeln der Kontaktblöcke.
  • Layout : Kopfbereich nicht auf jeder Seite wiederholen, Falzmarke, Text neben dem Datum, Papierformat.
  • Rechnungsspezifisch : verknüpfte Lieferungen, Zahlungsbedingungen, Teilrechnung (Baufortschritt), Online-Zahlungslink, offener Kundensaldo, Betrag in Worten, Zeile Gesamtbetrag brutto, Erzeugung ohne MwSt.-Spalte.
  • Gedruckte Unterschriften : Unterschrift des Verantwortlichen auf dem Dokument und Unterschrift des zuständigen Vertriebsmitarbeiters im Hinweistext. Dies sind Bilder, die dem PDF hinzugefügt werden, und nicht zu verwechseln mit der weiter unten beschriebenen kryptografischen Signatur.

PDF-Zusammenführung und AGB

  • AGB : eine PDF-Datei mit den allgemeinen Geschäftsbedingungen wird über die Seite Optionen hochgeladen und der Rechnung angehängt, wahlweise mit Vorauswahl als Standard.
  • Zusätzliche Dateien : nach Aktivierung der entsprechenden Option auf der Seite Rechnungen können eine oder mehrere beliebige PDF-Dateien direkt aus der Rechnungsmaske heraus mit dem Dokument zusammengeführt werden.

Elektronische Signatur der Rechnungen (PAdES)

UltimateInvoice kann das PDF bei seiner Erzeugung digital signieren. Die Signatur garantiert dem Empfänger die Authentizität (das Dokument stammt tatsächlich von Ihnen) und die Integrität (es wurde seitdem nicht verändert). Adobe Acrobat Reader zeigt sie im Fenster Signaturen an, und unten rechts auf der letzten Seite wird ein sichtbares Signaturfeld gezeichnet.

Aspekt Detail
Was die Funktion leistet Abgetrennte kryptografische PKCS#7-Signatur, entspricht PAdES-B-B, nativ in das PDF eingebettet, mit sichtbarem und anklickbarem Feld
Was sie nicht leistet Kein qualifizierter Zeitstempel (RFC 3161), kein LTV/Langzeitarchivierung, keine qualifizierte Beweiskraft nach eIDAS
Was sie nicht ersetzt Weder die elektronische Rechnungsstellung (Factur-X / ZUGFeRD, PDF/A-3) noch eine qualifizierte Signatur eines Vertrauensdiensteanbieters

Zulässige Zertifikatsformate : .pem, .crt, .p12, .pfx. Die Datei muss sowohl das Zertifikat als auch den privaten Schlüssel enthalten. Sie wird im Verzeichnis documents von Dolibarr außerhalb des Web-Ordners des Moduls gespeichert : sie kann daher nicht über einen Browser heruntergeladen werden.

Wichtige Einschränkung : das Zusammenführen zusätzlicher Dateien schreibt das PDF nach seiner Erzeugung neu und würde die Signatur zerstören. Bei einer Rechnung, in die Dateien eingefügt werden, wird die Signatur deshalb automatisch übersprungen (ein Warnhinweis wird in das Dolibarr-Protokoll geschrieben), statt ungültig erzeugt zu werden. Das Anhängen der AGB bleibt hingegen uneingeschränkt möglich.

Barcodes, QR-Codes und Schweizer QR-Rechnung

  • Barcodes für Artikel (EAN13 mit Prüfziffer, CODE128, CODE39) und für Geschäftspartner, oben oder unten auf der Seite.
  • QR-Codes für das eigene Unternehmen (MyCompany), den Geschäftspartner oder die Rechnung.
  • SEPA-Zahlungs-QR-Code (Norm EPC069-12) und Schweizer QR-Rechnung (Swiss QR-bill), einschließlich des vollständigen Zahlteils auf einer eigenen Seite. Bitte beachten : beide Einstellungen gehören zum Dolibarr-Kern (Start - Einstellungen - PDF - Reiter Spezifische Parameter, Abschnitt Rechnungen) und nicht zum Modul, das sie bei der Erzeugung lediglich berücksichtigt.

Für den vollständigen Schweizer Zahlteil muss die Zahlungsart Banküberweisung sein, ein Bankkonto muss auf der Rechnung hinterlegt sein, die Anschrift Ihres Unternehmens muss vollständig und die IBAN gültig sein (QR-IBAN werden noch nicht unterstützt). Das Feld der elektronischen Signatur wird bewusst auf der letzten Rechnungsseite gezeichnet, bevor der Zahlteil angehängt wird, da dessen Layout normativ vorgegeben ist.

Kompatibilität mit dem Modul Milestone

UltimateInvoice erkennt die Meilensteinzeilen des Moduls Milestone (product_type = 9) : sie werden bei der Berechnung des Zeilengewichts und des Einzelpreises nach Rabatt nicht wie gewöhnliche Artikelzeilen behandelt und behalten im PDF ihre eigene Formatierung.

Integriertes Benutzerhandbuch

Ein vollständiges Handbuch in französischer und englischer Sprache lässt sich direkt in der Moduleinrichtung im Reiter User guide aufrufen. Es wird mit jeder Version aktualisiert und beschreibt jede Option im Detail.

⬆ Zurück zum Inhaltsverzeichnis

Voraussetzungen

Dolibarr : Unterstützte Versionen :

  • 23.x
  • 24.x

PHP : mindestens Version 7.4. Der vollständige Schweizer Zahlteil auf einer eigenen Seite erfordert PHP 8.1 oder höher.

Dolibarr-Module : das Modul Rechnungen muss aktiviert sein.

⚙️ Installationsanleitung

⚙️ Manuelle Installation

  1. Laden Sie die Archivdatei des Moduls (.zip) herunter.
  2. Legen Sie die Datei in das Stammverzeichnis von Dolibarr.
  3. Entpacken Sie die ZIP-Datei mit dem Befehl :

unzip module_ultimateinvoice-X.0.0.zip

  1. Prüfen Sie, dass der richtige Ablageort des Moduls lautet :

htdocs/custom/ultimateinvoice

  1. Das Modul steht nun zur Verfügung und kann in Dolibarr aktiviert werden.

⬆ Zurück zum Inhaltsverzeichnis

Einrichtung

Um dieses Modul zu nutzen, müssen Sie es zunächst aktivieren. Melden Sie sich dazu mit einem Administratorkonto an und rufen Sie die Seite "Start - Einstellungen - Module/Anwendungen" auf. Das Modul erscheint im Reiter "Atoo-Net", klicken Sie auf "Aktivieren". Am Ende der Modulzeile erscheint ein Symbol ; klicken Sie darauf, um zu den modulspezifischen Einrichtungsseiten zu gelangen.

Alle Verwaltungsseiten des Moduls sind durch die Berechtigung ultimateinvoice -> config geschützt : nur Benutzer mit dieser Berechtigung (in der Regel Administratoren) haben Zugriff. Alle anderen Benutzer sehen lediglich die Vorlage ultimate_invoice in der Auswahlliste "Dokumentvorlage" der Rechnungsmaske.

Die Einrichtung besteht aus fünf Reitern : Models (Vorlagen), Optionen, Rechnungen, User guide (Benutzerhandbuch) und Über.

Reiter Models (Designs)

Hier entsteht das grafische Erscheinungsbild, das für alle Ihre Dokumente gilt.

  

- Die Liste zeigt alle vorhandenen Designs : Bezeichnung, Beschreibung, Rahmenart, Farben, Status und die Kennzeichnung "Standard" für das aktuell verwendete Design.

- Klicken Sie auf Design hinzufügen, um ein neues anzulegen, oder auf den Stift, um ein vorhandenes Design zu bearbeiten.

  

- Füllen Sie Block für Block aus : Angaben zur Vorlage und Schriftart, Seitenhintergrund, Kopfbereich und Logos, Firmen-Alias, zentraler Block, Ränder und Spaltenbreiten, Fußbereich. Jeder Block hat eine eigene Schaltfläche Speichern.

- Ein deaktiviertes Design erscheint nicht mehr in den Auswahllisten. Die "Hauptvorlage" und das Standard-Design können nicht gelöscht werden, damit die Dokumenterzeugung niemals unterbrochen wird.

Wichtig : wenn sich das erzeugte Dokument nach einer Änderung des Designs scheinbar nicht verändert hat, prüfen Sie, ob dieses Design tatsächlich die Kennzeichnung "Standard" trägt.

Reiter Optionen (globale Einstellungen)

Diese Einstellungen gelten unabhängig vom gewählten Design für alle Dokumente : Logos, Adressblöcke und betriebliche Identifikationsnummern, Seitenhintergrund, Positionsinhalte, AGB, Bankverbindung, Signaturzertifikat, Papierformat.

 

Die meisten Einstellungen sind Ein/Aus-Schalter, die sofort wirksam werden ; Papierformat und betriebliche Identifikationsnummern werden mit einer eigenen Schaltfläche Speichern bestätigt.

Hochladen der AGB

Wählen Sie im dafür vorgesehenen Block Ihre PDF-Datei mit den allgemeinen Geschäftsbedingungen aus und senden Sie sie ab. Sie erscheint anschließend in einer Auswahlliste neben der Schaltfläche Erzeugen der Rechnungsmaske und kann als Standard vorausgewählt werden.

Inbetriebnahme der elektronischen Signatur

Im Block Signaturzertifikat am Ende der Seite Optionen :

  1. Laden Sie Ihre Zertifikatsdatei hoch (.pem, .crt, .p12 oder .pfx), die sowohl das Zertifikat als auch den privaten Schlüssel enthält.
  2. Geben Sie den Grund der Signatur an (Freitext, der in den Signatureigenschaften des PDF sichtbar ist, zum Beispiel "Rechnung als richtig bescheinigt").
  3. Geben Sie das Kennwort des privaten Schlüssels an, falls dieser geschützt ist, und speichern Sie.
  4. Aktivieren Sie den Schalter "Rechnungs-PDF elektronisch signieren".
  5. Erzeugen Sie eine Rechnung und öffnen Sie sie im Acrobat Reader : im Fenster Signaturen muss die Signatur erscheinen, und das sichtbare Feld befindet sich unten rechts auf der letzten Seite.

Es wird immer nur ein Zertifikat berücksichtigt : löschen Sie das alte, bevor Sie ein neues hochladen.

Zum Testen genügt ein selbstsigniertes Zertifikat :

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout signature.key -out signature.crt

cat signature.crt signature.key > signature.pem

Acrobat zeigt die Signatur dann als "vorhanden, aber nicht vertrauenswürdig" an : das ist normal, da die Zertifizierungsstelle nicht anerkannt ist. Verwenden Sie im Produktivbetrieb ein Zertifikat einer Zertifizierungsstelle.

Vor dem Ausrollen zu beachten : das Kennwort des privaten Schlüssels wird mangels eines nativen Schlüsseltresors im Klartext in der Konstantentabelle von Dolibarr gespeichert. Beschränken Sie den Zugriff auf die Datenbank und die Sicherungen entsprechend und vergeben Sie strenge Dateirechte auf das Verzeichnis, in dem das Zertifikat abgelegt ist.

Reiter Rechnungen

Diese Seite bündelt die Einstellungen zum Inhalt der Rechnung : Adressen, Barcodes und QR-Codes, verknüpftes Projekt, Kopfbereich und Layout, Positionsspalten, gedruckte Unterschriften, PDF-Zusammenführung sowie rechnungsspezifische Einstellungen (verknüpfte Lieferungen, Teilrechnung, Online-Zahlungslink, offener Kundensaldo, Betrag in Worten...).

 

Reiter User guide (Benutzerhandbuch)

Zeigt das vollständige Handbuch des Moduls in der Sprache der Oberfläche an (Französisch oder Englisch). Es ist die maßgebliche Dokumentation und ausführlicher als diese Seite.

 

⬆ Zurück zum Inhaltsverzeichnis

Verwendung

- Öffnen Sie die Rechnungsmaske, wählen Sie dann im Block Verknüpfte Dokumente am Ende der Maske die Vorlage ultimate_invoice in der Auswahlliste "Dokumentvorlage" und klicken Sie auf Erzeugen.

- Das PDF erscheint in der Liste der angehängten Dateien : es kann heruntergeladen, angezeigt oder per E-Mail versendet werden.

- Design schnell wechseln : verwenden Sie das dafür vorgesehene Auswahlfeld im Menü oben rechts in der Anwendung, ohne die vollständige Einrichtung erneut aufzurufen.

- AGB anhängen : wählen Sie die AGB-Datei in der Auswahlliste neben der Schaltfläche Erzeugen aus.

- Weiteres PDF zusammenführen : nach Aktivierung der Option auf der Seite Rechnungen wählen Sie die zusammenzuführende(n) Datei(en) in der Rechnungsmaske aus. Bei diesen Rechnungen wird die elektronische Signatur automatisch übersprungen.

Fehlerbehebung

Symptom Wahrscheinliche Ursache
Die Vorlage ultimate_invoice fehlt in der Liste Das Modul UltimateInvoice oder das Modul Rechnungen ist nicht aktiviert
Das Dokument übernimmt die Änderungen eines Designs nicht Dieses Design trägt nicht die Kennzeichnung "Standard"
Keine Signatur und kein sichtbares Feld im PDF Kein Zertifikat hochgeladen oder Dateiendung nicht erkannt
Protokoll : skipped: additional files merging is active In diese Rechnung werden zusätzliche Dateien eingefügt, beide Funktionen schließen sich gegenseitig aus
Acrobat meldet "Signatur ungültig" Selbstsigniertes Zertifikat : beim Testen normal, im Produktivbetrieb ein Zertifikat einer anerkannten Zertifizierungsstelle verwenden
Protokoll : Error getting private key Kennwort des privaten Schlüssels fehlt oder ist falsch, oder die Datei enthält keinen privaten Schlüssel
Der Schweizer Zahlteil erscheint nicht Siehe die Meldungen SwissQr* im Dolibarr-Protokoll : andere Zahlungsart als Überweisung, nicht konforme Anschrift oder IBAN, QR-IBAN nicht unterstützt

Das Dolibarr-Protokoll (Start - Einstellungen - Andere - Protokolle) zeichnet jede Erzeugung und jeden Signaturversuch auf.

⬆ Zurück zum Inhaltsverzeichnis

Andere Sprachen

⬆ Zurück zum Inhaltsverzeichnis

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_UltimateInvoice_DE&oldid=66808"