Skip to main content

Proposals & Invoices · Article 5.7

Peppol – IDs, Netzwerkweiterleitung, Fehlerzustände

Peppol ist das universelle E-Rechnungsnetzwerk der EU. Senden Sie eine Peppol-UBL-Rechnung über Clozo, und sie wird über Ihren Access Point, das Peppol-Verzeichnis, den Access Point des Kunden und in dessen Buchhaltungssystem weitergeleitet – in der Regel innerhalb von 1–10 Minuten.

Peppol ist eines jener Akronyme, das einschüchternd aussieht, in der Praxis aber einer der einfacheren E-Rechnungskanäle ist. Es ist ein Vier-Ecken-Netzwerk: Sie, Ihr Access Point (AP), der AP des Empfängers und der Empfänger. Das Peppol-Verzeichnis teilt Ihrem AP mit, wohin geliefert werden soll; das Format ist standardisiert; die Zertifikate werden zentral verwaltet. Sobald beide Parteien registriert sind, ist das Senden einer Rechnung ein einziger API-Aufruf.

Step by step

  1. Peppol-ID registrieren

    (einmalig): /settings/payments → Peppol-Bereich → Registrieren. Zustimmungsbildschirm bestätigen. Auf das „Registriert"-Abzeichen warten (ca. 5 Minuten Einrichtung, ca. 1–4 Stunden Verbreitung im Verzeichnis).

  2. Peppol-ID des Kunden hinzufügen

    : /clients/{id} → Peppol-Bereich → vollständige Teilnehmer-ID eingeben (z. B. iso6523-actorid-upis::0007:1234567890).

  3. Generieren und senden

    : im Dokumente-Dropdown neben einer Rechnung auf „Via Peppol senden" klicken. Die Übermittlung startet; die Timeline verzeichnet den Versuch.

  4. Zustellung beobachten

    : Innerhalb von 1–10 Minuten aktualisiert die Timeline mit „An empfangenden AP zugestellt" (Erfolg) oder einem Fehlercode.

  5. Bei Bedarf wiederholen

    : Im Timeline-Ereignis auf Peppol-Zustellung wiederholen klicken, wenn sie fehlgeschlagen ist. Nützlich bei vorübergehenden Problemen (kurzer Netzwerkausfall, AP-Timeout). Bei „Empfänger nicht gefunden" zuerst die ID korrigieren.

Eine Aktion „Via Peppol senden" bei jeder Rechnung im Dokumentebereich. Timeline-Ereignisse für Übermittlung, Zustellbestätigung und etwaige Fehler. Das Angebots-Banner zeigt „Rechnung via Peppol zugestellt am [Datum]", sobald der Vorgang erfolgreich war.

Why this works this way

Peppol-Teilnehmer-IDs (die „ID an der Ecke des Netzwerks"). Jede Partei in Peppol hat eine eindeutige ID in einem bestimmten Schema. Für die meisten EU-Länder wird das Schema iso6523-actorid-upis mit einem Unterschema verwendet, das die Behörde des Landes identifiziert:

- 0007 – Schweden (Organisationsnummer) - 0088 – Norwegen (Foretaksregister) - 0192 – Norwegen (Mva-Register) - 0009 – Frankreich (SIRET) - 0204 – Italien (IPA) - 0184 – Dänemark (CVR) - 9925 – Belgien USt - 9930 – Deutschland USt - 9931 – Frankreich USt - 9932 – Spanien USt - 9933 – Italien USt - 9934 – Niederlande USt - 0007:1234567890 ist dann eine vollständige Teilnehmer-ID für ein schwedisches Unternehmen mit der Org.-Nr. 1234567890.

Clozo registriert Ihre Peppol-ID mithilfe Ihrer Umsatzsteuernummer im für Ihr Land passenden Schema (automatisch aus Ihrem Profilland ausgewählt). Die Registrierung ist ein einmaliger Vorgang, der ca. 5 Minuten dauert und sich innerhalb von 1–4 Stunden im Peppol-Verzeichnis verbreitet.

Das Vier-Ecken-Modell.

`` [Sie] [Empfänger] ↓ ↑ [Ihr AP] [AP des Empfängers] ↓ ↑ └──── Peppol-Netzwerk ─────┘ (SMP-Verzeichnis + Zertifikate) ``

Ihr AP ist das Gateway, über das Ihre Rechnungen das Netzwerk verlassen. Der Peppol SMP (Service Metadata Publisher) ordnet Teilnehmer-IDs AP-Endpunkten zu – Ihr AP fragt ihn ab, um zu ermitteln, wohin zugestellt werden soll. Der AP des Kunden ist das Gateway, über das Rechnungen eingehen; von dort wird sie über die jeweilige lokale Integration in sein Buchhaltungs-/ERP-System übertragen (in der Regel Plugins für SAP, Microsoft Dynamics, NetSuite, Visma, Exact usw.).

Clozo verwendet einen vorintegrierten AP-Anbieter; Sie müssen keinen auswählen. Ihre Rechnungen verlassen automatisch über diesen AP; die Empfängerseite ist Sache des Kunden.

Das Format: UBL EN 16931. EN 16931 ist die Europäische Norm für das semantische Datenmodell einer E-Rechnung. UBL ist eine der beiden Syntaxbindungen (die andere ist UN/CEFACT CII; beide übertragen dasselbe EN-16931-Modell). Peppol verwendet das Peppol BIS Billing 3.0 Profil, das im Wesentlichen EN 16931 mit einigen Peppol-spezifischen Einschränkungen ist. Clozo gibt BIS-Billing-3.0-konformes XML aus.

Der Weiterleitungsablauf:

1. Sie klicken auf „Als Peppol UBL herunterladen" oder Auto-Zustellung über die Sende-Aktion. 2. Clozo verpackt die Rechnung als Peppol BIS Billing 3.0 UBL. 3. Der AP von Clozo fragt den Peppol SMP nach dem AP-Endpunkt des Empfängers ab. 4. Der AP sendet die Rechnung über AS4 (ein industriestarkes Messaging-Protokoll). 5. Der AP des Empfängers empfängt, validiert und überträgt in sein Buchhaltungssystem. 6. Der AP des Empfängers sendet innerhalb von ca. 1–10 Minuten eine Zustellbestätigung an Ihren AP zurück. 7. Clozo verzeichnet die Bestätigung in der Angebots-Timeline.

Häufige Fehlerzustände:

- Empfänger nicht gefunden: Die von Ihnen angegebene Teilnehmer-ID ist nicht im SMP-Verzeichnis vorhanden. Entweder hat Ihnen der Kunde die falsche ID gegeben, oder sein AP ist nicht registriert. Mit dem Buchhalter des Kunden überprüfen. - Schema ungültig: Das UBL-Dokument besteht die Peppol-BIS-Billing-3.0-Validierung nicht. Fast immer ein Clozo-seitiges Problem – Support kontaktieren. - Vom empfangenden AP abgelehnt: Der AP des Empfängers setzt lokale Regeln über Peppol BIS hinaus durch (z. B. ein bestimmtes Bestellnummernformat erforderlich). Die Fehlermeldung identifiziert die Regel. - Zustellungs-Timeout: selten; der AP des Empfängers hat innerhalb von 24 Stunden nicht geantwortet. Clozo kann auf Anfrage einen erneuten Versuch starten.

Troubleshooting

Keep reading