Entwicklerfreundliche Peppol-Integration

Der Peppox API ermöglicht Ihnen die Integration der elektronischen Rechnungsstellung mit Peppol in Minuten statt Wochen. Verbinden Sie Ihr ERP-, Buchhaltungssystem oder Ihre SaaS-Plattform über eine einfache, einheitliche REST-API – ohne SOAP, ohne Komplexität.

API-Zugriff erhalten
Dieser Service ist für Entwickler/Integratoren die mehrere Unternehmen oder juristische Personen leiten.
Mit Peppox verwalten Sie alle Ihre Kunden von eine sichere, benutzerfreundliche Oberfläche.
Erstellen Sie eine dedizierte Firmenkonto für jeden Client, den Sie verwalten, und verwenden Sie dieselbe einfache API, um Senden und Empfangen ihre Peppol-Rechnungen und Gutschriften – ohne zu werden oder Registrierung mit ein Zugangspunkt.

Beispiel: Wenn Ihr ERP mehrere Unternehmen/Kunden hostet, erstellen Sie für jedes ein Peppox-Unternehmenskonto und verbinden Sie unsere API, um in deren Namen Dokumente zu übermitteln und zu empfangen.

Verbinden Sie sich nach Ihren Wünschen – Managed Access Point oder Ihr eigener

Wir machen das Leben leichter für Entwickler und Integratoren. Wenn Sie noch keinen Peppol Access Point haben, beginnen Sie mit dem Senden Peppol-konforme Rechnungen heute mit dem Verwalteter Zugangspunkt von Peppox — kein komplexes Onboarding.

Sie haben bereits einen Access Point? Einfach Verknüpfen Sie Ihre Anmeldeinformationen und Zertifikate in unserem sicheren Dashboard und schon sind Sie fertig. In beiden Fällen verwenden Sie die gleiche Peppox-API und Endpunkte – keine Codeänderungen.

Bringen Sie Ihren eigenen Zugangspunkt mit

Behalten Sie Ihren aktuellen Anbieter und verbinden Sie ihn in wenigen Minuten – ohne Umschreiben und ohne Migrationsprobleme.

  • Sichere Speicherung von Anmeldeinformationen und Zertifikaten im Dashboard
  • Keine Codeänderung – gleiche Endpunkte und Nutzdaten
  • Einheitliche Protokolle, Sendungsverfolgung und Fehlersichtbarkeit

Noch keinen Zugangspunkt?

Verwenden Sie die Verwalteter Zugangspunkt von Peppox und senden Sie Ihre erste Rechnung mit zwei Klicks.

  • Keine separaten AP-Verträge oder langwieriges Onboarding
  • Leistungsstarkes und sicheres Routing zum Peppol-Netzwerk
  • UBL/PEPPOL BIS-Validierung und Unterstützung von PDF-Anhängen
Dieselbe API für beide Szenarien. Wählen verwaltet oder verknüpft in der Konfiguration – Endpunkte bleiben identisch.

Wechseln Sie die Zugriffspunkte jederzeit über das Dashboard – behalten Sie Ihre API-Aufrufe bei, aktualisieren Sie einfach die Konfiguration.

Zwei API-Workflows für Entwickler

Wählen Sie aus, wie Sie Dokumente an Peppol senden möchten.

Peppox bietet Entwicklern zwei leistungsstarke Möglichkeiten zur Integration der Peppol-E-Rechnungsfunktion. Sie können entweder Dokumente erstellen, indem Sie strukturierte Rechnungsdaten über unsere bestehenden API-Endpunkte senden, oder die neue Funktion nutzen. PDF2Peppol API Um Dokumente schneller aus einem einfachen PDF zu versenden.

🧱

1. API für strukturierte Rechnungen

Dies ist der aktuelle Entwickler-Workflow. Ihre Anwendung sendet die Rechnungsinformationen manuell: Kopfzeile, Kunde, Lieferant, Positionen, Steuern, Summen, Anhänge und generiert anschließend die Peppol-XML-Datei.

  • Sie haben die Kontrolle über jedes Rechnungsfeld.
  • Sie senden strukturierte JSON-Daten
  • Sie fügen Rechnungspositionen über dedizierte Endpunkte hinzu.
  • Sie können die PDF-Datei bei Bedarf anhängen.
  • Sie generieren und senden Peppol-konformes XML.
/v1/Rechnung/Hinzufügen /v1/invoice_line/add/{id} /v1/invoice_attach_pdf/add /v1/xml/generate
📄

2. PDF2Peppol-API

Dies ist der schnellste Workflow. Ihre Anwendung sendet eine PDF-Rechnung oder Gutschrift an Peppox. Peppox bereitet die Dokumentdaten auf, Ihr System prüft und bestätigt sie und sendet sie an Peppol.

  • Keine manuelle XML-Generierung
  • Sie müssen nicht jedes Rechnungsfeld selbst zuordnen.
  • Funktioniert für Rechnungen und Gutschriften
  • Verifizierungsschritt vor dem Absenden
  • Ideal, wenn Ihre Software bereits PDFs generiert.
/pdf2peppol/add/ /pdf2peppol/check/ /pdf2peppol/confirm/ /pdf2peppol/send/

Von PDF zu Peppol in wenigen API-Aufrufen

Mit PDF2Peppol müssen Sie Ihre Rechnungsstellungs-Engine nicht neu entwickeln. Wenn Ihr ERP-System, Ihre SaaS-Plattform oder Ihr Buchhaltungstool bereits PDF-Rechnungen oder Gutschriften erstellt, können Sie Peppox verwenden, um dieses Dokument in einen Peppol-Versandworkflow umzuwandeln.

PDF-Dokument Peppox-Prüfung Bestätigen Peppol-Lieferung
PDF2Peppol API workflow illustration

Strukturierte API für volle Entwicklerkontrolle

Dieser API-Workflow ist ideal, wenn Ihre Anwendung bereits strukturierte Rechnungsdaten enthält. Sie senden JSON an Peppox – wir übernehmen automatisch die XML-Validierung, die Zertifikatsauthentifizierung und das Access-Point-Routing.

🔑 Sichere Authentifizierung

Stellen Sie eine Verbindung mit Ihrem API-Schlüssel her – jede Anfrage ist nur auf Ihr Konto beschränkt und verschlüsselt.

📤 Rechnungsendpunkt

Rechnungen versenden mit POST /v1/invoices/send — wir liefern es an den richtigen Access Point.

📡 Webhooks

Erhalten Sie asynchrone Benachrichtigungen bei Zustellbestätigungen, Ablehnungen oder Fehlern.

🧰 SDKs

Verwenden Sie vorgefertigte SDKs für PHP, Python oder Node.js – sparen Sie Tage an Entwicklungsarbeit.

Beispielanfrage – Senden einer Rechnung

Ein einfaches Beispiel mit cURL. Ersetzen Sie Ihre Anmeldeinformationen und Peppox validiert und übermittelt die Rechnung automatisch an den richtigen Zugangspunkt.


curl -X POST https://api.peppox.com/v1/invoices/send \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "access_point": "auto", "invoice": { "invoiceNumber": "INV-2025-1001", "issueDate": "2025-10-12", "currency": "EUR", "buyer": { "vat": "BE0123456789" }, "seller": { "vat": "BE0987654321" }, "lines": [ { "description": "Software Development", "amount": 1250.00 }, { "description": "Support Services", "amount": 350.00 } ], "attachments": [ { "type": "pdf", "fileBase64": "JVBERi0xLjQKJeLjz9M..." } ] } }'

✅ Derselbe Anruf funktioniert mit jedem Access Point – Peppox übernimmt das Routing.

API-Endpunkte im Überblick: Strukturierte API und PDF2Peppol-API

Endpunkt Beschreibung Verfahren
/v1/Rechnung/Hinzufügen Erstellen Sie einen neuen Rechnungskopf und speichern Sie Lieferanten-, Kunden- und Zahlungsdetails. POST
/v1/invoice_line/add/{id} Fügen Sie einer vorhandenen Rechnung eine oder mehrere Produkt- oder Servicezeilen hinzu. POST
/v1/invoice_attach_pdf/add Hängen Sie per Upload, Base64 oder Remote-URL ein PDF-Dokument an eine vorhandene Rechnung an. POST
/v1/xml/generate Generieren Sie eine Peppol-kompatible UBL-XML-Datei, die die Rechnung, ihre Zeilen und Anhänge kombiniert. POST
/v1/webhooks/register Registrieren Sie einen Webhook, um Lieferaktualisierungen zu erhalten POST
PDF2Peppol API – Dokumente schneller aus einem PDF senden
/pdf2peppol/add/ Laden Sie eine PDF-Rechnung oder Gutschrift hoch. Peppox bereitet die Dokumentendaten für die Weiterverarbeitung durch Peppol auf. POST
/pdf2peppol/check/ Prüfen Sie die extrahierten und aufbereiteten Dokumentdaten, bevor Sie sie an Peppol senden. ERHALTEN
/pdf2peppol/confirm/ Bitte prüfen Sie, ob die Dokumentendaten korrekt und für die Auslieferung an Peppol bereit sind. POST
/pdf2peppol/send/ Senden Sie die bestätigte Rechnung oder Gutschrift an das Peppol-Netzwerk. POST