v2.logistics.update_shipping_order
POST /api/v2/logistics/update_shipping_order
Chỉ dành cho phương thức lấy hàng tận nơi. Dùng API này để cập nhật địa chỉ lấy hàng và khung giờ lấy hàng cho các gói hàng đáp ứng: 1) trạng thái thực hiện của gói hàng là LOGISTICS_PICKUP_RETRY; hoặc 2) trạng thái thực hiện là 'LOGISTICS_REQUEST_CREATED' và đáp ứng điều kiện Đặt lại lịch lấy hàng tức thì.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/update_shipping_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_sn | string | True | 201214JASXYXY6 | Mã định danh duy nhất của Shopee cho một đơn hàng. |
| 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 | True | Tham số bắt buộc CHỈ KHI GetParameterForInit trả về "pickup" hoặc GetLogisticsInfo trả về "pickup" trong "info_needed". 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 | int64 | True | 126194 | Mã định danh của địa chỉ. Lấy từ get_shipping_parameter. |
| pickup_time_id | string | True | 439291 | ID khung giờ lấy hàng. Lấy từ get_shipping_parameter. |
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. |