Preskočiť na obsah
ShopentlyLearn
Slovenčina

Objednávky

Načítavajte prehľady a podrobnosti objednávok a upravujte stav objednávky alebo platby.

Operácie

GETZobraziť zoznam · Stavy — Objednávky/api/v1/order-statuses

Príklad požiadavkyPríklad odpovede

GETZobraziť zoznam — Objednávky/api/v1/orders

Príklad požiadavkyPríklad odpovede

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

Príklad požiadavkyPríklad odpovede

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

Príklad požiadavkyPríklad odpovede

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

Príklad požiadavkyPríklad odpovede

Ako to funguje

Zoznam aj detail objednávky obsahujú delivery.dates. Plánované dátumy YYYY-MM-DD nepotvrdzujú odoslanie. Aktuálne dátumy majú prednosť; staršie objednávky používajú uložený odhad. Vymazané alebo neznáme hodnoty sú null. Detail obsahuje aj všetky položky a obrázky produktov.

Platné identifikátory stavov načítajte z /api/v1/order-statuses. Stav objednávky a stav platby používajú oddelené koncové body PATCH a oprávnenia. Zmena evidovaného stavu platby nestiahne peniaze z karty ani nevykoná refundáciu u poskytovateľa platieb.

Bezpečné zápisy

Oprávnenia a plány

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Dátumy odoslania a doručenia: YYYY-MM-DD; null. Časové pásmo odoslania: IANA.

Objednávka · Súčty

Sumy a sadzby pochádzajú z uloženej objednávky vrátane opráv položiek. Chýbajúce historické údaje sú null a nenahrádzajú sa aktuálnymi sadzbami katalógu. Sumy zostávajú desatinnými reťazcami.

  • tax_country_code · Daňová krajina · Uložená snímka objednávky · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Jedna jednotka · Pred zľavami; lines[].original_total_* · Pred zľavami; lines[].total_* · Po zľavách.
  • lines[].discount_* · Zľavy; manual_discount · Ručná zľava; percentage "10" = 10%.
  • delivery.net / tax / gross · Po zľavách; delivery.original_* · Pred zľavami; delivery.discount_* · Zľavy.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Neznáme: null; známa nula: 0.
  • totals · Súčty; tax_breakdown.groups · Daňové skupiny; Nepriradená daň = order.tax − Σ groups.tax; ±.

Zoznam vracia súhrny. Pre každý výsledok načítajte GET /api/v1/orders/{order_id} a exportujte úplné finančné údaje. Opakovania GET sú obmedzené a rešpektujú Retry-After. Export podľa dátumu vytvorenia nesynchronizuje neskoršie opravy.

payment.amount je celková suma objednávky. Stav platby neurčuje zaplatené, vrátené ani dlžné sumy.

Dátové schémy

Sprievodcovia

Export objednávok