Gå til indhold
ShopentlyLearn
Dansk

Ordrer

Læs ordreoversigter og detaljer, og opdatér derefter ordre- eller betalingsstatus.

Operationer

GETVis liste · Statusser — Ordrer/api/v1/order-statuses

Eksempel på forespørgselEksempel på svar

GETVis liste — Ordrer/api/v1/orders

Eksempel på forespørgselEksempel på svar

GETHent — Ordrer/api/v1/orders/{order_id}

Eksempel på forespørgselEksempel på svar

PATCHOpdater · Betalingsstatus — Ordrer/api/v1/orders/{order_id}/payment-status

Eksempel på forespørgselEksempel på svar

PATCHOpdater · Status — Ordrer/api/v1/orders/{order_id}/status

Eksempel på forespørgselEksempel på svar

Principper

Ordrelisten og detaljer indeholder delivery.dates. Datoer i YYYY-MM-DD er planlagte og bekræfter ikke afsendelse. Aktuelle datoer har forrang; ældre ordrer bruger det gemte estimat. Slettede eller ukendte værdier er null. Detaljer indeholder også alle ordrelinjer og produktbilleder.

Hent gyldige statusidentifikatorer fra /api/v1/order-statuses. Ordrestatus og betalingsstatus bruger separate PATCH-endepunkter og rettigheder. Ændring af den registrerede betalingsstatus trækker ikke penge på et kort og udløser ikke en refusion via en betalingsudbyder.

Sikre skriveoperationer

Rettigheder og abonnementer

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Afsendelses- og leveringsdatoer: YYYY-MM-DD; null. Afsendelsens tidszone: IANA.

Ordre · Totaler

Beløb og satser kommer fra den gemte ordre, inklusive rettelser af linjer. Manglende historiske oplysninger er null og erstattes ikke med katalogets aktuelle satser. Beløb forbliver decimalstrenge.

  • tax_country_code · Skatteland · Gemte ordredata · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · En enhed · Før rabatter; lines[].original_total_* · Før rabatter; lines[].total_* · Efter rabatter.
  • lines[].discount_* · Rabatter; manual_discount · Manuel rabat; percentage "10" = 10%.
  • delivery.net / tax / gross · Efter rabatter; delivery.original_* · Før rabatter; delivery.discount_* · Rabatter.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Ukendt: null; kendt nul: 0.
  • totals · Totaler; tax_breakdown.groups · Skattegrupper; Ikke fordelt skat = order.tax − Σ groups.tax; ±.

Listen returnerer oversigter. Hent GET /api/v1/orders/{order_id} for hvert resultat for at eksportere fulde økonomiske oplysninger. GET-forsøg er begrænsede og følger Retry-After. Eksport efter oprettelsesdato synkroniserer ikke senere rettelser.

payment.amount er ordretotalen. Betalingsstatus bestemmer ikke betalte, refunderede eller udestående beløb.

Dataskemaer

Vejledninger

Eksportér ordrer