Zum Inhalt springen
ShopentlyLearn

Bestellungen

Lesen Sie Bestellübersichten und Details und ändern Sie Bestell- oder Zahlungsstatus.

Operationen

GETAuflisten · Statusliste — Bestellungen/api/v1/order-statuses

GETAuflisten — Bestellungen/api/v1/orders

GETAbrufen — Bestellungen/api/v1/orders/{order_id}

PATCHAktualisieren · Zahlungsstatus — Bestellungen/api/v1/orders/{order_id}/payment-status

PATCHAktualisieren · Status — Bestellungen/api/v1/orders/{order_id}/status

Funktionsweise

Bestelllisten und Details enthalten delivery.dates. Geplante Daten im Format YYYY-MM-DD bestätigen keinen Versand. Aktuelle Daten haben Vorrang; ältere Bestellungen verwenden die gespeicherte Schätzung. Gelöschte oder unbekannte Werte sind null. Details enthalten auch alle Positionen und Produktbilder.

Gültige Statuskennungen erhalten Sie über /api/v1/order-statuses. Bestellstatus und Zahlungsstatus haben getrennte PATCH-Endpunkte und Berechtigungen. Eine Änderung des gespeicherten Zahlungsstatus belastet keine Karte und löst beim Zahlungsanbieter keine Erstattung aus.

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Versand- und Lieferdaten: YYYY-MM-DD; null. Versandzeitzone: IANA.

Bestellung · Summen

Beträge und Steuersätze stammen aus der gespeicherten Bestellung einschließlich Positionskorrekturen. Fehlende historische Angaben sind null; aktuelle Katalogsteuersätze ersetzen sie nicht. Geldbeträge bleiben Dezimalzeichenfolgen.

  • tax_country_code · Steuerland · Gespeicherte Bestelldaten · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Eine Einheit · Vor Rabatten; lines[].original_total_* · Vor Rabatten; lines[].total_* · Nach Rabatten.
  • lines[].discount_* · Rabatte; manual_discount · Manueller Rabatt; percentage "10" = 10%.
  • delivery.net / tax / gross · Nach Rabatten; delivery.original_* · Vor Rabatten; delivery.discount_* · Rabatte.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Unbekannt: null; bekannte Null: 0.
  • totals · Summen; tax_breakdown.groups · Steuergruppen; Nicht zugeordnete Steuer = order.tax − Σ groups.tax; ±.

Die Liste liefert Zusammenfassungen. Rufen Sie für jedes Ergebnis GET /api/v1/orders/{order_id} ab, um vollständige Abrechnungsdaten zu exportieren. GET-Wiederholungen sind begrenzt und beachten Retry-After. Der Export nach Erstellungsdatum synchronisiert keine späteren Korrekturen.

payment.amount ist die Bestellsumme. Der Zahlungsstatus bestimmt keine bezahlten, erstatteten oder offenen Beträge.

Anleitungen

Bestellungen exportieren