Significant OpenAPI Updates

Dear Developers,

Please take note the following changes:

For all regions, In the add-on deal promotion, when the promotion_type is set to 1 (gift with minimum spend), the dts (day-to-shiop) for the main item must be greater than or equal to the dts for the sub item. Sub item that do not meet the requirements will be automatically set to disable (status=2).

When using the v2.add_on_deal.add_add_on_deal_sub_item function to add sub item, if the day to ship of the sub item is greater than that of the main item, and the status is set to 1 (enable), or an error occurs stating "The Days to ship is longer than that of the main item" the same error will also occur when using the v2.add_on_deal.update_add_on_deal_sub_item function to update sub item.

RelatedAPIs:

v2.add_on_deal.add_add_on_deal_sub_item

v2.add_on_deal.update_add_on_deal_sub_item

v2.add_on_deal.get_add_on_deal

Effective Date: Lived

Please note that the updates mentioned below are applicable to Shopee SG local whitelisted sellers only.

Shopee SG is launching the Next Day Delivery (NDD) Programme under the new masked channel. This channel will roll out to sellers on a whitelisted basis only. If you are keen, you can fill in the interest form.

For more information regarding NDD, you can refer here.

logistics_channel_id	mask_channel_id	logistics_channel_name
10700	1004	Next Day Doorstep Delivery

Sample of response body:

V2.logistics.get_channel_list

{

"error": "",

"message": "",

"response": {

"logistics_channel_list": [

{

"logistics_channel_id":10700,

"logistics_channel_name":"Next Day Doorstep Delivery",

"cod_enabled":true,

"enabled":true,

"fee_type":"FIXED_DEFAULT_PRICE",

"size_list":[

"weight_limit":{

"item_max_weight":0,

"item_min_weight":0

"item_max_dimension":{

"height":0,

"width":0,

"length":0,

"unit":"",

"dimension_sum":0

"preferred":false,

"force_enable":false,

"mask_channel_id":1004,

"logistics_description":"",

"volume_limit":{

"item_max_volume":0,

"item_min_volume":0

}

...

Seller will be able to enable/disable NDD channel on a shop-level and item-level basis through Open API.

Please refer to the table below for the customized AWB requirements for NDD.

RelatedAPIs:

v2.logistics.get_channel_list

v2.logistics.update_channel

v2.product.add_item

v2.product.update_item

v2.product.get_item_base_info

v2.logistics.get_shipping_parameter

v2.logistics.get_tracking_number

v2.logistics.get_shipping_document_parameter

v2.order.get_order_detail

v2.logistics.get_shipping_document_data_info

Effective Date: 2023.08.24

请开发者留意该变更：

1.对于所有站点，在加购优惠活动中 (add-on-deal)，当promotion_type=1 时（即满额增商品）主商品的备货时长必须大于或等于赠品的备货时长，存量不符合要求的赠品状态会自动置为关闭（status=2）

当调用 v2.add_on_deal.add_add_on_deal_sub_item 添加的增品备货时长大于主商品的备货时长，且设置的 status=1 （开启状态），会出现报错 “The Days to ship is longer than that of main item” 。当调用 v2.add_on_deal.update_add_on_deal_sub_item 添加的赠品的备货时长大于主商品的备货市场时，也会出现相同报错

影响的接口：

v2.add_on_deal.add_add_on_deal_sub_item

v2.add_on_deal.update_add_on_deal_sub_item

v2.add_on_deal.get_add_on_deal

生效日期: Lived

Significant OpenAPI Updates

资料正文

§1 Significant OpenAPI Updates