Treci la conținut
ShopentlyLearn
Română

Comenzi

Citiți rezumatele și detaliile comenzilor, apoi actualizați starea comenzii sau a plății.

Operații

GETListează · Stări — Comenzi/api/v1/order-statuses

Exemplu de cerereExemplu de răspuns

GETListează — Comenzi/api/v1/orders

Exemplu de cerereExemplu de răspuns

GETObține — Comenzi/api/v1/orders/{order_id}

Exemplu de cerereExemplu de răspuns

PATCHActualizează · Starea plății — Comenzi/api/v1/orders/{order_id}/payment-status

Exemplu de cerereExemplu de răspuns

PATCHActualizează · Stare — Comenzi/api/v1/orders/{order_id}/status

Exemplu de cerereExemplu de răspuns

Cum funcționează

Lista și detaliile comenzilor includ delivery.dates. Datele YYYY-MM-DD sunt planificate și nu confirmă expedierea. Datele curente au prioritate; comenzile vechi folosesc estimarea salvată. Valorile șterse sau necunoscute sunt null. Detaliile includ și toate pozițiile și imaginile produselor.

Obțineți identificatorii valizi ai stărilor din /api/v1/order-statuses. Starea comenzii și starea plății folosesc endpointuri PATCH și permisiuni separate. Schimbarea stării de plată înregistrate nu debitează un card și nu execută o rambursare printr-un furnizor de plăți.

Scrieri sigure

Permisiuni și planuri

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Date de expediere și livrare: YYYY-MM-DD; null. Fusul orar al expedierii: IANA.

Comandă · Totaluri

Sumele și cotele provin din comanda salvată, inclusiv corecturile pozițiilor. Datele istorice lipsă sunt null și nu sunt înlocuite cu taxele actuale din catalog. Sumele rămân șiruri zecimale.

  • tax_country_code · Țară fiscală · Datele salvate ale comenzii · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · O unitate · Înainte de reduceri; lines[].original_total_* · Înainte de reduceri; lines[].total_* · După reduceri.
  • lines[].discount_* · Reduceri; manual_discount · Reducere manuală; percentage "10" = 10%.
  • delivery.net / tax / gross · După reduceri; delivery.original_* · Înainte de reduceri; delivery.discount_* · Reduceri.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Necunoscut: null; zero cunoscut: 0.
  • totals · Totaluri; tax_breakdown.groups · Grupuri fiscale; Taxă nealocată = order.tax − Σ groups.tax; ±.

Lista returnează rezumate. Obține GET /api/v1/orders/{order_id} pentru fiecare rezultat pentru a exporta detaliile financiare complete. Reîncercările GET sunt limitate și respectă Retry-After. Exportul după data creării nu sincronizează corecturile ulterioare.

payment.amount este totalul comenzii. Starea plății nu determină sumele plătite, rambursate sau restante.

Scheme de date

Ghiduri

Exportul comenzilor