Dec. 13th, 2022

Please pay attention to this announcement: https://developers.aliexpress.com/en/doc.htm?docId=121124&docType=1

Aug. 4th, 2022

From Aug. 11th,2022, The “image” fields, in all product-management related APIs, needs to be acquired firstly by invoking
aliexpress.photobank.redefining.uploadimageforsdk before passed into the specific API. The affected APIs are as followings:
- aliexpress.solution.schema.product.instance.post
- aliexpress.solution.schema.product.full.update
- aliexpress.solution.feed.submit
- aliexpress.solution.product.post
- aliexpress.solution.product.edit

June. 21, 2022

Important Changes

From June. 23th,2022, the upper limit for item_list in one feed will be changed to 300.
- aliexpress.solution.feed.submit

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 list

• aliexpress.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.get

• aliexpress.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.

• Trade API changes

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.

Old API	New API
aliexpress.trade.redefining.findorderlistquery - Query Order List by page	aliexpress.trade.seller.orderlist.get - query order list
aliexpress.trade.redefining.findorderbyid - Query order transaction details	aliexpress.trade.new.redefining.findorderbyid - Get order details

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

[
    {"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"

[
    {"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:

[
    {"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

FAQ

关于此文档暂时还没有FAQ