---
title: "FAQ"
weight: 50
description: "Häufige Fragen zum Modul DoliPDF: Fehlerbehebung, typische Fehler und Tipps."
source_hash: "80ea28ec"
---

# 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](/dolipdf/configuration)).

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](/dolipdf/configuration) 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](/dolipdf/configuration) 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`).