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

[Important][For your action]Significant Open Platform 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-logisticstopic/changelogtopic/developertopic/openapi-updates

资料正文

§1 [Important][For your action]Significant Open Platform Updates

Dear Developer,

Please pay attention to the following updates:

1.[For your action] Sunset response field "recipient_addr" in Customized Airway Bill API

[Kindly Reminder] This is a reissue announcement for developers who have not updated this new customized airway bill, please update the logic of your customized airway bill as soon as possible to reduce the chances of misdelivery, missort and parcel rejection.

API: v2.logistics.get_shipping_document_data_info

[Action Required]

We will sunset the response field "recipient_addr" of v2.logistics.get_shipping_document_data_info on 19 Oct 2023, please update the logic of getting buyer PII info to request "receive_address_info" in the request body.

Related APIs:

v2.logistics.get_shipping_document_data_info

  1. [For your action] [For pickup method]To avoid unnecessary issue resulting in not getting tracking number from v2.logistics.get_tracking_number, please pass the exact "pickup_time_id"from v2.logistics.get_shipping_parameter to calling v2.logistics.ship_order.

Sample of response body:

v2.logistics.get_shipping_parameter

Sample of request body:

v2.logistics.ship_order

Note: the two pickup_time_id selected as same with each other which is "pickup_time_id": "1696928400_1"

3.[Important][PH] Logistic Channel Name Change

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

Please be advised that the “Cargo Local” masked channel will be renamed to “Sulit Local” on October 18, 2023. There will be no change to the channel ID.

Sample of response body:

v2.logistics.get_channel_list

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: Wednesday, October 18, 2023

尊敬的开发者:

请留意以下更新:

1.【供您操作】字画面单接口将下线响应参数"recipient_addr"

【温馨提示】本次为重发公告,未对接自画面单API(v2.logistics.get_shipping_document_data_info)的开发者请尽快对接。

作为买家信息保护政策的一部分,接口v2.logistics.get_shipping_document_data_info用于自画面单,只有对"recipient_address_info"字段入参,才可以获取到买家信息,否则将无法获取。

[需要采取的行动]我们将在 北京时间2023 年 10 月19日下线返回体中 "recipient_addr"字段,请更新获取买家 PII 信息的逻辑: 在请求体中请求 "receive_address_info"来获取。

影响接口:

v2.logistics.get_shipping_document_data_info

2.[供您操作] [仅适用于提货方式发货] 为避免因无法从 v2.logistics.get_tracking_number 中获取到TN而产生不必要的问题,请在调用 v2.logistics.ship_order 时准确传递 v2.logistics.get_shipping_parameter 中的 "pickup_time_id"。

响应示例:

v2.logistics.get_shipping_parameter

入参示例:

v2.logistics.ship_order

Note: 以上示例两次传参两个 pickup_time_id应该完全一致,才能避免错误,即 "pickup_time_id": "1696928400_1"

3.[PH] 物流渠道名称更改

下列更新仅适用于 Shopee 菲律宾本地卖家。

请注意,2023 年 10 月 18 日起,Cargo Local 将更名为 Sulit Local。物流渠道编号维持原状。

接口响应示例:

v2.logistics.get_channel_list

影响接口:

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 年 10 月 18 日,星期三

#