An SKU is a set of characteristics that despite being the same product makes it different. Furthermore, an SKU has its own independent stock and might have a different price.

Taking into account what has been stated before, it is needed an extra id to distinguis each variant inside a product. The "sku_code" fits that purpose, therefore, it is required to exists and be unique within a product.

Please, review the SKU information and make sure each variant has its own unique id.

Each category may support different attributes, which also includes SKU attributes.

Whereas some attributes can be overwritten with a customized alias, it is not yet a constant. Attributes that allow customization will have the parameter "support_customized_name" set tu true.

Please, use the following API  aliexpress.solution.sku.attribute.query  to obtain supported parameters for a given category.

There is a maximum number of products that a seller can have purblished. Currently that number is 100k products.

Please, make sure there aren't unnecessary products. If a catalog exceeds the maximum number already stated, contact the  seller support center  specifying that an increase in the maximum number of products is required.

A product title supports most languages, but htere are still characters which are not allowed. For example characters like <> are not allowed.

If the system receives invalid characters, it will proceed to remove them from the title. Nevertheless, if it does not succeed, it will throw an error.

Please, try to avoid the usage of symbols on product titles.

Some categories are restricted to a handful of sellers, due to its nature or the need of special certificates.

It is possible to  apply for permission  for any category necessary. If there are any doubts about the certificates needed, please, contact the  seller support center .

AliExpress categories have a list of possible attributes with the following information:

• If it is required or not for the given category
• The list of possible values ??for each attribute

If a non supported attribue value is selected or a required attributed is missing, the API will throw an error.

Please, follow the instructions of the schema. It can be obtained using this API  aliexpress.solution.sku.attribute.query .

There are several reasons for a category validation error to happen:

• The category does not exists
• It is not a leaf category
• The seller does not have permission or it is a restricted category

Take into account this kind of error could happen during the upload of a new product, but also during an update (if there has been any change in the category tree).

Despite being stable, AliExpress category tree may change occasionally. Thereofre, it is recommended to rebluid the tree every 1-3 months. Use the following API aliexpress.solution.seller.category.tree.query to retrirve AliExpress's category tree.

It is possible to  apply for permission  for any category necessary. If there are any doubts about the certificates needed, please, contact the  seller support center .

In order to prevent XSS attacks, it is not allowed to add scripts or external redirects into a produt's description.

The system will try to remove any external code and references, but if it is not able to do so or the code shows signs of vulnerabilities, the request will be rejected.

Please, review the description taking into account the restrictions mentioned above.

Error caused by an internal problem during content translation.

As a machine might have fallen while processing the request, it can be tried again. If the error persists contact the  seller support team .

A product must always be associated with a product group. If none is provided, it will be associated with the root group.

Product groups are used to organize related items together in the seller's store. For example, inside footwear, there might be sneakers, sandals, boots...

Please, make sure the "group_id" provided exists. It is possible to create a product group using the API aliexpress.postproduct.redefining.createproductgroup and obtain the current structure by using the following API aliexpress.product.productgroups.get.

The price of a product must be comprehended between 0.01 and 100000. It is not allowed to add a product for free.

If it is wanted to offer sellers free products for any reason, it is possible to create a coupon with a vlue equal to the desired product.

Products must always be associated with a shipping template. A shipping template provides delivery infromation such as:

• Which countries/regions a product can be delivered too.
• Expected delivery time 
• Delivery cost

Is is possible to create new templates or retireve existing ones by accessing the seller center page.

Please, review the field "freight_template_id" contains valid information.

Customizable attributes can be overrided using an alias. However, those alias still have to follow a certain set of rules:

• Avoid forbiden characters like < or >
• The value should not be a list
• Length should not exceed 70 characters

Those rules are valid for both "attribute_list" and "sku_attributes_list".

Error caused by an internal timeout.

As a machine might have fallen while processing the request, it can be tried again. If the error persists contact the seller support team.

Internal error during product description processing.

As a machine might have fallen while processing the request, it can be tried again. If the error persists contact the seller support team.

During upload, products undergo a verification process to ensure it complies with AliExpress terms. Usually, this process is done automatically and takes less than a minute. However, in some cases it may need manual supervision.

A prodcut being audited, it is locked and cannot be managed until the process finishes. If the product does not change its status in a maximum of 48 hours, please, contact the seller support center

In order to avoid bottlenecks and prevent users to have a bad experience, there are certain moments in which managing a produtc's price is not allowed:

• If a product has joined a promotion, its price cannot be edited
• If a product is punished any management actions will be rejected
• Durin AliExpress big promotion periods price management is frozen

If none of the previous cases apply to a given product and it is still locked, please, contact the seller support team.

There are three cases in which a product cannot be edited:

• The product has been deleted
• The product is being audited
• The product has been punished

Those three states can be easily observed accesing the seller center page. If tnone of the previous states apply and the request is still rejeected under this reason, please, contact the seller support team.

Internal error

Please, contact the seller support team.

Products have to be associated with a shipping template.

Please, make sure the  "freight_template_id" used matches a shipping tamplate from the seller center. If needed, the same url can be used to create a new template. 

Products have a limited title length. For an optimal display in different platforms 128 characters was set as maximum.

If the title of the product is uploaded in several languages, all of them have to comply with the length restriction.

Please, review the title and if possible reduce its length to fit AliExpress standars.

Products have a limited title length. For an optimal display in different platforms 128 characters was set as maximum.

If the title of the product is uploaded in several languages, all of them have to comply with the length restriction.

Please, review the title and if possible reduce its length to fit AliExpress standars.

During a product upload, AliExpress will try to obtain an image using the provided urls. If none of the urls can be used to obtain an image, and taking into account it a required attribute, the API throws and error.

Please, review the urls ane make sure that:

• It is an array of strings
• The syntax of the url is correct and it is accessible
• There is enough banwith to transfer the images without causing a timeout
• The image server does not abandon visiting from Aliexpress based on some firewall strategies(Please raise a ticket to check the Aliexpress public IP ranges for configuration)

AliExpress also offers the following API  aliexpress.photobank.redefining.uploadimageforsdk  to upload images into the platform.

Products must have at least one picture. The field "main_image_urls_list"  is required during product posting.

Remember to add at least one accesible url for the system to obtain an image.

A product must always be associated with a brand.

Please, refer to this  document  for any remainig doubts about brand management.

There are three cases in which a product cannot be edited:

• The product has been deleted
• The product is being audited
• The product has been punished

Those three states can be easily observed accesing the seller center page. If tnone of the previous states apply and the request is still rejeected under this reason, please, contact the seller support team.

Internal error.

Please, contact the seller support team.

Internal error occured while product images are being uploaded into AliCloud.

Please, try again and if the problem persists, contact the seller support team.

To provide a faster service for customers. AliExpress copies the image provided during product upload/update and adds it into an AliCloud account.Every seller has a total of 50GB.

When reaching the upper limit of this capacity, developers need to use the following 2 apis to free the space.
https://developers.aliexpress.com/en/doc.htm?docId=30181&docType=2
https://developers.aliexpress.com/en/doc.htm?docId=30192&docType=2

AliExpress categories have a list of possible attributes with the following information:

• If it is required or not for the given category
• The list of possible values ??for each attribute

If a non supported attribue value is selected or a required attributed is missing, the API will throw an error. 

Please, follow the instructions of the schema. It can be obtained using this API  aliexpress.solution.sku.attribute.query .