文章标题: 合并计划带来的Wish配送API变化

Wish近日发布了新的合并计划,这其中涉及到一些API的变化。商户需要了解这些变化,包括新增的API接口、订单相关的更新以及一些注意事项,方能更好地适应这一变化并优化自身的业务运营。本文将为您详细梳理Wish配送合并计划所带来的API变化。

Wish配送合并计划之API变化

Wish平台的V3 API文档中新增了"产品"一节。商户可通过以下新增的API接口执行相关操作：

1. 通过 /api/v3/products/{id}/first_mile_shipping 执行GET请求，可以查询Wish为产品计算的初始首程运费、最终生效的首程运费以及每个仓库中产品的合并计划状态。

2. 通过 /api/v3/products/{id}/first-mile-shipping 执行PUT请求，可以更新Wish为产品计算的首程运费以及每个仓库中产品的合并计划状态。如需禁用合并计划涵盖的国家/地区的配送及首程运费,需同时使用国家/地区运费API接口进行设置。

在执行上述操作前,商户可以先查询v2/product/multi-get接口了解哪些产品进行了更新,再通过/v3/products/{id}/first_mile_shipping查看各更新产品的首程运费信息,并区分已生效和未生效的产品。

此外,与订单相关的V2 API也进行了更新:

1. order_total属性现在包括了初始WishPost运费。

2. 新增shipping_reimbursement_amount属性,表示发往合并计划涵盖国家/地区订单的WishPost运费报销金额。

3. 新增eligible_for_shipping_reimbursement和shipping_reimbursement_status属性,用于标识订单是否适用于运费报销以及报销状态。

4. 新增requires_delivery_confirmation属性,用于确定选用哪种A-Super物流渠道。

综上所述,Wish配送合并计划给商户带来了一系列API变化,商户需要及时了解并做好相应的业务适配,以确保订单顺利履行。

FAQs:

Q1: 如何查找最近更新的发往合并计划涵盖国家/地区的订单?

A1: 可以将新增的shipping_reimbursement_status和last_update字段结合使用,检索这些订单的相关信息。

Q2: 如何确定订单需要选用哪种A-Super物流渠道?

A2: 根据requires_delivery_confirmation属性的值,如果所有订单ID的值为False,则选用A-Super经济渠道;如果至少一个订单ID的值为True,则选用A-Super标准渠道。

Q3: 如何区分首程运费已生效和未生效的产品?

A3: 通过/v3/products/{id}/first_mile_shipping接口查询到的effective_date字段,如当前日期早于生效日期,则表示首程运费未生效;反之,则表示首程运费已生效。