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

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

/product/add

/product/update-shipping

/product/update-multi-shipping

/product/add-variation

/product/update-variation

/variant/add

/variant/update

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

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

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

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

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

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

currency_code現為對以下所有訂單路徑的響應。currency_code是指相關訂單所有價錢相關字段所應用的貨幣。ERP/私服API需要恰當地應用currency_code返回的數據，以精確記錄和/或顯示訂單的價錢相關字段。

/order

/order/multi-get

/order/get-fulfill

/ticket

/ticket/get-action-required

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

wish商戶官網原文詳情：

6.WhataresomeAPIchangesIneedtobeawareof？

EffectiveJune20,202212:00AMUTC,thelocalized_price,localized_shipping,localized_currency_code,localized_cc,andanyotherprice-relatedfieldswith“localized_”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“localized_”fieldsbecomeoptionalforthesemerchantswhose“localized_currency_code”isupdatedto“USD”onJanuary14,202212:00AMUTC,regardlessoftheircurrent“localized_currency_code”.

StartingJanuary14,202212:00AMUTC,formerchantswhose“payment_currency_code”and“localized_currency_code”arebothUSD,valuesinall“localized_”fieldsmustbeinUSD.Ifmerchantsprovideinconsistentvaluesin“localized_”fieldsandcorrespondingnon-localizedfields(forexample,“localized_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.

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