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

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

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

自UTC时间2022年1月14日清晨0时起，对于payment_currency_code和localized_currency_code均为USD的商户，所有包括“localized_”的字段中的值必需以美元为单位。如果商户在“localized_”字段和对应的非本币字段中提供不同的值（例如localized_price与price，localized_shipping与shipping字段），则会产生错误。

自UTC时间2022年7月14日清晨0时起，本地货币代码为USD的商户应用“price=5.0，localized_price=5.0，localized_currency_code=CNY”字段提交/api/v2/variant/update命令时会发生报错资讯，且价钱更改不会被保留。

自2022年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.WhataresomeAPIchangesIneedtobeawareof？

EffectiveJune20,202212:00AMUTC,thelocalized_price,localized_shipping,localized_currency_code,localized_cc,andanyotherprice-relatedfieldswith“localized_”willbemandatoryformerchantsthathavetheirLocalCurrencyCodesetasCNY(notrequiredformerchantswhoseLocalCurrencyCodeissetasUSD).

/product/add

/product/update-shipping

/product/update-multi-shipping

/product/add-variation

/product/update-variation

/variant/add

/variant/update

ERPsareabletousetheAPIendpoint/api/v2/get-currency-codetoretrievethemerchant’slocalized_currency_code.ThisAPIendpointsalsoreturnstheparameter:payment_currency_code,whichrepresentsthecurrencyatwhichthemerchantwillbepaidinatthistime.

Inaddition,ifmerchants’payment_currency_code=CNY,allprice-relatedfieldsinthegetpathwayswillreturn999999fortheUSDvalues.Pleaseconsumelocalized_parametersinstead.

Somemerchants’LocalCurrencyCodewereupdatedfromCNYtoUSDonJanuary14,202212:00AMUTCtoreflectthepaymentsthesemerchantsarereceivingatthetime(USD,insteadofCNY),basedontheupdateddefinitionofLocalCurrencyCode(notedinthe“Whatdoesthe‘LocalCurrency’meantomerchants？”QAabove).Assuch,immediatelyafterthesemerchantsarenotifiedbyWishoftheJanuary14,2022updatesmadetotheirLocalCurrencyCode,valuesinall“localized_”fieldsbecomeoptionalforthesemerchantswhose“localized_currency_code”isupdatedto“USD”onJanuary14,202212:00AMUTC,regardlessoftheircurrent“localized_currency_code”.

StartingJanuary14,202212:00AMUTC,formerchantswhose“payment_currency_code”and“localized_currency_code”arebothUSD,valuesinall“localized_”fieldsmustbeinUSD.Ifmerchantsprovideinconsistentvaluesin“localized_”fieldsandcorrespondingnon-localizedfields(forexample,“localized_price”vs.“price”,localized_shipping”vs.“shipping”fields),anerrorwilloccur.

StartingJuly14,202212:00AMUTC,formerchantswhoseLocalCurrencyCodeisUSD,submittingthe“/api/v2/variant/update”callutilizingthefields“price=5.0,localized_price=5.0,localized_currency_code=CNY”willresultinanerrormessage,andthepricingchangeswillnotbesaved.

EffectiveJanuary25,2022,theproductandorderAPIendpointsrelatedtothenewlocalcurrencyAPIfeaturehavebeenchanged:

currency_codeisnowaresponsetoallthefollowingorderpathways.Currency_codeindicatesthecurrencyforallprice-relatedfieldsfortherelatedorder.Currency_codereturnsneedtobeappropriatelyconsumedbyERPs/privateAPIsforaccuraterecordsand/ordisplaysofprice-relatedfieldsforanorder.

/order

/order/multi-get

/order/get-fulfill

/ticket

/ticket/get-action-required

FormoredetailsaboutthelocalcurrencyAPIchanges,merchantsandEPRsmayvisitthisAPIdocumentation.