Significant Open API Updates

尊敬的开发者，请留意以下变动：

1.MX沙箱环境已经部署完成，Open Platform现已支持创建MX站点的测试账号进行测试，测试账号登陆后需要先将卖家和买家的地址均修改为可用的地址。

影响接口：ALL

上线时间：2021/12/10

2.为了优化用户体验，对于一些商品信息如category,attribute,logistic info等等，发生了失效、被平台侧删改或平台内部获取失败的情况，卖家仍然能通过api正常获取到库存价格等信息，v2.product.get_item_base_info新增返回warning与error的逻辑，逻辑如下

对应接口字段	API未能获取返回Error/ Warning	报错时是否返回字段	Warning 例子
item_id / item_sku / shop_id / item_status / item_name / description/ image / weight / wholesales / dimension /size_chart / condition / promotion_id	Error	否
category_id	Warning	否	"warning": "Invalid category ID, please use UpdateItem api to refresh item's category "
attribute_list	Warning	否	"warning": "Invalid attribute ID, please use UpdateItem api to refresh item's attribute"
brand	Warning	否	"warning": "Invalid brand ID, please use UpdateItem api to refresh item's brand "
logistic_info	Warning	否	"warning": "Logistics information of this item is changed, please use UpdateItem api to refresh item logistics info"
complaint_policy / tax_info	Warning	否
stock_info / price_info	Error	否

影响接口：v2.product.get_item_base_info

上线时间：2021/12/16

3.原来西班牙（ES）返回币种（currency）字段EUES，原法国（FR）返回币种（currency）字段EUFR，现均改为EUR

影响接口:

v2.product.get_item_base_info --2021/12/16 上线

shopee.item.GetItemDetail --2021/12/16 上线

shopee.item.Add --2021/12/16 上线

shopee.item.UpdateItem --2021/12/16 上线

v2.order.get_order_detail --已上线

v2.payment.get_escrow_detail --已上线

shopee.orders.MyIncome --已上线

shopee.orders.GetEscrowDetails --已上线

shopee.orders.GetOrderDetails --已上线

4.CNCB新增头程寄送方式： Self-deliver (卖家自送）

目前头程寄送方式共三种：Pickup, Drop off, Self-deliver (卖家自送)

说明：调用OMS相关绑定接口（FirstMileCodeBindOrder/bind_first_mile_tracking_number）时，self deliver传shipping_method = 3同时fm_tn和first_mile_id字段传空

影响接口：

V1:

FirstMileCodeBindOrder

FirstMileUnbind

GetShopFirstMileChannel

bind_first_mile_tracking_number

unbind_first_mile_tracking_number

get_channel_list

上线时间：2021/12/16

Dear Developer,

Please find below updates:

1.MX sandbox environment has been configured well, Open platform has supported the creation of the test account for MX region.Please pay attention to set an available address before after logging your shop and buyer account.

Related API:ALL

Effective Date on Live:2021/12/10

In order to optimize the user experience, for some product information such as category, attribute, logistic info, etc., if it is invalid, deleted by the platform side, or the internal platform error, the seller can still obtain the stock and price information normally through the API. v2.product.get_item_base_info adds the logic to return warning and error, the logic is as follows：

API field	Return Error or Warning when api cannot be obtained	Whether to return the corresponding field when error or warning report	Warning example
item_id / item_sku / shop_id / item_status / item_name / description/ image / weight / wholesales / dimension /size_chart / condition / promotion_id	Error	No
category_id	Warning	No	"warning": "Invalid category ID, please use UpdateItem api to refresh item's category "
attribute_list	Warning	No	"warning": "Invalid attribute ID, please use UpdateItem api to refresh item's attribute"
brand	Warning	No	"warning": "Invalid brand ID, please use UpdateItem api to refresh item's brand "
logistic_info	Warning	No	"warning": "Logistics information of this item is changed, please use UpdateItem api to refresh item logistics info"
complaint_policy / tax_info	Warning	No
stock_info / price_info	Error	No

Related API:v2.product.get_item_base_info

Effective Date on Live:2021/12/16

The original Spanish (ES) returned currency field as EUES, the original France (FR) return currency field as EUFR, now all changed to EUR.

Related API:

v2.product.get_item_base_info --2021/12/16 go live

shopee.item.GetItemDetail --2021/12/16 go live

shopee.item.Add --2021/12/16 go live

shopee.item.UpdateItem --2021/12/16 go live

v2.order.get_order_detail --on live

v2.payment.get_escrow_detail --on live

shopee.orders.MyIncome --on live

shopee.orders.GetEscrowDetails --on live

shopee.orders.GetOrderDetails --on live

4.CNCB first_mile new shipping method: Self-deliver

At present, there are three shipping methods: Pickup, Drop off, Self-deliver

Description: When calling bind interface (FirstMileCodeBindOrder/bind_first_mile_tracking_number), self deliver as shipping_method = 3 while fm_tn and first_mile_id fields are empty.

Impact Interface:

V1: