来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§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_id | mask_channel__id | logistics_channel_name |
|---|---|---|
| 40066 | 4000 | “SPX Express” |
| 40073 | 4103 | “SPX Express” |
| 40078 | 4000 | “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_id | mask_channel__id | 物流渠道名称 |
|---|---|---|
| 40066 | 4000 | “SPX Express” |
| 40073 | 4103 | “SPX Express” |
| 40078 | 4000 | “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日 星期一
