Тапсырыстар

Қонақтар үстелден QR-мәзір арқылы жіберетін себеттер.

Тапсырыс объектісі

numberinteger: Дауыстап айтуға және асхана чегіне басып шығаруға арналған қысқа нөмір.
statusstring: new, accepted, preparing, ready, served, completed, rejected, cancelled.
tablestring немесе null: Үстел сілтемесіндегі ?table= мәнінен алынады немесе қонақ өзі енгізеді.
notestring немесе null: Қонақтың пікірі.
subtotal, currency, item_count: Тапсырыс сәтіндегі мәзір бойынша өзіміз есептейміз.
items[]массив: item_id, external_id (сіздің SKU), name, quantity, unit_price, total, өз external_id және price_delta мәндері бар options[].
external_idstring немесе null: Сіздегі тапсырыс id-і, қабылдағанда беріледі.
guest_languagestring: Қонақ пайдаланған мәзір тілі.

Параметр	Түрі	Сипаттама
number	integer	Дауыстап айтуға және асхана чегіне басып шығаруға арналған қысқа нөмір.
status	string	`new`, `accepted`, `preparing`, `ready`, `served`, `completed`, `rejected`, `cancelled`.
table	string немесе null	Үстел сілтемесіндегі `?table=` мәнінен алынады немесе қонақ өзі енгізеді.
note	string немесе null	Қонақтың пікірі.
subtotal, currency, item_count		Тапсырыс сәтіндегі мәзір бойынша өзіміз есептейміз.
items[]	массив	`item_id`, `external_id` (сіздің SKU), `name`, `quantity`, `unit_price`, `total`, өз `external_id` және `price_delta` мәндері бар `options[]`.
external_id	string немесе null	Сіздегі тапсырыс id-і, қабылдағанда беріледі.
guest_language	string	Қонақ пайдаланған мәзір тілі.

JSON

{
  "object": "order",
  "id": "0c69a81c-0fbc-4333-b26c-789566b9bea4",
  "number": 10,
  "status": "new",
  "table": "7",
  "note": "No onions, please",
  "currency": "MDL",
  "subtotal": 14000,
  "item_count": 2,
  "items": [
    {
      "item_id": "a48343bd-9f6e-424a-b003-fe790617f4d6",
      "external_id": "2040",
      "name": "Zeamă",
      "quantity": 2,
      "unit_price": 7000,
      "total": 14000,
      "options": []
    }
  ],
  "external_id": null,
  "reject_reason": null,
  "guest_language": "en",
  "source": "qr_menu",
  "livemode": true,
  "created_at": "2026-10-06T18:14:48.233+00:00",
  "accepted_at": null,
  "completed_at": null,
  "updated_at": "2026-10-06T18:14:48.233+00:00"
}

GET/v1/orders

Құқық: orders:read

Жаңасынан бастап. ?status=new бойынша сүзіңіз (параметрді қайталаңыз немесе үтірмен бөліңіз). Беттеумен.

curl

curl "https://loyaltyfy.io/api/v1/orders?status=new" \
  -H "Authorization: Bearer sk_test_..."

GET/v1/orders/{order}

Құқық: orders:read

Бір тапсырыс.

POST/v1/orders/{order}/accept

Құқық: orders:write

new тапсырысын accepted мәртебесіне ауыстырады. Өз тапсырыс id-іңізді external_id ретінде беріңіз. Ол мекеме ішінде бірегей болуы керек.

curl

curl -X POST https://loyaltyfy.io/api/v1/orders/0c69a81c-0fbc-4333-b26c-789566b9bea4/accept \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "external_id": "POS-ORDER-55821" }'

POST/v1/orders/{order}/reject

Құқық: orders:write

new тапсырысын қабылдамайды. reason міндетті емес, ол тапсырыспен бірге сақталады.

curl

curl -X POST https://loyaltyfy.io/api/v1/orders/0c69a81c-0fbc-4333-b26c-789566b9bea4/reject \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Kitchen closes at 22:00" }'

PATCH/v1/orders/{order}

Құқық: orders:write

status орнатады (тек алға, қадамдарды өткізіп жіберуге болады; кез келген ашық тапсырысты reason көрсетіп cancelled етуге болады). Ағымдағы мәртебені қайта жіберу ештеңе өзгертпейді. previous_status бар order.updated жібереді.

curl

curl -X PATCH https://loyaltyfy.io/api/v1/orders/0c69a81c-0fbc-4333-b26c-789566b9bea4 \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "status": "ready" }'