[Important] Rectification Requirements for Get Shipping Parameter API Calls

Dear Developer,

Please find below the OpenAPI updates:

We have noticed that some partners have been incorrectly calling the v2.logistics.get_shipping_parameter or v2.logistics.get_mass_shipping_parameter APIs for orders or package logistics/fulfillment status that do not meet the API specifications.

According to the API definitions, the above APIs should only be used to retrieve shipping parameters under the following conditions:

- Order status is READY_TO_SHIP

- Package logistics/fulfillment status is LOGISTICS_READY

Currently, some partners are calling these APIs without verifying the order or package logistics/fulfillment status, which is not compliant with the API usage specifications. To ensure consistent and predictable API behavior and to prevent incorrect usage, the platform will tighten the conditions for calling these APIs.

Adjustment Details and Timeline:

- The platform has temporarily rolled back this logic tightening to avoid immediate impact on existing services.

- The tightened logic is scheduled to be re-enforced on December 23, 2025. From that date onward, non-compliant calls will no longer be supported.

Actions Required from Developers:

- Please complete the necessary adjustments to your shipping call processes by December 22, 2025.

- Ensure that the v2.logistics.get_shipping_parameter or v2.logistics.get_mass_shipping_parameter APIs are only called when the order status is READY_TO_SHIP or the package fulfillment status is LOGISTICS_READY.

This adjustment is a correction of API usage specifications. Developers are strongly advised to complete the rectification promptly to avoid any disruption to future shipping operations.

尊敬的开发者，

请留意以下接口变更：

我们发现，部分应用在不符合接口规范的订单/包裹履约状态下，错误调用了 v2.logistics.get_shipping_parameter 或 v2.logistics.get_mass_shipping_parameter 接口。

根据接口定义，上述接口仅用于在以下状态下获取发货参数：

- 订单状态为 READY_TO_SHIP

- 包裹履约状态为 LOGISTICS_READY

目前部分应用的调用流程中，未对订单或包裹履约状态进行校验即调用上述接口，该调用方式本身不符合接口使用规范。为保证接口行为的一致性与可预期性，并避免错误流程被继续使用，平台将对该接口的调用条件进行收紧。

调整说明与时间安排：

- 平台已暂时回滚本次逻辑收紧，以避免对现有服务造成直接影响；

- 计划于 2025年12月23日 重新发布收紧逻辑，届时，不符合规范的调用将不再被支持。

开发者需采取的行动：

- 请务必在 2025年12月22日 之前完成整改，调整您的发货调用流程；

- 确保仅在订单状态为 READY_TO_SHIP 或包裹履约状态为 LOGISTICS_READY 时，调用 v2.logistics.get_shipping_parameter 或 v2.logistics.get_mass_shipping_parameter 接口。

本次调整属于接口调用规范的纠正，请开发者尽快完成整改，以避免影响后续发货。