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

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

來源網(wǎng)絡
來源網(wǎng)絡
點贊icon 0
查看icon 798

中國wish商戶本地貨幣問題之商戶需要注意那些API更改?自UTC時間2022年6月20日清晨0時起,本地貨幣代碼為CNY的商戶必需填寫localized_price、localized_shipping、localized_currency_code、localized_cc以及任何其他...

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

自UTC時間2022年6月20日清晨0時起,本地貨幣代碼為CNY的商戶必需填寫localized_price、localized_shipping、localized_currency_code、localized_cc以及任何其他包括“l(fā)ocalized_”的價錢相關字段(對本地貨幣代碼為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端口還會返回以下參數(shù):payment_currency_code,它代表當前支付商戶所應用的貨幣。

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

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

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

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

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

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

/order

/order/multi-get

/order/get-fulfill

/ticket

/ticket/get-action-required

商戶和EPR可以訪問此API文檔,以了解有關本地貨幣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)容僅代表作者本人觀點,不代表ESG跨境電商觀點或立場。如有關于作品內(nèi)容、版權或其它問題請于作品發(fā)表后的30日內(nèi)與ESG跨境電商聯(lián)系。

北美和歐洲最大的用電商平臺,被評為硅谷最佳創(chuàng)新平臺和歐美最受歡迎的購物APP
查看更多
搜索 放大鏡
韓國平臺交流群
加入
韓國平臺交流群
掃碼進群
歐洲多平臺交流群
加入
歐洲多平臺交流群
掃碼進群
美國賣家交流群
加入
美國賣家交流群
掃碼進群
ESG跨境專屬福利分享群
加入
ESG跨境專屬福利分享群
掃碼進群
拉美電商交流群
加入
拉美電商交流群
掃碼進群
亞馬遜跨境增長交流群
加入
亞馬遜跨境增長交流群
掃碼進群
亞馬遜跨境增長交流群
加入
亞馬遜跨境增長交流群
掃碼進群
拉美電商交流群
加入
拉美電商交流群
掃碼進群
ESG獨家招商-PHH GROUP賣家交流群
加入
ESG獨家招商-PHH GROUP賣家交流群
掃碼進群
2025跨境電商營銷日歷
《Coupang自注冊指南》
《eMAG知識百科》
《TikTok官方運營干貨合集》
《韓國節(jié)日營銷指南》
《開店大全-全球合集》
《TikTok綜合運營手冊》
《TikTok短視頻運營手冊》
《TikTok直播運營手冊》
《TikTok全球趨勢報告》
通過ESG入駐平臺,您將解鎖
綠色通道,更高的入駐成功率
專業(yè)1v1客戶經(jīng)理服務
運營實操指導
運營提效資源福利
平臺官方專屬優(yōu)惠
聯(lián)系顧問

平臺顧問

平臺顧問 平臺顧問

微信掃一掃
馬上聯(lián)系在線顧問

icon icon

小程序

微信小程序

ESG跨境小程序
手機入駐更便捷

icon icon

返回頂部