Στοιχεία παραγγελίας

Η κλήση GET /orders/{id} επιστρέφει μία παραγγελία με τα προϊόντα της, τα στοιχεία του παραλήπτη και τις αποστολές (vouchers) που έχουν εκδοθεί για αυτή.

WARNING

Θα πρέπει να συμπεριλάβετε το API Token σας σε κάθε αίτημα ως Bearer Token. Αντικαταστήστε το YOUR_TOKEN με το API Token του καταστήματος (chub_...). Δείτε το Overview.

Method	URI	Headers
GET	/api/v2/orders/{id}	Authorization: Bearer YOUR_TOKEN

Μεταβλητές αποστολής

Variable Name	Type	Usage	Required
id	Integer	Το id της παραγγελίας (το εσωτερικό ID του CourierHub, όπως επιστρέφεται στη δημιουργία και στη λίστα), μέσα στο path του URL. Όχι το order_id ούτε το order_number: για αναζήτηση με αυτά χρησιμοποιήστε το φίλτρο order_number του GET /orders.	*

Βλέπετε τις παραγγελίες όλων των καταστημάτων του λογαριασμού σας, όχι μόνο του καταστήματος του token. Παραγγελία άλλου λογαριασμού ή διαγραμμένη παραγγελία επιστρέφει 404.

Απάντηση αιτήματος

Η εφαρμογή σας επιστρέφει δεδομένα σε μορφή JSON, μέσα στο κλειδί data. Το ίδιο αντικείμενο επιστρέφεται και από το POST /orders και το PATCH /orders/{id}. Στη λίστα παραγγελιών επιστρέφεται χωρίς τα products και shipments.

Variable Name	Type	Description
id	Integer	Το εσωτερικό ID της παραγγελίας στο CourierHub. Είναι το {id} των /orders/{id} και το order.id των αποστολών.
order_id	String	Αριθμητικό αναγνωριστικό της παραγγελίας. Για παραγγελίες που δημιουργήθηκαν από το API (ή χειροκίνητα στο CourierHub) το παράγει το CourierHub (π.χ. 20261015101200482) και είναι η αναφορά παραγγελίας που λαμβάνει η courier. Για παραγγελίες από e-shop είναι το ID του e-shop. Δείτε order_id και order_number.
order_number	String ή null	Ο δικός σας αριθμός παραγγελίας, όπως τον στείλατε (π.χ. #1001, INV-2026/17). Για παραγγελίες e-shop μπορεί να είναι null (δείτε Αριθμός παραγγελίας).
status	String	Η κατάσταση της παραγγελίας: pending, processing, shipped, delivered, cancelled, refunded, store_pickup, store_pickup_ready, store_pickup_completed. Δείτε τον πίνακα καταστάσεων.
status_label	String	Η κατάσταση στα Ελληνικά, για εμφάνιση.
order_date	String ή null	Η ημερομηνία της παραγγελίας (ISO 8601, UTC).
recipient.name	String	Ονοματεπώνυμο παραλήπτη.
recipient.phone	String	Τηλέφωνο παραλήπτη, κανονικοποιημένο (χωρίς κενά και παύλες, το 00 στην αρχή γίνεται +).
recipient.email	String	Email παραλήπτη.
recipient.address	String	Διεύθυνση (οδός και αριθμός).
recipient.city	String	Πόλη / περιοχή.
recipient.postal_code	String	Ταχυδρομικός κώδικας, κανονικοποιημένος (π.χ. 105 63 αποθηκεύεται ως 10563).
recipient.country	String	GR, CY, EU, US ή OTHER.
receive_from_reception	Boolean	true για παραλαβή από το δικό σας κατάστημα (store pickup, χωρίς courier).
courier	Object ή null	Η courier της παραγγελίας (id, name), με το ίδιο id όπως στο GET /couriers. null αν δεν έχει οριστεί ή αν πρόκειται για παραλαβή από κατάστημα.
services	Array	Επιπλέον υπηρεσίες courier: saturday, epistrofi, receive_from_reception. Δείτε το POST /orders.
locker_id	String ή null	Η θυρίδα (locker) Box Now. null για τις άλλες courier.
payment_method	String	Τρόπος πληρωμής: cod (αντικαταβολή), paypal, stripe, bank_transfer, other. Οι παραγγελίες e-shop μπορεί να έχουν και άλλες τιμές, όπως τις έστειλε το e-shop.
subtotal	String	Αξία προϊόντων, με 2 δεκαδικά.
shipping_cost	String	Μεταφορικά, με 2 δεκαδικά.
cod_cost	String	Έξοδα αντικαταβολής, με 2 δεκαδικά. "0.00" όταν η πληρωμή δεν είναι cod.
total_amount	String	Σύνολο παραγγελίας, με 2 δεκαδικά. Για παραγγελίες του API ισούται με subtotal + shipping_cost + cod_cost. Σε αντικαταβολή είναι το ποσό που εισπράττει η courier.
weight	String ή null	Βάρος σε κιλά, με 3 δεκαδικά (π.χ. "1.200").
notes	String ή null	Σημειώσεις.
has_shipment	Boolean	Αν η παραγγελία έχει εκδοθέν voucher (μη διαγραμμένο).
store.id, store.name	Integer, String	Το κατάστημα της παραγγελίας.
products	Array	Τα προϊόντα (δείτε παρακάτω). Κενός πίνακας αν δεν υπάρχουν. Δεν επιστρέφεται στη λίστα.
products[].name	String	Όνομα προϊόντος.
products[].sku	String ή null	Κωδικός προϊόντος.
products[].unit_price	String	Τιμή μονάδας, με 2 δεκαδικά.
products[].quantity	Integer	Ποσότητα.
products[].total_price	String	unit_price × quantity, με 2 δεκαδικά.
shipments	Array	Τα vouchers της παραγγελίας, με την ίδια μορφή όπως στο GET /shipments/{voucher}. Μία παραγγελία μπορεί να έχει περισσότερα από ένα voucher (π.χ. όταν προωθήθηκε σε άλλη courier). Δεν επιστρέφεται στη λίστα.
created_at	String	Πότε δημιουργήθηκε η παραγγελία στο CourierHub (ISO 8601, UTC).
updated_at	String	Πότε άλλαξε τελευταία φορά (ISO 8601, UTC).

Ποσά και ημερομηνίες

Όπως σε όλο το v2, τα ποσά είναι string με 2 δεκαδικά και οι ημερομηνίες ISO 8601 σε UTC. Δείτε Ημερομηνίες και ποσά.

Παράδειγμα επιτυχημένης αναζήτησης (παραγγελία με voucher).

{
    "data": {
        "id": 2,
        "order_id": "20261015101700155",
        "order_number": "INV-2026/17",
        "status": "pending",
        "status_label": "Εκκρεμής",
        "order_date": "2026-10-15T07:17:00Z",
        "recipient": {
            "name": "Γιώργος Νικολάου",
            "phone": "+302310123456",
            "email": "giorgos@example.com",
            "address": "Τσιμισκή 40",
            "city": "Θεσσαλονίκη",
            "postal_code": "54623",
            "country": "GR"
        },
        "receive_from_reception": false,
        "courier": {
            "id": 9,
            "name": "ELTA"
        },
        "services": [
            "saturday"
        ],
        "locker_id": null,
        "payment_method": "stripe",
        "subtotal": "24.00",
        "shipping_cost": "0.00",
        "cod_cost": "0.00",
        "total_amount": "24.00",
        "weight": null,
        "notes": null,
        "has_shipment": true,
        "store": {
            "id": 1,
            "name": "Το Κατάστημά μου"
        },
        "products": [
            {
                "name": "Τσάντα πάνινη",
                "sku": "BAG-02",
                "unit_price": "24.00",
                "quantity": 1,
                "total_price": "24.00"
            }
        ],
        "shipments": [
            {
                "voucher_number": "ZE123456789GR",
                "courier": {
                    "id": 9,
                    "name": "ELTA"
                },
                "status": "created",
                "status_label": "Δημιουργήθηκε",
                "delivered_at": null,
                "returned_at": null,
                "cod_amount": "0.00",
                "cod_paid": false,
                "last_event": {
                    "description": "Παραλαβή από ELTA",
                    "code": 2,
                    "occurred_at": "2026-10-15T07:57:00Z"
                },
                "tracking_url": "https://courierhub.gr/t/xKcspf55",
                "created_at": "2026-10-15T07:57:00Z",
                "order": {
                    "id": 2,
                    "order_id": "20261015101700155",
                    "order_number": "INV-2026/17",
                    "store": {
                        "id": 1,
                        "name": "Το Κατάστημά μου"
                    }
                }
            }
        ],
        "created_at": "2026-10-15T07:17:00Z",
        "updated_at": "2026-10-15T07:17:00Z"
    }
}

Το status της παραγγελίας και το status της αποστολής είναι διαφορετικά πεδία: το πρώτο είναι η κατάσταση της παραγγελίας στο CourierHub, το δεύτερο η κατάσταση του voucher από την courier. Για το ιστορικό ενός voucher χρησιμοποιήστε το GET /shipments/{voucher}/tracking.

Παράδειγμα σφάλματος (άγνωστο id, παραγγελία άλλου λογαριασμού ή διαγραμμένη παραγγελία).

{
    "message": "Resource not found.",
    "code": "not_found"
}

Παράδειγμα κλήσης

curl https://courierhub.gr/api/v2/orders/2 \
  -H "Authorization: Bearer chub_YOUR_API_TOKEN" \
  -H "Accept: application/json"