v2.logistics.batch_ship_order
POST /api/v2/logistics/batch_ship_order
Dùng API này để khởi tạo vận chuyển hàng loạt, bao gồm đặt lịch lấy hàng tận nơi, giao hàng tại điểm hoặc giao hàng cho kênh vận chuyển không tích hợp. Nên gọi v2.logistics.get_shipping_parameter trước để lấy tất cả tham số cần thiết. Khuyến nghị khởi tạo vận chuyển sau ít nhất một giờ kể từ khi đơn hàng được đặt, vì người mua có thể hủy đơn trong vòng một giờ đầu mà không cần yêu cầu người bán đồng ý. Chỉ kênh 90003 - Padrão tại Brazil được phép sử dụng API này.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/batch_ship_order
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_list | object[] | True | Danh sách đơn hàng. | |
| order_sn | string | True | 201212DCXHJUIKJ | Mã định danh duy nhất của Shopee cho một đơn hàng. Giới hạn 150. |
| 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 không có mã gói hàng. | |
| pickup | object | False | Tham số bắt buộc CHỈ KHI GetParameterForInit trả về "pickup" hoặc GetLogisticsInfo trả về "pickup" trong "info_needed" cho cùng đơn hàng đó. Vẫn phải bao gồm trường "pickup" trong lời gọi ngay cả khi "pickup" có giá trị rỗng. | |
| address_id | int | False | Mã định danh của địa chỉ. Lấy từ shopee.logistics.GetAddress. | |
| pickup_time_id | string | False | ID khung giờ lấy hàng. Lấy từ shopee.logistics.GetTimeSlot. | |
| tracking_number | string | False | Cần điền trường này khi "tracking_number" được trả về từ "info_need". Đây là mã vận đơn do đơn vị vận chuyển bên thứ ba cấp cho lô hàng. | |
| dropoff | object | False | Tham số bắt buộc CHỈ KHI GetParameterForInit trả về "dropoff" hoặc GetLogisticsInfo trả về "dropoff" trong "info_needed" cho cùng đơn hàng đó. Vẫn phải bao gồm trường "dropoff" trong lời gọi ngay cả khi "dropoff" có giá trị rỗng. Đối với logistic_id 80003 và 80004, cả hai phương thức giao hàng Regular và JOB đều được hỗ trợ. Nếu chọn Regular, dùng "tracking_no" để gọi Init API. Nếu chọn JOB, dùng "sender_real_name". Chỉ được chọn một trong hai. | |
| branch_id | int | False | 0 | Mã định danh của chi nhánh. Lấy từ shopee.logistics.GetBranch. |
| sender_real_name | string | False | Tên thật của người gửi. | |
| tracking_number | string | False | Cần điền trường này khi "tracking_number" được trả về từ "info_need". Đây là mã vận đơn do đơn vị vận chuyển bên thứ ba cấp cho lô hàng. | |
| non_integrated | object | False | Tham số tùy chọn khi GetParameterForInit trả về "non-integrated" hoặc GetLogisticsInfo trả về "non-integrated" trong "info_needed". | |
| tracking_number | string | False | Tham số tùy chọn cho đơn hàng kênh không tích hợp. Mã vận đơn do đơn vị vận chuyển cấp cho lô hàng. |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | 3dad66f43b8447d282ae6da36626c6b7 | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| error | string | error_auth | 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 | Invalid access_token. | 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. |
| warning | object[] | Thông báo cảnh báo cần lưu ý. | |
| order_sn | string | 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. Không nên điền chuỗi rỗng khi không có mã gói hàng. | |
| response | object | ||
| result_list | object[] | ||
| order_sn | string | 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. | |
| fail_error | string | Cho biết loại lỗi nếu một phần tử gặp lỗi. | |
| fail_message | string | Cho biết chi tiết lỗi nếu một phần tử gặp lỗi. |
, { "order_sn": "201212CXHQWEIKD" } ], "dropoff": { "tracking_no": "", "branch_id": 0, "sender_real_name": "" } }