中國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)系。
二維碼加載中...
使用微信掃一掃登錄
使用賬號(hào)密碼登錄
平臺(tái)顧問
微信掃一掃
馬上聯(lián)系在線顧問
小程序
ESG跨境小程序
手機(jī)入駐更便捷
返回頂部