Preskoči na vsebino
ShopentlyLearn
Slovenščina

Naročila

Preberite povzetke in podrobnosti naročil ter posodobite status naročila ali plačila.

Operacije

GETPrikaži seznam · Statusi — Naročila/api/v1/order-statuses

Primer zahtevePrimer odgovora

GETPrikaži seznam — Naročila/api/v1/orders

Primer zahtevePrimer odgovora

GETPridobi — Naročila/api/v1/orders/{order_id}

Primer zahtevePrimer odgovora

PATCHPosodobi · Status plačila — Naročila/api/v1/orders/{order_id}/payment-status

Primer zahtevePrimer odgovora

PATCHPosodobi · Status — Naročila/api/v1/orders/{order_id}/status

Primer zahtevePrimer odgovora

Kako deluje

Seznam in podrobnosti naročila vsebujejo delivery.dates. Načrtovani datumi YYYY-MM-DD ne potrjujejo odpreme. Trenutni datumi imajo prednost; starejša naročila uporabljajo shranjeno oceno. Izbrisane ali neznane vrednosti so null. Podrobnosti vsebujejo tudi vse postavke in slike izdelkov.

Veljavne identifikatorje statusov pridobite iz /api/v1/order-statuses. Status naročila in plačila uporabljata ločeni končni točki PATCH in dovoljenja. Sprememba zabeleženega plačilnega statusa ne bremeni kartice in ne izvede vračila pri ponudniku plačil.

Varni zapisi

Dovoljenja in paketi

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Datumi odpreme in dostave: YYYY-MM-DD; null. Časovni pas odpreme: IANA.

Naročilo · Skupni zneski

Zneski in stopnje izvirajo iz shranjenega naročila, vključno s popravki postavk. Manjkajoči pretekli podatki so null in se ne nadomestijo s trenutnimi stopnjami kataloga. Zneski ostanejo decimalni nizi.

  • tax_country_code · Davčna država · Shranjeni podatki naročila · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Ena enota · Pred popusti; lines[].original_total_* · Pred popusti; lines[].total_* · Po popustih.
  • lines[].discount_* · Popusti; manual_discount · Ročni popust; percentage "10" = 10%.
  • delivery.net / tax / gross · Po popustih; delivery.original_* · Pred popusti; delivery.discount_* · Popusti.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Neznano: null; znana ničla: 0.
  • totals · Skupni zneski; tax_breakdown.groups · Davčne skupine; Nerazporejen davek = order.tax − Σ groups.tax; ±.

Seznam vrne povzetke. Za vsak rezultat pridobite GET /api/v1/orders/{order_id} za popolne finančne podatke. Ponovitve GET so omejene in upoštevajo Retry-After. Izvoz po datumu nastanka ne sinhronizira poznejših popravkov.

payment.amount je skupni znesek naročila. Stanje plačila ne določa plačanih, vrnjenih ali dolgovanih zneskov.

Podatkovne sheme

Vodiči

Izvoz naročil