PEPPOL-API

Überblick

Die PEPPOL-API ermöglicht externen Systemen das Senden und Empfangen von PEPPOL-Dokumenten, die Validierung von XML, Teilnehmer-Lookups und Webhook-Abonnements — ohne Invoice Manager für jede Nachricht zu nutzen.

Vollständige Methodenliste: REST-API-Referenz.
Konzepte: PEPPOL-Übersicht.

Zugriff freischalten

Bestätigen Sie, dass Ihr Abonnementplan API- / PEPPOL-Automatisierung erlaubt.
Legen Sie einen Integrations-User mit Least-Privilege-Rollen an.
Erzeugen Sie API-Schlüssel für diesen Benutzer.
Schränken Sie bei Bedarf Legal Entity User Permissions ein.

Authentifizierung

Authorization: token {api_key}:{api_secret}

Kernmethoden

Funktion	Method path
XML oder Factur-X-PDF senden	`tapr_next.api.peppol.transmission.send_peppol_invoice`
SI aus XML erzeugen und senden	`tapr_next.api.peppol.transmission.send_invoice`
Status prüfen	`tapr_next.api.peppol.transmission.check_status`
XML validieren	`tapr_next.api.peppol.transmission.validate_xml`
Empfang (API storage)	`tapr_next.api.peppol.inbound.receive_peppol_message`
Empfangene auflisten / abrufen	`get_received_invoices` / `get_received_invoice` (vollständige Rechnung: Kopf, Summen, Positionen, Charges, Steuern; `include_xml=1` ergänzt das Roh-XML)
Buchung bestätigen	`confirm_invoice_posted`
SMP-Lookup	`lookup_participant`
Webhook konfigurieren	`tapr_next.api.peppol.webhooks.configure_webhook`

Aufruf über POST/GET /api/method/<path>.

Webhooks

Ereignistypen:

Invoice Received
MLR Received
All

Auth: keine, Bearer, API-Key-Header, Basic Auth. Optionale HMAC-Signierung. Nur HTTPS; private IP-Bereiche blockiert (SSRF-Schutz). Konfiguration nur für System Manager.

Metering

Senden und einige Lookup-/Validate-Endpunkte werden gegen Plan-Kontingente gemessen. Überwachen Sie Tapr Settings → Subscription.