v2.logistics.get_tracking_number
GET /api/v2/logistics/get_tracking_number
Sau khi sắp xếp vận chuyển (v2.logistics.ship_order) cho kênh tích hợp, 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 bên vận chuyển thứ ba (3PL). Do đó được phép gọi lại API trong khoảng cách 5 phút cho đến khi có tracking_number.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/get_tracking_number
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| 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 của bạn. Có thể 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 Shopee cho một cửa hàng. 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 băm HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| order_sn | string | True | 201214JASXYXY6 | Mã định danh duy nhất của Shopee cho một đơn hàng. |
| package_number | string | False | Mã định danh duy nhất của Shopee cho gói hàng thuộc đơn hàng. Không nên điền chuỗi rỗng khi không có mã gói hàng. | |
| response_optional_fields | string | False | first_mile_tracking_number | Chỉ định các trường phản hồi bạn muốn nhận. Vui lòng 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ố bên trong sẽ tự động được trả về. Nếu có nhiều trường cần lấy, dùng dấu phẩy tiếng Anh để phân cách. Các giá trị có thể: plp_number, first_mile_tracking_number, last_mile_tracking_number. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | 9d07076ffda5407bb7c559f0b82ed91e | Mã định danh cho yêu cầu API, dùng để 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. | |
| tracking_number | string | MY200448706479IT | Mã vận đơn 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ã vận đơn chặng đầu của đơn hàng. Chỉ dành cho người bán Cross Border. |
| last_mile_tracking_number | string | 200448706479IT | Mã vận đơn chặng cuối của đơn hàng. Chỉ dành cho người bán Cross Border Brazil. |
| hint | string | Buyers CVS closed， waiting for buyer to reselect another CVS stores，auto cancel time 2021-01-01 | Thông tin gợi ý khi không thể lấy một số trường trong tình huống đặc biệt. Ví dụ: không lấy được tracking_number khi cửa hàng CVS đóng cửa. |
| pickup_code | string | Mã để tài xế nhanh chóng xác định gói hàng cần lấy. Chỉ trả về cho đơn hàng nội địa Indonesia sử dụng dịch vụ giao hàng instant+sameday. |