Per Peppol versenden

Diese Anleitung beschreibt, wie Sie ein Dokument (Rechnung oder Gutschrift) über das Peppol-Netz versenden.

Voraussetzungen

In xTool erstelltes oder hochgeladenes Dokument. Siehe Dokumente erstellen.
Dokument in einem Peppol-fähigen Format (z. B. Peppol BIS Billing, XRechnung UBL). Siehe Formate.
Peppol-ID des Empfängers (Schema + Wert) im Dokument korrekt gesetzt (z. B. bei Käufer/Empfänger). Der Empfänger muss in Peppol erreichbar sein (siehe Peppol Lookup).

Testnetz

Für Entwicklung und Tests das Peppol-Testnetz nutzen. Siehe Peppol — Netze.

Dokument in der Dokumente-Liste öffnen.
„Per Peppol versenden“ (oder ähnlich) klicken.
Bestätigen. Das Dokument wird an Peppol übergeben; der Status wird gemäß Status-Lebenszyklus aktualisiert (z. B. gesendet oder zugestellt).

POST-Request an den Dokument-Versand-Endpoint mit Dokument-ID und Body senden:

Endpoint: POST /api/v2/documents/{document_id}/send (oder gleichwertig).
Body: {"transaction_type": "send.peppol"} (und ggf. weitere erforderliche Parameter).

Die Antwort bestätigt den Versand; der Dokumentstatus wird aktualisiert. Status per Polling oder Webhooks (falls angeboten) abfragen.

Siehe API-Referenz für exakten Endpoint und Parameter.

Status: Dokumentstatus und Status-Log prüfen (Web oder API). Siehe Status-Lebenszyklus.
Fehler: Bei Status „failed“ Dokument öffnen und im Log die Fehlermeldung prüfen (z. B. Empfänger nicht gefunden, Validierungsfehler).