Inhaltsverzeichnis

  1. Einführung

  2. Verstehen, wie Dolibarr die PDF-Generierung handhabt

  3. Die temporäre Natur von PDF-Dateien in Dolibarr

  4. Wo werden PDFs gespeichert (und wie lange)?

  5. Häufige Missverständnisse zum Speichern von Dokumenten

  6. Dateigenerierung vs. Dateispeicherung in Dolibarr

  7. Modulverhalten: Rechnungen, Bestellungen, Angebote usw.

  8. Konfigurationseinstellungen mit Auswirkungen auf die PDF-Verarbeitung

  9. Überlegungen zu Berechtigungen und Serverumgebung

  10. Was passiert, wenn Sie eine PDF-Datei neu generieren?

  11. So speichern und archivieren Sie PDFs automatisch

  12. Nachverfolgen generierter PDFs aus rechtlichen oder Prüfungsgründen

  13. Verwenden externer Datei-Repositories (Dropbox, Nextcloud, FTP)

  14. Problemumgehung: Automatisches Kopieren von PDF-Dateien

  15. Best Practices für die Dokumentenaufbewahrung in Dolibarr

  16. Vermeiden von Datenverlust durch temporäre Dateien

  17. So verarbeiten benutzerdefinierte Module das Speichern von PDF-Dateien

  18. Unterschiede im Verhalten zwischen gehostetem und selbstgehostetem Dolibarr

  19. Wann Sie um Entwicklerhilfe bitten sollten

  20. Fazit: PDF-Dateien sicher in Dolibarr verwalten

1. Einleitung

Dolibarr ist eine robuste ERP- und CRM-Lösung für kleine und mittlere Unternehmen. Zu den zahlreichen Funktionen gehört die Erstellung von PDF-Dokumenten wie Rechnungen, Angeboten, Lieferscheinen und mehr. Neue Nutzer fragen sich jedoch häufig: „Warum speichert Dolibarr die generierten PDF-Dokumente nicht standardmäßig?“

Dieser Artikel befasst sich eingehend mit der Architektur, Logik und den Best Practices zur PDF-Dokumentenverarbeitung in Dolibarr. Wenn Sie dies verstehen, können Sie Dateien besser verwalten, Datenverlust vermeiden und Ihr System an Ihre Geschäftsanforderungen anpassen.

2. Verstehen, wie Dolibarr die PDF-Generierung handhabt

Dolibarr verwendet standardmäßig keine vorgespeicherten PDFs. Stattdessen generiert es Dokumente auf Anfrage. Sobald ein Benutzer eine PDF-Datei anklickt, um sie anzuzeigen oder herunterzuladen, erstellt Dolibarr die Datei dynamisch mithilfe von Daten aus seiner Datenbank und einer vordefinierten Vorlage.

Dieser Ansatz stellt Folgendes sicher:

  • Das PDF spiegelt die aktuellsten Daten wider

  • Es wird kein Speicherplatz für veraltete oder ungenutzte Dateien verschwendet

  • Vorlagen und Layouts können aktualisiert werden, ohne dass alle vorhandenen Dateien neu generiert werden müssen

3. Die temporäre Natur von PDF-Dateien in Dolibarr

Standardmäßig speichert Dolibarr PDF-Dateien nur temporär. Das System speichert sie im /documents/ Verzeichnis, oft unter einer Struktur wie /documents/facture/, /documents/propal/ oder /documents/commande/.

Wenn die Datei jedoch bereits vorhanden ist, überschreibt Dolibarr sie möglicherweise, sofern nicht anders konfiguriert. Wenn Sie ein Dokument neu generieren, erstellt Dolibarr es mit den neuesten Daten neu.

4. Wo werden PDFs gespeichert (und wie lange)?

Dolibarr organisiert Dateien nach Modul:

  • Rechnungen: /documents/facture/REF/

  • Bestellungen: /documents/commande/REF/

  • Vorschläge: /documents/propal/REF/

Diese Ordner enthalten PDF-Dateien, sofern diese heruntergeladen oder explizit generiert wurden. Wenn Sie jedoch nie auf die Generierung einer PDF-Datei geklickt haben, ist diese möglicherweise nicht auf der Festplatte vorhanden.

PDFs bleiben gespeichert, sofern sie nicht manuell gelöscht oder durch eine Systembereinigung entfernt werden. Es gibt keinen automatischen Ablauf, aber beim erneuten Generieren werden die Dateien überschrieben, sofern keine Dateiversionierung verwendet wird.

5. Häufige Missverständnisse beim Speichern von Dokumenten

Benutzer gehen oft davon aus:

  • PDFs werden nach der Validierung automatisch gespeichert – sie sind nicht

  • Bei allen Aktionen werden Dateien auf der Festplatte erstellt – nur die Dokumentgenerierung

  • PDFs werden dauerhaft gespeichert – nur bei manueller Aufbewahrung

Das Verständnis, dass die PDF-Generierung von der Speicherung getrennt ist, ist der Schlüssel zur Verwaltung von Dokumenten in Dolibarr.

6. Dateigenerierung vs. Dateispeicherung in Dolibarr

So funktioniert Dolibarr normalerweise:

  • Ein Dokument (z. B. eine Rechnung) wird erstellt und validiert

  • An dieser Stelle wird keine Datei gespeichert

  • Der Benutzer klickt auf „PDF generieren“

  • Dolibarr erstellt die Datei anhand der Vorlage und speichert sie im entsprechenden Verzeichnis

  • Die Datei bleibt bestehen, bis sie gelöscht oder überschrieben wird

Diese Trennung bietet Flexibilität, erfordert jedoch Aufmerksamkeit, um spätere Dateiverluste zu vermeiden.

7. Modulverhalten: Rechnungen, Bestellungen, Angebote usw.

Jedes Modul behandelt Dokumente etwas anders:

  • Rechnungen: PDFs werden nur beim Anklicken erstellt; sie können jederzeit neu generiert werden

  • Bestellungen: Dieselbe Logik gilt

  • Vorschläge: Kann optional Wasserzeichen und Status enthalten

Es empfiehlt sich, nach der Validierung PDFs zu erstellen und zu speichern, um eine Aufzeichnung des Dokuments zum Zeitpunkt seiner Fertigstellung zu haben.

8. Konfigurationseinstellungen, die die PDF-Verarbeitung beeinflussen

Sie können einige Verhaltensweisen konfigurieren:

  • Gehe zu Setup > Module > PDF-Vorlagen

  • Legen Sie Standardvorlagen fest und aktivieren Sie die automatische Generierung (in begrenzten Modulen).

  • Verwenden Sie die Einstellungen für den Dokumentverzeichnispfad unter Setup > Anderes Setup beim Anpassen der Dateistruktur

Diese Einstellungen beeinflussen, wo und wie PDFs generiert und gespeichert werden.

9. Berechtigungen und Überlegungen zur Serverumgebung

Dolibarr muss Schreibrechte für die /documents/ Ordner. Wenn die Berechtigungen falsch konfiguriert sind:

  • PDFs dürfen nicht gespeichert werden

  • Die Dateigenerierung kann unbemerkt fehlschlagen

Stellen Sie sicher, dass Ihr Apache/Nginx-Benutzer über den richtigen Zugriff verfügt und dass Ihre Serverumgebung (insbesondere bei Shared Hosting) das Schreiben von Dateien unterstützt.

10. Was passiert, wenn Sie eine PDF-Datei neu generieren?

Wenn Sie ein Dokument neu generieren:

  • Die alte Datei wird überschrieben (sofern der Dateiname gleich ist)

  • Der Inhalt wird aktualisiert, um aktuelle Daten widerzuspiegeln

Dies ist zum Korrigieren von Daten nützlich, aber problematisch, wenn Sie die Originalversion für Rechts- oder Prüfzwecke aufbewahren müssen.

11. So speichern und archivieren Sie PDFs automatisch

Optionen zum automatischen Speichern:

  • Verwenden Sie einen Cron-Job, um die PDF-Generierung nach der Validierung auszulösen

  • Fügen Sie ein Modul oder einen Hook hinzu, um PDFs automatisch zu generieren und zu sperren

  • PDF-Dateien per Skript in ein Archivverzeichnis verschieben

Dadurch wird sichergestellt, dass jedes validierte Dokument auch in seinem Originalzustand erhalten bleibt.

12. Nachverfolgen generierter PDFs aus rechtlichen oder Prüfungsgründen

So stellen Sie die Auditbereitschaft sicher:

  • Generieren Sie PDFs zum Zeitpunkt der Dokumentvalidierung

  • Verschieben oder kopieren Sie die Dateien in ein schreibgeschütztes Archiv

  • Verwenden Sie Versionierung (z. B. Rechnung-2025-01-V1.pdf), um Überschreibungen zu vermeiden

Dies ist insbesondere in Ländern mit strengen Anforderungen an die elektronische Rechnungsstellung oder Mehrwertsteuerarchivierung von entscheidender Bedeutung.

13. Verwenden externer Datei-Repositories (Dropbox, Nextcloud, FTP)

Dolibarr kann in externen Speicher integriert werden:

  • Verwenden Sie Module zum Synchronisieren /documents/ zu Cloud-Diensten

  • Automatisieren Sie die Sicherung von PDF-Dateien auf FTP oder SFTP

  • Implementieren Sie WebDAV oder freigegebene Ordner für den Teamzugriff

Dies erhöht die Dokumentensicherheit und -verfügbarkeit.

14. Workaround: PDF-Dateien automatisch kopieren

Verwenden Sie ein Skript (Bash, Python usw.), um die /documents/ Verzeichnis und:

  • Neue Dateien erkennen

  • Kopieren Sie sie an einen anderen Ort

  • Benennen Sie sie zum Archivieren um

Richten Sie dieses Skript als Cron-Job ein, um es stündlich oder täglich auszuführen.

15. Best Practices für die Dokumentenaufbewahrung in Dolibarr

  • Bei der Dokumentvalidierung immer PDFs generieren

  • Verwenden Sie Namenskonventionen für die Versionsverfolgung

  • Bewahren Sie ein separates Backup außerhalb des Dolibarr-Servers auf

  • Schulen Sie Benutzer darin, wann und wie PDFs erstellt werden

16. Vermeidung von Datenverlust durch temporäre Dateien

Wenn nie ein PDF erstellt oder gespeichert wurde:

  • Es kann nicht aus dem Verlauf abgerufen werden

  • Sie müssen es neu generieren – was möglicherweise nicht mehr die ursprünglichen Daten widerspiegelt

Schützen Sie sich davor, indem Sie zum Zeitpunkt der Dokumentgenehmigung Generierungsrichtlinien durchsetzen.

17. So handhaben benutzerdefinierte Module das Speichern von PDF-Dateien

Einige Dolibarr-Erweiterungen bieten Funktionen zur automatischen Speicherung oder PDF-Protokollierung. Diese Module können:

  • Automatische Generierung von PDFs bei Ereignisauslösern

  • Protokollieren Sie, wann und von wem ein PDF erstellt wurde

  • Speichern Sie Backups auf externen Systemen

Wählen Sie seriöse Module von Dolistore oder arbeiten Sie mit einem Entwickler zusammen, um diese Funktion hinzuzufügen.

18. Unterschiede im Verhalten zwischen gehostetem und selbstgehostetem Dolibarr

Gehostete Dolibarr-Versionen (z. B. SaaS-Anbieter):

  • Kann den Zugriff auf das Dateisystem einschränken

  • Kann alte Dateien automatisch bereinigen

  • Für Massendownloads ist häufig ein Support-Ticket erforderlich

Selbst gehostete Installationen bieten mehr Kontrolle über die Dokumentenspeicherung, Skripterstellung und Sicherungen.

19. Wann Sie um Entwicklerhilfe bitten sollten

Wenden Sie sich an einen Dolibarr-Integrator, wenn:

  • Sie benötigen eine automatische Archivierung

  • Sie möchten Cloud-Speicher integrieren

  • Sie haben revisionsspezifische Anforderungen an die PDF-Versionierung

Benutzerdefinierte Skripte oder Module können diese Lücken effektiv schließen.

20. Fazit: PDF-Dateien sicher in Dolibarr verwalten

Dolibarrs Ansatz zur PDF-Generierung setzt auf Flexibilität und Effizienz – überträgt aber die Verantwortung für das Speichern und Archivieren von Dokumenten auf den Benutzer. Sobald Sie verstehen, wie PDFs generiert werden, wo sie gespeichert werden und wie Sie den Prozess steuern, können Sie Compliance sicherstellen, Datenverluste minimieren und Ihre Geschäftsabläufe optimieren.

Ob integrierte Tools, intelligente Skripts oder externer Speicher: Dolibarr bietet alles, was Sie zur Verwaltung von Dokumenten benötigen – wenn Sie wissen, wie Sie es richtig konfigurieren.