v2.logistics.update_tracking_status
POST /api/v2/logistics/update_tracking_status
Chỉ dành cho người bán Brazil. API này chỉ khả dụng cho đơn hàng/gói hàng được thực hiện bởi kênh BR Seller Logistics (logistics_channel_id: 90021), Samsung (logistics_channel_id: 90025) và kênh BR Instant Delivery (logistics_channel_id: 90026). logistics_status sẽ trở thành LOGISTICS_REQUEST_CREATED sau khi sắp xếp vận chuyển, và có thể gọi API này để cập nhật thành: LOGISTICS_PICKUP_DONE, LOGISTICS_DELIVERY_DONE, LOGISTICS_DELIVERY_FAILED.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/update_tracking_status
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 | 201212DCXHJUIKJ | Mã định danh duy nhất của Shopee cho một đơn hàng. |
| tracking_number | string | False | 1234567890 | Mã vận đơn của đơn hàng, có thể giúp người bán xác định đơn hàng trên tracking_URL. Chỉ được gửi khi cập nhật logistics_status thành "logistic_pickup_done". |
| tracking_url | string | False | https://tracking\_url\_order\_201212DCXHJUIKJ | URL website theo dõi đơn hàng, tối đa 2048 ký tự. Chỉ được gửi khi cập nhật logistics_status thành "logistic_pickup_done". |
| logistics_status | string | True | logistics_pickup_done | Cập nhật trạng thái đơn hàng được hỗ trợ: logistics_pickup_done, logistics_delivery_done, logistics_delivery_failed. |
| failed_reason | string | False | buyer_unreachable | Chỉ bắt buộc khi cập nhật logistics_status thành "logistics_delivery_failed". Chỉ bắt buộc cho kênh BR Instant Delivery (logistics_channel_id: 90026). Chỉ chấp nhận các giá trị: buyer_unreachable, buyer_unresponsive, no_delivery_location_consensus. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | e9b086380a7dcdc408cb5ebe2cf38041 | Mã định danh cho yêu cầu API. |
| error | string | Mã lỗi. | |
| message | string | Thông báo lỗi. | |
| warning | string | ||
| response | object | Nội dung phản hồi. | |
| update_result | string | succeed | Kết quả cập nhật: succeed (thành công), failed (thất bại). |