Ich habe strukturierte Rechnungsdaten
Erstellen Sie den Kopf, fügen Sie jede Position hinzu, hängen Sie optional die PDF an und generieren Sie das Peppol-UBL-Dokument.
Ablauf ansehen →
Peppox Developer Platform
Senden Sie Ihre erste Rechnung über Peppol – Schritt für Schritt.
Wählen Sie den passenden Weg: vom ersten API-Aufruf bis zur Zustellverfolgung.
PEPPOX / INTEGRATION FLOW
- 01Dashboard
- 02API-Schlüssel
- 03Rechnung
- 04Validieren
- 05Peppol
READY TO BUILD
01 · Vor dem ersten Aufruf
Vier Dinge einmalig vorbereiten
Richten Sie zuerst Konto und Lieferantenprofil ein. Danach nutzt Ihre Anwendung dieselben Zugangsdaten für jedes Dokument.
- 01
Peppox-Konto erstellen
Registrieren Sie das Unternehmen, das Dokumente versendet.
- 02
Lieferantenprofil vervollständigen
Unternehmens-, USt.-, Bank- und Peppol-Routingdaten stammen aus Ihrem Konto.
- 03
Integrationsumgebung öffnen
Testen Sie mit den Dashboard-Werkzeugen sicher vor der Produktion.
- 04
API-Schlüssel kopieren
Bewahren Sie ihn nur serverseitig auf, nie im Browser- oder App-Code.
02 · Den kürzesten Weg wählen
Beginnen Sie mit Ihren vorhandenen Daten
Ich erzeuge bereits eine PDF
PDF hochladen, Daten durch Peppox extrahieren, prüfen, bestätigen und über Peppol senden.
Ablauf ansehen →03 · PDF2Peppol
Vollständiger Versand in vier API-Aufrufen
Der direkteste dokumentierte Weg, wenn Ihr System bereits PDF-Rechnungen erstellt.
- 01
PDF hochladen
Senden Sie Datei, Base64-Inhalt oder URL und speichern Sie queue_guid.
POST/pdf2peppol/add - 02
Extrahierte Daten prüfen
Fragen Sie den Status bis zum Abschluss ab und prüfen Sie Käufer, Summen, USt. und Positionen.
GET/pdf2peppol/check - 03
Dokument bestätigen
Bestätigen Sie erst, wenn alle extrahierten Daten korrekt sind.
POST/pdf2peppol/confirm - 04
An Peppol senden
Senden Sie das bestätigte Dokument und speichern Sie die Dokument-GUID.
POST/pdf2peppol/send - 05
Zustellung verfolgen
Nutzen Sie die Versandliste oder das Dashboard für den Endstatus.
GET/doc-sent/header/list
Minimales Beispiel
Upload → check → confirm → send
Ersetzen Sie Platzhalter durch Ihre Kennung und die IDs des vorherigen Aufrufs.
pdf2peppol.sh
curl -X POST "https://api.peppox.com/pdf2peppol/add/" \
-F "supplier_id=YOUR_SUPPLIER_ID" \
-F "pdf=@invoice.pdf" \
-F "network=integration"
# Save queue_guid, then check it
curl "https://api.peppox.com/pdf2peppol/check/?supplier_id=YOUR_SUPPLIER_ID&queue_guid=QUEUE_GUID"
curl -X POST "https://api.peppox.com/pdf2peppol/confirm/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID","confirmed":1}'
curl -X POST "https://api.peppox.com/pdf2peppol/send/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID"}'04 · Strukturierte Rechnungs-API
Erstellen Sie eine Peppol-fertige Rechnung aus Ihren Daten
Ideal, wenn Ihr ERP alle Rechnungsfelder und Positionen strukturiert speichert.
- 01
Kopf erstellen
Senden Sie Kunde, Daten, Währung, Zahlung und Lieferung und speichern Sie invoice_guid.
POST/invoice/add - 02
Positionen hinzufügen
Wiederholen Sie den Aufruf für jedes Produkt oder jede Leistung.
POST/invoice_line/add - 03
PDF anhängen (optional)
Fügen Sie die lesbare Rechnung per Datei, Base64 oder URL hinzu.
POST/invoice_attach_pdf/add - 04
UBL XML generieren
Peppox kombiniert Kopf, Positionen und Anhang; Erfolg liefert XML_BUILT.
POST/xml/generate - 05
Verfolgen und verwalten
Prüfen Sie Dokument und Status im Dashboard oder über Versand-APIs.
GET/doc-sent/header/list
API NOTE
Wichtig: Die veröffentlichte Referenz für strukturierte Rechnungen beschreibt die XML-Erzeugung, derzeit jedoch keinen separaten finalen /send-Endpoint. Für einen expliziten Sendeaufruf nutzen Sie PDF2Peppol oder schließen den Versand über den konfigurierten Peppox-Workflow bzw. das Dashboard ab.
05 · Endpoint-Übersicht
Alle Endpoints einfach erklärt
01Rechnungen
POST/invoice/addRechnungskopf erstellen und invoice_guid erhalten.
POST/invoice_line/addPosition zu einer Rechnung hinzufügen.
POST/invoice_attach_pdf/addRechnungs-PDF anhängen oder ersetzen.
02UBL-Erzeugung
POST/xml/generatePeppol-kompatibles UBL XML generieren.
03Gutschriften
POST/creditnote/addGutschriftskopf erstellen.
POST/creditnote_line/addPosition zu einer Gutschrift hinzufügen.
POST/creditnote_attach_pdf/addGutschrifts-PDF anhängen oder ersetzen.
04Gesendete Dokumente
GET/doc-sent/header/listGesendete Köpfe mit Filtern und Seiten auflisten.
GET/doc-sent/lines/listPositionen eines gesendeten Dokuments abrufen.
05Empfangene Dokumente
GET/doc-received/header/listEmpfangene Köpfe mit Filtern und Seiten auflisten.
GET/doc-received/lines/listPositionen eines empfangenen Dokuments abrufen.
06PDF2Peppol
POST/pdf2peppol/addPDF hochladen und Extraktion starten.
GET/pdf2peppol/checkStatus und extrahierte Felder prüfen.
POST/pdf2peppol/confirmGeprüfte Daten bestätigen.
POST/pdf2peppol/sendBestätigtes Dokument über Peppol senden.
06 · Tests ohne Code
Verstehen Sie jede Anfrage im Dashboard, bevor Sie programmieren
Geführte Formulare im Peppox-Dashboard rufen die APIs für Sie auf. Testen Sie echte Dokumente, erkennen Sie Pflichtparameter und verstehen Sie die JSON-Antwort, bevor Sie Ihr ERP anbinden.
- 01Endpoint wählen und Felder ausfüllen
- 02Anfrage ohne Testclient ausführen
- 03GUIDs, JSON-Daten und Fehler prüfen
- 04Ablauf in der Integrationsumgebung validieren
- 05Funktionierende Anfrage im Backend übernehmen
- 06Gesendete und empfangene Dokumente überwachen
Diese Kennungen speichern
Der Integrationsstatus bleibt einfach
invoice_guidVerknüpft Kopf, Positionen, PDF und generiertes XML.
queue_guidVerknüpft die vier PDF2Peppol-Aufrufe während der Extraktion.
Dokument-GUIDVerknüpft das endgültige Dokument mit Zustellung und Abgleich.
Wenn eine Anfrage fehlschlägt
400Fehlende oder ungültige Felder prüfen.401API-Schlüssel und Umgebung prüfen.404GUID des vorherigen Aufrufs prüfen.429Drosseln und mit wachsender Wartezeit erneut versuchen.500Anfrage protokollieren, sicher wiederholen und Peppox kontaktieren, falls nötig.