Bestillinger

Nettbutikk

Betalte kjøp. En bestilling bærer kjøperens e-post, og for fysiske varer navn og adresse, så orders:read gir mer personopplysninger enn noen annen tilgang. Som resten av nettbutikken krever rutene at butikken er slått på, ellers svarer de 409 shop-not-enabled.

Krever at nettbutikken er slått på.

Alle sidene

Kom i gang

Guider

Referanse

Referanse

Plattform

Publikasjon

Nettsted

Nettbutikk

Videre

Kodeeksemplene kaller en skribb-funksjon du setter opp selv. Hent klienten for språket ditt og lim den inn én gang, så kan eksemplene under limes rett etter.

GET/v1/orders

orders:read

Hent bestillinger

Uten varelinjer. Hent én bestilling for å få dem.

?status: paid, fulfilled, canceled eller refunded.
?limit: 1 til 200. Standard er 50.
?cursor: next_cursor fra forrige side.
?updated_since: ISO 8601. Bare bestillinger endret etter dette tidspunktet. Statusbytter og sporingsnummer teller som endring.

Svaret · 200

ordersOrder[]: Denne sida med bestillinger, uten items.
has_moreboolean: Om det finnes en side til.
next_cursorstring | null: Sendes som ?cursor= for neste side. null når du er ferdig.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/orders?status=paid&limit=20"

GET/v1/orders/{id}

orders:read

Hent én bestilling med varelinjer

Svaret · 200

orderOrder: Bestillingen, med items.

Svar

{
  "order": {
    "id": "ord_3Ln9Ra",
    "status": "paid",
    "buyer_email": "kari@example.no",
    "currency": "nok",
    "subtotal_ore": 49800,
    "discount_ore": 0,
    "discount_code": null,
    "free_shipping": false,
    "shipping_ore": 7900,
    "total_ore": 57700,
    "shipping_address": {
      "name": "Kari Nordmann",
      "line1": "Storgata 1",
      "line2": null,
      "postal_code": "0155",
      "city": "Oslo",
      "country": "NO"
    },
    "tracking_note": null,
    "tracking_carrier": null,
    "tracking_url": null,
    "paid_at": "2026-07-24T18:02:11.000Z",
    "fulfilled_at": null,
    "created_at": "2026-07-24T18:01:40.000Z",
    "items": [
      {
        "id": "itm_5Vb1",
        "product_id": "prod_8kQ2vX",
        "variant_id": "var_3Tn9",
        "title": "Kaffekrus",
        "variant_label": "Blå",
        "type": "physical",
        "unit_price_ore": 24900,
        "quantity": 2,
        "line_total_ore": 49800
      }
    ]
  }
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
order_id="ord_9Xy2"

skribb "/orders/$order_id"

POST/v1/orders/{id}/fulfill

orders:write

Merk som sendt

Kjøperen får e-post med sporingsnummeret. Navngir du fraktselskapet, blir nummeret en lenke kjøperen kan åpne, og bestillinger du leser ut igjen har tracking_url ferdig satt sammen. Merker du den samme bestillingen igjen, får du 409 i stedet, så kjøperen ikke får to beskjeder.

Bodyen du sender

tracking_notestring: Sporingsnummer eller en kort beskjed til kjøperen. Valgfritt.
tracking_carrierstring: posten, postnord eller helthjem. Noe annet svarer 422. Valgfritt, men uten den blir sporingsnummeret bare tekst og ikke en lenke.

Svaret · 200

orderOrder: Bestillingen slik den nå er.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
order_id="ord_9Xy2"

skribb "/orders/$order_id/fulfill" \
  -X POST \
  -H "content-type: application/json" \
  -d '{
    "tracking_note": "CJ123456789NO",
    "tracking_carrier": "posten"
  }'

POST/v1/orders/{id}/refund

orders:write

Refunder hele beløpet

200 betyr at Stripe tok imot refusjonen, ikke at bestillingen alt står som refundert. Statusen settes av Stripe sitt varsel like etter, og svaret her viser bestillingen slik den er i øyeblikket. Bare betalte og sendte bestillinger kan refunderes.

Svaret · 200

orderOrder: Bestillingen slik den er i øyeblikket, som regel fortsatt paid.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
order_id="ord_9Xy2"

skribb "/orders/$order_id/refund" \
  -X POST

Objekter

Order

Et betalt kjøp.

Felter

idstring: Bestillingens id.
statusstring: paid, fulfilled, canceled eller refunded. Handlekurver som aldri ble betalt, er ikke bestillinger og kommer ikke ut herfra.
buyer_emailstring: Kjøperens e-post. Tom streng når kontaktopplysningene er slettet, enten på forespørsel fra kjøperen eller etter to år.
currencystring: Alltid nok.
subtotal_oreinteger: Varene, uten frakt, i øre.
discount_oreinteger: Hva en rabattkode tok av varene, i øre. 0 uten kode. Regnestykket er subtotal_ore minus discount_ore pluss shipping_ore.
discount_codestring | null: Koden som ble brukt. Lagret som tekst på bestillingen, så den står selv om du siden endrer eller sletter selve koden.
free_shippingboolean: Om en rabattregel gjorde frakten gratis. shipping_ore alene sier det ikke: en digital bestilling er 0 uansett.
shipping_oreinteger: Frakten, i øre.
total_oreinteger: Det kjøperen faktisk betalte, i øre.
shipping_addressShippingAddress | null: null når bestillingen ikke har noe å sende, altså rent digitale kjøp.
tracking_notestring | null: Sporingsnummeret eller beskjeden du sendte inn da du merket den som sendt.
tracking_carrierstring | null: posten, postnord eller helthjem.
tracking_urlstring | null: Sporingssida hos fraktselskapet. Vi setter den sammen av de to over, og lagrer den aldri, så den følger med uten at du gjør noe.
paid_atstring | null: ISO 8601 i UTC.
fulfilled_atstring | null: ISO 8601 i UTC.
created_atstring: ISO 8601 i UTC.
itemsOrderItem[]ikke alltid med: Bare når du henter én bestilling. Lista utelater dem.

OrderItem

En varelinje. Alt er et øyeblikksbilde fra kjøpet, ikke et oppslag i dag.

Felter

idstring: Varelinjas id.
product_idstring | null: Produktet den kom fra. null om produktet er borte siden.
variant_idstring | null: Utgaven den kom fra. null om produktet ikke har utgaver.
titlestring: Tittelen slik den var da kjøpet skjedde, ikke slik den er nå.
variant_labelstring | null: Utgaven slik den het da kjøpet skjedde, for eksempel M. Den du pakker etter, og den endrer seg ikke om utgaven senere får nytt navn.
typestring: digital eller physical, slik den var.
unit_price_oreinteger: Stykkprisen som ble betalt, i øre.
quantityinteger: Antall.
line_total_oreinteger: Stykkpris ganger antall, i øre.

ShippingAddress

Adressen en fysisk bestilling skal til.

Felter

namestring | null: Mottakerens navn.
line1string | null: Gate og nummer.
line2string | null: Andre adresselinje, om den finnes.
postal_codestring | null: Postnummer.
citystring | null: Poststed.
countrystring | null: Landkode, ISO-3166 alfa-2.

← Alle rutene