BetaBusiness+

Peppol Gateway

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

POST/v1/peppol/send

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.

Als zertifizierter Peppol Access Point übernehmen wir die technische Komplexität der AS4-Kommunikation und Zertifikatsverwaltung für dich.

40+

Länder

300k+

Teilnehmer

AS4

Protokoll

MDN

Bestätigung

Rechnung senden

bash

1curl -X POST https://api.xhub.io/v1/peppol/send \
2  -H "Authorization: Bearer xhub_live_abc123..." \
3  -H "Content-Type: application/json" \
4  -d '{
5    "invoiceId": "inv_xyz789",
6    "recipient": {
7      "peppolId": "0204:DE123456789",
8      "name": "Behörde XY"
9    }
10  }'

Alternative: Direkt mit XML

bash

1curl -X POST https://api.xhub.io/v1/peppol/send \
2  -H "Authorization: Bearer xhub_live_abc123..." \
3  -H "Content-Type: application/json" \
4  -d '{
5    "xml": "<?xml version=\"1.0\"?>\n<Invoice>...</Invoice>",
6    "format": "xrechnung-3.0",
7    "recipient": {
8      "peppolId": "0204:DE123456789"
9    }
10  }'

Response

json

1{
2  "transmissionId": "pep_abc123xyz",
3  "status": "sent",
4  "timestamp": "2025-01-15T10:30:00Z",
5  "invoice": {
6    "id": "inv_xyz789",
7    "invoiceNumber": "RE-2025-001"
8  },
9  "recipient": {
10    "peppolId": "0204:DE123456789",
11    "name": "Behörde XY",
12    "endpoint": "https://ap.example.de/as4"
13  },
14  "sender": {
15    "peppolId": "0204:DE987654321",
16    "name": "Meine Firma GmbH"
17  },
18  "messageId": "msg_xyz789abc",
19  "protocol": "AS4"
20}

Request Parameter

Parameter	Typ	Pflicht	Beschreibung
`invoiceId`	string	-	ID einer zuvor erstellten Rechnung. Alternativ: xml + format
`xml`	string	-	XML-Rechnung als String (wenn keine invoiceId)
`format`	string	-	Format der XML-Rechnung (wenn xml übergeben wird)
`recipient.peppolId`	string		Peppol Participant ID des Empfängers
`recipient.name`	string	-	Name des Empfängers (zur Verifizierung)

Peppol Participant IDs

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

Schema	Name	Beispiel	Land
`0204`	Leitweg-ID	`0204:991-12345-67`	DE
`0088`	EAN/GLN	`0088:5790000123456`	EU
`9930`	DE:VAT	`9930:DE123456789`	DE
`0184`	DUNS	`0184:123456789`	INT
`0190`	OFT (NL)	`0190:NL12345678`	NL
`0007`	SIRET (FR)	`0007:12345678901234`	FR

Zustellstatus abfragen

GET /v1/peppol/transmissions/{transmissionId}

json

1{
2  "transmissionId": "pep_abc123xyz",
3  "status": "delivered",
4  "timeline": [
5    {
6      "status": "sent",
7      "timestamp": "2025-01-15T10:30:00Z",
8      "message": "Rechnung an Peppol-Netzwerk übergeben"
9    },
10    {
11      "status": "received",
12      "timestamp": "2025-01-15T10:30:05Z",
13      "message": "Access Point des Empfängers hat Nachricht empfangen"
14    },
15    {
16      "status": "delivered",
17      "timestamp": "2025-01-15T10:30:12Z",
18      "message": "Empfangsbestätigung (MDN) erhalten"
19    }
20  ],
21  "mdn": {
22    "received": true,
23    "timestamp": "2025-01-15T10:30:12Z",
24    "disposition": "automatic-action/MDN-sent-automatically; processed"
25  }
26}

Status-Werte

pendingRechnung wartet auf Übertragung

sentAn Peppol-Netzwerk übergeben

receivedEmpfänger-AP hat Nachricht empfangen

deliveredEmpfangsbestätigung (MDN) erhalten

failedÜbertragung fehlgeschlagen

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

Zertifizierter Access Point

invoice.xhub ist ein offiziell zertifizierter Peppol Access Point. Wir kümmern uns um Zertifikate, SMP-Lookups und AS4-Kommunikation.

Business- und Enterprise-Plan

Der Peppol Gateway ist ab dem Business-Plan verfügbar. Im Free- und Starter-Plan ist Peppol nicht enthalten.

Weiterführende Dokumentation

Creator API

Rechnungen erstellen

Webhooks

Peppol-Events empfangen

Error Handling

Fehler verstehen

Pricing

Business-Plan Preise