Siirry sisältöön
ShopentlyLearn
Suomi

Tilaukset

Lue tilausten yhteenvedot ja tiedot ja päivitä sitten tilauksen tai maksun tila.

Toiminnot

GETListaa · Tilat — Tilaukset/api/v1/order-statuses

PyyntöesimerkkiVastausesimerkki

GETListaa — Tilaukset/api/v1/orders

PyyntöesimerkkiVastausesimerkki

GETHae — Tilaukset/api/v1/orders/{order_id}

PyyntöesimerkkiVastausesimerkki

PATCHPäivitä · Maksun tila — Tilaukset/api/v1/orders/{order_id}/payment-status

PyyntöesimerkkiVastausesimerkki

PATCHPäivitä · Tila — Tilaukset/api/v1/orders/{order_id}/status

PyyntöesimerkkiVastausesimerkki

Periaatteet

Tilausluettelo ja tiedot sisältävät delivery.dates-objektin. YYYY-MM-DD-päivät ovat suunniteltuja eivätkä vahvista lähetystä. Nykyiset päivät ovat ensisijaisia; vanhat tilaukset käyttävät tallennettua arviota. Poistetut tai tuntemattomat arvot ovat null. Tiedot sisältävät myös kaikki tilausrivit ja tuotekuvat.

Hae kelvolliset tilatunnisteet osoitteesta /api/v1/order-statuses. Tilauksen tila ja maksun tila käyttävät erillisiä PATCH-päätepisteitä ja käyttöoikeuksia. Kirjatun maksutilan muuttaminen ei veloita korttia eikä käynnistä palautusta maksupalveluntarjoajan kautta.

Turvalliset kirjoitukset

Käyttöoikeudet ja paketit

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Lähetys- ja toimituspäivät: YYYY-MM-DD; null. Lähetyksen aikavyöhyke: IANA.

Tilaus · Yhteissummat

Summat ja verokannat tulevat tallennetusta tilauksesta rivikorjauksineen. Puuttuvat historiatiedot ovat null, eikä niitä korvata luettelon nykyisillä verokannoilla. Summat pysyvät desimaalimerkkijonoina.

  • tax_country_code · Verotusmaa · Tallennetut tilaustiedot · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Yksi yksikkö · Ennen alennuksia; lines[].original_total_* · Ennen alennuksia; lines[].total_* · Alennusten jälkeen.
  • lines[].discount_* · Alennukset; manual_discount · Manuaalinen alennus; percentage "10" = 10%.
  • delivery.net / tax / gross · Alennusten jälkeen; delivery.original_* · Ennen alennuksia; delivery.discount_* · Alennukset.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Tuntematon: null; tunnettu nolla: 0.
  • totals · Yhteissummat; tax_breakdown.groups · Veroryhmät; Kohdistamaton vero = order.tax − Σ groups.tax; ±.

Lista palauttaa yhteenvedot. Nouda GET /api/v1/orders/{order_id} kullekin tulokselle täydellisiä taloustietoja varten. GET-uusinnat ovat rajattuja ja noudattavat Retry-After-arvoa. Luontipäivään perustuva vienti ei synkronoi myöhempiä korjauksia.

payment.amount on tilauksen kokonaissumma. Maksutila ei määritä maksettuja, palautettuja tai avoimia summia.

Tietoskeemat

Oppaat

Tilausten vienti