v2.logistics.get_mass_tracking_number
POST /api/v2/logistics/get_mass_tracking_number
Sau khi sắp xếp vận chuyển (v2.logistics.mass_ship_order) cho kênh tích hợp, sử dụng API này để lấy tracking_number — tham số bắt buộc để tạo nhãn vận chuyển. Phản hồi có thể trả về tracking_number rỗng vì thông tin này phụ thuộc vào 3PL, do đó được phép gọi lại API theo khoảng 5 phút một lần cho đến khi tracking_number được trả về.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/get_mass_tracking_number
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 |
|---|---|---|---|---|
| package_list | object[] | True | Danh sách các gói hàng cần lấy mã theo dõi. Giới hạn [1, 50]. | |
| package_number | string | True | Mã định danh duy nhất của gói hàng trong đơn hàng trên Shopee. Không được để trống khi không có số gói hàng. | |
| response_optional_fields | string | False | first_mile_tracking_number | Cho biết các trường phản hồi bạn muốn lấy. Chọn từ các tham số phản hồi bên dưới. Nếu nhập trường object, tất cả tham số trong đó sẽ tự động được đưa vào phản hồi. Dùng dấu phẩy tiếng Anh để ngăn cách nhiều trường. Các giá trị: plp_number, first_mile_tracking_number, last_mile_tracking_number. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| request_id | string | 9d07076ffda5407bb7c559f0b82ed91e | 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. | |
| success_list | object[] | Danh sách gói hàng thành công. | |
| package_number | string | Mã định danh duy nhất của gói hàng trong đơn hàng trên Shopee. | |
| tracking_number | string | MY200448706479IT | Mã theo dõi của đơn hàng này. |
| plp_number | string | Mã định danh duy nhất cho gói hàng BR correios. | |
| first_mile_tracking_number | string | CNF877146678717210312 | Mã theo dõi chặng đầu của đơn hàng. Chỉ dành cho người bán xuyên biên giới. |
| last_mile_tracking_number | string | 200448706479IT | Mã theo dõi chặng cuối của đơn hàng. Chỉ dành cho người bán xuyên biên giới tại BR. |
| hint | string | Buyers CVS closed， waiting for buyer to reselect another CVS stores，auto cancel time 2021-01-01 | Cho biết thông tin gợi ý nếu không thể lấy một số trường trong các tình huống đặc biệt. Ví dụ: không thể lấy tracking_number khi cửa hàng CVS đóng cửa. |
| pickup_code | string | Mã để tài xế nhanh chóng xác định kiện hàng cần lấy. Chỉ trả về cho đơn hàng instant+sameday. | |
| fail_list | object[] | Danh sách gói hàng thất bại. | |
| package_number | string | Mã định danh duy nhất của gói hàng trong đơn hàng trên Shopee. | |
| fail_reason | string | Lý do thất bại. |
], "response_optional_fields": "first_mile_tracking_number" }