中國?wish商戶本地貨幣問題之商戶需要注意那些API更改？-ESG跨境

中國Wish商戶本地貨幣問題之商戶需要注意那些API更改？

自UTC時間2022年6月20日清晨0時起，本地貨幣代碼為CNY的商戶必需填寫localized_price、localized_shipping、localized_currency_code、localized_cc以及任何其他包括“l(fā)ocalized_”的價錢相關(guān)字段（對本地貨幣代碼為USD的商戶不作要求）。

/product/add

/product/update-shipping

/product/update-multi-shipping

/product/add-variation

/product/update-variation

/variant/add

/variant/update

ERP可以應(yīng)用API端口/api/v2/get-currency-code來檢索商戶的localized_currency_code。該API端口還會返回以下參數(shù)：payment_currency_code，它代表當(dāng)前支付商戶所應(yīng)用的貨幣。

此外，如果商戶的payment_currency_code=CNY，但應(yīng)用美元數(shù)值，則get資源路徑中所有與價錢相關(guān)的字段都將返回999999。請改用localized_參數(shù)。

依據(jù)本地貨幣代碼的更新定義（如上文“‘本地貨幣’對商戶意味著什么？”常見問題解答中所述），部分商戶的本地貨幣代碼已于UTC時間2022年1月14日清晨0時起從CNY更新為USD，以反應(yīng)這些商戶當(dāng)時吸收付款所用的幣種（是美元而非人民幣）。因此，當(dāng)這些商戶接獲有關(guān)Wish在2022年1月14日更新其本地貨幣代碼的通知后，對于“l(fā)ocalized_currency_code”在UTC時間2022年1月14日清晨0時更新為“USD”的商戶，所有“l(fā)ocalized_”字段中的值將變?yōu)檫x填項(xiàng)，無論其當(dāng)前的“l(fā)ocalized_currency_code”是何幣種。

自UTC時間2022年1月14日清晨0時起，對于payment_currency_code和localized_currency_code均為USD的商戶，所有包括“l(fā)ocalized_”的字段中的值必需以美元為單位。如果商戶在“l(fā)ocalized_”字段和對應(yīng)的非本幣字段中提供不同的值（例如localized_price與price，localized_shipping與shipping字段），則會產(chǎn)生錯誤。

自UTC時間2022年7月14日清晨0時起，本地貨幣代碼為USD的商戶應(yīng)用“price=5.0，localized_price=5.0，localized_currency_code=CNY”字段提交/api/v2/variant/update命令時會發(fā)生報錯資訊，且價錢更改不會被保留。

自2022年1月25日起，與本地貨幣API新功能相關(guān)的產(chǎn)品和訂單API端口已更改：

currency_code現(xiàn)為對以下所有訂單路徑的響應(yīng)。currency_code是指相關(guān)訂單所有價錢相關(guān)字段所應(yīng)用的貨幣。ERP/私服API需要恰當(dāng)?shù)貞?yīng)用currency_code返回的數(shù)據(jù)，以精確記錄和/或顯示訂單的價錢相關(guān)字段。

/order

/order/multi-get

/order/get-fulfill

/ticket

/ticket/get-action-required

商戶和EPR可以訪問此API文檔，以了解有關(guān)本地貨幣API更改的更多詳情。

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

6.WhataresomeAPIchangesIneedtobeawareof？

EffectiveJune20,202212:00AMUTC,thelocalized_price,localized_shipping,localized_currency_code,localized_cc,andanyotherprice-relatedfieldswith“l(fā)ocalized_”willbemandatoryformerchantsthathavetheirLocalCurrencyCodesetasCNY(notrequiredformerchantswhoseLocalCurrencyCodeissetasUSD).

/product/add

/product/update-shipping

/product/update-multi-shipping

/product/add-variation

/product/update-variation

/variant/add

/variant/update

ERPsareabletousetheAPIendpoint/api/v2/get-currency-codetoretrievethemerchant’slocalized_currency_code.ThisAPIendpointsalsoreturnstheparameter:payment_currency_code,whichrepresentsthecurrencyatwhichthemerchantwillbepaidinatthistime.

Inaddition,ifmerchants’payment_currency_code=CNY,allprice-relatedfieldsinthegetpathwayswillreturn999999fortheUSDvalues.Pleaseconsumelocalized_parametersinstead.

Somemerchants’LocalCurrencyCodewereupdatedfromCNYtoUSDonJanuary14,202212:00AMUTCtoreflectthepaymentsthesemerchantsarereceivingatthetime(USD,insteadofCNY),basedontheupdateddefinitionofLocalCurrencyCode(notedinthe“Whatdoesthe‘LocalCurrency’meantomerchants？”QAabove).Assuch,immediatelyafterthesemerchantsarenotifiedbyWishoftheJanuary14,2022updatesmadetotheirLocalCurrencyCode,valuesinall“l(fā)ocalized_”fieldsbecomeoptionalforthesemerchantswhose“l(fā)ocalized_currency_code”isupdatedto“USD”onJanuary14,202212:00AMUTC,regardlessoftheircurrent“l(fā)ocalized_currency_code”.

StartingJanuary14,202212:00AMUTC,formerchantswhose“payment_currency_code”and“l(fā)ocalized_currency_code”arebothUSD,valuesinall“l(fā)ocalized_”fieldsmustbeinUSD.Ifmerchantsprovideinconsistentvaluesin“l(fā)ocalized_”fieldsandcorrespondingnon-localizedfields(forexample,“l(fā)ocalized_price”vs.“price”,localized_shipping”vs.“shipping”fields),anerrorwilloccur.

StartingJuly14,202212:00AMUTC,formerchantswhoseLocalCurrencyCodeisUSD,submittingthe“/api/v2/variant/update”callutilizingthefields“price=5.0,localized_price=5.0,localized_currency_code=CNY”willresultinanerrormessage,andthepricingchangeswillnotbesaved.

EffectiveJanuary25,2022,theproductandorderAPIendpointsrelatedtothenewlocalcurrencyAPIfeaturehavebeenchanged:

currency_codeisnowaresponsetoallthefollowingorderpathways.Currency_codeindicatesthecurrencyforallprice-relatedfieldsfortherelatedorder.Currency_codereturnsneedtobeappropriatelyconsumedbyERPs/privateAPIsforaccuraterecordsand/ordisplaysofprice-relatedfieldsforanorder.

/order

/order/multi-get

/order/get-fulfill

/ticket

/ticket/get-action-required

FormoredetailsaboutthelocalcurrencyAPIchanges,merchantsandEPRsmayvisitthisAPIdocumentation.

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