Note I: AliExpress is using the cost per sale model; according to them the percentage is always between 5-8% depending on categories/items.
Note II: The API token for AliExpress is valid for one month. After this month you can refresh the API token by clicking on refresh token in the connection. Click here for more information about refreshing an existing connection.
Step 1 - Create a new connection
Go to the project you are working in and navigate to the API tab. Click '+ Add new API' and then ‘Add new connection'.
Now, select AliExpress, name the connection and click on 'Connect with AliExpress'.
Step 2 - Login to AliExpress
You will automatically be redirected to your AliExpress environment. Sign in with your email or username and password (or AliExpress shows if you want to use the account you are logged in with).
You need to grant access to Channable, and then you are redirected back to Channable.
Step 3 - Add the new connection
Back in Channable you can finish creating the connection by clicking on 'Add connection'.
Step 4 - Setup AliExpress API
Once you have created the new AliExpress API, you can give the API a name and select the country and unique ID per item. The country setting is used to pull the business policies (i.e. shipping profile) from your AliExpress account for that specific country.
Step 5 - Create your product listings
Follow the four steps below to configure your product listings for AliExpress.
In the Build step you can find our pre-set template for the product listings. All you have to do is to fill it out by clicking on the field itself and selecting the corresponding value. For instance, the field 'Brand' should display the 'Brand' of your product and so on.
The ‘Item group ID’ field is used to combine multiple items into a single listing. Select the field that contains the group or parent ID of your products here. Later, in the Attribute step, you can select fields to configure the variants of grouped products.
Note: 'Unit' is often'piece/pieces', but you can change this to another static value or connect it to a dynamic field.
Tip! Hover over the question marks next to the fields to see a description of the field and suggestions for possible values.
In the Build step you also find a 'Title & description' tab. Here, you need to select a title and description for your products per language. You need to select the language of the title and description and connect the fields you use in Channable (which fields contain your title and description).
In this step you also need to set your shipping information, for example weight, length, height, width, dispatch etc. A part of this is to select a profile for service policy. If you have set this policy but can't find them, you might need to enable them first. In Channable, you can automatically select the profile you have configured in AliExpress. You also need to select a freight template ID, more information can be found on this page.
Note II: The AliExpress profile is a static value we retrieve from AliExpress, so you cannot find them in the project fields when trying to select them. Instead, click on the ‘back’ arrow and go to static values. Now you should be able to select the profiles from AliExpress.
The last tab in the build step is the 'images' tab and here you can link field(s) which contains your images.
Next you need to fill in the attributes per category in the Attributes step. See the screenshot below for an example of how the attributes look. A more detailed explanation of what to do in the Attributes step can be found in our Attributes support article.
Note: if you have variants of products, you can configure this in the Attributes step as well. When selecting a field as attribute value, for some fields you can also check the ‘Use as variant attribute’ box. The attributes with the 'Use as variant attribute' box checked will be shown on AliExpress as variant options (for example color or size).
Step 6 - Send your product listings to AliExpress
Once you have finished configuring your product listings, you can start sending your listings to AliExpress. If you have not activated the project yet, navigate to ‘Setup > Project settings’ and activate the project. Then, go back to APIs and go to the Settings of your AliExpress API and activate the API here. When you click on 'Run now' your products will be sent to AliExpress!
Step 7 - Results
After you have sent your listing to AliExpress go to the Results tab. By clicking on 'errors' you can see which product listings have errors and will not be placed. Click on an error to see what the error message is and which products have that error.
Note: If you get an error on one variant in a listing this error is shown for every variant in said listing.