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

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

wish觀察
wish觀察
2022-03-26
點(diǎn)贊icon 0
查看icon 804

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

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

自 UTC 時(shí)間2019年6月20日凌晨0時(shí)起,本地貨幣代碼為 CNY 的商戶必須填寫 localized_price、localized_shipping、localized_currency_code、localized_cc 以及任何其他包含“l(fā)ocalized_”的價(jià)格相關(guān)字段(對(duì)本地貨幣代碼為 USD 的商戶不作要求)。

/product/add

/product/update-shipping

/product/update-multi-shipping

/product/add-variation

/product/update-variation

/variant/add

/variant/update

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

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

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

自 UTC 時(shí)間2020年1月14日凌晨0時(shí)起,對(duì)于 payment_currency_code 和 localized_currency_code 均為 USD 的商戶,所有包含“l(fā)ocalized_”的字段中的值必須以美元為單位。如果商戶在“l(fā)ocalized_”字段和對(duì)應(yīng)的非本幣字段中提供不同的值(例如 localized_price 與 price,localized_shipping 與 shipping 字段),則會(huì)發(fā)生錯(cuò)誤。

自 UTC 時(shí)間2020年7月14日凌晨0時(shí)起,本地貨幣代碼為 USD 的商戶使用“price = 5.0,localized_price = 5.0,localized_currency_code = CNY”字段提交 /api/v2/variant/update 命令時(shí)會(huì)產(chǎn)生報(bào)錯(cuò)消息,且價(jià)格更改不會(huì)被保存。

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

currency_code 現(xiàn)為對(duì)以下所有訂單路徑的響應(yīng)。currency_code 是指相關(guān)訂單所有價(jià)格相關(guān)字段所使用的貨幣。ERP/私服 API 需要適當(dāng)?shù)厥褂?currency_code 返回的數(shù)據(jù),以準(zhǔn)確記錄和/或顯示訂單的價(jià)格相關(guān)字段。

/order

/order/multi-get

/order/get-fulfill

/ticket

/ticket/get-action-required

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

6. What are some API changes I need to be aware of?

Effective June 20, 2019 12:00AM UTC, the localized_price, localized_shipping, localized_currency_code, localized_cc, and any other price-related fields with “l(fā)ocalized_” will be mandatory for merchants that have their Local Currency Code set as CNY (not required for merchants whose Local Currency Code is set as USD).

/product/add

/product/update-shipping

/product/update-multi-shipping

/product/add-variation

/product/update-variation

/variant/add

/variant/update

ERPs are able to use the API endpoint  /api/v2/get-currency-code to retrieve the merchant’s localized_currency_code. This API endpoints also returns the parameter: payment_currency_code, which represents the currency at which the merchant will be paid in at this time.

In addition, if merchants’ payment_currency_code = CNY, all price-related fields in the get pathways will return 999999 for the USD values. Please consume localized_ parameters instead.

Some merchants’ Local Currency Code were updated from CNY to USD on January 14, 2020 12:00AM UTC to reflect the payments these merchants are receiving at the time (USD, instead of CNY), based on the updated definition of Local Currency Code (noted in the “What does the ‘Local Currency’ mean to merchants?” Q&A above). As such, immediately after these merchants are notified by Wish of the January 14, 2020 updates made to their Local Currency Code, values in all “l(fā)ocalized_” fields become optional for these merchants whose “l(fā)ocalized_currency_code” is updated to “USD” on January 14, 2020 12:00AM UTC, regardless of their current “l(fā)ocalized_currency_code”.

Starting January 14, 2020 12:00AM UTC, for merchants whose “payment_currency_code” and “l(fā)ocalized_currency_code” are both USD, values in all “l(fā)ocalized_” fields must be in USD. If merchants provide inconsistent values in “l(fā)ocalized_” fields and corresponding non-localized fields (for example, “l(fā)ocalized_price” vs. “price”, localized_shipping” vs. “shipping” fields), an error will occur.

Starting July 14, 2020 12:00AM UTC, for merchants whose Local Currency Code is USD, submitting the “/api/v2/variant/update” call utilizing the fields “price = 5.0, localized_price = 5.0, localized_currency_code = CNY” will result in an error message, and the pricing changes will not be saved.

Effective January 25, 2019, the product and order API endpoints related to the new local currency API feature have been changed:

currency_code is now a response to all the following order pathways. Currency_code indicates the currency for all price-related fields for the related order. Currency_code returns need to be appropriately consumed by ERPs/prie APIs for accurate records and/or displays of price-related fields for an order.

/order

/order/multi-get

/order/get-fulfill

/ticket

/ticket/get-action-required

For more details about the local currency API changes, merchants and EPRs may visit this API documentation.


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

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

平臺(tái)顧問

平臺(tái)顧問 平臺(tái)顧問

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

icon icon

小程序

微信小程序

ESG跨境小程序
手機(jī)入駐更便捷

icon icon

返回頂部

【免費(fèi)領(lǐng)取】全球跨境電商運(yùn)營干貨 關(guān)閉
進(jìn)行中
進(jìn)行中
2025跨境電商營銷日歷
包括傳統(tǒng)中、外重要節(jié)日及重點(diǎn)電商營銷節(jié)點(diǎn)還對(duì)營銷關(guān)鍵市場(chǎng)、選品輔以說明,讓你的365天安排的明明白白!
免費(fèi)領(lǐng)取
進(jìn)行中
進(jìn)行中
【平臺(tái)干貨】eMAG知識(shí)百科
涵蓋從開店到大賣6個(gè)板塊:開店、運(yùn)營、廣告、選品、上架、物流
免費(fèi)領(lǐng)取
進(jìn)行中
進(jìn)行中
TikTok運(yùn)營必備干貨包
包含8個(gè)TikTok最新運(yùn)營指南(市場(chǎng)趨勢(shì)、運(yùn)營手冊(cè)、節(jié)日攻略等),官方出品,專業(yè)全面!
免費(fèi)領(lǐng)取
進(jìn)行中
進(jìn)行中
韓國coupang平臺(tái)自注冊(cè)指南
韓國Coupang電商平臺(tái)從注冊(cè)準(zhǔn)備、提交申請(qǐng)到完成注冊(cè),開店全流程詳細(xì)指引。
免費(fèi)領(lǐng)取
進(jìn)行中
進(jìn)行中
全球平臺(tái)詳解——全球合集
涵括全球100+個(gè)電商平臺(tái)的核心信息,包括平臺(tái)精煉簡(jiǎn)介、競(jìng)爭(zhēng)優(yōu)勢(shì)、熱銷品類、入駐要求以及入駐須知等關(guān)鍵內(nèi)容。
立即領(lǐng)取
進(jìn)行中
進(jìn)行中
韓國電商節(jié)日營銷指南
10+韓國電商重要營銷節(jié)點(diǎn)詳細(xì)解讀;2024各節(jié)日熱度選品助力引爆訂單增長;8大節(jié)日營銷技巧輕松撬動(dòng)大促流量密碼。
免費(fèi)領(lǐng)取
進(jìn)行中
進(jìn)行中
全球平臺(tái)詳解——?dú)W洲篇
涵蓋20+歐洲電商平臺(tái),詳細(xì)解讀優(yōu)勢(shì)、入駐條件、熱銷品等
立即領(lǐng)取