Geplant 2027

Peppol Gateway

Versende E-Rechnungen direkt über das Peppol-Netzwerk an Behörden und Unternehmen in Europa. Inklusive Empfangsbestätigung und Zustellstatus.

In Planung

Was ist Peppol?

Peppol (Pan-European Public Procurement OnLine) ist ein europaweites Netzwerk für den sicheren Austausch von E-Rechnungen und anderen Geschäftsdokumenten.

Der Peppol-Versand über AS4 ist für 2027 geplant. Bis dahin liefert die API das fertige Peppol-BIS-3.0-Dokument; Zertifikate, SMP-Lookup und AS4-Transport bleiben bei Ihrem Access Point.

40+
Länder
300k+
Teilnehmer
AS4
Protokoll
MDN
Bestätigung

Rechnung senden

bash
1curl -X POST https://service.invoice-api.xhub.io/api/v1/peppol/send \
2  -H "Authorization: Bearer sk_live_abc123..." \
3  -H "Content-Type: application/json" \
4  -d '{
5    "receiverPeppolId": "9930:DE987654321",
6    "documentType": "invoice",
7    "document": "PD94bWwgdmVyc2lvbj0iMS4wIj8+PEludm9pY2U+Li4u",
8    "invoiceNumber": "RE-2026-0042",
9    "issueDate": "2026-03-01",
10    "verifyReceiver": true
11  }'

Vorher prüfen: Ist der Empfänger erreichbar?

bash
1curl https://service.invoice-api.xhub.io/api/v1/peppol/receivers/9930:DE987654321 \
2  -H "Authorization: Bearer sk_live_abc123..."
3 
4# {
5#   "reachable": true,
6#   "participant": {
7#     "peppolId": {
8#       "scheme": "9930",
9#       "identifier": "DE987654321",
10#       "formatted": "9930:DE987654321"
11#     },
12#     "name": "Behörde XY",
13#     "country": "DE",
14#     "documentTypes": ["urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_3.0"],
15#     "accessPoint": "storecove"
16#   }
17# }

Response

json
1{
2  "success": true,
3  "transmission": {
4    "id": "d29c1f5e-8c2a-4c1e-9f0b-3f1a2b4c5d6e",
5    "organizationId": "org_7Hq2",
6    "invoiceId": null,
7    "direction": "outbound",
8    "providerName": "storecove",
9    "messageId": "0f7b1c94-5a1e-4a0b-9d3c-2e6f8a9b0c1d",
10    "senderPeppolId": "9930:DE123456789",
11    "receiverPeppolId": "9930:DE987654321",
12    "documentType": "invoice",
13    "status": "sent",
14    "errorCode": null,
15    "errorMessage": null,
16    "contentHash": "9f2c1b7d4e8a03f5c6b9d0e1a2f3c4b5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1",
17    "createdAt": "2026-03-01T10:30:00.000Z",
18    "updatedAt": "2026-03-01T10:30:00.000Z",
19    "statusAt": "2026-03-01T10:30:00.000Z"
20  }
21}

Request Parameter

ParameterTypPflichtBeschreibung
receiverPeppolIdstringPeppol-Adresse des Empfängers, Muster `^\d{4}:.+$` (Beispiel `9930:DE987654321`).
documentstringBase64-kodiertes UBL-XML (Peppol BIS Billing 3.0) — z. B. der `data`-Wert aus einem `/generate`-Aufruf.
documentType"invoice" | "credit-note"-Dokumentart der UBL-Nutzlast. Standard: `invoice`.
environment"sandbox" | "production"-Welche Peppol-Einstellungen (Provider-Konfiguration und Provider-Key) gelten sollen. Standard: `production`.
invoiceNumberstring-Rechnungsnummer für das Übertragungsprotokoll — geht nicht über das Netzwerk.
issueDatestring-Rechnungsdatum (ISO 8601) für das Übertragungsprotokoll — geht nicht über das Netzwerk.
verifyReceiverboolean-Vorab eine SMP-Abfrage ausführen und mit `RECEIVER_NOT_REACHABLE` (HTTP 422) abbrechen, wenn der Empfänger die Dokumentart nicht annehmen kann.

Peppol Participant IDs

Peppol IDs bestehen aus einem Schema-Präfix und einem Identifier. Häufig verwendete Schemas:

SchemaNameBeispielLand
0204DE: Leitweg-ID0204:04011000-12345-34DE
9930DE: USt-IdNr.9930:DE123456789DE
0088GLN (GS1)0088:5790000123456INT
0060DUNS0060:123456789INT
0184DK: CVR0184:12345678DK
0190NL: OIN0190:12345678901234567890NL
0106NL: KvK0106:12345678NL
0009FR: SIRET0009:12345678901234FR
0007SE: Organisationsnummer0007:1234567890SE
0192NO: Organisasjonsnummer0192:123456789NO
0208BE: Ondernemingsnummer0208:1234567890BE
9914AT: UID9914:ATU12345678AT
9920ES: NIF9920:ESA12345674ES

Zustellstatus abfragen

GET /api/v1/peppol/transmissions

json
1{
2  "transmissions": [
3    {
4      "id": "d29c1f5e-8c2a-4c1e-9f0b-3f1a2b4c5d6e",
5      "direction": "outbound",
6      "providerName": "storecove",
7      "messageId": "0f7b1c94-5a1e-4a0b-9d3c-2e6f8a9b0c1d",
8      "senderPeppolId": "9930:DE123456789",
9      "receiverPeppolId": "9930:DE987654321",
10      "documentType": "invoice",
11      "status": "delivered",
12      "errorCode": null,
13      "errorMessage": null,
14      "createdAt": "2026-03-01T10:30:00.000Z",
15      "updatedAt": "2026-03-01T10:30:12.000Z",
16      "statusAt": "2026-03-01T10:30:12.000Z"
17    }
18  ]
19}

Den Zustellstatus einer einzelnen Übertragung beim Access Point nachfragen: POST /api/v1/peppol/transmissions/{messageId}/refresh

bash
1curl -X POST https://service.invoice-api.xhub.io/api/v1/peppol/transmissions/0f7b1c94-5a1e-4a0b-9d3c-2e6f8a9b0c1d/refresh \
2  -H "Authorization: Bearer sk_live_abc123..." \
3  -H "Content-Type: application/json" \
4  -d '{ "environment": "production" }'

Status-Werte

pendingE-Rechnung wartet auf Übertragung
sentAn Peppol-Netzwerk übergeben
deliveredEmpfangsbestätigung (MDN) erhalten
failedÜbertragung fehlgeschlagen
rejectedAccess Point hat das Dokument abgelehnt

Peppol Webhooks

Erhalte automatisch Benachrichtigungen über den Zustellstatus:

peppol.sent

Rechnung an Peppol-Netzwerk übergeben

peppol.delivered

Empfangsbestätigung (MDN) erhalten

peppol.failed

Übertragung fehlgeschlagen

Webhook-Konfiguration: Webhooks Dokumentation

Ihr bestehender Access Point

Bis unser Gateway verfügbar ist (geplant 2027), erzeugt die API Peppol-BIS-3.0-konforme Dokumente, die Sie über Ihren vorhandenen Access Point versenden. Das Format ist genormt — es ist nicht an uns gebunden.

Premium- und Enterprise-Plan

Der Peppol Gateway ist noch nicht verfügbar — geplant für 2027. Zur Verfügbarkeit wird er Bestandteil des Premium-Plans; im Free- und Starter-Plan ist er nicht enthalten.

Weiterführende Dokumentation

Creator API

Rechnungen erstellen

Webhooks

Peppol-Events empfangen

Error Handling

Fehler verstehen

Preise

Premium-Plan Preise