Aqbeż għall-kontenut
ShopentlyLearn
Malti

Ordnijiet

Aqra sommarji u dettalji tal-ordnijiet, imbagħad aġġorna l-istatus tal-ordni jew tal-ħlas.

Operazzjonijiet

GETElenka · Stati — Ordnijiet/api/v1/order-statuses

Eżempju ta’ talbaEżempju ta’ tweġiba

GETElenka — Ordnijiet/api/v1/orders

Eżempju ta’ talbaEżempju ta’ tweġiba

GETIkseb — Ordnijiet/api/v1/orders/{order_id}

Eżempju ta’ talbaEżempju ta’ tweġiba

PATCHAġġorna · Stat tal-ħlas — Ordnijiet/api/v1/orders/{order_id}/payment-status

Eżempju ta’ talbaEżempju ta’ tweġiba

PATCHAġġorna · Stat — Ordnijiet/api/v1/orders/{order_id}/status

Eżempju ta’ talbaEżempju ta’ tweġiba

Kif jaħdem

Il-lista u d-dettalji tal-ordnijiet jinkludu delivery.dates. Id-dati YYYY-MM-DD huma ppjanati u ma jikkonfermawx it-tluq. Id-dati attwali jieħdu preċedenza; ordnijiet qodma jużaw l-istima ssejvjata. Valuri mħassra jew mhux magħrufa huma null. Id-dettalji jinkludu wkoll il-linji kollha u l-immaġnijiet tal-prodotti.

Ikseb identifikaturi validi tal-istatus minn /api/v1/order-statuses. L-istatus tal-ordni u tal-ħlas jużaw endpoints PATCH u permessi separati. Il-bidla tal-istatus tal-ħlas irreġistrat ma tiġborx ħlas minn karta u ma tagħmilx rifużjoni permezz ta’ fornitur tal-ħlas.

Kitbiet siguri

Permessi u pjanijiet

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Dati tat-tluq u tal-kunsinna: YYYY-MM-DD; null. Żona tal-ħin tat-tluq: IANA.

Ordni · Totali

L-ammonti u r-rati jiġu mill-ordni maħżuna, inklużi l-korrezzjonijiet tal-linji. Id-dejta storika nieqsa hija null u ma tinbidilx bir-rati attwali tal-katalgu. L-ammonti jibqgħu strings deċimali.

  • tax_country_code · Pajjiż tat-taxxa · Dejta maħżuna tal-ordni · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Unità waħda · Qabel l-iskontijiet; lines[].original_total_* · Qabel l-iskontijiet; lines[].total_* · Wara l-iskontijiet.
  • lines[].discount_* · Skontijiet; manual_discount · Skont manwali; percentage "10" = 10%.
  • delivery.net / tax / gross · Wara l-iskontijiet; delivery.original_* · Qabel l-iskontijiet; delivery.discount_* · Skontijiet.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Mhux magħruf: null; żero magħruf: 0.
  • totals · Totali; tax_breakdown.groups · Gruppi tat-taxxa; Taxxa mhux allokata = order.tax − Σ groups.tax; ±.

Il-lista tagħti sommarji. Ikseb GET /api/v1/orders/{order_id} għal kull riżultat biex tesporta d-dettalji finanzjarji sħaħ. It-tentattivi GET huma limitati u jirrispettaw Retry-After. Esportazzjoni skont id-data tal-ħolqien ma tissinkronizzax korrezzjonijiet sussegwenti.

payment.amount huwa t-total tal-ordni. L-istatus tal-ħlas ma jiddeterminax ammonti mħallsa, rimborżati jew dovuti.

Skemi tad-data

Gwidi

Esporta l-ordnijiet