> For the complete documentation index, see [llms.txt](https://docs.pixeleyes.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixeleyes.de/anleitungen-instructions/deutsch/dokumentation-unserer-shopware-6-plugins/formular-manager-fur-shopware-6/fehlercodes-beim-e-mail-versand.md). # 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. {% hint style="info" %} Der Besucher des Shops sieht den Code **nicht**. Im Storefront erscheint weiterhin ausschließlich der Fehlertext, den Sie in der Formularkonfiguration hinterlegt haben. {% endhint %} ### Wo der Code erscheint **Im Log** unter `var/log/` — die vollständige Diagnose: ```bash 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`: ```json { "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"**. {% hint style="warning" %} 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. {% endhint %} #### 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: ```bash grep -a "Could not send mail with error message" var/log/*.log | tail -20 ``` {% hint style="danger" %} Diese Zeilen können Hostnamen und E-Mail-Adressen enthalten. Vor der Weitergabe an Dritte prüfen. {% endhint %} ### 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.