Gå til innhold
ShopentlyLearn

Ordrer

Les ordreoversikter og detaljer, og oppdater deretter ordre- eller betalingsstatus.

Operasjoner

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

GETVis liste — Ordrer/api/v1/orders

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

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

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

Prinsipper

Ordrelisten og detaljene inneholder delivery.dates. Datoer i YYYY-MM-DD er planlagte og bekrefter ikke forsendelse. Gjeldende datoer har forrang; eldre ordrer bruker det lagrede estimatet. Slettede eller ukjente verdier er null. Detaljene inneholder også alle ordrelinjer og produktbilder.

Hent gyldige statusidentifikatorer fra /api/v1/order-statuses. Ordrestatus og betalingsstatus bruker separate PATCH-endepunkter og tilganger. Endring av registrert betalingsstatus belaster ikke et kort og utløser ikke refusjon gjennom en betalingsleverandør.

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Forsendelses- og leveringsdatoer: YYYY-MM-DD; null. Tidssone for forsendelse: IANA.

Ordre · Totalsummer

Beløp og satser kommer fra den lagrede ordren, inkludert linjerettelser. Manglende historiske opplysninger er null og erstattes ikke med katalogens gjeldende satser. Beløp forblir desimalstrenger.

  • tax_country_code · Avgiftsland · Lagrede ordredata · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Én enhet · Før rabatter; lines[].original_total_* · Før rabatter; lines[].total_* · Etter rabatter.
  • lines[].discount_* · Rabatter; manual_discount · Manuell rabatt; percentage "10" = 10%.
  • delivery.net / tax / gross · Etter rabatter; delivery.original_* · Før rabatter; delivery.discount_* · Rabatter.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Ukjent: null; kjent nullverdi: 0.
  • totals · Totalsummer; tax_breakdown.groups · Avgiftsgrupper; Ufordelt avgift = order.tax − Σ groups.tax; ±.

Listen returnerer sammendrag. Hent GET /api/v1/orders/{order_id} for hvert resultat for å eksportere fullstendige økonomiske opplysninger. GET-forsøk er begrenset og følger Retry-After. Eksport etter opprettelsesdato synkroniserer ikke senere rettelser.

payment.amount er ordretotalen. Betalingsstatus bestemmer ikke betalte, refunderte eller utestående beløp.

Veiledninger

Eksporter bestillinger