Fehlercodes beim E-Mail-Versand
Fehlercodes beim E-Mail-Versand
Schlägt der Versand eines Formulars fehl, liefert PixelForms einen eindeutigen Fehlercode statt einer allgemeinen Meldung. Der Code benennt die Ursache und lässt sich gefahrlos weitergeben — er enthält keine Hosts, E-Mail-Adressen, IP-Adressen oder Zugangsdaten.
Wo der Code erscheint
Im Log unter var/log/ — die vollständige Diagnose:
grep -a "PIXELFORMS MAIL FAILED" var/log/*.log | tail -20Beispielzeile:
PIXELFORMS MAIL FAILED {"code":"PXF-MAIL-101","smtp":"5.7.8","formId":"018f…","exception":"TransportException","detail":"Expected response code \"250\" but got code \"535\", with message \"535 5.7.8 Authentication credentials invalid\"."}code
Fehlercode aus der Tabelle unten
smtp
Statuscode des Mailservers, sofern übermittelt
formId
ID des betroffenen Formulars
exception
technische Fehlerklasse
detail
Meldung des Mailservers, um Hosts und Adressen bereinigt
In der Server-Antwort des Formulars im Feld message:
{
"success": true,
"type": "danger",
"message": "PXF-MAIL-101"
}Übersicht
PXF-MAIL-101
Authentifizierung fehlgeschlagen
535, 534, 530
PXF-MAIL-102
Absenderadresse abgelehnt
550 5.7.60, 553
PXF-MAIL-103
Empfängeradresse abgelehnt
550 5.1.1
PXF-MAIL-104
Keine Verbindung zum Mailserver
—
PXF-MAIL-105
TLS/SSL-Fehler
—
PXF-MAIL-106
Sendelimit erreicht
421, 450, 4.7.0
PXF-MAIL-107
Relaying verweigert
554 5.7.1
PXF-MAIL-108
Nachricht abgelehnt
552
PXF-MAIL-109
Ungültige E-Mail-Adresse in der Konfiguration
—
PXF-MAIL-110
E-Mail-Vorlage nicht gefunden
—
PXF-MAIL-111
Keine Vorlagen-ID übergeben
—
PXF-MAIL-199
Unbekannter Fehler
—
Die Codes im Einzelnen
PXF-MAIL-101 — Authentifizierung fehlgeschlagen
Der Mailserver hat Benutzername oder Passwort abgelehnt.
Prüfen: Zugangsdaten unter Einstellungen → System → Mailer. Der Benutzername ist bei den meisten Providern die vollständige E-Mail-Adresse, nicht der Kontoname. Bei Microsoft 365 und Google Workspace mit aktivierter Zwei-Faktor-Authentifizierung wird ein eigenes App-Passwort benötigt. Bei OAuth2: Token abgelaufen oder die erteilte Berechtigung reicht für den Mailversand nicht aus.
PXF-MAIL-102 — Absenderadresse abgelehnt
Der Mailserver akzeptiert die verwendete Absenderadresse nicht. Authentifizierte SMTP-Server lassen in der Regel nur die Adresse als Absender zu, mit der sich der Shop angemeldet hat.
Der Fehler tritt auf, wenn das Formular die Adresse des Formularausfüllers oder eine abweichende Empfängeradresse als Absender verwendet.
Lösung: In der Plugin-Konfiguration die Option „Andere ReplyTo Sendemethode" aktivieren. Die Besucheradresse wird dann als Reply-To gesetzt statt als Absender; Antworten gehen weiterhin an den Besucher. Verwenden Sie zusätzliche Empfänger, aktivieren Sie ebenso „Andere Zusätzliche Empfänger E-Mail Sendemethode".
PXF-MAIL-103 — Empfängeradresse abgelehnt
Der Mailserver kennt eine der Empfängeradressen nicht oder verweigert die Zustellung.
Prüfen: das Feld „Zusätzliche Empfänger" in der Formularkonfiguration sowie die Shop-E-Mail-Adresse unter Einstellungen → Shop → Grundeinstellungen.
PXF-MAIL-104 — Keine Verbindung zum Mailserver
Der Shop erreicht den Mailserver nicht. Es kommt keine Serverantwort zustande.
Prüfen: Servername und Port unter Einstellungen → System → Mailer. Übliche Ports sind 587 (STARTTLS) und 465 (SSL). Blockiert die Firewall des Hosters ausgehende Verbindungen auf diesem Port? Ist der Hostname korrekt geschrieben und per DNS auflösbar?
PXF-MAIL-105 — TLS/SSL-Fehler
Die Verbindung kommt zustande, die Verschlüsselung schlägt fehl.
Prüfen: Passt die eingestellte Verschlüsselung zum Port? Port 465 erwartet SSL, Port 587 erwartet STARTTLS. Weitere Ursachen sind abgelaufene oder selbstsignierte Zertifikate auf dem Mailserver.
PXF-MAIL-106 — Sendelimit erreicht
Der Mailserver drosselt den Versand oder das Kontingent des Kontos ist ausgeschöpft. Der Fehler ist vorübergehend.
Prüfen: Sendelimits des Providers. Bei wiederholtem Auftreten das Kontingent erhöhen oder den Versand über einen dedizierten Mailservice abwickeln.
PXF-MAIL-107 — Relaying verweigert
Der Mailserver erlaubt dem Konto nicht, an die angegebene Empfängeradresse zuzustellen.
Prüfen: Ist die Authentifizierung in den Mailer-Einstellungen aktiviert? Ohne Anmeldung verweigern die meisten Server die Weiterleitung an externe Adressen. Zusätzlich beim Provider prüfen, ob das Konto zum Versand freigeschaltet ist.
PXF-MAIL-108 — Nachricht abgelehnt
Der Mailserver hat die Nachricht selbst zurückgewiesen, meist wegen Größe oder Inhalt.
Prüfen: Größe der hochgeladenen Dateien gegen die Maximalgröße des Mailservers. Bei Spam-Verdacht den Inhalt der E-Mail-Vorlage prüfen.
PXF-MAIL-109 — Ungültige E-Mail-Adresse in der Konfiguration
Eine der verwendeten Adressen ist leer oder syntaktisch fehlerhaft.
Prüfen: Das Feld „Zusätzliche Empfänger" darf nicht leer bleiben, wenn die ReplyTo-Option deaktiviert ist. Ebenso die Shop-E-Mail-Adresse unter Einstellungen → Shop → Grundeinstellungen.
PXF-MAIL-110 — E-Mail-Vorlage nicht gefunden
Die im Formular hinterlegte E-Mail-Vorlage existiert nicht mehr, etwa weil sie gelöscht wurde.
Prüfen: Formular öffnen und die E-Mail-Vorlage neu zuweisen.
PXF-MAIL-111 — Keine Vorlagen-ID übergeben
Das Formular hat beim Absenden keine E-Mail-Vorlage mitgeschickt.
Prüfen: Formularkonfiguration auf eine zugewiesene Vorlage prüfen, anschließend den Shop-Cache leeren.
PXF-MAIL-199 — Unbekannter Fehler
Der Fehler ließ sich keiner bekannten Ursache zuordnen.
Prüfen: Das Feld detail der Log-Zeile enthält die Originalmeldung des Mailservers.
Zusätzliche Fehlerquelle im Log
Shopware protokolliert Versandfehler unabhängig vom Plugin. Diese Zeilen enthalten die unbereinigte Originalmeldung:
Hinweis zur Zuordnung
Die Zuordnung erfolgt anhand der Klartextmeldung des Mailservers, nicht allein anhand der SMTP-Nummer: Der Code 550 steht je nach Server sowohl für eine abgelehnte Absender- als auch für eine abgelehnte Empfängeradresse. Formuliert ein Mailserver seine Antwort ungewöhnlich, kann die Meldung als PXF-MAIL-199 eingestuft werden. Das Feld detail enthält in diesem Fall den Originaltext.
Last updated