中国?wish商户外地钱币问题之商户需要注重哪些API更改？？ ？？？ ？？
中国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商户官方网站