v2.logistics.update_self_collection_order_logistics
POST /api/v2/logistics/update_self_collection_order_logistics
Use this api to update the order status for buyer to collect the orders directly from your pharmacy. This includes indicating that order is ready for collection, and that the order has been picked up by the buyer. You should call v2.logistics.get_order_detail or v2.logistics.get_package_detail first to get the package_number of such orders.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/logistics/update_self_collection_order_logistics
Tham số chung
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID được gán 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 để chỉ định thời điểm gửi 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. 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. Tham số 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 qua thuật toán 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 |
|---|---|---|---|---|
| package_number | string | True | OFG211171863281841 | Mã định danh duy nhất của Shopee cho gói hàng trong đơn hàng. |
| self_collection_logistics_action | string | True | order_collected | Order logistics action. available values: - ready_for_collection - order_collected |
| epoc_image_list | string[] | False | ["id-11134284-7r98o-mef6xcoiw1nt15"] | List of image_id for the proof that buyer already collected the order at the store. Required when self_collection_logistics_action is order_collected. Max: 3. You can call the v2.media.upload_image to upload image and get the image_id, for this scenario, please pass the business = 1 and scene = 1. |
| pin | string | False | 123456 | Mã PIN bắt buộc cho đơn hàng kê đơn khi người mua lấy hàng tại cửa hàng của bạn. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | error_auth | Cho biết loại lỗi nếu 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 xảy ra. Trống nếu không có lỗi. |
| request_id | string | 3dad66f43b8447d282ae6da36626c6b7 | Mã định danh của yêu cầu API dùng để theo dõi lỗi. |