Zustellungen und Status

POST /invoices/{id}/deliveries versendet eine ausgestellte Rechnung. Senden Sie einen Idempotency-Key, damit Wiederholungen sicher sind.

curl -s -X POST $BASE/invoices/<id>/deliveries -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' -d '{"channel":"peppol","recipient":"0204:04011000-12345-34"}'

Kanäle

peppol: die archivierte XRechnung (UBL, sonst CII) an einen Peppol-Teilnehmer (Schema:Wert, z. B. 9930:DE123456788 oder eine Leitweg-ID 0204:…). Ohne recipient wird die elektronische Adresse des Käufers aus der Rechnung (BT-49) verwendet. Nimmt der Empfänger nur die andere XRechnung-Syntax an, wird sie aus derselben Rechnung erzeugt, geprüft und gesendet. Mit "fallbackEmail": "kaeufer@example.de" geht eine fehlgeschlagene Peppol-Zustellung stattdessen per E-Mail. Der Verkäufer braucht eine Peppol-Adresse mit numerischem Schema; echtes Peppol braucht einen verifizierten Verkäufer mit aktiviertem Peppol und den Tarif Growth oder höher.
email: alle Dokumente im Anhang, von „<Verkäufer> via Fakturnaut“, Antworten gehen an den Verkäufer. Nur verifizierte Verkäufer; höchstens 200 in 24 Stunden.
anaf: rumänische Verkäufer, die im Portal mit ANAF verbunden sind; Empfänger ist die CIF des Verkäufers.

Status

PENDING (24 Stunden lang wiederholt) → SENT → DELIVERED, oder REJECTED / FAILED (mit error). UNCONFIRMED: keine Bestätigung binnen 72 Stunden; die Rechnung kann angekommen sein, ein erneuter Versand braucht daher "resend": true. OUTCOME_UNKNOWN: der Zugangspunkt hat nicht eindeutig geantwortet; wir suchen die Rechnung dort und senden sie nie blind ein zweites Mal.

Eine Peppol-Zustellung, die nicht angekommen ist, hat ein failure mit festem code und Texten auf Englisch (en) und Deutsch (de): not-on-peppol (keine Peppol-Adresse oder nicht registriert), format-not-supported, validation, transport, recipient-rejected, duplicate (schon früher gesendet, nicht erneut), sender-not-registered oder other.

Verfolgen Sie eine Zustellung mit GET /deliveries/{id}, listen Sie die Zustellungen einer Rechnung mit GET /invoices/{id}/deliveries auf, oder empfangen Sie delivery.updated-Webhooks. Eine zweite Zustellung an denselben Empfänger ergibt 409 delivery.duplicate, außer Sie setzen "resend": true.

Dokumente, die Ihre Verkäufer über Peppol empfangen, finden Sie unter GET /received-documents.