English Version

Zurück zur Übersicht

PDF-Rechnungen: Fehlerbehebung

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.

Fehler des Moduls werden über den OXID-Logger protokolliert. Die meisten Meldungen beginnen mit [mmd_pdfinvoice]. Die Einstellung "Debug-Logging aktivieren" ist für zusätzliche Ablaufmeldungen des Moduls vorgesehen. Fehlermeldungen werden davon unabhängig immer protokolliert.

Der Tab "PDF-Rechnung" fehlt in der Bestellung

Symptom: In den Bestelldetails gibt es keinen Tab "PDF-Rechnung".

1. Prüfen, ob das Modul aktiviert ist (Erweiterungen > Module).
2. Den Cache leeren: vendor/bin/oe-console oe:cache:clear.
3. Das Modul deaktivieren und wieder aktivieren, damit die Menü-Konfiguration neu eingelesen wird.

Meldung "Fehler bei der Rechnungserstellung."

Symptom: Beim Klick auf "Rechnung erstellen" erscheint diese Meldung.

1. Das OXID-Log nach Einträgen mit Invoice creation failed oder PDF generation failed durchsuchen. Sie enthalten die Ursache.
2. Prüfen, ob der Webserver-Benutzer in den Speicherpfad (Standard source/export/invoices) schreiben darf.
3. Prüfen, ob der Webserver-Benutzer in source/tmp/dompdf schreiben darf.
4. Prüfen, ob die Tabellen mmd_pdfinvoice und mmd_pdfinvoice_seq existieren. Sie werden bei der Aktivierung angelegt.

Die Rechnung hängt nicht an der Bestellmail

Symptom: Die Bestellbestätigung kommt ohne PDF an.

Prüfe der Reihe nach:

1. E-Mail-Anhang: Steht die Einstellung auf "Nicht anhängen", oder passt sie nicht zum Empfänger? "Nur an Kunde" hängt die Rechnung nicht an die Mail an den Shopbetreiber an und umgekehrt.
2. Automatisch erstellen: Ist die Option aus und gibt es noch keine Rechnung zur Bestellung, wird keine angehängt. Erstelle die Rechnung im Admin oder aktiviere die Option.
3. Log: Das OXID-Log nach Failed to attach invoice PDF to email durchsuchen. Das Anhängen schlägt dann fehl, die Bestellmail wird trotzdem versendet.
4. Cache: Nach Änderungen an den Einstellungen den Cache leeren.

Der Download oder der Anhang schlägt fehl (Integritätsprüfung)

Symptom: Im Admin erscheint "Fehler beim Herunterladen der Rechnung.", im Log steht PDF integrity check failed oder PDF file not found.

Ursache: Beim Lesen der PDF-Datei vergleicht das Modul ihren SHA-256-Hashwert mit dem gespeicherten Wert. Die Datei wurde verändert, ersetzt oder gelöscht.

Lösung: Im Tab "PDF-Rechnung" auf "PDF neu generieren" klicken. Das Modul erzeugt das PDF aus dem Snapshot neu, ersetzt die Datei und speichert den neuen Hashwert.

Meldung "Für diese Bestellung existiert bereits eine Rechnung."

Je Bestellung und Shop gibt es genau eine Rechnung, das erzwingt ein eindeutiger Schlüssel in der Datenbank. Eine zweite Rechnung kann das Modul nicht anlegen.

"PDF neu generieren" rendert das PDF aus dem gespeicherten Snapshot der Bestellung. Damit lassen sich nur Änderungen an Stammdaten, Logo und Template übernehmen. Falsche Bestelldaten im Snapshot (Adresse, Positionen, Preise) korrigiert das nicht.

Logo wird nicht angezeigt

1. Der Pfad muss relativ zu out/pictures/ angegeben sein.
2. Die Datei muss unter out/pictures/ tatsächlich existieren, sonst wird kein Logo gedruckt und der Shop-Name erscheint stattdessen.
3. Bei leerem Feld verwendet das Modul das Shop-Logo aus den Shop-Einstellungen. Prüfe, ob dieses ebenfalls unter out/pictures/ liegt.
4. Nach dem Ändern des Logos "PDF neu generieren" klicken, bereits erstellte PDFs ändern sich nicht von selbst.

Falsche Bankdaten oder Firmendaten auf der Rechnung

Die Angaben im Kopf, in der Fußzeile und im Zahlungsblock stammen aus den Shop-Stammdaten im OXID Admin (Stammdaten > Grundeinstellungen > Stammdaten). Sie werden bei jeder PDF-Erzeugung neu gelesen. Nach einer Änderung der Stammdaten wirkt sich das nur auf neue Rechnungen und auf neu generierte PDFs aus.

Lücken in der Rechnungsnummerierung

Ursache: Die Rechnungsnummer wird vergeben, bevor das PDF erzeugt und gespeichert wird. Schlägt die Erzeugung oder Ablage danach fehl, bleibt die Nummer verbraucht und es entsteht eine Lücke, weil für diese Bestellung keine Rechnung gespeichert wurde.

Hinweis: Prüfe bei fortlaufend nummerierten Rechnungen im Log, ob ein Fehler dahinter steckt, und dokumentiere solche Lücken in deiner Buchhaltung.

PDF-Rechnung ist nicht auf Englisch

Das Rechnungs-Template enthält die Texte fest auf Deutsch, unabhängig von der Shop-Sprache. Siehe Template und Variablen.

Rechnungs-E-Mail aus dem Admin wird nicht gesendet

Symptom: "E-Mail-Versand fehlgeschlagen".

1. Prüfen, ob die Bestellung eine Rechnungs-E-Mail-Adresse hat. Ohne Adresse wird nicht gesendet.
2. Prüfen, ob der normale E-Mail-Versand des Shops funktioniert (Absenderadresse aus den Shop-Stammdaten, Mail-Konfiguration).
3. Das OXID-Log nach Invoice email failed durchsuchen.

Lastschrift-Rechnung zeigt keine IBAN des Kunden

Die Bankdaten des Kunden stehen nur auf der Rechnung, wenn die Zahlungsart oxiddebitnote ist und die Bankdaten in der Bestellung gespeichert sind. Fehlen sie, bleibt die IBAN-Angabe im SEPA-Block leer.