成人网久久,日韩精品久热大陆

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

wish觀察

2022-03-26

799

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

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

自 UTC 時間2019年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

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

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

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

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

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

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

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