v2.logistics.get_booking_tracking_number
GET /api/v2/logistics/get_booking_tracking_number
Sau khi sắp xếp vận chuyển (v2.logistics.ship_booking) 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_booking_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 |
|---|---|---|---|---|
| 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 | a8e1b94f51d64540bf5762abe7783073 | Mã định danh của yêu cầu API để theo dõi lỗi. |
| error | string | common.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. |
| tracking_number | string | MY200448706479IT | Mã theo dõi của booking này. |