API Changes
Oct. 15, 2021
Important Changes
From Oct. 15th, aliexpress_attribute_name_id with 2(representing brand) is mandatory to be filled in the following API, unless Aliexpress’s system could recognize brand_name field and was able to do the text matching. Please guide the sellers to apply for brand permissions in https://gsp.aliexpress.com/apps/oversea/brand/myListNew
- aliexpress.solution.product.post
From Oct. 15th, category_attributes->Brand name is mandatory to be filled in the following APIs, unless Aliexpress’s system could recognize brand_name field and was able to do the text matching. Please guide the sellers to apply for brand permissions in https://gsp.aliexpress.com/apps/oversea/brand/myListNew
- aliexpress.solution.schema.product.instance.post
- aliexpress.solution.schema.product.full.update
- Using feed solution with operation_type: PRODUCT_CREATE: aliexpress.solution.feed.submit
- Using feed solution with operation_type: PRODUCT_FULL_UPDATE: aliexpress.solution.feed.submit
Sep. 8, 2021
QPS(Query per second) limit set to 80; QPM(Query per minute) limit set to 4800
-aliexpress.solution.product.info.get
July. 15, 2021
Service_name adjustment for order fulfillment. Please see detailed here
Jun. 29, 2021
Add marketing images in the following APIs:
- aliexpress.solution.product.post
- aliexpress.solution.product.edit
Apr. 19, 2021
- aliexpress.solution.schema.product.instance.post
- aliexpress.solution.schema.product.full.update
- aliexpress.solution.product.schema.get
QPS(Invoke per second) for these 3 APIs are limited to 200 for each appkey and 25 for each seller.
Apr. 12, 2021
- aliexpress.solution.feed.submit
The number of feeds uploaded for one seller under each operation_type is limited under 300 in every 24 hours.
Dec 23, 2020
Important Notice
- http://api.alibaba.com
For those developers, who were still using this old endpoint, please change the endpoint
according to [https://developers.aliexpress.com/en/doc.htm?docId=108974&docType=1]
This old endpoint will be offline before Jan. 10th
Dec 2, 2020
aliexpress.solution.feed.list.get
Add submitted_time_start and submitted_time_end to filter the feed listaliexpress.solution.feed.invalidate
In case that queue of feeds waiting to be executed is too log, provided a new api for invalidating the feeds, which have not been executed, in the queue. Recommended to use along with aliexpress.solution.feed.list.getaliexpress.solution.order.info.get
Add category_id of product in child_order_ext_info_list
Aug 11, 2020
- aliexpress.solution.feed.query
Invoke limit added: 30 times/minute for each appkey. Please arrange the frequency properly.
Feb 27, 2020
Important Changes
From Feb 27th, a new field: brand_name has been added into the json response of : aliexpress.solution.product.schema.get.
Developers under the following 4 scenarios need to update the Integration system. This newly added brand_name will become mandatory from March 10th when submitting the json instance, unless the field category_attributes->Brand name, which represents the brand existed in Aliexpress ,has already been filled with a value ID.
- aliexpress.solution.schema.product.instance.post
- aliexpress.solution.schema.product.full.update
- Using feed solution with operation_type: PRODUCT_CREATE: aliexpress.solution.feed.submit
- Using feed solution with operation_type: PRODUCT_FULL_UPDATE: aliexpress.solution.feed.submit
Feb 19, 2020
Important Changes
From February 28th, the field: brand_name in API: aliexpress.solution.product.post
will become mandatory,unless the brand info is provided in the field: attribute_list, with aliexpress_attribute_name_id equals to 2.
Please make the necessary changes to ensure that the product uploading remains stable.
Note: brand_name could either be the brand name from merchants or brand_name already existed in Aliexpress.
Nov 21, 2019
Changes
Add api to query the job list belonged to a seller when using feed solution. aliexpress.solution.feed.list.get
Nov 20, 2019
Changes
Add deleting multi-country price ability in aliexpress.solution.product.edit, also in schema full edit and feed type of PRODUCT_FULL_UPDATE.
Oct 25, 2019
Changes
Add api to query the seller’s general profile. aliexpress.solution.merchant.profile.get
One important field in the reponse: product_posting_forbidden, indicating whether the seller currently could post products to Aliexpress or not.
Oct 15, 2019
Changes
All online logistics order will require “refund” information starting from Nov 25, 2019. Please change your application logic to meet this requirement to avoid failure on creating online logistics orders.
The “address_d_t_os” -> “refund” in API aliexpress.logistics.createwarehouseorder will be mandatory. Inside it, “address_id” is mandatory while others are not required.
Sep 04, 2019
Changes
Add api to query the permitted Aliexpress category tree.aliexpress.solution.seller.category.tree.query
-filter_no_permission=true: filter the categories which seller does not have permission, only returning the category tree which the seller has permissions.
-filter_no_permission=false: do not filter, returning the original whole Aliexpress category tree.
Aug 07, 2019
Changes
aliexpress.solution.feed.submit
- STOCK_UPDATE type will be no longer supported, please migrate to PRODUCT_STOCKS_UPDATE according to document: https://developers.aliexpress.com/en/doc.htm?docId=118066&docType=1
- PRICE_UPDATE type will be no longer supported, please migrate to PRODUCT_PRICES_UPDATE according to document: https://developers.aliexpress.com/en/doc.htm?docId=118066&docType=1
Aug 06, 2019
Changes
aliexpress.solution.product.post
- Add group_id in API
Aug 05, 2019
Changes
aliexpress.solution.batch.product.price.update
- Add three fields: update_success, update_error_code, update_error_message, fixing the problem that update_failed_list and update_successful_list could not be displayed when only part of the list were updated successfully.
aliexpress.solution.batch.product.inventory.update
- Add three fields: update_success, update_error_code, update_error_message, fixing the problem that update_failed_list and update_successful_list could not be displayed when only part of the list were updated successfully.
Jul 24, 2019
Changes
aliexpress.solution.batch.product.price.update
- Add a new API for oversea sellers batch updating prices of multiple skus among multiple products in one call. Maximum 20 products for single call and maximum 200 skus within one product. For sellers previously using aliexpress.solution.product.sku.price.edit, which will be offline in the future, please migrate to this API. Skus belonged to the same Aliexpress product should be set in the same multiple_sku_update_list.
aliexpress.solution.batch.product.inventory.updatet
- Add a new API for oversea sellers batch updating inventory of multiple skus among multiple products in one call. Maximum 20 products for single call and maximum 200 skus within one product. For sellers previously using aliexpress.solution.product.sku.price.edit, which will be offline in the future, please migrate to this API. Skus belonged to the same Aliexpress product should be set in the same multiple_sku_update_list.
Jul 15, 2019
Changes
aliexpress.solution.product.post
- Modify the format of multi_language_description_list, please refer to Data format of subject and detail for more details. Recommend developers to upgrade if want to utilize the new features.
aliexpress.solution.product.edit
- Modify the format of multi_language_description_list, please refer to Data format of subject and detail for more details. Recommend developers to upgrade if want to utilize the new features.
Jul 8, 2019
Changes
There are new changes on Trade APIs and the target date is changed to Jul 12. Please refer to Trade API changes after Jul 12 for details.
Jun 27, 2019
Changes
Starting from Jul 8, there are changes on trade, marketing and product APIs (the changes of product APIs have been started already). At the beginning, the changes only impact part of the seller. The scope will be gradually increased till all sellers are involved on Jul 18. Below is trade API changes. We will publish the changes of marketing and product APIs soon.
May 30, 2019
Changes
aliexpress.marketing.redefining.restocklimiteddiscountpromproduct ( Replenishment of goods in limited time activities for a shop ) will be offline on June 20, 2019. The inventory model of store promotions is upgraded. There is no promotion inventory now, the store promotion will use the normal inventory of the product. So this API is meaningless.
impact
Need to remove related business from your applications.
Apr 17, 2019
Changes
- Added an output parameter (sku property list) for aliexpress.offer.ds.product.simplequery( Query simple information of product for dropshipper )
Apr 16, 2019
Trade APIs offline notification
Below trade APIs will be offline on Jun 1, 2019. Please migrate to new APIs in time.
Apr 10, 2019
Changes
- Added an output parameter to indicate if the order is cash-on-delivery for API of querying order details
- Added a new API to query seller’s profile (country and quotation currency)
Mar 08, 2019
Changes
changes of product national quote configuration（aeop_national_quote_configuration）format,the following APIs are involved
- aliexpress.postproduct.redefining.postaeproduct( 发布产品信息 )
- aliexpress.postproduct.redefining.findaeproductbyid( 获取单个产品信息 )
- aliexpress.postproduct.redefining.postmultilanguageaeproduct( 发布多语言产品(试用) )
- aliexpress.postproduct.redefining.editaeproduct( 修改编辑商品信息 )
- aliexpress.offer.draftproduct.get( 查询草稿箱里的产品信息 )
old format
when configuration_type is:
- percentage：Proportional configuration based on benchmark price,At this point percentage is the price adjustment ratio relative to the benchmark price(Percentage Integer,negative number is supported，Current restriction>=-30 && <=100)
- relative：Rise or fall relative to the original price,At this point percentage is the range of rising or falling based on benchmark price
now format is as follow
1 2 3 4 | [ {"absoluteQuoteMap":{"14:193":84.99,"14:771":84.99},"shiptoCountry":"FR"}, {"absoluteQuoteMap":{"14:193":89.99,"14:771":89.99},"shiptoCountry":"ES"}] |
when configuration_type is “absolute”(direct quote),the format is as follow,If there are multiple SKU attributes, separate them with “;”,If there is no SKU attribute, just use empty string directly like "“,”14:173“, ”14:173;3:2034781"
1 2 3 4 | [ {"absoluteQuoteMap":{"14:193":84.99,"14:771":84.99},"shiptoCountry":"FR"}, {"absoluteQuoteMap":{"14:193":89.99,"14:771":89.99},"shiptoCountry":"ES"}] |
new format
The new format will no longer use “percentage” fields, but will use “absoluteQuoteMap” uniformly.When using “percentage” or “relative” in the old format, you can only adjust the price uniformly for all skUs,The new format uses “absoluteQuoteMap” to adjust price for any SKU or multiple skUs,The value meaning of “absoluteQuoteMap” is related to the value of “configuration_type”,The “key” format of “absoluteQuoteMap” remains unchanged
| configuration_type | value meaning of “absoluteQuoteMap” |
|---|---|
| percentage | Ratio of Price Adjustment Relative to Benchmark Price(Percentage Integer,negative number is supported，>=-30 && <=100) |
| relative | Adjustment value relative to base price，negative number is supported |
| absolute | set specific values directly,negative number is not supported |
example:
1 2 3 4 | [ {"absoluteQuoteMap":{"14:193":1.0},"shiptoCountry":"RU"}, {"absoluteQuoteMap":{"14:193":2.0},"shiptoCountry":"US"}] |
impact
- at present,when input national quote configuration,both the two format is supported,But we suggest switching to the new format as soon as possible,because the old format will not be supported in the future,Second, some of the commodity data synchronized may have been in the new format.
- at present,it is possible to return the new format or the old format when obtaining commodity information,Please do compatibility processing,and remove it when the new format is returned uniformly in the future.
Feb 13, 2019
Changes
Added two APIs
- Query product list in draft box (aliexpress.offer.draftproducts.get)
- Get draft product information (aliexpress.offer.draftproduct.get)
Note, please use post product (aliexpress.postproduct.redefining.postaeproduct) to upload the draft product instead of edit API. The input parameter “product_id” must be the “product_id” of the draft product.
Jan 2, 2019
In the response of aliexpress.trade.redefining.findorderreceiptinfo( Query receipt info of the order ), we have added a new field “country_name” which is the English name of the country.
Nov 30, 2018
Changes
Add buyer’s order comments to the return result of aliexpress.trade.new.redefining.findorderbyid, which is target -> child_order_list -> buyer_memo.
Before this change, target -> memo is the buyer’s order comments when the main order has only one child order. The newly added field “buyer_memo” is the comments for each child order.
If one main order has multiple child orders, target -> memo is null and target -> child_order_list -> buyer_memo may have value if there is buyer’s comment. If one main order has only one child order and there is buyer’s comment, target -> memo is same as target -> child_order_list -> buyer_memo. So you can use target -> child_order_list -> buyer_memo only to get buyer’s comments. target -> memo can be ignored.
Nov 30, 2018
Issue APIs offline notification
Below issue APIs will be offline on Dec 30, 2018. Please migrate to new APIs in time.
| Old API | New API |
|---|---|
| aliexpress.issue.redefining.queryissuelist | aliexpress.issue.issuelist.get |
| aliexpress.issue.redefining.findissuedetailbyissueid | aliexpress.issue.detail.get |
Nov 27, 2018
Changes
aliexpress.offer.ds.product.simplequery
- Fixed the issue of missing value for sku_bulk_order, offer_bulk_sale_price, offer_sale_price inside aeop_ae_product_s_k_us when the product doesn’t have any sku
- Added s_k_u_available_stock to aeop_ae_product_s_k_us
- Added item_offer_site_sale_price and total_available_stock
aliexpress.postproduct.redefining.findaeproductbyidfordropshipper
- Fixed the issue of missing value for sku_bulk_order, offer_bulk_sale_price, offer_sale_price, s_k_u_available_stock inside aeop_ae_product_s_k_us when the product doesn’t have any sku
- Fixed the issue of missing value for sku_property_name and sku_property_value inside aeop_ae_product_s_k_us.aeop_s_k_u_propertys
- Added more information, including
– store information (store_info), including store name (store_name), store NO (store_id), DSR (communication_rating, tem_as_descriped_rating, shipping_speed_rating)
– product information, including order number (order_count), evaluation number (evaluation_count), average evaluation rating (avg_evaluation_rating)
Sep 12, 2018
Changes
New APIs added
- Seller refuses to cancel order: aliexpress.trade.seller.order.refusecancel
- Seller agrees to cancel order: aliexpress.trade.seller.order.acceptcancel
Comments
Post a Comment