Preskoči na sadržaj
ShopentlyLearn
Hrvatski

Narudžbe

Čitajte sažetke i detalje narudžbi te ažurirajte status narudžbe ili plaćanja.

Operacije

GETPopis · Statusi — Narudžbe/api/v1/order-statuses

Primjer zahtjevaPrimjer odgovora

GETPopis — Narudžbe/api/v1/orders

Primjer zahtjevaPrimjer odgovora

GETDohvati — Narudžbe/api/v1/orders/{order_id}

Primjer zahtjevaPrimjer odgovora

PATCHAžuriraj · Status plaćanja — Narudžbe/api/v1/orders/{order_id}/payment-status

Primjer zahtjevaPrimjer odgovora

PATCHAžuriraj · Status — Narudžbe/api/v1/orders/{order_id}/status

Primjer zahtjevaPrimjer odgovora

Kako funkcionira

Popis i pojedinosti narudžbe sadrže delivery.dates. Planirani datumi YYYY-MM-DD ne potvrđuju otpremu. Trenutačni datumi imaju prednost; starije narudžbe koriste spremljenu procjenu. Izbrisane ili nepoznate vrijednosti su null. Pojedinosti sadrže i sve stavke i slike proizvoda.

Valjane identifikatore statusa dohvatite s /api/v1/order-statuses. Status narudžbe i status plaćanja koriste zasebne PATCH krajnje točke i ovlasti. Promjena evidentiranog statusa plaćanja ne tereti karticu niti izvršava povrat preko pružatelja platnih usluga.

Sigurni upisi

Ovlasti i planovi

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Datumi otpreme i dostave: YYYY-MM-DD; null. Vremenska zona otpreme: IANA.

Narudžba · Ukupni iznosi

Iznosi i stope dolaze iz spremljene narudžbe, uključujući ispravke stavki. Nepoznati povijesni podaci su null i ne zamjenjuju se trenutačnim stopama iz kataloga. Iznosi ostaju decimalni nizovi.

  • tax_country_code · Porezna država · Spremljeni podaci narudžbe · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Jedna jedinica · Prije popusta; lines[].original_total_* · Prije popusta; lines[].total_* · Nakon popusta.
  • lines[].discount_* · Popusti; manual_discount · Ručni popust; percentage "10" = 10%.
  • delivery.net / tax / gross · Nakon popusta; delivery.original_* · Prije popusta; delivery.discount_* · Popusti.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Nepoznato: null; poznata nula: 0.
  • totals · Ukupni iznosi; tax_breakdown.groups · Porezne skupine; Neraspoređeni porez = order.tax − Σ groups.tax; ±.

Popis vraća sažetke. Za svaki rezultat dohvatite GET /api/v1/orders/{order_id} za potpune financijske podatke. Ponavljanja GET ograničena su i poštuju Retry-After. Izvoz po datumu izrade ne sinkronizira kasnije ispravke.

payment.amount je ukupni iznos narudžbe. Status plaćanja ne određuje plaćene, vraćene ili nepodmirene iznose.

Sheme podataka

Vodiči

Izvoz narudžbi