API παραγγελιών2026-11Προεπισκόπηση

Αποστολές

Ένα δέμα καθ' οδόν προς τον πελάτη σας. Η παρακολούθησή του επιστρέφει στο κατάστημα από το οποίο ήρθε η παραγγελία, ώστε ο πελάτης σας να ενημερώνεται από εσάς, όχι από εμάς.

Το order.shipped ενεργοποιείται όταν δημιουργείται μια αποστολή, με την παρακολούθησή της.

Endpoints

GET/v1/shipmentsΛίστα αποστολών
GET/v1/shipments/{id}Ανάκτηση αποστολής
GET/v1/shipments/{id}/trackingΑνάκτηση συμβάντων παρακολούθησης

Το αντικείμενο Shipment

idstring: Ξεκινά με shp_.
order, fulfillment_orderstring: Τι μεταφέρει.
lanestring: saver ή fast.
carrier, tracking_number, tracking_urlstring: Παρακολούθηση, έτοιμη για τον πελάτη σας.
weight_ginteger: Πόσο ζύγιζε το δέμα όταν το συσκευάσαμε.
shipping_chargedmoney: Αποστολή, χρέωση διαχείρισης και φόρος για το ζυγισμένο δέμα, σε CN¥: όσα πλήρωσε το υπόλοιπό σας.
pushed_to_channelboolean: Αν το κατάστημα από το οποίο ήρθε η παραγγελία έχει την παρακολούθηση. Το Shopify μετά τη στέλνει με email στον πελάτη σας.
statusstring: in_transit, out_for_delivery, delivered ή exception (σε αναμονή, επιστράφηκε, χάθηκε).
shipped_at, delivered_atstring|null: Πότε έφυγε από εμάς, και πότε ο μεταφορέας λέει ότι έφτασε.

shipment

{
  "id": "shp_5r8w",
  "order": "ord_3n7q",
  "fulfillment_order": "fo_7k2m",
  "lane": "saver",
  "carrier": "YunExpress",
  "tracking_number": "YT2630812345678",
  "tracking_url": "https://t.17track.net/en#nums=YT2630812345678",
  "weight_g": 176,
  "shipping_charged": { "amount": "134.52", "currency": "CNY" },
  "pushed_to_channel": true,
  "status": "in_transit",
  "shipped_at": "2026-11-03T06:00:00Z",
  "delivered_at": null
}

Λίστα αποστολών

GET/v1/shipments

Τα νεότερα πρώτα. Φιλτράρετε ανά κατάσταση για να βρείτε όσα χρειάζονται ενέργειά σας.

Scopeorders:read

Παράμετροι ερωτήματος

statusstring: Προαιρετικό.
orderstring: Προαιρετικό. Ένα id παραγγελίας.
shipped_sincestring: Προαιρετικό. Μια χρονική στιγμή.
limit, cursor: Pagination

curl "https://www.ninjabuy.com/api/v1/shipments?status=exception" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "data": [
    {
      "id": "shp_5q1d",
      "order": "ord_3m2b",
      "tracking_number": "YT2630811190042",
      "status": "exception"
    }
  ],
  "has_more": false,
  "cursor": null
}

Ανάκτηση αποστολής

GET/v1/shipments/{id}

Ένα δέμα, με την παρακολούθησή του.

Scopeorders:read

Παράμετροι διαδρομής

idstringυποχρεωτικό: Το id της αποστολής.

Σφάλματα

Κατάσταση	Τύπος	Πότε
404	not-found	Δεν υπάρχει τέτοια αποστολή σε αυτόν τον λογαριασμό.

curl "https://www.ninjabuy.com/api/v1/shipments/shp_5r8w" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "id": "shp_5r8w",
  "order": "ord_3n7q",
  "fulfillment_order": "fo_7k2m",
  "lane": "saver",
  "carrier": "YunExpress",
  "tracking_number": "YT2630812345678",
  "tracking_url": "https://t.17track.net/en#nums=YT2630812345678",
  "weight_g": 176,
  "shipping_charged": { "amount": "134.52", "currency": "CNY" },
  "pushed_to_channel": true,
  "status": "in_transit",
  "shipped_at": "2026-11-03T06:00:00Z",
  "delivered_at": null
}

Ανάκτηση συμβάντων παρακολούθησης

GET/v1/shipments/{id}/tracking

Τα σκαναρίσματα του μεταφορέα, τα παλαιότερα πρώτα, στα αγγλικά.

Scopeorders:read

Παράμετροι διαδρομής

idstringυποχρεωτικό: Το id της αποστολής.

Σφάλματα

Κατάσταση	Τύπος	Πότε
404	not-found	Δεν υπάρχει τέτοια αποστολή σε αυτόν τον λογαριασμό.

curl "https://www.ninjabuy.com/api/v1/shipments/shp_5r8w/tracking" \
  -H "Authorization: Bearer $NINJABUY_API_KEY" \
  -H "NinjaBuy-Version: 2026-11"

Response 200

HTTP/2 200 OK

{
  "shipment": "shp_5r8w",
  "status": "in_transit",
  "events": [
    {
      "at": "2026-11-03T06:00:00Z",
      "where": "Shenzhen, CN",
      "status": "in_transit",
      "description": "Left the NinjaBuy warehouse"
    },
    {
      "at": "2026-11-05T22:10:00Z",
      "where": "Shenzhen, CN",
      "status": "in_transit",
      "description": "Departed the origin country"
    },
    {
      "at": "2026-11-09T19:40:00Z",
      "where": "Los Angeles, US",
      "status": "in_transit",
      "description": "Arrived in the destination country"
    }
  ]
}