快工助手跨境电商知识与商机助手

Significant OpenAPI Updates

Shopee 官方资料 · Shopee Open Platform 变更通知(Announcements) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.announcements
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/announcementtopic/apitopic/api-paymenttopic/changelogtopic/developertopic/logistics-channel-awb-updatestopic/openapi-updates

资料正文

§1 Significant OpenAPI Updates

Dear Developer,

Please note the following changes:

  1. [MY] Important Update for Shipping Carrier Airway Bill (Same Day Delivery)

The updates below are applicable to selected Shopee MY local sellers only.

Airway Bill (AWB) Template Update for Shipping Carrier

Please note that starting from 12 August 2024, Same Day Delivery (Channel ID: 22000) will have some changes on the Airway Bill (AWB) template.

- When calling the following API v2.logistics.get_shipping_document_data_info, there are some changes on Airway Bill (AWB) layout if the Response body field “shipping_carrier" returns Same Day Delivery and “cod” returns “true”.

Sample of Response body:

v2.logistics.get_shipping_document_data_info

{

"error": "",

"message": "",

"response": {

"cod": true,

"cod_amount": "20.50",

"create_date_ymd_sl": "2024/06/05",

"deliver_area": "",

"delivery_hub": "",

"dely_fri_label": "",

"dely_sat_label": "",

"dely_sun_label": "",

"destination_base_code": "",

"ec_order_no": "",

"is_lm_dg_bool": 0,

"last_mile_tracking_number": "",

"last_third_digits_buyer_phone": "",

"logistics_channel_id": 22000,

"manufacturers_name": "",

"manufacturers_website": "",

"mutual_check": 0,

"order_weight": 1000,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_addr": "Mercu 2 Corporate Tower, KL Eco City, Jalan Bangsar, KL Eco City, Bandar Kuala Lumpur, W.P. Kuala Lumpur, W.P. Kuala Lumpur",

"recipient_sort_code": {

"first_recipient_sort_code": "",

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

"sod": false,

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "MY240965719762UU",

"zone": "",

"zone_code": ""

}

Changes Required in Same Day Delivery 22000:

-To hardcode “COD '' wording above the zipcode field if cod return “true”.

Effective Date:

12 August 2024

  1. We introduced a new response field "vat_on_imported_goods" for TH means the 7% VAT is charged for imported goods for v2.payment.get_escrow_detail API and v2.payment.get_escrow_detail_batch API.

Related APIs:

v2.payment.get_escrow_detail

v2.payment.get_escrow_detail_batch

Effective Date on Live:

Lived

尊敬的开发者,

请留意以下变动:

1.[MY] Important Update for Shipping Carrier Airway Bill (Same Day Delivery)

以下更新仅适用于特定的Shopee马来西亚本地卖家。

关于AWB模板更新

请注意,从2024年8月12日开始,Same Day Delivery(渠道ID:22000)的AWB模板将进行一些更改。

在调用以下API v2.logistics.get_shipping_document_data_info时,如果响应体字段“shipping_carrier”返回Same Day Delivery,并且响应体字段“cod”返回 true,则面单会有一些变化。

响应主体示例:

v2.logistics.get_shipping_document_data_info

{

"error": "",

"message": "",

"response": {

"cod": true,

"cod_amount": "20.50",

"create_date_ymd_sl": "2024/06/05",

"deliver_area": "",

"delivery_hub": "",

"dely_fri_label": "",

"dely_sat_label": "",

"dely_sun_label": "",

"destination_base_code": "",

"ec_order_no": "",

"is_lm_dg_bool": 0,

"last_mile_tracking_number": "",

"last_third_digits_buyer_phone": "",

"logistics_channel_id": 22000,

"manufacturers_name": "",

"manufacturers_website": "",

"mutual_check": 0,

"order_weight": 1000,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_addr": "Mercu 2 Corporate Tower, KL Eco City, Jalan Bangsar, KL Eco City, Bandar Kuala Lumpur, W.P. Kuala Lumpur, W.P. Kuala Lumpur",

"recipient_sort_code": {

"first_recipient_sort_code": "",

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

"sod": false,

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "MY240965719762UU",

"zone": "",

"zone_code": ""

}

Same Day Delivery 22000 面单的变更要求:

- 如果 "cod" 字段返回"true",在邮政编码字段上方硬编码“COD”文字。

上线时间:

2024.08.12

2.为 v2.payment.get_escrow_detail API 和 v2.payment.get_escrow_detail_batch API 引入了一个新的响应字段 "vat_on_imported_goods",表示对泰国进口货物收取 7% 的增值税。

影响接口:

v2.payment.get_escrow_detail

v2.payment.get_escrow_detail_batch

上线时间:

已上线

#