v2.first_mile.get_detail
GET /api/v2/first_mile/get_detail
Dùng API này để lấy thông tin chi tiết chặng đầu.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/first_mile/get_detail
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác được cấp sau khi đăng ký thành công. Bắt buộc cho tất cả các 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 tất cả các yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token dùng để truy cập API, xác định quyền của bạn đối với API. 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 gian hàng. Tham số bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: 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ả |
|---|---|---|---|---|
| first_mile_tracking_number | string | True | CNF731738838434210105 | The first mile tracking number. |
| cursor | string | False | "" | Chỉ định mục bắt đầu của dữ liệu cần trả về trong lần gọi hiện tại. Mặc định là "". Nếu dữ liệu nhiều hơn một trang, offset có thể là điểm bắt đầu cho lần gọi tiếp theo. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | 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 xảy ra lỗi. Rỗng nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| response | object | Thông tin chi tiết bạn đang truy vấn. | |
| logistics_channel_id | int | 813 | The identity of logistic channel. |
| first_mile_tracking_number | string | CNF731738838434210105 | Mã theo dõi vận chuyển đầu tiên. |
| shipment_method | string | pickup | The shipment method for bound orders, should be pickup or dropoff. |
| status | string | PICKED_UP | The logistics status for first-mile tracking number. Status could be: NOT_AVAILABLE,ORDER_CREATED,PICKED_UP,DELIVERED,ORDER_RECEIVED,CANCELING,CANCELED. NOT_AVAILABLE status means that either of the two scenarios has happened: 1. First Mile Tracking Number in the request does not exist. (e.g., wrong format) 2. First Mile Tracking Number is not yet bound with any order. |
| declare_date | string | 2020-05-19 | Ngày giao hàng được chỉ định. |
| more | boolean | false | This is to indicate whether the item list is more than one page. If this value is true, you may want to continue to check next page to retrieve the rest of items. |
| order_list | object[] | The list of order. | |
| order_sn | string | 20012328KKGVR0 | Shopee's unique identifier for an order. |
| package_number | string | 25333320394471234567 | Shopee's unique identifier for the package under an order. |
| sls_tracking_number | string | TW211342705212345 | The tracking number of SLS for orders/forders. |
| pick_up_done | boolean | false | Use this filed to indicate whether the order has been picked up by carrier. |
| arrived_transit_warehouse | boolean | false | Use this filed to indicate whether the order has arrived at transit warehouse. |
| next_cursor | string | "100" | If more is true, you should pass the next_cursor in the next request as cursor. The value of next_cursor will be empty string when more is false. |