Bestellung ändern

Muss eine Bestellung nach dem Versand angepasst werden? Mit einem Order Change kann der Käufer eine bestehende Bestellung ändern, zum Beispiel um Mengen anzupassen, Bestellpositionen hinzuzufügen oder Artikel zu ersetzen. Order Changes sind Teil des Peppol Advanced Ordering-Profils.

Wie funktioniert ein Order Change?

Ein Order Change ist im Wesentlichen ein vollständig neues UBL Order-Dokument, das auf die ursprüngliche Bestellung verweist. Es ersetzt die vorherige Bestellung vollständig. Der Lieferant empfängt das geänderte Dokument und kann mit einer Order Response antworten (akzeptieren, ablehnen oder unter Bedingungen akzeptieren).

Der Ablauf sieht wie folgt aus:

Käufer sendet einen Order Change mit Verweis auf die ursprüngliche Bestellung
Lieferant empfängt die Änderung über den OrderChangeReceived-Webhook
Lieferant lädt die geänderte Bestellung herunter und vergleicht sie mit dem Original
Lieferant sendet eine Order Response zurück (AB, AP, CA oder RE)

Endpoint (Käufer)

Der Käufer sendet einen Order Change, indem er ein neues UBL Order-Dokument über den regulären Endpoint hochlädt:

POST /api/v1/{partyId}/purchaseOrder/send

Das Dokument enthält einen Verweis auf die ursprüngliche Bestellung im OrderReference-Element der UBL-Datei. Der PSB erkennt automatisch, dass es sich um eine Änderung handelt.

Als Lieferant empfangen

Richten Sie einen Webhook auf das Topic OrderChangeReceived ein:

{
  "action": "https://Ihr-endpoint.de/order-changes",
  "topics": ["OrderChangeReceived"],
  "secret": "Ihr-geheimer-schluessel"
}

Laden Sie anschließend das geänderte Dokument herunter über:

GET /api/v1/{partyId}/salesOrder/{documentId}/download

Tipp: Vergleichen Sie das empfangene Dokument mit der ursprünglichen Bestellung, um festzustellen, was sich geändert hat. Der PSB bietet keine Diff-Funktion; Ihr System muss die Änderungen selbst erkennen.

Webhook-Topics

Topic

Richtung

Wann

OrderChangeSent

Käufer

Änderung wurde erfolgreich zugestellt

OrderChangeReceived

Lieferant

Änderung wurde empfangen

OrderResponseReceived

Käufer

Lieferant hat auf die Änderung geantwortet

Auf einen Order Change reagieren

Als Lieferant reagieren Sie auf einen Order Change über den Order Response Endpoint, genau wie bei einer regulären Bestellung. Die verfügbaren Statuscodes sind dieselben: AB (empfangen), AP (akzeptiert), CA (unter Bedingungen akzeptiert) und RE (abgelehnt).

Häufig gestellte Fragen

Wie erkennt die PSB, dass meine Nachricht ein Order Change und keine neue Bestellung ist?

Sie senden die geänderte UBL Order über denselben Endpoint wie eine neue Bestellung: POST /api/v1/{partyId}/purchaseOrder/send. Im UBL-Dokument setzen Sie die Referenz zur ursprünglichen Bestellung im OrderReference-Element. Die PSB erkennt daran, dass es sich um eine Änderung handelt.

Ersetzt ein Order Change die vorherige Bestellung vollständig?

Ja. Ein Order Change ist ein vollständig neues UBL Order-Dokument, das auf die ursprüngliche Bestellung verweist und die vorherige Version ersetzt. Der Lieferant lädt das Dokument herunter und muss den Unterschied zum früheren Dokument selbst ermitteln; die PSB bietet keine Diff-Funktion.

Welchem Integrationsmuster folgt der Lieferant nach `OrderChangeReceived`?

Richten Sie einen Webhook auf OrderChangeReceived ein, laden Sie über GET /api/v1/{partyId}/salesOrder/{documentId}/download herunter und vergleichen Sie mit der vorherigen Bestellung. Antworten Sie dann mit einer Order Response (AB, AP, CA oder RE). Der Käufer verfolgt den Fortschritt unter anderem über OrderChangeSent und OrderResponseReceived.

Die vollständige API-Spezifikation finden Sie unter psb.econnect.eu für die genaue UBL-Struktur eines Order Change.

API-Dokumentation ansehen

Verwandt