中国wish商户本地货币问题之商户需要注意哪些 API 更改?

自 UTC 时间2019年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 时间2020年1月14日凌晨0时起从 CNY 更新为 USD,以反映这些商户当时接收付款所用的币种(是美元而非人民币)。因此,当这些商户接获有关 Wish 在2020年1月14日更新其本地货币代码的通知后,对于“localized_currency_code”在 UTC 时间2020年1月14日凌晨0时更新为“USD”的商户,所有“localized_”字段中的值将变为选填项,无论其当前的“localized_currency_code”是何币种。

自 UTC 时间2020年1月14日凌晨0时起,对于 payment_currency_code 和 localized_currency_code 均为 USD 的商户,所有包含“localized_”的字段中的值必须以美元为单位。如果商户在“localized_”字段和对应的非本币字段中提供不同的值(例如 localized_price 与 price,localized_shipping 与 shipping 字段),则会发生错误。

自 UTC 时间2020年7月14日凌晨0时起,本地货币代码为 USD 的商户使用“price = 5.0,localized_price = 5.0,localized_currency_code = CNY”字段提交 /api/v2/variant/update 命令时会产生报错消息,且价格更改不会被保存。

自2019年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. 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 “localized_” 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 “localized_” fields become optional for these merchants whose “localized_currency_code” is updated to “USD” on January 14, 2020 12:00AM UTC, regardless of their current “localized_currency_code”.

Starting January 14, 2020 12:00AM UTC, for merchants whose “payment_currency_code” and “localized_currency_code” are both USD, values in all “localized_” fields must be in USD. If merchants provide inconsistent values in “localized_” fields and corresponding non-localized fields (for example, “localized_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/private 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.

 文章内容来源:wish商户官方网站