v2.order.get_shipment_list
GET /api/v2/order/get_shipment_list
Sử dụng API này để lấy danh sách đơn hàng có order_status là READY_TO_SHIP hoặc RETRY_SHIP để bắt đầu xử lý toàn bộ quy trình vận chuyển.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/order/get_shipment_list
Tham số chung
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác được cấp 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ấu thời gian 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 để truy cập API, dùng để xác định quyền của bạn với API. 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 shop trên Shopee. Bắt buộc cho hầu hết 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
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| cursor | string | False | "" | Xác định mục bắt đầu của dữ liệu 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, có thể dùng offset để bắt đầu lần gọi tiếp theo. |
| page_size | int32 | True | 20 | Mỗi kết quả được trả về theo trang. Dùng "page_size" để kiểm soát số lượng mục tối đa mỗi trang. Giới hạn page_size từ 1 đến 100. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | common.error_auth | 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. | 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_list | object[] | Danh sách đơn hàng cần giao. | |
| order_sn | string | 2003160SXK2A3T | Mã định danh duy nhất của đơn hàng trên Shopee. |
| package_number | string | 38027870177402 | Mã định danh duy nhất của kiện hàng trong đơn hàng trên Shopee. |
| more | boolean | true | Cho biết danh sách đơn hàng có nhiều hơn một trang không. Nếu giá trị này là true, bạn nên tiếp tục kiểm tra trang tiếp theo. |
| next_cursor | string | 20 | Nếu more là true, hãy truyền next_cursor vào tham số cursor ở lần gọi tiếp theo. Giá trị của next_cursor sẽ là chuỗi rỗng khi more là false. |
| request_id | string | 69ee3f61ec6f4e3f85836391e5b78dbc | Mã định danh cho yêu cầu API dùng để theo dõi lỗi. |