Significant OpenAPI Updates for Mass Shipment and Shop Performance&Penalty

Significant OpenAPI Updates for Mass Shipment and Shop Performance&Penalty

Dear Developer,

Please note the following changes:

1. To enhance order fulfillment efficiency, Shopee now supports mass shipment via OpenAPI. The Open API updates are as follows:

1. Add v2.order.search_package_list API to batch query pending shipment packages with filters (e.g., logistics_channel_id, product_location_id).

2. Add v2.logistics.get_mass_shipping_parameter API to batch retrieve shipping parameters for packages (Note: Only support packages under the same warehouse and logistics channel in one request).

3. Add v2.logistics.mass_ship_order API to batch arrange shipments for packages (Note: Only support packages under the same warehouse and logistics channel in one request).

4. Add v2.logistics.get_mass_tracking_number API to batch retrieve tracking numbers for shipped packages (Note: Support packages across different warehouses or logistics channels in one request).

Related APIs：

v2.order.search_package_list

v2.logistics.get_mass_shipping_parameter

v2.logistics.mass_ship_order

v2.logistics.get_mass_tracking_number

Effective Date on Live：

2025.02.24

2. Shopee introduces a new metric: % NDD Listings. The Open API updates are as follows:

1. v2.account_health.get_shop_performance supports returning the following new metric:

2. v2.account_health.get_metric_source_detail add ndd_listing_list response parameter to support querying the relevant listings and its NDD status.

Related APIs：

v2.account_health.get_shop_performance

v2.account_health.get_metric_source_detail

Effective Date on Live：

2025.02.28

3. Shopee introduces a new punishment type: Order Limit. The Open API updates are as follows:

1. Add 2008: Order Limit enumeration to the punishment_type response parameter of v2.account_health.get_punishment_history.

2. Add order_limit response parameter in v2.account_health.get_punishment_history to return the specific order limit when punishment_type is 2008: Order Limit.

3. Add listing_limit response parameter in v2.account_health.get_punishment_history to return the specific product limit when the punishment_type is:

- 1109: Listing Limit is reduced

- 1110: Listing Limit is reduced

- 1111: Listing Limit is reduced

- 1112: Listing Limit is reduced

Note: The existing v2.account_health.shop_penalty will not be updated anymore and sunset soon. To ensure that your service will not be affected, please migrate as soon as possible to the v2.account_health.get_penalty_point_history and v2.account_health.get_punishment_history to get the shop penalty information.

Related APIs：

v2.account_health.shop_penalty

v2.account_health.get_punishment_history

Effective Date on Live：

2025.02.28

尊敬的开发者，

请留意以下变更：

1. 为提升卖家的订单处理效率，平台将支持 Open API 批量发货功能，接口更新如下：

1）新增 v2.order.search_package_list 接口，用于批量查询待发货包裹列表 (支持物流渠道 logistics_channel_id、仓库 product_location_id 等筛选条件)。

2）新增 v2.logistics.get_mass_shipping_parameter 接口，用于批量获取包裹的发货所需参数 (注意：该接口只能同时请求同一仓库以及同一物流渠道下的不同包裹的发货所需参数)。

3）新增 v2.logistics.mass_ship_order 接口，用于批量对包裹进行发货 (注意：该接口只能同时对同一仓库以及同一物流渠道下的不同包裹进行发货)。

4）新增 v2.logistics.get_mass_tracking_number 接口，用于批量获取已发货包裹的运单号 (注意：该接口支持同时获取不同仓库或物流渠道下的不同包裹的运单号)。

影响接口：

v2.order.search_package_list

v2.logistics.get_mass_shipping_parameter

v2.logistics.mass_ship_order

v2.logistics.get_mass_tracking_number

上线时间：

2025.02.24

2. 平台新增了一个新的指标：% NDD Listings，接口更新如下：

1）v2.account_health.get_shop_performance 接口支持返回新指标：

2）v2.account_health.get_metric_source_detail 新增 ndd_listing_list 响应参数，支持获取该指标对应的商品列表及 NDD 状态。

影响接口：

v2.account_health.get_shop_performance

v2.account_health.get_metric_source_detail

上线时间：

2025.02.28

3. 平台新增了一种新的惩罚类型：Order Limit，接口更新如下：

1）v2.account_health.get_punishment_history 接口的响应参数 punishment_type 新增 2008: Order Limit 枚举值。

2）v2.account_health.get_punishment_history 接口新增 order_limit 响应参数，当 punishment_type为 2008: Order Limit 时，返回具体的订单限制。

3）v2.account_health.get_punishment_history接口新增 listing_limit 响应参数，当 punishment_type为以下情况时，返回具体的商品限制。

- 1109: Listing Limit is reduced

- 1110: Listing Limit is reduced

- 1111: Listing Limit is reduced

- 1112: Listing Limit is reduced

注意：已有的 v2.account_health.shop_penalty 接口后续将不再继续更新，且即将下线，为了保证您的服务不受影响，请尽快迁移至使用 v2.account_health.get_penalty_point_history 和 v2.account_health.get_punishment_history 接口获取店铺的罚分与惩罚信息。

影响接口：

v2.account_health.shop_penalty

v2.account_health.get_punishment_history

上线时间：

2025.02.28