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

[MY] Important Update for Open Platform AWB API - Shopee Express (Sea Shipping)

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/changelogtopic/developertopic/logistics-channel-awb-updates

资料正文

§1 [MY] Important Update for Open Platform AWB API - Shopee Express (Sea Shipping)

Dear Developers,

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

Airway Bill (AWB) Template Update for Shopee Express (Sea Shipping)

Please note that starting from 15 Jan 2025, Shopee Express (Sea Shipping) (Channel ID: 20078) will have some changes on the Airway Bill (AWB) template.

Important Note:

Do note that this shipping carrier "Shopee Express (Sea Shipping)" (Channel ID: 20078) is a fulfillment channel under the masked channel “Doorstep Delivery (Sea Shipping)" (Channel ID: 2001).

logistics_channel_idmask_channel_idshipping_carrier
200782001Shopee Express (Sea Shipping)

When the API v2.order.get_order_detail returns 20078 under the parameter logistics_channel_id, self-design AWB is not allowed, developers will need to follow the call flow to get the correct Airway Bill (AWB) labels. For more info can refer to the “Arrange Shipment” section from V2.0 API call Flow.

If you insist on using a self-designed AWB, it may lack of essential information required for 3PL fulfillment or contain incorrect details, resulting in your parcel being undeliverable to the buyer.

Below is a sample of the new Airway Bill (AWB) layout generated by the system when the Response Body v2.order.get_order_detail.logistics_channel_id returns 20078:

Related API:

v2.order.get_order_detail

v2.logistics.get_shipping_document_parameter

v2.logistics.create_shipping_document

v2.logistics.get_shipping_document_result

v2.logistics.download_shipping_document

Effective Date:

15 Jan 2024

尊敬的开发者,

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

关于Shopee Express (Sea Shipping)的面单模板更新

请注意,从2025年1月15日开始,Shopee Express (Sea Shipping) (Channel ID:20078) 渠道的面单模板将进行一些更改。

重要提示:

请注意,Shopee Express (Sea Shipping) (Channel ID:20078) 渠道是位于 Doorstep Delivery (Sea Shipping) (Channel ID: 2001) 虚拟渠道下的履约渠道。

logistics_channel_idmask_channel_idshipping_carrier
200782001Shopee Express (Sea Shipping)

当 v2.order.get_order_detail 的响应参数 logistics_channel_id 返回 20078 时,不允许自画面单。开发者需要按照调用流程获取正确的面单 (AWB) 标签。有关更多信息,请参考 V2.0 API Call Flow 中的 “Arrange Shipment” 部分。

如果您坚持使用自画面单(AWB),可能会缺少3PL (第三方物流) 履约所需的必要信息,或包含错误的细节,从而导致您的包裹无法送达买家。

当 v2.order.get_order_detail 的响应参数 logistics_channel_id 返回 20078 时,系统生成的面单 (AWB) 新格式如下:

影响接口:

v2.order.get_order_detail

v2.logistics.get_shipping_document_parameter

v2.logistics.create_shipping_document

v2.logistics.get_shipping_document_result

v2.logistics.download_shipping_document

上线时间:

2025年1月15日

#