Skapa eller uppdatera kundkorg

PUT/api/v1/stores/{store_id}/carts/{cart_id}

Skapar korgen med butikens id, eller uppdaterar den. Raderna ersätter de tidigare.

En korg hör alltid till en kund, som skapas eller uppdateras med den. Ta bort korgen när den har blivit en order.

Guide: e-handel →

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.
cart_idstringkrävs: Kundkorgens 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).
checkout_urlstring | null: Adressen där kunden kan slutföra köpet.högst 2048 tecken
currencystring: Standard: butikens valuta.
order_totalnumberkrävs: Korgens totalbelopp.minst 0 · högst 999999999999.99
tax_totalnumber | null: Varav moms.minst 0 · högst 999999999999.99
linesarray<object>krävs: Korgens rader. Ersätter alla rader.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

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 Kundkorgen (201 om den skapades).

idstringkrävs
customerobjectkrävs
customer.idstringkrävs
customer.emailstringkrävs
campaign_idstring | nullkrävs
checkout_urlstring | nullkrävs
currencystringkrävs
order_totalnumberkrävs
tax_totalnumber | nullkrävs
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
created_atstring (tid, ISO 8601)krävs: När korgen skickades in första gången.
updated_atstring (tid, ISO 8601)krävs: När korgen 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/carts/c-8812' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customer":{"id":"1042","email":"anna@example.se"},"checkout_url":"https://butik.se/kassa?korg=c-8812","order_total":498,"lines":[{"id":"1","product_id":"731","variant_id":"731-blue-m","quantity":2,"price":249}]}'

Svar 200

{
  "id": "c-8812",
  "customer": {
    "id": "1042",
    "email": "anna@example.se"
  },
  "campaign_id": null,
  "checkout_url": "https://butik.se/kassa?korg=c-8812",
  "currency": "SEK",
  "order_total": 498,
  "tax_total": 99.6,
  "lines": [
    {
      "id": "1",
      "product_id": "731",
      "variant_id": "731-blue-m",
      "title": "T-shirt i ekologisk bomull, blå, M",
      "quantity": 2,
      "price": 249
    }
  ],
  "created_at": "2026-10-19T08:30:00.000Z",
  "updated_at": "2026-10-19T08:30:00.000Z"
}