Vorschau vor Änderungen

Weil es keine Sandbox gibt, prüfst du Änderungen vorab mit den Vorschau-Endpunkten. Sie schreiben nichts. Sie zeigen, was die Änderung jetzt bewirken würde.

Vorschau	Zweck
POST /api/orders/preview	Neue Bestellung prüfen
POST /api/orders/{order_id}/cancel/preview	Prüfen, ob und zu welchen Bedingungen ein Storno geht
POST /api/orders/{order_id}/delivery-address/preview	Prüfen, ob die Lieferadresse noch änderbar ist
POST /api/orders/{order_id}/items/preview	Variantentausch prüfen

Alle vier brauchen nur merchant_order:read.

Antwort

Jede Vorschau liefert fingerprint und confirmed_summary. Zwei Vorschauen einer unveränderten Bestellung haben denselben fingerprint. Daran erkennst du, dass sich zwischen Vorschau und Änderung nichts verändert hat.

Die REST-API verlangt keine vorherige Vorschau. Du kannst jede Änderung auch direkt senden.

Fehler und Zustand

• Ist die Anfrage selbst fehlerhaft, antwortet die Vorschau mit 422 und einem Code in extra.error, zum Beispiel UNKNOWN_SKU oder INVALID_DELIVERY_ADDRESS. Die Codes stehen in der Referenz bei der jeweiligen Operation.
• Dass eine Bestellung nicht mehr änderbar oder stornierbar ist, ist kein Fehler. Es steht im 200-Ergebnis der Vorschau.