来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Significant OpenAPI Updates
Dear Developers,
Please note the following changes:
- For local shops in TH region, Shopee provides "Instant Delivery - ส่งด่วน" channel (channel ID: 70123), due to compliance issue, this channel does not allow sellers to cover shipping fee.
In order to get the information of "whether the channel allows sellers to cover shipping fee", we add the block_seller_cover_shipping_fee field in v2.logistics.get_channel_list, if the channel does not allow sellers to cover shipping fee, then the block_seller_cover_shipping_fee field will return true, otherwise it will return false.
For channels that do not allow sellers to cover shipping fee, when calling v2.product.add_item and v2.product.update_item to set the logistic_info of the item, is_free should be false, and if is_free is true, the API will return error.
Related APIs:
v2.logistic.get_channel_list
v2.product.add_item
v2.product.update_item
Effective Date on Live:
Lived on 2023.10.20
2.[For your action] Please pay attention to the following updates for v2.order.get_order_detail API:
In order to make it easier for developers to split order, we will add 3 new fields under package_list>item_list in response parameter:
| Field name | Format |
|---|---|
| order_item_id | int |
| product_location_id | string |
| promotion_group_id | int |
Note: The existing "product_location_id" under "item_list" order level, format as string[], while the new added "product_location_id" under "package_list" item level format as string.
These new fields above will released to live in late November 2023, the specific date will be announced later, please prepare for docking compatibility in advance.
Related APIs:
v2.order.get_order_detail
尊敬的开发者，
请留意以下变动：
- 针对TH地区的Local Shop，Shopee提供了“Instant Delivery - ส่งด่วน”渠道 (channel ID: 70123)，由于政策原因，该渠道不允许卖家设置包邮。
为了便于获取“渠道是否允许卖家设置包邮”信息，v2.logistics.get_channel_list接口新增了block_seller_cover_shipping_fee字段，若渠道不允许卖家设置包邮，则block_seller_cover_shipping_fee字段将会返回true，否则将会返回false。
针对不允许买家设置包邮的渠道，在调用v2.product.add_item与v2.product.update_item接口，设置item的logistic_info时，is_free字段应该传false，若is_free传true，接口将会报错。
影响接口:
v2.logistic.get_channel_list
v2.product.add_item
v2.product.update_item
上线时间:
2023.10.20
2.[需要采取的行动］请留意v2.order.get_order_detail API 的以下更新：
为了提供更好的订单拆分体验，我们将在响应参数中的 package_list>item_list 下添加 3 个新字段：
| Field name | Format |
|---|---|
| order_item_id | int |
| product_location_id | string |
| promotion_group_id | int |
需要注意的是 现有的订单维度 item_list下product_location_id格式为string[],而新增的package_list下的item_list中格式为string。
以上新字段将于 2023 年 11 月下旬发布上线，具体日期将另行通知，请提前做好对接兼容准备。
影响接口：
v2.order.get_order_detail