Behebung von Peppol-Fehlercodes mit D Soft

Sien Jans
vor 7 Tagen
2 Min. Lesezeit

Entwickler, die unsere Peppol-Lösung integrieren, erhalten über Statusmeldungen und Fehlercodes umfangreiches Feedback. Nachfolgend finden Sie eine Übersicht über häufig auftretende Fehlermeldungen, wie Sie diese erkennen und welche Schritte Sie unternehmen können. Alle Beispiele basieren auf den Prozessen, die wir auf unserer Peppol-Seite beschreiben.

Allgemeiner Debugging-Ansatz

Überprüfen Sie das Dokumentformat: Validierungen erfolgen gemäß EN 16931/Peppol BIS. Eine fehlende IBAN oder ein falscher Umsatzsteuercode führen schnell zu einem Fehler.
Überprüfen Sie Ihre SMP-Daten: Das Register legt fest, welche Dokumenttypen Sie empfangen können. Sind neue Prozesse noch nicht registriert, erhalten Sie eine Ablehnung. Verwenden Sie diesen Link, um Ihre Dokumente zu validieren: https://ecosio.com/en/peppol-e-invoice-xml-document-validator/ (wählen Sie Openpeppol UBL Invoice/Creditnote).
Verwenden Sie DocTrails Monitoring: Unsere Lösung zeigt Statusmeldungen an, sodass Entwickler genau sehen können, an welcher Ecke des 4-Ecken-Modells der Fehler aufgetreten ist.

Häufig gesuchte Fehlercodes

Fehlende Pflichtfelder

Dieser Fehler tritt auf, wenn ein Pflichtfeld (z. B. „cbc:ID” oder „cbc:EndpointID”) fehlt. Der Validator des Access Points stoppt die Übertragung.

Lösung: Überprüfen Sie die Zuordnung in Ihrem ERP-System oder Integrationskonnektor. Füllen Sie das Feld aus und senden Sie es erneut.

Ungültige KBO-Nummer

Wenn die KBO-Nummer nicht der erforderlichen Struktur (10 Ziffern) entspricht oder nicht mit den Angaben im SMP übereinstimmt, erhalten Sie diese Meldung.

Lösung: Validieren Sie die KBO-Nummer über die ERP-Stammdaten. Wenn sich die Nummer kürzlich geändert hat, bitten Sie unsere Berater, das SMP zu aktualisieren.

Falsche Codelistenwert

Peppol verwendet feste Codelisten für Umsatzsteuercodes, Ländercodes und Dokumenttypen. Ein unbekannter Wert führt zu einer Ablehnung.

Lösung: Ersetzen Sie den Wert durch einen zulässigen Code (z. B. „S” für Standardumsatzsteuer). Weitere Informationen finden Sie in der Dokumentation auf unserer Peppol-Seite oder in DocTrails.

Falsche Peppol-ID

Wenn Ihr Teilnehmer im SMP nicht gefunden wird oder Ihr mit unserer API verknüpftes JWT-Token abgelaufen ist, erhalten Sie diese Meldung.

Lösung: Überprüfen Sie, ob die Peppol-ID (=KBO-Nummer) korrekt ist und ob die Teilnehmerregistrierung aktiv ist.

Empfänger nicht erreichbar

Dieser Status wird angezeigt, wenn der Access Point des Empfängers nicht erreichbar ist oder wenn der Dokumenttyp für diese Partei nicht zulässig ist.

Lösung: Überprüfen Sie mit dem Kunden, ob er den Dokumenttyp unterstützt. Gegebenenfalls registriert unser SMP-Dienst ihn schnell für Sie.

Geschäftsregel blockiert

DocTrails kann benutzerdefinierte Regeln enthalten (z. B. obligatorische Angabe der Bestellnummer). Wenn eine Regel fehlschlägt, wird dieser Fehler angezeigt.

Lösung: Überprüfen Sie in DocTrails, welche Regel ausgelöst wurde. Fügen Sie die fehlenden Informationen hinzu oder passen Sie die Regel über das Verwaltungsportal an.

Best Practices für Entwickler

Automatische Wiederholungsversuche: Senden Sie Dokumente erneut, wenn es sich um einen vorübergehenden Netzwerkfehler handelt, aber beschränken Sie die Anzahl der Wiederholungsversuche auf drei.
Protokollierung + Korrelations-IDs: Verwenden Sie dieselbe ID wie in DocTrails, damit der Support die Nachricht schnell finden kann.
Testumgebung: Nutzen Sie unsere Akzeptanzumgebung, um neue Zuordnungen zu validieren, bevor Sie live gehen.
Nutzen Sie unsere Checkliste: Kombinieren Sie diesen Artikel mit der Peppol Readiness Checklist 2026, um festzustellen, ob Ihre Einrichtung bereit ist.