FAQ

Das PDF wird nicht erzeugt, was tun?

Prüfen Sie die folgenden Punkte:

1. Das Modul DoliPDF ist in der Liste der Module aktiviert
2. Sie verwenden eine Dokumentvorlage im ODT-Format (DoliPDF funktioniert nicht mit den nativen PDF-Vorlagen von Dolibarr)
3. Im Fernmodus: Serveradresse, E-Mail und API-Schlüssel sind korrekt eingetragen
4. Im lokalen Modus: Der LibreOffice-Befehl ist korrekt und LibreOffice ist auf dem Server installiert
5. Ist die Option DoliPDF nur für validierte Dokumente ausführen aktiviert, prüfen Sie, ob das Dokument den Status "Validiert" hat

Ich erhalte den Fehler "Fehler bei der Übertragung der PDF-Datei"

Dieser Fehler bedeutet, dass die PDF-Datei vom DoliPDF-Server empfangen wurde, die MD5-Integritätsprüfung aber fehlgeschlagen ist. Die Datei wurde bei der Übertragung möglicherweise verändert. Erzeugen Sie das Dokument erneut. Bleibt der Fehler bestehen, prüfen Sie die Netzwerkverbindung zwischen Ihrem Dolibarr-Server und dem DoliPDF-Server.

Ich erhalte den Fehler "DoliPDF-Fehler"

Dieser allgemeine Fehler bedeutet, dass der DoliPDF-Server die Umwandlung nicht durchführen konnte. Mögliche Ursachen sind:

• Ungültiger oder abgelaufener API-Schlüssel
• DoliPDF-Server vorübergehend nicht verfügbar
• Beschädigte ODT-Datei oder nicht unterstütztes Format
• Falsche Adresse des DoliPDF-Servers

Sehen Sie in den Dolibarr-Protokollen (Datei dolibarr.log) nach, um weitere Einzelheiten zum Fehler zu erhalten.

Um die Ursache zu finden, verwenden Sie die Schaltfläche Verbindung testen der Registerkarte Konfiguration: Sie prüft die Serveradresse und den API-Schlüssel, ohne ein Dokument umzuwandeln, und zeigt eine Meldung an, die das Problem benennt.

Wie erhalte ich meinen API-Schlüssel?

Wenn Sie noch kein Konto haben, eröffnen Sie es über die Registerkarte Konto eröffnen der Modulkonfiguration: Der Schlüssel wird automatisch gespeichert, sobald Ihre Bestellung bezahlt ist (siehe Konfiguration).

Wenn Sie bereits ein Konto haben:

1. Gehen Sie auf den DoliPDF-Server (standardmäßig https://pdf.cap-rel.fr)
2. Melden Sie sich mit Ihrem Konto an
3. Öffnen Sie das Menü API-Token
4. Klicken Sie auf Neu
5. Kopieren Sie den erzeugten Schlüssel in die Konfiguration des Moduls

Die Umwandlung wird abgelehnt: "kein aktiver Tarif"

Der DoliPDF-Server wandelt Dokumente nur für ein Konto um, dessen Tarif bezahlt ist, und nur im Rahmen der Dokumentanzahl dieses Tarifs. Die Fehlermeldung enthält einen Link Einen Tarif bestellen, der die Bestellseite öffnet.

Kann ich meinen eigenen DoliPDF-Server verwenden?

Ja. Tragen Sie die Adresse Ihres Servers im Feld Adresse des DoliPDF-Servers der Konfiguration ein. Ihr Server muss eine mit dem DoliPDF-Protokoll kompatible API bereitstellen. Seit Version 1.0.18 ruft das Modul die Adressen /api/v1/pdf (Umwandlung) und /api/v1/ping (Verbindungstest) auf: Prüfen Sie vor dem Update, dass Ihr Server sie bereitstellt.

Der lokale Modus funktioniert nicht

Prüfen Sie, ob:

• Die Option LibreOffice verwenden, das lokal installiert ist aktiviert ist
• Der unter Lokaler Befehl angegebene Befehl korrekt ist und vom Benutzer des Webservers (zum Beispiel www-data) ausgeführt werden kann
• LibreOffice auf dem Server installiert und über die Kommandozeile erreichbar ist
• Der Benutzer des Webservers Schreibrechte im Zielverzeichnis der PDF-Dateien hat

Das PDF wird bei jeder Zeilenänderung neu erzeugt

Standardmäßig erzeugt Dolibarr das Dokument bei jedem Hinzufügen oder Ändern einer Artikelzeile neu, was eine DoliPDF-Umwandlung auslöst. Um das zu vermeiden, aktivieren Sie die Option Automatische PDF-Erstellung bei jedem Hinzufügen oder Ändern einer Artikelzeile deaktivieren in der Konfiguration des Moduls.

Funktioniert DoliPDF mit den nativen PDF-Dokumenten von Dolibarr?

Nein. DoliPDF wandelt nur ODT-Dateien in PDF um. Wenn Sie die nativen PDF-Vorlagen von Dolibarr verwenden (wie crabe, sponge usw.), erzeugt Dolibarr das PDF direkt, ohne DoliPDF.

Welche Dolibarr-Versionen werden unterstützt?

DoliPDF ist mit Dolibarr 14 und höher kompatibel (geprüft bis Dolibarr 24), mit mindestens PHP 7.4. Das Modul enthält eine Kompatibilitätsschicht für Versionen vor Dolibarr 16.0 (Klasse FormSetup).