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.

Der Besucher des Shops sieht den Code nicht. Im Storefront erscheint weiterhin ausschließlich der Fehlertext, den Sie in der Formularkonfiguration hinterlegt haben.

Wo der Code erscheint

Im Log unter var/log/ — die vollständige Diagnose:

grep -a "PIXELFORMS MAIL FAILED" var/log/*.log | tail -20

Beispielzeile:

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\"."}

Feld	Bedeutung
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

Code	Bedeutung	Typische Serverantwort
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".

Bei Microsoft 365, Google Workspace und beim Versand über OAuth2 sind diese beiden Optionen zwingend erforderlich. Diese Anbieter lassen eine fremde Absenderadresse grundsätzlich nicht zu.

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:

grep -a "Could not send mail with error message" var/log/*.log | tail -20

Diese Zeilen können Hostnamen und E-Mail-Adressen enthalten. Vor der Weitergabe an Dritte prüfen.

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.