☰ Μενού · Παραγγελίες
Αναφορά API
Παραγγελίες
Καλάθια που στέλνουν οι πελάτες από το QR μενού στο τραπέζι.
Το αντικείμενο order
- numberinteger
- Σύντομος αριθμός για να λέγεται φωναχτά και να τυπώνεται στο δελτίο κουζίνας.
- statusstring
new,accepted,preparing,ready,served,completed,rejected,cancelled.- tablestring ή null
- Από τον σύνδεσμο τραπεζιού
?table=ή όπως το πληκτρολόγησε ο πελάτης. - notestring ή null
- Το σχόλιο του πελάτη.
- subtotal, currency, item_count
- Τιμολογούνται από εμάς με βάση το μενού τη στιγμή της παραγγελίας.
- items[]array
item_id,external_id(το SKU σας),name,quantity,unit_price,total,options[]με δικά τουςexternal_idκαιprice_delta.- external_idstring ή null
- Το id της παραγγελίας σας, ορίζεται κατά την αποδοχή.
- guest_languagestring
- Η γλώσσα μενού που χρησιμοποίησε ο πελάτης.
- typestring
tableγια παραγγελίες από τραπέζι,pickupγια παραγγελίες από πριν με παραλαβή από κατάστημα.- day_numberinteger
- Αριθμός της παραγγελίας στο κατάστημα σήμερα, από το 1 κάθε μέρα. Ο πελάτης τον βλέπει στις παραγγελίες πακέτο.
- locationobject ή null
id,name,addressτου καταστήματος παραλαβής της παραγγελίας πακέτο.- pickup_at, pickup_lead_minutes
- Πότε θα έρθει ο πελάτης και σε πόσα λεπτά το επέλεξε (null αν επέλεξε ακριβή ώρα).
- guestobject ή null
nameκαιphoneπου άφησε ο πελάτης στην παραγγελία πακέτο.- paymentobject
method(cashήonline),status(unpaid,pending,paid,refunded,failed),provider,reference,paid_at. Τα μετρητά σημειώνονται ως πληρωμένα όταν παραδοθεί η παραγγελία.- prepared_at, picked_up_atstring ή null
- Πότε η παραγγελία έγινε
readyκαι πότε παραδόθηκε η παραγγελία πακέτο. - history[]array
- Κάθε αλλαγή κατάστασης:
status,at,by(όνομα υπαλλήλου),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Δικαίωμα: 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 (μόνο προς τα εμπρός, με δυνατότητα παράλειψης βημάτων· κάθε ανοιχτή παραγγελία μπορεί να γίνει cancelled με reason). Αν στείλετε ξανά την τρέχουσα κατάσταση, δεν γίνεται καμία αλλαγή. Στέλνει order.updated με previous_status.
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" }'