Significant OpenAPI Updates

Dear Developers,

1.[Important][PH] New YTO Express Logistic Channel

The updates below are applicable to Shopee PH local sellers only.

Shopee PH is providing a new integrated logistic channel, YTO Express, under the new masked channel (checkout channel)"Cargo Local".

Sample of response body:

v2.logistics.get_channel_list

{

"error": "",

"message": "",

"response": {

"logistics_channel_list": [

{

"logistics_channel_id": 4002,

"logistics_channel_name": "Cargo Local",

"cod_enabled": true,

"enabled": true,

"fee_type": "SIZE_INPUT",

"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": 0,

"logistics_description": "",

"volume_limit": {

"item_max_volume": 0,

"item_min_volume": 0

},

"logistics_capability": {

"seller_logistics": false

},

"seller_logistic_has_configuration": null

},

{

"logistics_channel_id": 40032,

"logistics_channel_name": "YTO Express",

"cod_enabled": true,

"enabled": true,

"fee_type": "SIZE_INPUT",

"size_list": [],

"weight_limit": {

"item_max_weight": 100,

"item_min_weight": 0

},

"item_max_dimension": {

"height": 300,

"width": 300,

"length": 300,

"unit": "cm",

"dimension_sum": 0

},

"preferred": false,

"force_enable": false,

"mask_channel_id": 4002,

"logistics_description": "",

"volume_limit": {

"item_max_volume": 0,

"item_min_volume": 0

},

"logistics_capability": {

"seller_logistics": false

},

"seller_logistic_has_configuration": null

}

]

},

"request_id": "a8ac7ec1e5fdaf58d551afcc98a1bc21"

}

This channel will be gradually rolled out to sellers identified to be handling bulky items on a whitelist-basis.

Sellers will be able to enable/disable the YTO Express channel on a shop-level and item-level basis through Open API.

Please refer to the table below for the customized AWB requirements for YTO Express.

You may refer the announcement for the full list of custom AWB requirements for all PH logistic channels.

Related APIs:

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 on Live:

2023.08.15

2. Shopee allows to raise return & refund after order completed for some specific scenarios, so for order_status_push add a new field "completed_scenario" to indicate which COMPLETED status the order is in.

Effective Date on Live:

2023.08.15

尊敬的开发者：

1.[重要][PH] 新增YTO Express物流渠道

以下更新仅适用于Shopee PH本地卖家。

Shopee PH 现在提供了一个新的集成物流渠道YTO Express，该物流包含在新的checkout 渠道"Cargo Local"中。

响应体示例（Sample of response body）:

v2.logistics.get_channel_list

{

"error": "",

"message": "",

"response": {

"logistics_channel_list": [

{

"logistics_channel_id": 4002,

"logistics_channel_name": "Cargo Local",

"cod_enabled": true,

"enabled": true,

"fee_type": "SIZE_INPUT",

"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": 0,

"logistics_description": "",

"volume_limit": {

"item_max_volume": 0,

"item_min_volume": 0

},

"logistics_capability": {

"seller_logistics": false

},

"seller_logistic_has_configuration": null

},

{

"logistics_channel_id": 40032,

"logistics_channel_name": "YTO Express",

"cod_enabled": true,

"enabled": true,

"fee_type": "SIZE_INPUT",

"size_list": [],

"weight_limit": {

"item_max_weight": 100,

"item_min_weight": 0

},

"item_max_dimension": {

"height": 300,

"width": 300,

"length": 300,

"unit": "cm",

"dimension_sum": 0

},

"preferred": false,

"force_enable": false,

"mask_channel_id": 4002,

"logistics_description": "",

"volume_limit": {

"item_max_volume": 0,

"item_min_volume": 0

},

"logistics_capability": {

"seller_logistics": false

},

"seller_logistic_has_configuration": null

}

]

},

"request_id": "a8ac7ec1e5fdaf58d551afcc98a1bc21"

}

此分配选项将逐步对需要运送大件商品的卖家开放，并通过白名单的方式进行开通。

卖家将可以通过Open API在店铺和商品上启用/停用YTO Express渠道。

有关YTO Express的自画面单格式要求，请参阅下表。

您可以参考此公告了解所有 PH 物流渠道的自画面单格式要求。

影响接口：

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

上线时间：

2023.08.15

2.Shopee 允许在某些特定情况下，在订单完成后提出return & refund，因此在order_status_push中增加了一个新字段 "completed_scenario"，以显示订单处于哪种 "COMPLETED" 状态。

上线时间：

2023.08.15