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
FAQ
Trade API changes after Jul 12
Below trade API changes will take effect to part of the sellers on Jul 12. The scope will be gradually increased till all sellers are involved on Jul 18. Please complete below changes before Jul 12.
APIs/parameters to be changed | API changes | Impact to API users |
Query order list |
|
|
The expiration time of order operations aliexpress.trade.redefining.findorderlistsimplequery
aliexpress.trade.new.redefining.findorderbyid
aliexpress.trade.seller.orderlist.get
| Now we only support expiration time of below order statuses. Will return null when order is in other order statuses
| Please let us know other cases if you're using |
The escrow fee rate and affiliate fee rate aliexpress.trade.new.redefining.findorderbyid
aliexpress.trade.seller.orderlist.get
| aliexpress.trade.new.redefining.findorderbyid will provide trial fee rates (may not be accurate) after buyer's payment and before loan settlement. The accurate fee rates will be provided after loan settlement. The APIs to query order list will not provide fee rates.
| If you have the logic to use fee rates before order payment, please remove the logic. If you use fee rates when querying order list, plese use aliexpress.trade.new.redefining.findorderbyid to get the fee rates. |
Operation log list of single order details query aliexpress.trade.new.redefining.findorderbyid
| This field will be null in response | Please remove related logic if you're using the operation log list. |
Whether the order is placed by mobile phone aliexpress.trade.seller.orderlist.get
aliexpress.trade.redefining.findordertradeinfo
aliexpress.trade.new.redefining.findorderbyid
| Removed, always returns false | Please remove related logic |
The ship order id in logistics informations of order details aliexpress.trade.new.redefining.findorderbyid
| Removed | Please remove related logic |
Whether the product guarantees triple refund for fake products aliexpress.trade.redefining.findorderlistsimplequery
aliexpress.trade.seller.orderlist.get
| Removed, always returns false | The business has been inactive for a long time. So it's correct behavior to return false You can ignore this change but it's recommended to remove related logic. |
Fax related information in buyer's receipt information aliexpress.trade.redefining.findorderreceiptinfo
aliexpress.trade.new.redefining.findorderbyid
| Removed | The fax related information is not used anywhere. So the change doesn't matter. You can ignore this change but it's recommended to remove related logic. |
Refund reason in refund information aliexpress.trade.new.redefining.findorderbyid
| Current data returned is incorrect. The new refund reason will be returned (only for display purpose) | If you use it only for display, you needn't change anything. Otherwise adjust the logic.
|
Query order's loan list aliexpress.trade.redefining.findloanlistquery
|
|
|
Payment Type aliexpress.trade.new.redefining.findorderbyid
aliexpress.trade.seller.orderlist.get
| Removed | Please remove related logic |
The time when the goods is sent aliexpress.trade.seller.orderlist.get
| Removed | Please remove related logic |
Appendix I: the changes of querying order list by order status(es). The yellow background means there is change.
| order_status | order_status_list | old logic | new logic |
| none | including FUND_PROCESSING but not FINISH | returns orders in FUND_PROCESSING but not orders in FINISH | returns orders in both FUND_PROCESSIONG and FINISH |
| none | including FINISH but not FUND_PROCESSING | returns orders in FINISH but not orders in FUND_PROCESSING | |
| none | none | returns orders in FUND_PROCESSING but not orders in FINISH | won't return orders in either FUND_PROCESSING or FINISH |
| FINISH | none | returns orders in both FUND_PROCESSIONG and FINISH | |
service_name adjustment for aliexpress.solution.order.fulfill
Aim for providing better logisics experience for customers, there will be some changes in the allowed options when doing order fulfillment. Logistics services below in red will be offline before July 22th. Please adjust the service_name when using API: aliexpress.solution.order.fulfill, otherwise the invoke will be failed.
| Old Service Name | Actions | Consistent Service Name to be selected |
| SPAIN_LOCAL_GLS | To be removed | SPAIN_LOCAL_ASM |
| Other | To be removed | OTHER_ES_LOCAL |
| OTHER_ES | To be removed | OTHER_ES_LOCAL |
| CORREOSEXPRESS | To be removed | SPAIN_LOCAL_CORREOSEXPRESS |
| CORREOS | To be removed | SPAIN_LOCAL_CORREOS |
| ASM | To be removed | SPAIN_LOCAL_ASM |
| ES_LOCALFPX_PAQ24_ES | To be removed | SPAIN_LOCAL_CORREOS |
| ES_LOCAL_FPX_SEUR24 | To be removed | SPAIN_LOCAL_SEUR |
| MRW | To be removed | SPAIN_LOCAL_MRW |
| ES_LOCAL_FPX_TR72_PACKET | To be removed | SPAIN_LOCAL_CORREOS |
| SEUR | To be removed | SPAIN_LOCAL_SEUR |
| FPX_PAQ24_ES | To be removed | SPAIN_LOCAL_CORREOS |
| ES_LOCALFPX_SEUREU_ES | To be removed | SPAIN_OVERSEAS_SEUR |
| FPXES_GLSEU_LARGE_ES | To be removed | SPAIN_OVERSEAS_GLS |
| ES_LOCAL_FOURPXES_POSTPY_ES | To be removed | SPAIN_LOCAL_CORREOORDINARIO |
| GLS_ES | To be removed | SPAIN_LOCAL_ASM |
| ES_LOCALFPXES_GLSEU_SMALL_ES | To be removed | SPAIN_OVERSEAS_GLS |
| DHL_ES | To be removed | SPAIN_LOCAL_DHL |
| ES_LOCALFPXES_ESPOST_EU_ES | To be removed | SPAIN_OVERSEAS_CORREOS |
| ES_LOCALFPXES_GLSEU_LARGE_ES | To be removed | SPAIN_OVERSEAS_GLS |
| CAINIAO_OVERSEAS_WH_STDES | To be removed | ES_CAINIAO_OVERSEAS_WH_STDES |
| DPD_PL | To be removed | - |
| DHL | To be removed | - |
| UPS | To be removed | - |
Comments
Post a Comment