Significant OpenAPI Updates of New Package Detail API & Fulfillment Status Push

Significant OpenAPI Updates of New Package Detail API & Fulfillment Status Push

Dear Developer,

To further enhance OpenAPI shipping capabilities, especially for multi-package order scenarios, Shopee optimize the shipping process and introduce the following new capabilities:

1. New v2.order.get_package_detail API

Add the v2.order.get_package_detail API, which allows developers to retrieve detailed package-level information for packages shipment. It complements the existing v2.order.search_package_list API and enables more comprehensive shipping data retrieval.

2. New package_fulfillment_status_push Push

Add the package_fulfillment_status_push Push, which notifies developers of real-time package fulfillment status changes, helping improve fulfillment data synchronization and reducing the need for repeated polling.

3. Updated Shipping API Call Flow

Based on these enhancements, Shopee has updated the shipping API call flow. You can refer to the updated and previous process flowcharts for comparison:

New Shipping API Call Flow (updated version):

Old Shipping API Call Flow (for comparison):

For the complete shipping flow and integration guide, please refer to this document: Order Management.

Note: The existing v2.order.get_shipment_list will be sunset soon. To ensure your service will not be affected, please migrate as soon as possible to use v2.order.search_package_list.

We recommend all developers upgrade your integration to the new API and push mechanism as soon as possible to improve shipping efficiency and fulfillment data synchronization.

尊敬的开发者，

为了进一步提升 OpenAPI 发货能力，特别是针对多包裹订单场景，Shopee 优化了发货流程并引入了以下新能力：

1. 新增 v2.order.get_package_detail 接口

新增 v2.order.get_package_detail 接口，支持开发者按包裹维度查询待发货包裹的详细信息，补充 v2.order.search_package_list 接口能力，帮助开发者获取更完整的包裹发货数据。

2. 新增 package_fulfillment_status_push 推送

新增 package_fulfillment_status_push 推送，实时通知开发者包裹的履约状态变更，提升履约数据同步效率，减少轮询调用。

3. 更新发货接口调用流程

基于以上能力的增强，Shopee 已同步更新发货接口调用流程，您可以参考以下新旧流程图进行对比：

新版发货接口调用流程 (已更新)：

旧版发货接口调用流程 (供参考对比)：

完整的发货流程与对接指南请参考以下文档：订单管理。

注意：现有 v2.order.get_shipment_list 接口即将下线。为避免影响您的服务，请尽快迁移至 v2.order.search_package_list。

我们建议各位开发者尽快升级对接新版接口及推送能力，以获得更好的发货体验和履约信息同步效果。