Order Response | eConnect

Wenn Sie als Lieferant eine Bestellung, Änderung oder Stornierung empfangen, senden Sie eine Order Response zurück, um den Käufer wissen zu lassen, was Sie mit der Bestellung tun. Die Order Response ist ein Kernbestandteil des Peppol Advanced Ordering-Profils.

Endpoint

POST /api/v1/{partyId}/salesOrder/{documentId}/response

Die {partyId} ist der Peppol-Identifier des Lieferanten. Die {documentId} ist die ID der empfangenen Bestellung, auf die Sie antworten.

Statuscodes

Die Order Response enthält einen Statuscode, der angibt, was Sie mit der Bestellung tun:

Code

Name

Wann verwenden

Acknowledged

Sie haben die Bestellung empfangen und sie ist lesbar. Verwenden Sie dies als Zwischenbestätigung, während Sie die Bestellung noch prüfen.

Accepted

Sie akzeptieren die Bestellung vollständig und werden sie ausführen.

Conditionally Accepted

Sie akzeptieren die Bestellung, aber mit Änderungen (zum Beispiel angepasste Lieferzeit oder Mengen). Fügen Sie die geänderten Bestellpositionen der Antwort hinzu.

Rejected

Sie lehnen die Bestellung ab. Der Käufer muss eine neue Bestellung einreichen, wenn der Kauf trotzdem erfolgen soll.

Tipp: Sie können mehrere Antworten für dieselbe Bestellung senden. Beginnen Sie zum Beispiel mit AB (Empfangsbestätigung) und senden Sie später AP (akzeptiert), sobald die Bestellung intern genehmigt wurde.

Beispielablauf

Ein typisches Advanced Ordering-Szenario sieht so aus:

Käufer sendet eine Bestellung über POST /{partyId}/purchaseOrder/send
Lieferant empfängt die Bestellung über den OrderReceived-Webhook
Lieferant lädt die Bestellung über GET /{partyId}/salesOrder/{documentId}/download herunter
Lieferant sendet eine AB-Response (Empfangsbestätigung)
Lieferant prüft die Bestellung intern
Lieferant sendet eine AP-Response (Bestellung akzeptiert)
Käufer empfängt die Antwort über den OrderResponseReceived-Webhook

Bedingt akzeptieren (CA)

Bei einer CA-Response (Conditionally Accepted) geben Sie an, dass Sie die Bestellung akzeptieren, aber mit Anpassungen. Die Response enthält dann eine geänderte Version der Bestellpositionen. Der Käufer kann auf dieser Basis entscheiden, ob die angepasste Bestellung akzeptabel ist.

Mögliche Gründe für eine CA-Response sind unter anderem eine angepasste Lieferzeit, eine geänderte Menge (begrenzter Bestand) oder Ersatzartikel.

Webhook-Topics

Topic

Richtung

Wann

OrderResponseSent

Lieferant

Response wurde erfolgreich an den Käufer gesendet

OrderResponseReceived

Käufer

Response vom Lieferanten wurde empfangen

Request-Body

Die Response wird als UBL OrderResponse XML-Dokument im Body der Anfrage mitgesendet, mit Content-Type application/xml. Das Dokument muss den korrekten Verweis auf die ursprüngliche Bestellung enthalten.

Die genaue XML-Struktur und die Pflichtfelder finden Sie in der Swagger-Dokumentation unter psb.econnect.eu.

Häufig gestellte Fragen

Wann verwende ich AB, AP, CA oder RE in einer Order Response?

AB bedeutet, dass die Bestellung empfangen und lesbar ist, häufig als Zwischenschritt. AP ist die vollständige Akzeptanz und Ausführung. CA ist die Akzeptanz mit Änderungen; Sie fügen die angepassten Bestellpositionen hinzu. RE lehnt die Bestellung ab; der Käufer muss dann eine neue Bestellung einreichen, wenn die Bestellung durchgeführt werden soll.

Kann ich mehrere Order Responses für dieselbe Bestellung senden?

Ja. Sie können beispielsweise zuerst AB senden, sobald Sie die Bestellung eingelesen haben, und später AP, wenn die interne Genehmigung abgeschlossen ist. Das passt zu einer typischen Advanced Ordering-Kette mit dem Webhook OrderResponseReceived auf der Seite des Käufers.

Wie rufe ich den Order Response-Endpoint technisch auf?

Verwenden Sie POST /api/v1/{partyId}/salesOrder/{documentId}/response mit {partyId} als Peppol-Kennung des Lieferanten und {documentId} als ID der empfangenen Bestellung. Der Body ist ein UBL OrderResponse XML mit Content-Type: application/xml und der korrekten Referenz zur ursprünglichen Bestellung.

Die vollständige API-Spezifikation finden Sie unter psb.econnect.eu mit Beispiel-Payloads und Fehlermeldungen.

API-Referenz öffnen

Verwandt