☰ Menü · Siparişler
API referansı
Siparişler
Misafirlerin masadan QR menü üzerinden gönderdiği sepetler.
Sipariş nesnesi
- numberinteger
- Sesli söylemek ve mutfak fişine basmak için kısa numara.
- statusstring
new,accepted,preparing,ready,served,completed,rejected,cancelled.- tablestring veya null
- Masa bağlantısındaki
?table=değerinden gelir veya misafir tarafından yazılır. - notestring veya null
- Misafirin notu.
- subtotal, currency, item_count
- Sipariş anındaki menüye göre bizim hesapladığımız tutarlar.
- items[]dizi
item_id,external_id(sizin SKU'nuz),name,quantity,unit_price,total, kendiexternal_idveprice_deltadeğerleriyleoptions[].- external_idstring veya null
- Sizin sipariş numaranız, kabul sırasında atanır.
- guest_languagestring
- Misafirin kullandığı menü dili.
- typestring
- Masadan siparişler için
table, bir şubeden alınan önceden siparişler içinpickup. - day_numberinteger
- Siparişin bugünkü numarası, her gün 1'den başlar. Misafir gel-al siparişlerinde görür.
- locationobject veya null
- Gel-al siparişinin alınacağı şubenin
id,name,addressbilgileri. - pickup_at, pickup_lead_minutes
- Misafirin ne zaman geleceği ve seçtiği dakika (tam saat seçtiyse null).
- guestobject veya null
- Misafirin gel-al siparişinde bıraktığı
namevephone. - paymentobject
method(cashveyaonline),status(unpaid,pending,paid,refunded,failed),provider,reference,paid_at. Nakit, sipariş teslim edilince ödendi olarak işaretlenir.- prepared_at, picked_up_atstring veya null
- Siparişin
readyolduğu ve gel-al siparişinin teslim edildiği an. - history[]array
- Her durum değişikliği:
status,at,by(personel adı),via(dashboard,telegram,api,guest).
JSON
{
"object": "order",
"id": "0c69a81c-0fbc-4333-b26c-789566b9bea4",
"number": 10,
"day_number": 3,
"type": "table",
"status": "new",
"table": "7",
"location": null,
"pickup_at": null,
"pickup_lead_minutes": null,
"guest": null,
"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": []
}
],
"payment": { "method": "cash", "status": "unpaid", "provider": null, "reference": null, "paid_at": null },
"external_id": null,
"reject_reason": null,
"guest_language": "en",
"source": "qr_menu",
"loyalty_transaction_id": null,
"history": [],
"livemode": true,
"created_at": "2026-10-06T18:14:48.233+00:00",
"accepted_at": null,
"prepared_at": null,
"picked_up_at": null,
"completed_at": null,
"updated_at": "2026-10-06T18:14:48.233+00:00"
}GET
/v1/ordersİzin: orders:read
En yeniden eskiye. ?status=new ile filtreleyin (parametreyi tekrarlayın veya değerleri virgülle ayırın). Sayfalıdır.
curl
curl "https://loyaltyfy.io/api/v1/orders?status=new" \
-H "Authorization: Bearer sk_test_..."GET
/v1/orders/{order}İzin: orders:read
Tek bir sipariş.
POST
/v1/orders/{order}/acceptİzin: orders:write
new durumundaki siparişi accepted durumuna geçirir. Kendi sipariş numaranızı external_id olarak gönderin. İşletme bazında benzersiz olmalıdır.
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İzin: orders:write
new durumundaki siparişi reddeder. reason isteğe bağlıdır ve siparişle birlikte saklanır.
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}İzin: orders:write
status değerini ayarlar (yalnızca ileri yönde, adımlar atlanabilir; açık her sipariş bir reason ile cancelled yapılabilir). Mevcut durumu tekrar göndermek hiçbir şey değiştirmez. previous_status ile order.updated gönderir.
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" }'