Παραγγελίες

Καλάθια που στέλνουν οι πελάτες από το 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: Η γλώσσα μενού που χρησιμοποίησε ο πελάτης.

Παράμετρος	Τύπος	Περιγραφή
number	integer	Σύντομος αριθμός για να λέγεται φωναχτά και να τυπώνεται στο δελτίο κουζίνας.
status	string	`new`, `accepted`, `preparing`, `ready`, `served`, `completed`, `rejected`, `cancelled`.
table	string ή null	Από τον σύνδεσμο τραπεζιού `?table=` ή όπως το πληκτρολόγησε ο πελάτης.
note	string ή null	Το σχόλιο του πελάτη.
subtotal, currency, item_count		Τιμολογούνται από εμάς με βάση το μενού τη στιγμή της παραγγελίας.
items[]	array	`item_id`, `external_id` (το SKU σας), `name`, `quantity`, `unit_price`, `total`, `options[]` με δικά τους `external_id` και `price_delta`.
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 (μόνο προς τα εμπρός, με δυνατότητα παράλειψης βημάτων· κάθε ανοιχτή παραγγελία μπορεί να γίνει 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" }'