v2.logistics.get_booking_tracking_info
GET /api/v2/logistics/get_booking_tracking_info
Sử dụng API này để lấy thông tin theo dõi vận chuyển của một booking.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/get_booking_tracking_info
Tham số chung
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token truy cập API, dùng để xác định quyền truy cập của bạn. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của cửa hàng trên Shopee. Bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Chữ ký được tạo từ partner_id, đường dẫn API, timestamp, access_token, shop_id và partner_key thông qua thuật toán HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| booking_sn | string | True | 201201E81SYYKE | Mã định danh duy nhất của booking trên Shopee. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| request_id | string | 862fc4d77de74edf9bf045c7650f1988 | Mã định danh của yêu cầu API để theo dõi lỗi. |
| error | string | error_auth | Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. |
| message | string | Invalid access_token. | Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi. |
| response | object | Thông tin chi tiết bạn đang truy vấn. | |
| booking_sn | string | 201214JASXYXY6 | Mã định danh duy nhất của booking trên Shopee. |
| logistics_status | string | LOGISTICS_REQUEST_CREATED | Trạng thái vận chuyển Shopee của booking. Các giá trị: LOGISTICS_REQUEST_CREATED: đã sắp xếp vận chuyển LOGISTICS_PICKUP_DONE: đã bàn giao cho 3PL LOGISTICS_PICKUP_FAILED: bị 3PL hủy do lấy hàng thất bại hoặc lấy được nhưng không thể giao LOGISTICS_DELIVERY_DONE: giao hàng thành công LOGISTICS_REQUEST_CANCELED: đã hủy khi ở trạng thái LOGISTICS_REQUEST_CREATED LOGISTICS_READY: booking sẵn sàng để thực hiện LOGISTICS_INVALID: đã hủy khi ở trạng thái LOGISTICS_READY LOGISTICS_LOST: đã hủy do 3PL làm mất kiện hàng |
| tracking_info | object[] | Thông tin theo dõi của booking. | |
| update_time | timestamp | 1587375600 | Thời điểm cập nhật thông tin vận chuyển. |
| description | string | Your parcel is ready to ship from the seller | Mô tả thông tin theo dõi vận chuyển của booking. |
| logistics_status | string | PICKED_UP | Trạng thái vận chuyển Shopee của booking. Các trạng thái theo dõi: INITIAL, ORDER_INIT, ORDER_SUBMITTED, ORDER_CREATED, PICKUP_REQUESTED, PICKUP_PENDING, PICKED_UP, DELIVERY_PENDING, DELIVERED, LOST, UPDATE, UPDATE_SUBMITTED, UPDATE_CREATED, RETURN_STARTED, RETURN_PENDING, CANCEL, CANCEL_CREATED, CANCELED, FAILED_ORDER_SUBMITTED, FAILED_ORDER_CREATED, FAILED_PICKUP_REQUESTED, FAILED_PICKED_UP, FAILED_DELIVERED, FAILED_UPDATE_SUBMITTED, FAILED_UPDATE_CREATED, FAILED_RETURNED, FAILED_CANCEL_CREATED, FAILED_CANCELED, RETURNED, RETURN_INTIATED |