Přejít na obsah
ShopentlyLearn
Čeština

Objednávky

Načítejte přehledy a podrobnosti objednávek a upravujte stav objednávky nebo platby.

Operace

GETVypsat · Stavy — Objednávky/api/v1/order-statuses

Příklad požadavkuPříklad odpovědi

GETVypsat — Objednávky/api/v1/orders

Příklad požadavkuPříklad odpovědi

GETNačíst — Objednávky/api/v1/orders/{order_id}

Příklad požadavkuPříklad odpovědi

PATCHUpravit · Stav platby — Objednávky/api/v1/orders/{order_id}/payment-status

Příklad požadavkuPříklad odpovědi

PATCHUpravit · Stav — Objednávky/api/v1/orders/{order_id}/status

Příklad požadavkuPříklad odpovědi

Jak to funguje

Seznam i detail objednávky obsahují delivery.dates. Plánovaná data YYYY-MM-DD nepotvrzují odeslání. Aktuální data mají přednost; starší objednávky používají uložený odhad. Vymazané nebo neznámé hodnoty jsou null. Detail obsahuje také všechny položky a obrázky produktů.

Platné identifikátory stavů načtěte z /api/v1/order-statuses. Stav objednávky a stav platby používají oddělené koncové body PATCH a oprávnění. Změna evidovaného stavu platby nestrhne peníze z karty ani neprovede refundaci u poskytovatele plateb.

Bezpečné zápisy

Oprávnění a tarify

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Data odeslání a doručení: YYYY-MM-DD; null. Časové pásmo odeslání: IANA.

Objednávka · Součty

Částky a sazby pocházejí z uložené objednávky včetně oprav položek. Chybějící historické údaje jsou null a nenahrazují se aktuálními sazbami katalogu. Částky zůstávají desetinnými řetězci.

  • tax_country_code · Daňová země · Uložený snímek objednávky · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Jedna jednotka · Před slevami; lines[].original_total_* · Před slevami; lines[].total_* · Po slevách.
  • lines[].discount_* · Slevy; manual_discount · Ruční sleva; percentage "10" = 10%.
  • delivery.net / tax / gross · Po slevách; delivery.original_* · Před slevami; delivery.discount_* · Slevy.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Neznámé: null; známá nula: 0.
  • totals · Součty; tax_breakdown.groups · Daňové skupiny; Nepřiřazená daň = order.tax − Σ groups.tax; ±.

Seznam vrací souhrny. Pro každý výsledek načtěte GET /api/v1/orders/{order_id} a exportujte úplné finanční údaje. Opakování GET jsou omezená a respektují Retry-After. Export podle data vytvoření nesynchronizuje pozdější opravy.

payment.amount je celková částka objednávky. Stav platby neurčuje zaplacené, vrácené ani dlužné částky.

Datová schémata

Průvodci

Export objednávek