Peppol

Peppol ist ein Netzwerk für E-Rechnungen und andere B2B-Dokumente. Teilnehmer werden über eine Peppol-ID identifiziert. xTool kann Dokumente über Peppol senden und empfangen. Siehe Versand über Peppol und Empfang über Peppol.

Peppol-ID

Eine Peppol-ID besteht aus zwei Teilen:

• Scheme (Schema) — Art des Bezeichners (z. B. 9930 für deutsche USt-IdNr.).
• Value (Wert) — Der Bezeichner selbst (z. B. DE123456789).

Oft geschrieben als scheme::value oder in URI-Form.

• Ihre Organisation — Konfigurieren Sie die Peppol-ID(s) Ihrer Organisation in den Organisationseinstellungen. Sie werden für den Empfang genutzt: Wenn eine Nachricht eingeht, ordnet xTool die Empfänger-ID Ihrer Organisation zu. Siehe Organisation und Benutzer.
• Empfänger (beim Senden) — In den Dokumentmetadaten muss die Peppol-ID des Empfängers stehen (receiver_id mit Schema und Wert). Nutzen Sie Peppol Lookup, um vor dem Senden zu prüfen, ob der Teilnehmer registriert ist und welche Dokumenttypen unterstützt werden.

Netze: Test und Produktion

• Testnetz — Für Entwicklung und Integration. Keine echte Zustellung an Geschäftspartner. Nutzen Sie es für Entwicklung und Tests.
• Produktion — Live-Netz. Echte Zustellung. Nur nutzen, wenn Sie produktionsbereit sind.

Viele API- und Lookup-Endpoints akzeptieren einen Parameter network (z. B. prod oder test). Verwenden Sie für die Integration immer test und wechseln Sie erst bei Bereitschaft auf prod.

Peppol Lookup (API)

Die Peppol-Lookup-API ermöglicht Abfragen im Netz:

• Existenzprüfung — Ist der Teilnehmer registriert? (Parameter: scheme, value, network, uri_scheme.)
• Visitenkarte — Teilnehmerdaten.
• Dokumenttypen — Welche Dokumenttypen der Teilnehmer unterstützt.
• Endpoints — SMP-Endpoints des Teilnehmers.

Nutzen Sie die Existenzprüfung (und bei Bedarf Dokumenttypen) vor dem Senden, um fehlgeschlagene Zustellungen zu vermeiden. Siehe API-Referenz zu Peppol Lookup und Versand über Peppol.

Unterstützte Formate für Peppol

Über Peppol werden typischerweise Peppol BIS Billing (Rechnung und Gutschrift, UBL und CII), Peppol BIS Self Billing und XRechnung (UBL) verwendet. In der Formate-Tabelle (Spalte Peppol) steht, welche Formate Senden/Empfang über Peppol unterstützen.

So funktionieren Versand und Empfang (Überblick)

• Versand — Sie lösen den Versand aus → xTool validiert das Dokument → sendet es über den Access Point an den Empfänger. Der Dokumentenstatus wechselt zu send.completed oder send.failed.
• Empfang — Eine eingehende Nachricht trifft am Access Point von xTool ein → xTool ordnet die Peppol-ID des Empfängers einer Organisation zu → es wird ein eingehendes Dokument erstellt. Der Dokumentenstatus wechselt zu receive.completed oder receive.failed.