[MY] Important Update for Open Platform Shopee Logistics API (Same Day Delivery)

Dear Developers,

Please note the following updates:

1.Shipping Carrier Renaming

Effective 17 June 2024, there will be some changes on the naming of shipping carrier Instant Delivery by ShopeeFood.

Scenario

1.When developers call v2.order.get_order_detail, or v2.logistics.get_shipping_document_data_info, the response body will be as follows:

Sample of Response body:

v2.logistics.get_shipping_document_data_info

"shipping_document_info": {

"cod": false,

"cod_amount": "0",

"create_date_ymd_sl": "2022/11/25",

"deliver_area": "",

"delivery_hub": "",

"destination_base_code": "",

"ec_order_no": "",

"is_lm_dg_bool": 1,

"last_mile_tracking_number": "",

"last_third_digits_buyer_phone": "",

"logistics_channel_id": 22000,

"manufacturers_name": "",

"manufacturers_website": "",

"order_weight": 31000,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_addr": "Klang, Klang, Selangor",

"recipient_sort_code": {

"first_recipient_sort_code": "KVY-KVY001Z",

"second_recipient_sort_code": "",

"third_recipient_sort_code": ""

},

"return_sort_code": {

"return_first_sort_code": ""

},

"sender_sort_code": {

"first_sender_sort_code": "",

"second_sender_sort_code": "",

"third_sender_sort_code": ""

},

"shipping_carrier": "Same Day Delivery",

"shopee_tracking_number": "MY2268251467810U",

"sod": false,

"spx_receive_station": {

"spx_first_receive_station": ""

},

v2.order.get_order_detail

"package_list": [

{

"item_list": [

{

"item_id": 18059630467,

"model_id": 0,

"model_quantity": 1

}

],

"logistics_status": "LOGISTICS_REQUEST_CREATED",

"package_number": "OFG124169767234082",

"parcel_chargeable_weight_gram": 0,

"shipping_carrier": "Same Day Delivery"

}

],

2.When developers call v2.logistics.get_channel_list the response body will be as follows:

Sample of Response body:

v2.logistics.get_channel_list

{

"logistics_channel_id": 22000,

"logistics_channel_name": "Same Day Delivery",

"cod_enabled": false,

"enabled": true,

"fee_type": "SIZE_INPUT",

"size_list": [],

"weight_limit": {

"item_max_weight": 10,

"item_min_weight": 0

},

"item_max_dimension": {

"height": 30,

"width": 30,

"length": 30,

"unit": "cm",

"dimension_sum": 0

},

"force_enable": false,

"mask_channel_id": 0,

"logistics_description": "Instant Delivery by ShopeeFood offers same-day delivery after the package has been picked up by the courier to your buyers within the selected coverage. Daily pick-up starts at 9:00AM and cut-off is at 8:00PM. \n<br> <br> \n1. All Instant Delivery orders must be handed over to the courier within 24 hours after the order is paid (excluding weekends and public holidays). <br> \n2. Please make sure you have a valid pick-up address.<br> \n3. It is recommended to keep your Instant Delivery orders separate from your standard orders to avoid wrong pick-up. <br> \n4. For more information on Instant Delivery, please refer to the <a href="https://seller.shopee.com.my/edu/article/19274"" target="_blank">SEH</a> article.<br> <br> \n\n\nMax Dimension = 90cm (Height + Length + Width), or a max of 30cm on any side."",

"volume_limit": {

"item_max_volume": 0,

"item_min_volume": 0

},

"logistics_capability": {

"seller_logistics": false,

"direct_delivery": false

},

"seller_logistic_has_configuration": null,

"support_cross_border": false,

"block_seller_cover_shipping_fee": false,

"support_pre_order": true

}

Action to take from developers

When calling this API “v2.logistics.get_shipping_document_data_info”,

If the Response body field "shipping_carrier" returns the "shipping_carrier" named "Same Day Delivery", the developer should hardcode the wording "Same Day Delivery" under Order Details (Courier) at the top right of the AWB.

For this channel, sellers are able to pre-print AWB before arranging shipment. The API calling method is the same as normal.

Related APIs

v2.logistics.get_channel_list

v2.order.get_order_detail

v2.logistics.get_shipping_document_data_info

Affected field:

shipping_carrier

logistics_channel_name

Effective Date: 17 June 2024

尊敬的开发者，

请留意以下变动：

1.实际履约物流渠道更名

自2024年6月17日起，将对实际履约物流渠道Instant Delivery by ShopeeFood的命名进行一些更改，更名为“Same Day Delivery”。

场景

1.当开发者调用v2.order.get_order_detail 或 v2.logistics.get_shipping_document_data_info时，响应主体将如下所示：

v2.logistics.get_shipping_document_data_info

"shipping_document_info": {

"cod": false,

"cod_amount": "0",

"create_date_ymd_sl": "2022/11/25",

"deliver_area": "",

"delivery_hub": "",

"destination_base_code": "",

"ec_order_no": "",

"is_lm_dg_bool": 1,

"last_mile_tracking_number": "",

"last_third_digits_buyer_phone": "",

"logistics_channel_id": 22000,

"manufacturers_name": "",

"manufacturers_website": "",

"order_weight": 31000,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_addr": "Klang, Klang, Selangor",

"recipient_sort_code": {

"first_recipient_sort_code": "KVY-KVY001Z",

"second_recipient_sort_code": "",

"third_recipient_sort_code": ""

},

"return_sort_code": {

"return_first_sort_code": ""

},

"sender_sort_code": {

"first_sender_sort_code": "",

"second_sender_sort_code": "",

"third_sender_sort_code": ""

},

"shipping_carrier": "Same Day Delivery",

"shopee_tracking_number": "MY2268251467810U",

"sod": false,

"spx_receive_station": {

"spx_first_receive_station": ""

},

2. v2.order.get_order_detail

"package_list": [

{

"item_list": [

{

"item_id": 18059630467,

"model_id": 0,

"model_quantity": 1

}

],

"logistics_status": "LOGISTICS_REQUEST_CREATED",

"package_number": "OFG124169767234082",

"parcel_chargeable_weight_gram": 0,

"shipping_carrier": "Same Day Delivery"

}

],

2.当开发者调用v2.logistics.get_channel_list时，响应主体将如下所示：

响应主体示例：

v2.logistics.get_channel_list

{

"logistics_channel_id": 22000,

"logistics_channel_name": "Same Day Delivery",

"cod_enabled": false,

"enabled": true,

"fee_type": "SIZE_INPUT",

"size_list": [],

"weight_limit": {

"item_max_weight": 10,

"item_min_weight": 0

},

"item_max_dimension": {

"height": 30,

"width": 30,

"length": 30,

"unit": "cm",

"dimension_sum": 0

},

"force_enable": false,

"mask_channel_id": 0,

"logistics_description": "Instant Delivery by ShopeeFood offers same-day delivery after the package has been picked up by the courier to your buyers within the selected coverage. Daily pick-up starts at 9:00AM and cut-off is at 8:00PM. \n<br> <br> \n1. All Instant Delivery orders must be handed over to the courier within 24 hours after the order is paid (excluding weekends and public holidays). <br> \n2. Please make sure you have a valid pick-up address.<br> \n3. It is recommended to keep your Instant Delivery orders separate from your standard orders to avoid wrong pick-up. <br> \n4. For more information on Instant Delivery, please refer to the <a href="https://seller.shopee.com.my/edu/article/19274"" target="_blank">SEH</a> article.<br> <br> \n\n\nMax Dimension = 90cm (Height + Length + Width), or a max of 30cm on any side."",

"volume_limit": {

"item_max_volume": 0,

"item_min_volume": 0

},

"logistics_capability": {

"seller_logistics": false,

"direct_delivery": false

},

"seller_logistic_has_configuration": null,

"support_cross_border": false,

"block_seller_cover_shipping_fee": false,

"support_pre_order": true

}

开发人员需要采取的行动

当调用此API“v2.logistics.get_shipping_document_data_info”时，如果响应主体字段"shipping_carrier"返回名为"Same Day Delivery"的"shipping_carrier"，开发人员应在AWB右上角的Order Details (Courier)部份写入"Same Day Delivery"这个词。

对于这个渠道，卖家可以在安排货物运输之前预先打印AWB。 API调用方法与正常情况下相同。

影响API：

v2.logistics.get_channel_list

v2.order.get_order_detail

v2.logistics.get_shipping_document_data_info

受影响的字段：

shipping_carrier

logistics_channel_name

生效日期：2024年6月17日