v2.first_mile.get_courier_delivery_detail
GET /api/v2/first_mile/get_courier_delivery_detail
Dùng API này để lấy thông tin chi tiết chặng đầu cho phương thức giao hàng qua đơn vị vận chuyển.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/first_mile/get_courier_delivery_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ả |
|---|---|---|---|---|
| binding_id | string | True | DCN249237197572VU | Binding ID |
| 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. |
| page_size | int64 | False | 10 | Each result set is returned as a page of entries. Use the "page_size" filters to control the maximum number of entries to retrieve per page (i.e., per call). This integer value is used to specify the maximum number of entries to return in a single "page" of data. limit [1, 50]. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| 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. | |
| request_id | string | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. | |
| response | object | ||
| binding_id | string | DCN249237197572VU | Binding ID |
| first_mile_tracking_number | string | ZJS1729224232 | The first mile tracking number. |
| status | string | ORDER_RECEIVED | The logistics status for first-mile tracking number. Status could be: CANCELED CANCELING DELIVERED NOT_AVAILABLE ORDER_CREATED ORDER_RECEIVED PICKED_UP |
| declare_date | string | 2024-10-18 | 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. |
| next_cursor | string | "" | 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. |
| order_list | object[] | ||
| order_sn | string | 2410106R6X5Q85 | Shopee's unique identifier for an order. |
| package_number | string | OFG182232162204802 | Shopee's unique identifier for the package under an order. |
| sls_tracking_number | string | SG246207786489JU | 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. |