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

[Important][PH] SPX-FEX 4PL Multi-Leg Channel Integration

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/logistics-channel-awb-updatestopic/openapi-updates

资料正文

§1 [Important][PH] SPX-FEX 4PL Multi-Leg Channel Integration

Dear Developers,

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

Beginning on May 7, SPX PH will be launching a 4PL integration partnership with Flash Express (FEX) to expand their serviceable area coverage. Certain SPX orders will be fulfilled at the last mile by FEX.

Both SPX and FEX sort code information will need to be displayed on Air Waybills (AWBs) for SPX-FEX 4PL orders.

Buyers and Sellers will still see SPX Express as their main channel.

Both SPX-SPX (SPX Only) and SPX-FEX orders will still show “SPX Express” as the logistics channel/shipping carrier. To differentiate between SPX-SPX and SPX-FEX orders, please check the “second_recipient_sort_code” value in the v2.get_shipping document_data_info API response (see sample API response below.)

Affected Logistics Channels

#

§2 Custom AWB Requirements (Important)

Custom AWB Requirements (Important)

When customizing AWBs for SPX, FEX, and SPX-FEX orders, please take note of the following requirements. Failure to comply may result in parcels being rejected for pickup/dropoff or delays in fulfillment.

Required Information

*For SPX-FEX and FEX orders, the 3rd and 4th digits of the first_recipient_sort_code must be in a larger font size.

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:

1.v2.logistics.get_shipping_document_parameter

2.v2.logistics.create_shipping_document

3.v2.logistics.get_shipping_document_result

4.v2.logistics.download_shipping_document

Sample AWBs

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

SPX Only / SPX-SPX Sample AWB

SPX-FEX Sample AWB

FEX Sample AWB

Samples of response body:

v2.get_shipping document_data_info - (API to be used for custom AWB designs)

SPX Only Order (Current / Pre-Launch)

SPX Only Order (Post-Launch)

The format of the tracking_number will be different for SPX orders arranged for shipment after launch.

SPX-SPX orders will have a null second_recipient_sort_code value.

SPX-FEX Order (Post-Launch)

SPX-FEX orders will have a second_recipient_sort_code value.

Related APIs:

v2.get_shipping document_data_info

Effective Date on Live:

Tuesday, May 7, 2024

亲爱的开发者们,

下列更新仅限 Shopee 菲律宾本土卖家。

自2024 年 5 月 7 日起,菲律宾的 SPX 物流将与 Flash Express 物流合并以扩大服务范围。

部分 SPX 订单的最后一公里将由 FEX 物流履行。SPX-FEX 4PL 订单的物流提单上需同时出现 SPX 和 FEX 的分拣码信息。

买卖双方看到的主要物流渠道仍为 SPX Express。

SPX-SPX(仅使用 SPX)订单和 SPX-FEX 订单的订单履行物流仍将显示 SPX Express。为区分这两种订单,请检查 v2.get_shipping document_data_info API 代码中的 “second_recipient_sort_code” 数值(参阅下列示例)。

#

§3 物流面单格式要求(重要)

物流面单格式要求(重要)

定制 SPX,FEX 和 SPX-FEX 订单的物流提单格式时,请注意下列要求。无法达到下列要求或导致订单因包裹被拒收而延迟履行。

*SPX-FEX 和 FEX 订单的 first_recipient_sort_code 的第三个和第四个数字的字号需加大。

请严格遵守各个物流的物流提单格式以避免运营受限(退货/包裹丢失/其它损失)。更多详情请参阅:[PH] Shopee 物流提单格式要求

为避免运营受限,我们强烈建议您按顺序调用下列 API 使用 Shopee 系统生成的物流单,直到您可以自行更新物流提单的格式设计:

1.v2.logistics.get_shipping_document_parameter

2.v2.logistics.create_shipping_document

3.v2.logistics.get_shipping_document_result

4.v2.logistics.download_shipping_document

物流面单示例

请遵循下列格式并确保所有数值出现在正确的位置以避免运营受限。

FEX 商标示例

响应体示例

v2.get_shipping document_data_info - (自画面单接口)

仅使用 SPX 的订单 (当前/上线前)

仅使用 SPX 的订单 (上线后)

此更新上线后,已预约取件的 SPX 订单的物流追踪码(tracking_number)的格式将有所不同。

SPX-SPX 订单的 second_recipient_sort_code 数值将为空。

SPX-FEX 订单 (上线后)

SPX-FEX 订单将出现 second_recipient_sort_code 数值。

影响接口:

v2.get_shipping document_data_info

生效日期:

2024 年 5 月 7 日,星期二

#