wish配送合并計(jì)劃之API變更-ESG跨境

Wish配送合并計(jì)劃之API變更

V3API文檔中新增了“產(chǎn)品”一節(jié)。商戶可通過(guò)下面新添加的API端口執(zhí)行以下相關(guān)操作：

通過(guò)/api/v3/products/{id}/first_mile_shipping執(zhí)行GET請(qǐng)求

商戶可以應(yīng)用此API端口執(zhí)行“GET”請(qǐng)求，以檢索Wish為產(chǎn)品盤(pán)算的初始首程運(yùn)費(fèi)、更畢生效的首程運(yùn)費(fèi)（不管商戶是否更新）以及每個(gè)倉(cāng)庫(kù)中的產(chǎn)品的合并計(jì)劃狀況（啟用或禁用）。

通過(guò)/api/v3/products/{id}/first-mile-shipping執(zhí)行PUT請(qǐng)求

商戶可以應(yīng)用此API端口執(zhí)行“PUT”請(qǐng)求，以更新Wish為產(chǎn)品盤(pán)算的首程運(yùn)費(fèi)以及每個(gè)倉(cāng)庫(kù)中的產(chǎn)品的合并計(jì)劃狀況。要禁用合并計(jì)劃涵蓋的所有 /地域的配送以及實(shí)用于這些 /地域的首程運(yùn)費(fèi)，商戶需要應(yīng)用“ /地域運(yùn)費(fèi)”API端口進(jìn)行設(shè)置并通過(guò)/api/v3/products/{id}/first-mile-shipping執(zhí)行PUT請(qǐng)求。

在執(zhí)行上述操作前，商戶若要查找“首程運(yùn)費(fèi)”未生效和已生效的相關(guān)產(chǎn)品。

摘要：

a.首先，查詢v2/product/multi-get，看看那些產(chǎn)品在上一次查看后進(jìn)行了更新（應(yīng)用“since”參數(shù)）。

b.接著，查詢/v3/products/{id}/first_mile_shipping，查看各更新產(chǎn)品的first_mile_shipping信息。

c.更后，要區(qū)分“首程運(yùn)費(fèi)”已盤(pán)算但未生效的產(chǎn)品ID和“首程運(yùn)費(fèi)”已生效的產(chǎn)品ID，商戶可以通過(guò)上述程序b中查詢到的字段“effective_date”查看生效日期。

如果當(dāng)前日期早于生效日期，則表明產(chǎn)品的“首程運(yùn)費(fèi)”尚未生效；

否則，表明產(chǎn)品的“首程運(yùn)費(fèi)”已于指定的生效日期起生效。

此外，與訂單相關(guān)的V2API更新如下：

對(duì)于發(fā)往合并計(jì)劃涵蓋的目標(biāo)國(guó)/地域的訂單，現(xiàn)有的“order_total”屬性現(xiàn)在將包含初始WishPost運(yùn)費(fèi)（即，創(chuàng)立運(yùn)單時(shí)商戶向WishPost支付的金額，沒(méi)有任何退款或調(diào)解）。

wish商戶平臺(tái)新增加了一個(gè)新屬性“shipping_reimbursement_amount”，用于表現(xiàn)發(fā)往Wish合并計(jì)劃所涵蓋 /地域的訂單的WishPost運(yùn)費(fèi)報(bào)銷(xiāo)金額。更終金額將在WishPost物流記錄表明訂單已確認(rèn)實(shí)行之后顯示。

注意：如果“shipping_reimbursement_status”的值為PENDING，則此新屬性的值將為“0.0”（請(qǐng)參見(jiàn)下文解釋?zhuān)?/p>

新增“eligible_for_shipping_reimbursement”屬性。如果訂單發(fā)往Wish合并計(jì)劃涵蓋的 /地域，則此屬性為T(mén)rue，否則為False。

我們新增加了一個(gè)新屬性“shipping_reimbursement_status”，用于表現(xiàn)Wish合并計(jì)劃所涵蓋 /地域的訂單的狀況。具體而言：

N/A：表現(xiàn)此訂單并非發(fā)往Wish合并計(jì)劃涵蓋的目標(biāo)國(guó)/地域的訂單。

PENDING：表現(xiàn)該訂單沒(méi)有初始WishPost運(yùn)費(fèi)（即，沒(méi)有任何退款或調(diào)解）。

FINAL：表現(xiàn)該訂單已有初始WishPost運(yùn)費(fèi)（即，沒(méi)有任何退款或調(diào)解）。

要查找更近更新的發(fā)往合并計(jì)劃涵蓋的 /地域的訂單，您可以將上述新字段與“l(fā)ast_update”字段聯(lián)合應(yīng)用，以檢索運(yùn)費(fèi)報(bào)銷(xiāo)狀況可能已更新的相關(guān)訂單。

更后，要通過(guò)API確認(rèn)那些訂單需要選用哪種安速派物流渠道進(jìn)行配送，您可以利用屬性“requires_delivery_confirmation”。

在WishPost中創(chuàng)立的運(yùn)單中，如果此屬性對(duì)商戶平臺(tái)中所有訂單ID返回的值為False，則商戶必需選擇WishPost的“安速派經(jīng)濟(jì)”物流渠道來(lái)實(shí)行此運(yùn)單。

相反，在WishPost中創(chuàng)立的運(yùn)單中，如果此屬性對(duì)商戶平臺(tái)中至少一個(gè)訂單ID返回的值為T(mén)rue，則商戶必需選擇WishPost的“安速派準(zhǔn)則”物流渠道來(lái)實(shí)行此運(yùn)單。

wish商戶官網(wǎng)原文詳情：

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“l(fā)ast_updatefieldcombinedwiththeabovenewfieldstoretrievetheserelevantordersthatmayhaverecentupdatesinshippingreimbursementstatuses.

Lastly,toidentifywhichordersarerequiredtousewhichA-SuperlogisticschannelsviaAPI,youmayleveragetheattribute“requires_delivery_confirmation”.

IfthisvalueforallOrderIDsfromMerchantDashboardwithinaWishPostshippingorderisFalse,thenmerchantsmustchoosetheA-SuperECONOMYWishPostlogisticschanneltofulfillthisshippingorder.

Ontheotherhand,ifthisvalueforatleastoneOrderIDfromMerchantDashboardwithinaWishPostshippingorderisTrue,thenmerchantsmustchoosetheA-SuperSTANDARDWishPostlogisticschanneltofulfillthisshippingorder.

特別聲明：以上文章內(nèi)容僅代表作者本人觀點(diǎn)，不代表ESG跨境電商觀點(diǎn)或立場(chǎng)。如有關(guān)于作品內(nèi)容、版權(quán)或其它問(wèn)題請(qǐng)于作品發(fā)表后的30日內(nèi)與ESG跨境電商聯(lián)系。