Στοιχεία αποστολής

Η κλήση GET /shipments/{voucher} επιστρέφει μία αποστολή με βάση τον αριθμό voucher της courier.

WARNING

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

Method	URI	Headers
GET	/api/v2/shipments/{voucher}	Authorization: Bearer YOUR_TOKEN

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

Variable Name	Type	Usage	Required
voucher	String	Ο αριθμός voucher, μέσα στο path του URL (π.χ. 7012345678).	*

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

Η εφαρμογή σας επιστρέφει δεδομένα σε μορφή JSON, μέσα στο κλειδί data. Το ίδιο αντικείμενο επιστρέφεται στα στοιχεία της λίστας αποστολών και στα webhooks (data.shipment).

Variable Name	Type	Description
voucher_number	String	Ο αριθμός voucher της courier.
courier.id	Integer	Το ID της courier (ίδιο με το GET /couriers).
courier.name	String	Το όνομα της courier.
status	String	Η κατάσταση της αποστολής: cancelled, returned, delivered, lost, problem, stalled, in_transit, created.
status_label	String	Η κατάσταση στα Ελληνικά, για εμφάνιση.
delivered_at	String ή null	Πότε παραδόθηκε (ISO 8601, UTC).
returned_at	String ή null	Πότε επιστράφηκε (ISO 8601, UTC).
cod_amount	String ή null	Το ποσό αντικαταβολής με 2 δεκαδικά. "0.00" αν η αποστολή δεν έχει αντικαταβολή. null μόνο αν δεν έχει αποθηκευτεί ποσό για την αποστολή.
cod_paid	Boolean	Αν η αντικαταβολή έχει εξοφληθεί / αποδοθεί.
last_event	Object ή null	Το τελευταίο tracking event της παραγγελίας (δείτε παρακάτω). null αν δεν υπάρχει κανένα.
last_event.description	String	Το κείμενο της courier όπως ακριβώς το έστειλε.
last_event.code	Integer ή null	Ο κωδικός κατάστασης της courier.
last_event.occurred_at	String	Πότε έγινε το event (ISO 8601, UTC).
tracking_url	String	Η δημόσια σελίδα tracking για τον πελάτη σας.
created_at	String	Πότε δημιουργήθηκε η αποστολή (ISO 8601, UTC).
order.id	Integer	Το εσωτερικό ID της παραγγελίας στο CourierHub.
order.order_id	String	Το ID της παραγγελίας στο e-shop (π.χ. το εσωτερικό ID της Shopify).
order.order_number	String ή null	Ο αριθμός παραγγελίας (π.χ. #12345). Δείτε Αριθμός παραγγελίας.
order.store	Object ή null	Το κατάστημα της παραγγελίας (id, name).

Το last_event ανήκει στην παραγγελία

Το last_event είναι το πιο πρόσφατο tracking event της παραγγελίας, όχι αποκλειστικά του voucher. Αν η παραγγελία έχει προωθηθεί σε άλλη courier, το last_event μπορεί να είναι event της άλλης courier. Αντίθετα, το GET /shipments/{voucher}/tracking και τα new_events των webhooks φιλτράρονται με βάση την courier του voucher. Αν χρειάζεστε το ιστορικό ενός συγκεκριμένου voucher, χρησιμοποιήστε το /tracking.

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

{
    "data": {
        "voucher_number": "7012345678",
        "courier": {
            "id": 8,
            "name": "ACS"
        },
        "status": "delivered",
        "status_label": "Παραδόθηκε",
        "delivered_at": "2026-10-15T05:40:00Z",
        "returned_at": null,
        "cod_amount": "49.90",
        "cod_paid": true,
        "last_event": {
            "description": "Παραδόθηκε",
            "code": 7,
            "occurred_at": "2026-10-15T05:40:00Z"
        },
        "tracking_url": "https://courierhub.gr/t/mQ7CdcKy",
        "created_at": "2026-10-14T07:05:00Z",
        "order": {
            "id": 1,
            "order_id": "5012345678901",
            "order_number": "#12345",
            "store": {
                "id": 1,
                "name": "Το Κατάστημά μου"
            }
        }
    }
}

Παράδειγμα με last_event από άλλη courier

Η ίδια αποστολή, όταν η παραγγελία έχει μεταγενέστερο event από άλλη courier (ELTA). Το status και τα υπόλοιπα πεδία παραμένουν της ACS:

{
    "data": {
        "voucher_number": "7012345678",
        "courier": {
            "id": 8,
            "name": "ACS"
        },
        "status": "delivered",
        "status_label": "Παραδόθηκε",
        "delivered_at": "2026-10-15T05:40:00Z",
        "returned_at": null,
        "cod_amount": "49.90",
        "cod_paid": true,
        "last_event": {
            "description": "Εκκρεμεί παράδοση",
            "code": 3,
            "occurred_at": "2026-10-15T06:30:00Z"
        },
        "tracking_url": "https://courierhub.gr/t/mQ7CdcKy",
        "created_at": "2026-10-14T07:05:00Z",
        "order": {
            "id": 1,
            "order_id": "5012345678901",
            "order_number": "#12345",
            "store": {
                "id": 1,
                "name": "Το Κατάστημά μου"
            }
        }
    }
}

Παράδειγμα σφάλματος (άγνωστος αριθμός voucher ή voucher άλλου λογαριασμού).

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

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

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