wish配送合并计划之API变更-ESG跨境

Wish配送合并计划之API变更

V3API文档中新增了“产品”一节。商户可通过下面新添加的API端口执行以下相关操作：

通过/api/v3/products/{id}/first_mile_shipping执行GET请求

商户可以应用此API端口执行“GET”请求，以检索Wish为产品盘算的初始首程运费、更毕生效的首程运费（不管商户是否更新）以及每个仓库中的产品的合并计划状况（启用或禁用）。

通过/api/v3/products/{id}/first-mile-shipping执行PUT请求

商户可以应用此API端口执行“PUT”请求，以更新Wish为产品盘算的首程运费以及每个仓库中的产品的合并计划状况。要禁用合并计划涵盖的所有 /地域的配送以及实用于这些 /地域的首程运费，商户需要应用“ /地域运费”API端口进行设置并通过/api/v3/products/{id}/first-mile-shipping执行PUT请求。

在执行上述操作前，商户若要查找“首程运费”未生效和已生效的相关产品。

摘要：

a.首先，查询v2/product/multi-get，看看那些产品在上一次查看后进行了更新（应用“since”参数）。

b.接着，查询/v3/products/{id}/first_mile_shipping，查看各更新产品的first_mile_shipping信息。

c.更后，要区分“首程运费”已盘算但未生效的产品ID和“首程运费”已生效的产品ID，商户可以通过上述程序b中查询到的字段“effective_date”查看生效日期。

如果当前日期早于生效日期，则表明产品的“首程运费”尚未生效；

否则，表明产品的“首程运费”已于指定的生效日期起生效。

此外，与订单相关的V2API更新如下：

对于发往合并计划涵盖的目标国/地域的订单，现有的“order_total”属性现在将包含初始WishPost运费（即，创立运单时商户向WishPost支付的金额，没有任何退款或调解）。

wish商户平台新增加了一个新属性“shipping_reimbursement_amount”，用于表现发往Wish合并计划所涵盖 /地域的订单的WishPost运费报销金额。更终金额将在WishPost物流记录表明订单已确认实行之后显示。

注意：如果“shipping_reimbursement_status”的值为PENDING，则此新属性的值将为“0.0”（请参见下文解释）。

新增“eligible_for_shipping_reimbursement”属性。如果订单发往Wish合并计划涵盖的 /地域，则此属性为True，否则为False。

我们新增加了一个新属性“shipping_reimbursement_status”，用于表现Wish合并计划所涵盖 /地域的订单的状况。具体而言：

N/A：表现此订单并非发往Wish合并计划涵盖的目标国/地域的订单。

PENDING：表现该订单没有初始WishPost运费（即，没有任何退款或调解）。

FINAL：表现该订单已有初始WishPost运费（即，没有任何退款或调解）。

要查找更近更新的发往合并计划涵盖的 /地域的订单，您可以将上述新字段与“last_update”字段联合应用，以检索运费报销状况可能已更新的相关订单。

更后，要通过API确认那些订单需要选用哪种安速派物流渠道进行配送，您可以利用属性“requires_delivery_confirmation”。

在WishPost中创立的运单中，如果此属性对商户平台中所有订单ID返回的值为False，则商户必需选择WishPost的“安速派经济”物流渠道来实行此运单。

相反，在WishPost中创立的运单中，如果此属性对商户平台中至少一个订单ID返回的值为True，则商户必需选择WishPost的“安速派准则”物流渠道来实行此运单。

wish商户官网原文详情：

APIchanges

Anew“Products”phasbeenaddedtotheV3APIDocumentation.Merchantsareabletoconductthefollowingrelevantactionsviathenewly-addedAPIendpointsbelow:

GETrequeston/api/v3/products/{id}/first_mile_shipping

Merchantsmayperformthe“GET”requestusingthisAPIendpointtoretrievetheWish-calculatedinitialFirst-MileShippingPrice,thefinalizedeffectiveFirst-MileShippingPrice(withorwithoutmerchantupdates),andunificationinitiativestatuses(enabledordisabled)oftheproductineachwarehouse.

PUTrequeston/api/v3/products/{id}/first-mile-shipping

Merchantsmayperformthe“PUT”requestusingthisAPIendpointtoupdatetheWish-calculatedFirst-MileShippingPriceandunificationinitiativestatusesoftheproductineachwarehouse.TodisableshippingtoallcountriesincludedintheunificationcountriesaswellastheFirst-MileShippingPricetobeappliedtothesecountries,merchantsneedtoutilizeBOTHtheCountryShippingAPIendpointandthePUTrequeston/api/v3/products/{id}/first-mile-shipping.

Beforetakingtheaboveactions,todiscoverrelevantproductsbeforeandaftertheFirst-MileShippingPricebecomeseffective,merchantsmayfindmoreinformationaboutunificationinitiative-relatedAPIshere(v3APIs)andhere(v2APIs).

Asasummary:

a.First,queryv2/product/multi-gettoseewhichproductshavebeenupdatedsincethelasttimetheychecked(usingthesinceparameter).

b.Then,query/v3/products/{id}/first_mile_shippingtocheckthefirst_mile_shippinginformationforeachproductthatwasupdated.

c.Lastly,todistinguishProductIDswithWish-calculatedFirst-MileShippingPricebeforeitbecomeseffectiveANDProductIDswithalready-effectiveFirst-MileShippingPrice,merchantsmayidentifythefield“effective_date”basedontheinformationqueriedinstepbabove.

Ifthecurrentdateispriortotheeffectivedate,thentheproduct’sFirst-MileShippingPriceisnotyeteffective;

Otherwise,theproduct’sFirst-MileShippingPriceiseffectivestartingontheeffectivedatespecified.

Inaddition,theOrder-relatedV2APIshavebeenupdatedasbelow:

Theexisting“order_total”attributewillnowincludetheinitialWishPostShippingamount(i.e.,theamountthatmerchantsinitiallypaytoWishPostwhencreatingashippingorder,withoutanyrefundsoradjustments)forordersboundfordestinationcountriesincludedintheunificationinitiative.

Anewattribute“shipping_reimbursement_amount”isnowadded,indicatingtheWishPostShippingreimbursementamountoftheorderboundforcountriesincludedinWish’sunificationinitiative.FinalamountwilldisplayaftertheorderisconfirmedfulfilledperWishPostrecord.

NOTE:thevalueforthisnewattributewillbe“0.0”ifthe“shipping_reimbursement_status”isPENDING(seebulletpointbelow).

Anewattribute“eligible_for_shipping_reimbursement”hasbeenadded.ThisattributewillbeTrueiftheorderisanorderboundforacountryincludedinWish’sunificationinitiative,Falseotherwise.

Anewattribute“shipping_reimbursement_status”hasbeenadded,indicatingthestateoftheorderboundforacountryincludedinWish’sunificationinitiative.Specifically:

N/A:meaningthisisNOTanorderboundforadestinationcountryincludedinWish’sunificationinitiative.

PENDING:meaningtheorderdoesNOTyethaveaninitialWishPostShippingamount(i.e.,withoutanyrefundsoradjustments).

FINAL:meaningtheordernowhasaninitialWishPostShippingamount(i.e.,withoutanyrefundsoradjustments).

Tofindrecentlyupdatedordersboundforcountriesincludedintheunificationinitiative,youcanusethe“last_updatefieldcombinedwiththeabovenewfieldstoretrievetheserelevantordersthatmayhaverecentupdatesinshippingreimbursementstatuses.

Lastly,toidentifywhichordersarerequiredtousewhichA-SuperlogisticschannelsviaAPI,youmayleveragetheattribute“requires_delivery_confirmation”.

IfthisvalueforallOrderIDsfromMerchantDashboardwithinaWishPostshippingorderisFalse,thenmerchantsmustchoosetheA-SuperECONOMYWishPostlogisticschanneltofulfillthisshippingorder.

Ontheotherhand,ifthisvalueforatleastoneOrderIDfromMerchantDashboardwithinaWishPostshippingorderisTrue,thenmerchantsmustchoosetheA-SuperSTANDARDWishPostlogisticschanneltofulfillthisshippingorder.

特别声明：以上文章内容仅代表作者本人观点，不代表ESG跨境电商观点或立场。如有关于作品内容、版权或其它问题请于作品发表后的30日内与ESG跨境电商联系。