Resty | API παραγγελιών

Τι κάνει

Οι συνδρομητές μπορούν να καλούν μη εκτυπωμένα δελτία κουζίνας και τιμολογημένες αποδείξεις, και να τις σημειώνουν ως εκτυπωμένες αφού τις χειριστούν.

Δημιουργήστε API key στο Dashboard → Ρυθμίσεις → API παραγγελιών.
Καλέστε GET /api/public/orders/unprinted με header X-Api-Key (δελτία κουζίνας).
Μετά την εκτύπωση δελτίου, καλέστε POST /api/public/orders/{orderId}/printed.
Καλέστε GET /api/public/orders/unprinted-receipts για τιμολογημένες παραγγελίες (περιλαμβάνει invoice JSON).
Μετά την εκτύπωση απόδειξης, καλέστε POST /api/public/orders/{orderId}/receipt-printed.

Ταυτοποίηση

Στείλτε το Orders API key σε κάθε αίτημα. Μην το εκθέτετε σε δημόσιο front-end κώδικα.

Ανοίξτε τις Ρυθμίσεις για να δημιουργήσετε κλειδί →

X-Api-Key: YOUR_ORDERS_API_KEY

Μπορείτε επίσης να χρησιμοποιήσετε Authorization: Bearer YOUR_ORDERS_API_KEY.

Λίστα μη εκτυπωμένων

GET https://resty.gr/api/public/orders/unprinted

Επιστρέφει JSON με ok, username, currency, count και πίνακα orders. Περιλαμβάνονται μόνο δελτία κουζίνας με Εκτυπωμένη = Όχι (έως 500, από τις παλαιότερες). Αν η παραγγελία έχει τιμολογηθεί, περιλαμβάνονται invoice (JSON Wrapp/απόδειξης) και invoice_receipt_printed· αλλιώς invoice είναι null.

ok · username · currency (code, symbol, label, position) · count · orders

Παράδειγμα cURL

curl -sS -H "X-Api-Key: YOUR_ORDERS_API_KEY" "https://resty.gr/api/public/orders/unprinted"

Σήμανση δελτίου κουζίνας ως εκτυπωμένο

POST https://resty.gr/api/public/orders/{orderId}/printed

Ορίζει Εκτυπωμένη = Ναι για αυτή την παραγγελία (του εμπόρου του API key). Η απάντηση περιλαμβάνει username και currency. Είναι ασφαλές να ξανακληθεί: επιστρέφει ok με already_printed true.

Παράδειγμα cURL

curl -sS -X POST -H "X-Api-Key: YOUR_ORDERS_API_KEY" "https://resty.gr/api/public/orders/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/printed"

Παράδειγμα απάντησης σήμανσης

{
    "ok": true,
    "username": "your_username",
    "currency": {
        "code": "EUR",
        "symbol": "€",
        "label": "EUR — Euro (€)",
        "position": "left"
    },
    "order_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "order_code": "A104",
    "is_printed": true,
    "already_printed": false
}

Λίστα μη εκτυπωμένων αποδείξεων

GET https://resty.gr/api/public/orders/unprinted-receipts

Επιστρέφει παραγγελίες με αποθηκευμένο invoice/receipt JSON και Απόδειξη = Όχι (έως 500). Κάθε cart_items[] έχει vat_rate, net_total, vat_total για εκτύπωση απόδειξης. Εκτυπώστε με cart_items (+ invoice) και μετά κάντε σήμανση receipt-printed.

Παράδειγμα cURL

curl -sS -H "X-Api-Key: YOUR_ORDERS_API_KEY" "https://resty.gr/api/public/orders/unprinted-receipts"

Παράδειγμα απάντησης αποδείξεων

{
    "ok": true,
    "username": "your_username",
    "currency": {
        "code": "EUR",
        "symbol": "€",
        "label": "EUR — Euro (€)",
        "position": "left"
    },
    "count": 1,
    "orders": [
        {
            "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "order_code": "A104",
            "username": "your_username",
            "currency": {
                "code": "EUR",
                "symbol": "€",
                "label": "EUR — Euro (€)",
                "position": "left"
            },
            "status_id": "…",
            "status_name": "Completed",
            "status_color": "#22c55e",
            "order_mode": "in_store",
            "floor_table_id": "…",
            "floor_table_code": "T12",
            "customer_inputs": {
                "custom_fields": [
                    {
                        "label": "Name",
                        "value": "Maria"
                    },
                    {
                        "label": "Phone",
                        "value": "6900000000"
                    }
                ]
            },
            "custom_fields": [
                {
                    "label": "Name",
                    "value": "Maria"
                },
                {
                    "label": "Phone",
                    "value": "6900000000"
                }
            ],
            "cart_items": [
                {
                    "id": "line_…",
                    "product_id": "…",
                    "name": "Burger",
                    "quantity": 2,
                    "unit_price": 8.5,
                    "total_num": 17,
                    "net_total": 13.71,
                    "vat_total": 3.29,
                    "vat_rate": 24,
                    "vat_exemption_code": null,
                    "comment": "No onions",
                    "option_labels": [
                        "Size: Large"
                    ],
                    "options": [
                        {
                            "group_id": "…",
                            "group": "Size",
                            "item_id": "…",
                            "label": "Large",
                            "price_num": 1
                        }
                    ],
                    "selections": {},
                    "thumb_url": ""
                },
                {
                    "id": "line_…",
                    "product_id": "…",
                    "name": "Coffee",
                    "quantity": 1,
                    "unit_price": 2.5,
                    "total_num": 2.5,
                    "net_total": 2.21,
                    "vat_total": 0.29,
                    "vat_rate": 13,
                    "vat_exemption_code": null,
                    "comment": "",
                    "option_labels": [],
                    "options": [],
                    "selections": {},
                    "thumb_url": ""
                }
            ],
            "cart_total": 19.5,
            "show_on_order_screen": true,
            "is_printed": true,
            "payment_method_type": 0,
            "invoice": {
                "invoice_id": "wrapp-…",
                "mark": "123456789",
                "my_data_uid": "…",
                "my_data_qr_url": "https://…",
                "wrapp_invoice_url": "https://…",
                "pdf_url": "https://…",
                "pdf_status": "ready",
                "payment_method_type": 0,
                "pos_device_id": "",
                "sandbox": false,
                "has_pdf": true,
                "receipt_printed": false,
                "request_payload": {
                    "invoice_lines": [
                        {
                            "line_number": 1,
                            "name": "Burger",
                            "quantity": 2,
                            "unit_price": 6.85,
                            "net_total_price": 13.71,
                            "vat_rate": 24,
                            "vat_total": 3.29,
                            "subtotal": 17
                        },
                        {
                            "line_number": 2,
                            "name": "Coffee",
                            "quantity": 1,
                            "unit_price": 2.21,
                            "net_total_price": 2.21,
                            "vat_rate": 13,
                            "vat_total": 0.29,
                            "subtotal": 2.5
                        }
                    ]
                }
            },
            "invoice_receipt_printed": false,
            "created_at": "2026-07-20 12:00:00",
            "updated_at": "2026-07-20 12:05:00",
            "created_at_unix": 1721476800,
            "updated_at_unix": 1721477100
        }
    ]
}

Πώς να δείξετε ΦΠΑ ανά είδος στην απόδειξη

Για κάθε γραμμή στο cart_items εκτυπώστε name, quantity, total_num και από κάτω το vat_rate (%) μαζί με net_total / vat_total. Τα ίδια ποσοστά υπάρχουν και στο invoice.request_payload.invoice_lines[].vat_rate.

2× Burger                 €17.00
   VAT 24%   net €13.71   VAT €3.29
1× Coffee                  €2.50
   VAT 13%   net €2.21    VAT €0.29

Σήμανση απόδειξης ως εκτυπωμένη

POST https://resty.gr/api/public/orders/{orderId}/receipt-printed

Ορίζει invoice_receipt_printed = Ναι και ενημερώνει invoice.receipt_printed στο αποθηκευμένο JSON. Είναι ασφαλείς επανακλήσεις. Μετά την επιτυχία, η παραγγελία φεύγει από το unprinted-receipts.

Παράδειγμα cURL

curl -sS -X POST -H "X-Api-Key: YOUR_ORDERS_API_KEY" "https://resty.gr/api/public/orders/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/receipt-printed"

Παράδειγμα απάντησης σήμανσης

{
    "ok": true,
    "username": "your_username",
    "currency": {
        "code": "EUR",
        "symbol": "€",
        "label": "EUR — Euro (€)",
        "position": "left"
    },
    "order_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "order_code": "A104",
    "invoice_receipt_printed": true,
    "already_printed": false
}

Παράδειγμα απάντησης λίστας κουζίνας

Κάθε παραγγελία περιλαμβάνει username, currency (code, symbol, label, position), τύπο, τραπέζι, προσαρμοσμένα πεδία, γραμμές καλαθιού, σύνολα, κατάσταση, χρονικές σφραγίδες, payment_method_type, invoice (null αν δεν έχει τιμολογηθεί) και invoice_receipt_printed. Μορφοποιήστε ποσά με currency.symbol και currency.position (left = πριν, right = μετά).

{
    "ok": true,
    "username": "your_username",
    "currency": {
        "code": "EUR",
        "symbol": "€",
        "label": "EUR — Euro (€)",
        "position": "left"
    },
    "count": 1,
    "orders": [
        {
            "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "order_code": "A104",
            "username": "your_username",
            "currency": {
                "code": "EUR",
                "symbol": "€",
                "label": "EUR — Euro (€)",
                "position": "left"
            },
            "status_id": "…",
            "status_name": "Preparing",
            "status_color": "#22c55e",
            "order_mode": "in_store",
            "floor_table_id": "…",
            "floor_table_code": "T12",
            "customer_inputs": {
                "custom_fields": [
                    {
                        "label": "Name",
                        "value": "Maria"
                    },
                    {
                        "label": "Phone",
                        "value": "6900000000"
                    },
                    {
                        "label": "Address",
                        "value": ""
                    }
                ]
            },
            "custom_fields": [
                {
                    "label": "Name",
                    "value": "Maria"
                },
                {
                    "label": "Phone",
                    "value": "6900000000"
                },
                {
                    "label": "Address",
                    "value": ""
                }
            ],
            "cart_items": [
                {
                    "id": "line_…",
                    "product_id": "…",
                    "name": "Burger",
                    "quantity": 2,
                    "unit_price": 8.5,
                    "total_num": 17,
                    "comment": "No onions",
                    "option_labels": [
                        "Size: Large",
                        "Extra cheese"
                    ],
                    "options": [
                        {
                            "group_id": "…",
                            "group": "Size",
                            "item_id": "…",
                            "label": "Large",
                            "price_num": 1
                        },
                        {
                            "group_id": "…",
                            "group": "Extras",
                            "item_id": "…",
                            "label": "Extra cheese",
                            "price_num": 0.5
                        }
                    ],
                    "selections": {},
                    "thumb_url": ""
                }
            ],
            "cart_total": 17,
            "show_on_order_screen": true,
            "is_printed": false,
            "payment_method_type": null,
            "invoice": null,
            "invoice_receipt_printed": false,
            "created_at": "2026-07-20 12:00:00",
            "updated_at": "2026-07-20 12:01:00",
            "created_at_unix": 1721476800,
            "updated_at_unix": 1721476860
        }
    ]
}

Αναφορά πεδίων (λίστα)

Πεδίο	Περιγραφή
`id`	UUID παραγγελίας (χρησιμοποιήστε το ως {orderId} στη σήμανση).
`order_code`	Αναγνώσιμος κωδικός παραγγελίας.
`username`	Username εμπόρου (επιστρέφεται και στο top level της λίστας/σήμανσης).
`currency`	Νόμισμα εμφάνισης από τις Ρυθμίσεις: {code, symbol, label, position} όπου position είναι left ή right. Επιστρέφεται και στο top level.
`status_*`	Id, όνομα και χρώμα κατάστασης.
`order_mode`	delivery \| takeaway \| in_store (ή κενό για παλιές κάρτες).
`floor_table_*`	Id και κωδικός τραπεζιού όταν είναι στο κατάστημα.
`customer_inputs`	Πλήρες αντικείμενο εισόδων (περιλαμβάνει custom_fields και τυχόν επιπλέον κλειδιά).
`custom_fields`	Όλα τα προσαρμοσμένα πεδία ως [{label, value}, …], συμπεριλαμβανομένων κενών τιμών. Η ίδια λίστα υπάρχει και στο customer_inputs.custom_fields.
`cart_items`	Λεπτομερείς γραμμές καλαθιού (όνομα, product_id, ποσότητα, τιμές, ΦΠΑ, σχόλιο, επιλογές, selections, thumb).
`cart_items[].quantity`	Ποσότητα γραμμής (ακέραιος, ελάχ. 1).
`cart_items[].unit_price`	Τιμή ανά μονάδα (πριν την ποσότητα).
`cart_items[].total_num`	Σύνολο γραμμής = unit_price × quantity.
`cart_items[].net_total`	Καθαρό ποσό γραμμής (χωρίς ΦΠΑ), υπολογισμένο από total_num και vat_rate.
`cart_items[].vat_total`	Ποσό ΦΠΑ γραμμής.
`cart_items[].vat_rate`	Ποσοστό ΦΠΑ της γραμμής (π.χ. 24, 13, 6, 0). Προεπιλογή 24 αν λείπει από παλιές παραγγελίες.
`cart_items[].vat_exemption_code`	Κωδικός απαλλαγής myDATA όταν vat_rate = 0· αλλιώς null.
`cart_items[].comment`	Προαιρετική σημείωση κουζίνας/προσωπικού για τη γραμμή.
`cart_items[].options`	Επιλεγμένες επιλογές ως [{group, label, price_num, …}] και option_labels.
`cart_total`	Άθροισμα των total_num των γραμμών.
`show_on_order_screen`	Αν εμφανίζεται στην οθόνη παραγγελιών.
`is_printed`	Σημαία εκτύπωσης δελτίου κουζίνας (πάντα false στη λίστα μη εκτυπωμένων).
`payment_method_type`	Τύπος πληρωμής checkout όταν έχει τιμολογηθεί: 0 = μετρητά, 3 = κάρτα, 7 = IRIS· null αν δεν έχει οριστεί / μόνο προώθηση.
`invoice`	Αποθηκευμένο JSON τιμολογίου/απόδειξης Wrapp όταν έχει τιμολογηθεί· αλλιώς null. Περιλαμβάνει mark, pdf_url, has_pdf, receipt_printed και σχετικά πεδία Wrapp.
`invoice.request_payload.invoice_lines`	Γραμμές Wrapp με vat_rate / vat_total (αν αποθηκεύτηκαν στο invoice JSON). Χρήσιμο ως εναλλακτική πηγή για την απόδειξη.
`invoice_receipt_printed`	Σημαία εκτύπωσης απόδειξης (false στο unprinted-receipts). Σήμανση με POST …/receipt-printed.
`invoice.receipt_printed`	Η ίδια σημαία μέσα στο invoice.receipt_printed (συγχρονισμένη με invoice_receipt_printed).
`created_at` / `updated_at`	Datetime MySQL και unix timestamps.

Για AI / αυτοματισμούς

Κατεβάστε το Markdown και επισυνάψτε το στις οδηγίες του agent. Κάντε poll δελτία (…/unprinted) και αποδείξεις (…/unprinted-receipts). Στην απόδειξη δείξτε κάθε είδος με vat_rate / net_total / vat_total, μετά POST …/printed ή …/receipt-printed.

Λήψη οδηγιών AI (.md)

Μενού

Τι κάνει

Ταυτοποίηση

Λίστα μη εκτυπωμένων

Παράδειγμα cURL

Σήμανση δελτίου κουζίνας ως εκτυπωμένο

Παράδειγμα cURL

Παράδειγμα απάντησης σήμανσης

Λίστα μη εκτυπωμένων αποδείξεων

Παράδειγμα cURL

Παράδειγμα απάντησης αποδείξεων

Πώς να δείξετε ΦΠΑ ανά είδος στην απόδειξη

Σήμανση απόδειξης ως εκτυπωμένη

Παράδειγμα cURL

Παράδειγμα απάντησης σήμανσης

Παράδειγμα απάντησης λίστας κουζίνας

Αναφορά πεδίων (λίστα)

Για AI / αυτοματισμούς