Skapa eller uppdatera order

PUT/api/v1/stores/{store_id}/orders/{order_id}

Skapar ordern med butikens id, eller uppdaterar den – skicka ordern igen när den ändras (betald, återbetald, avbruten).

Ordern skickas hel: kunden, totalbeloppet och alla rader. Kunden skapas eller uppdateras med den, och raderna ersätter de tidigare. campaign_id, financial_status, currency, processed_at och delbeloppen behåller sina värden om du utelämnar dem.

Bara betalda ordrar (paid) räknas som köp i distributionslistornas villkor och som intäkt för kampanjen i campaign_id. Delvis återbetald: skicka ordern igen med det nya totalbeloppet.

Svarar 201 när ordern skapades och 200 när den uppdaterades.

Intäkt per kampanj →

Behörighet

ecommerce:write Ändra e-handel – personen bakom nyckeln måste vara redaktör eller högre.

Sökvägsparametrar

store_idstringkrävs: Butikens id, som ni väljer.
order_idstringkrävs: Orderns id i er butik.

Kropp

JSON, Content-Type: application/json. Okända fält ger 422.

customerobjectkrävs: Kunden. Skapas eller uppdateras med ordern (samma regler som PUT /customers/{customer_id}).
customer.idstringkrävs: Kundens id i er butik.
customer.emailstringkrävs: Kundens e-postadress.högst 254 tecken
customer.first_namestring | null: Förnamn.högst 100 tecken
customer.last_namestring | null: Efternamn.högst 100 tecken
customer.companystring | null: Företag.högst 200 tecken
campaign_idstring | null: Kampanjen kunden kom från: värdet av qn_cid på länken hen klickade på. Räknas bara för arbetsytans egna kampanjer; ett okänt id sparas inte (men ordern sparas).
financial_statusstring: paid: betald – räknas som köp · pending: väntar på betalning · refunded: återbetald · cancelled: avbruten. Standard när ordern skapas: paid.pendingpaidrefundedcancelled
currencystring: Standard: butikens valuta.
order_totalnumberkrävs: Orderns totalbelopp, inklusive moms och frakt.minst 0 · högst 999999999999.99
tax_totalnumber | null: Varav moms.minst 0 · högst 999999999999.99
shipping_totalnumber | null: Varav frakt.minst 0 · högst 999999999999.99
discount_totalnumber | null: Rabatt.minst 0 · högst 999999999999.99
processed_atstring: När ordern lades i butiken (ISO 8601). Standard när ordern skapas: nu. Skicka den vid import av gamla ordrar.
linesarray<object>krävs: Orderns rader (högst 500). Ersätter alla rader. Produkterna behöver inte ha skickats in.minst 1 · högst 500 st
lines[].idstringkrävs: Radens id i er butik.
lines[].product_idstringkrävs: Produktens id i er butik.
lines[].variant_idstring | null: Variantens id i er butik.
lines[].titlestring | null: Vad som köptes, som det stod på ordern.högst 255 tecken
lines[].quantityintegerkrävs: Antal.minst 1 · högst 1000000
lines[].pricenumberkrävs: Pris per styck.minst 0 · högst 999999999999.99
lines[].discountnumber | null: Rabatt på raden.minst 0 · högst 999999999999.99

Göra om anropet

PUT skapar eller uppdaterar på butikens egna id: samma anrop två gånger ger samma resultat, så det kan alltid göras om. Batch och idempotens

Svar

200 Ordern (201 om den skapades).

idstringkrävs
customerobject | nullkrävs: null när kunden har raderats: ordern räknas fortfarande till kampanjens intäkt.
customer.idstringkrävs
customer.emailstringkrävs
campaign_idstring | nullkrävs
financial_statusstringkrävs: pendingpaidrefundedcancelled
currencystringkrävs
order_totalnumberkrävs
tax_totalnumber | nullkrävs
shipping_totalnumber | nullkrävs
discount_totalnumber | nullkrävs
processed_atstring (tid, ISO 8601)krävs: När ordern lades.
linesarray<object>krävs
lines[].idstringkrävs
lines[].product_idstringkrävs
lines[].variant_idstring | nullkrävs
lines[].titlestring | nullkrävs
lines[].quantityintegerkrävs
lines[].pricenumberkrävs
lines[].discountnumber | nullkrävs
created_atstring (tid, ISO 8601)krävs: När ordern skickades in första gången.
updated_atstring (tid, ISO 8601)krävs: När ordern senast ändrades.

Fel

400: bad_request
401: unauthenticated invalid_key key_revoked key_expired key_inactive
402: payment_required
403: insufficient_scope forbidden workspace_suspended
404: not_found
415: unsupported_media_type
422: validation_failed
429: rate_limited
500: internal_error

Anrop

curl -X PUT 'https://newsletter.qrona.se/api/v1/stores/butik-se/orders/50087' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer":{"id":"1042","email":"anna@example.se","first_name":"Anna","last_name":"Svensson"},"campaign_id":"6d1f0c3a-2b4e-4f6a-8c9d-0e1f2a3b4c5d","financial_status":"paid","currency":"SEK","order_total":548,"tax_total":109.6,"shipping_total":49,"processed_at":"2026-10-12T14:03:00Z","lines":[{"id":"1","product_id":"731","variant_id":"731-blue-m","title":"T-shirt i ekologisk bomull, blå, M","quantity":2,"price":249}]}'

Svar 200

{
  "id": "50087",
  "customer": {
    "id": "1042",
    "email": "anna@example.se"
  },
  "campaign_id": "6d1f0c3a-2b4e-4f6a-8c9d-0e1f2a3b4c5d",
  "financial_status": "paid",
  "currency": "SEK",
  "order_total": 548,
  "tax_total": 109.6,
  "shipping_total": 49,
  "discount_total": 0,
  "processed_at": "2026-10-12T14:03:00.000Z",
  "lines": [
    {
      "id": "1",
      "product_id": "731",
      "variant_id": "731-blue-m",
      "title": "T-shirt i ekologisk bomull, blå, M",
      "quantity": 2,
      "price": 249,
      "discount": null
    }
  ],
  "created_at": "2026-10-12T14:03:05.000Z",
  "updated_at": "2026-10-12T14:03:05.000Z"
}