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

[Important][PH] Updated AWB Requirements for SPX Channels

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 [Important][PH] Updated AWB Requirements for SPX Channels

Dear Developers, The updates below are applicable to Shopee PH local and crossborder sellers only.

Affected Logistics Channels

logistics_channel_idmask_channel__idlogistics_channel_name
400664000“SPX Express”
400734103“SPX Express”
400784000“SPX Same Day Delivery”

Required Information

When calling the v2.logistics.get_shipping_document_data_info API, please ensure that you update your custom AWBs to reflect the following changes by the live date. Failure to comply may result in parcels being rejected for pickup/dropoff, delays in fulfillment, and developer penalties such as restrictions on API access and new shop authorizations.

Logistics Channel ID: 40066

Logistics Channel ID: 40073

Logistics Channel ID: 40078

Sample AWBs

Please follow the prescribed layout and ensure that values are shown in the correct places to avoid operational issues.

Logistics Channel ID: 40066

Logistics Channel ID: 40073

Logistics Channel ID: 40078

Always follow the prescribed 3PL AWB format to avoid 3PL operational problems (returns/lost/other losses). For more information, please refer to [PH] Shopee 3PL Airway Bill Requirements article.

To avoid operational issues, we strongly advise you to please use the Shopee system-generated AWBs using the following APIs until you are able to support the necessary design changes:

  • v2.logistics.create_shipping_document
  • v2.logistics.get_shipping_document_result
  • V2.logistics.download_shipping_document

Sample of response body:

v2.get_shipping document_data_info

{

"error": "",

"message": "",

"request_id": "e3e3e7f340029132d41b282059dcea01:010003f7439896cf:000000fcd17d3794",

"response": {

"recipient_address_info": null,

"shipping_document_info": {

"cod": false,

"cod_amount": "0",

"create_date_ymd_sl": "2025/09/30",

"deliver_area": "",

"delivery_hub": "",

"dely_fri_label": "",

"dely_sat_label": "M",

"dely_sun_label": "M",

"destination_base_code": "",

"ec_order_no": "",

"is_lm_dg_bool": 1,

"last_mile_tracking_number": "",

"last_third_digits_buyer_phone": "",

"logistics_channel_id": 40078,

"manufacturers_name": "",

"manufacturers_website": "",

"mutual_check": 0,

"order_weight": 1000,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_addr": "Unit 1F Phase 3 Purok 3, Barangay 287, Paranaque City, Metro Manila, Metro Manila",

"recipient_sort_code": {

"first_recipient_sort_code": "yyfhddkv",

"second_recipient_sort_code": "MFM DZ 6",

"third_recipient_sort_code": "MFM DZ 6"

},

"return_sort_code": {

"return_first_sort_code": "111"

},

"sender_sort_code": {

"first_sender_sort_code": "",

"second_sender_sort_code": "",

"third_sender_sort_code": ""

},

"shipping_carrier": "SPX Same Day Delivery",

"shopee_tracking_number": "PH252801102030PU",

"sod": false,

"sorting_group": "",

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "SPEPH050932287189",

"unpackaged_sku_id": "",

"unpackaged_sku_id_qrcode": "",

"zone": "",

"zone_code": ""

}

Related APIs:

  • v2.get_shipping document_data_info
  • v2.logistics.create_shipping_document
  • v2.logistics.get_shipping_document_result
  • v2.logistics.download_shipping_document

Effective Date on Live:

Monday, October 6, 2025

亲爱的开发者们,

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

受影响的物流渠道

logistics_channel_idmask_channel__id物流渠道名称
400664000“SPX Express”
400734103“SPX Express”
400784000“SPX Same Day Delivery”

所需信息

调用 v2.logistics.get_shipping_document_data_info API 时,请确保在生效日期前更新您的自定义运单,以反映以下变更。否则,可能会导致包裹被拒收/投递、配送延迟,以及开发者受到处罚,例如 API 访问权限和新店铺授权受限。

Logistics Channel ID: 40066

Logistics Channel ID: 40073

Logistics Channel ID: 40078

运单样本

请遵循规定的布局并确保值显示在正确的位置以避免操作问题。

Logistics Channel ID: 40066

Logistics Channel ID: 40073

Logistics Channel ID: 40078

请务必遵循规定的第三方物流运单 (3PL AWB) 格式,以避免第三方物流运营问题(例如退货/丢失/其他损失)。更多信息,请参阅 [PH] Shopee 3PL 空运提单要求文章。

为避免操作问题,我们强烈建议您使用以下 API 使用 Shopee 系统生成的 AWB,直到您能够支持必要的设计更改:

  • v2.logistics.create_shipping_document
  • v2.logistics.get_shipping_document_result
  • V2.logistics.download_shipping_document

响应主体示例:

v2.get_shipping document_data_info

{

"error": "",

"message": "",

"request_id": "e3e3e7f340029132d41b282059dcea01:010003f7439896cf:000000fcd17d3794",

"response": {

"recipient_address_info": null,

"shipping_document_info": {

"cod": false,

"cod_amount": "0",

"create_date_ymd_sl": "2025/09/30",

"deliver_area": "",

"delivery_hub": "",

"dely_fri_label": "",

"dely_sat_label": "M",

"dely_sun_label": "M",

"destination_base_code": "",

"ec_order_no": "",

"is_lm_dg_bool": 1,

"last_mile_tracking_number": "",

"last_third_digits_buyer_phone": "",

"logistics_channel_id": 40078,

"manufacturers_name": "",

"manufacturers_website": "",

"mutual_check": 0,

"order_weight": 1000,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_addr": "Unit 1F Phase 3 Purok 3, Barangay 287, Paranaque City, Metro Manila, Metro Manila",

"recipient_sort_code": {

"first_recipient_sort_code": "yyfhddkv",

"second_recipient_sort_code": "MFM DZ 6",

"third_recipient_sort_code": "MFM DZ 6"

},

"return_sort_code": {

"return_first_sort_code": "111"

},

"sender_sort_code": {

"first_sender_sort_code": "",

"second_sender_sort_code": "",

"third_sender_sort_code": ""

},

"shipping_carrier": "SPX Same Day Delivery",

"shopee_tracking_number": "PH252801102030PU",

"sod": false,

"sorting_group": "",

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "SPEPH050932287189",

"unpackaged_sku_id": "",

"unpackaged_sku_id_qrcode": "",

"zone": "",

"zone_code": ""

}

相关 API:

  • v2.get_shipping document_data_info
  • v2.logistics.create_shipping_document
  • v2.logistics.get_shipping_document_result
  • v2.logistics.download_shipping_document

上线生效日期:

2025年10月6日 星期一

#