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跨境電商聯系。