Ordrar

Endpoints

Metod	URL	Beskrivning
`GET`	`/v1/orders`	Lista ordrar
`POST`	`/v1/orders`	Skapa order
`GET`	`/v1/orders/{id}`	Hämta en order
`PATCH`	`/v1/orders/{id}`	Uppdatera order
`POST`	`/v1/orders/{id}/complete`	Stäng order (betald)
`POST`	`/v1/orders/{id}/cancel`	Avbeställ order

Hämta ordrar

GET /v1/orders?status=open&limit=20
Authorization: Bearer ta_live_xxx

Query-parametrar

Parameter	Typ	Beskrivning
`status`	string	`open`, `completed`, `cancelled`
`table_id`	string	Filtrera på bord
`from`	ISO 8601	Från och med datum
`to`	ISO 8601	Till och med datum
`limit`	number	Antal resultat (max 100, default 20)
`cursor`	string	Pagination-cursor från föregående svar

Svar

{
  "data": [
    {
      "id": "ord_01HXK8N2P3Q4R5S6T7U8V9W0X",
      "status": "open",
      "table_id": "tbl_abc123",
      "table_name": "Bord 4",
      "created_at": "2025-06-01T18:32:10Z",
      "items": [
        {
          "id": "item_xyz789",
          "product_id": "prod_burger01",
          "name": "Klassisk burgare",
          "quantity": 2,
          "unit_price": 14900,
          "total": 29800,
          "notes": "Utan lök"
        }
      ],
      "subtotal": 29800,
      "tax": 3576,
      "total": 29800,
      "currency": "SEK"
    }
  ],
  "cursor": "eyJpZCI6Im9yZF8wMUhYSz...",
  "has_more": true
}

Skapa order

POST /v1/orders
Authorization: Bearer ta_live_xxx
Content-Type: application/json

{
  "table_id": "tbl_abc123",
  "items": [
    {
      "product_id": "prod_burger01",
      "quantity": 2,
      "notes": "Utan lök"
    }
  ]
}

Svar `201 Created`

{
  "id": "ord_01HXK8N2P3Q4R5S6T7U8V9W0X",
  "status": "open",
  ...
}

Uppdatera order

PATCH /v1/orders/{id}
Content-Type: application/json

{
  "items": [
    { "product_id": "prod_burger01", "quantity": 3 },
    { "product_id": "prod_fries01",  "quantity": 2 }
  ]
}

PATCH ersätter hela items-arrayen. Skicka alltid alla rader, inte bara förändringarna.

Order-objekt

Fält	Typ	Beskrivning
`id`	string	Unikt ID med prefix `ord_`
`status`	string	`open` \| `completed` \| `cancelled`
`table_id`	string \| null	Kopplat bord (`null` för take-away)
`items`	array	Orderns rader
`subtotal`	number	Belopp exkl. moms, i ören
`tax`	number	Moms i ören
`total`	number	Totalt belopp inkl. moms, i ören
`currency`	string	Alltid `SEK`
`created_at`	string	ISO 8601 UTC
`completed_at`	string \| null	ISO 8601 UTC

Webhook-händelsen order.completed skickas när en order stängs. Se Webhooks för hur du lyssnar på realtidshändelser.

Ordrar

På den här sidan