v2.logistics.get_tracking_info
GET /api/v2/logistics/get_tracking_info
Dùng API này để lấy thông tin theo dõi vận chuyển của một đơn hàng.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/get_tracking_info
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 | 2409177JCSRTEU | 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 có mã gói hàng. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | e3e3e7f33c4d75f91fb48ecb41aa2a01:010003d71ed9e184:00000066cec6b739 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| error | string | 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 | 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. | |
| order_sn | string | 2409177JCSRTEU | Mã định danh duy nhất của Shopee cho một đơn hàng. |
| package_number | string | Mã định danh duy nhất của Shopee cho gói hàng thuộc đơn hàng. | |
| logistics_status | string | LOGISTICS_DELIVERY_FAILED | Trạng thái vận chuyển của đơn hàng. Các giá trị có thể: Xem Định nghĩa dữ liệu - LogisticsStatus. |
| tracking_info | object[] | Thông tin theo dõi của đơn hàng. | |
| update_time | timestamp | 1726561500 | Thời điểm cập nhật thông tin theo dõi vận chuyển. |
| description | string | 包裹正退回物流中心 | Mô tả thông tin theo dõi vận chuyển. |
| logistics_status | string | FAILED_DELIVERED | Trạng thái vận chuyển của đơn hàng. Các giá trị có thể: Xem Định nghĩa dữ liệu - LogisticsStatus. |
| reversed_tracking_number | string | SG246907296501CU | Mã vận đơn của vận chuyển ngược chiều. Lưu ý: Chỉ áp dụng cho chặng xuyên biên giới của các kiện hàng giao thất bại được trả từ kho trả hàng nội địa về người bán. |
| reversed_courier_name | string | SPX Express | Tên đơn vị vận chuyển ngược chiều. Lưu ý: Chỉ áp dụng cho chặng xuyên biên giới của các kiện hàng giao thất bại được trả từ kho trả hàng nội địa về người bán. |
| reversed_tracking_info | object[] | Thông tin theo dõi của vận chuyển ngược chiều. Lưu ý: Chỉ áp dụng cho chặng xuyên biên giới của các kiện hàng giao thất bại được trả từ kho trả hàng nội địa về người bán. | |
| update_time | int64 | 1729842624 | Thời điểm cập nhật thông tin theo dõi vận chuyển ngược chiều. |
| description | string | 当地仓库已备货，包裹准备发运 | Mô tả thông tin theo dõi vận chuyển ngược chiều. |