Note: EAN codes are mandatory for VidaXL. Make sure you have valid EAN codes for all your products, otherwise no product listings can be created for your products.
Step 1: Generate your API credentials in your VidaXL account
The VidaXL API uses the Mirakl platform, which means you will need a Mirakl- account to start sending your product listings to VidaXL.
When you have a Mirakl VidaXL account login and navigate to My user settings by clicking on your email address in the top right corner. After that you go to "API key" tab and click "generate API key" if there is no key available yet. If there is an API key available, you can use that one, you don't have to create a new one. Copy the API key, you will need this for the next step.
Next, you will need to find you Shop ID in your seller central. First select the shop you want to send products to in the top right corner. Next, go to My Account > Settings to find your Shop ID. Copy your Shop ID as well, you will need this for the next step.
Step 2: Create a new VidaXL API in Channable
Go to Channable, open your project and go to APIs > Add new API. A new screen will open with the API Settings where you can click on the "+ Add new connection" button.
You will be forwarded to an overview in which you can select "VidaXL" to create a new connection. Fill in a name for the connection under "Label", we recommend naming your connection VidaXL Belgium or VidaXL Netherlands depending on with which country your are creating a connection. Fill in the API key and Shop ID you copied in step 1, and click the "Create" button to save your connection.
You will the be redirected back to the API Settings step where you can your API a name. After choosing a name click on the "Continue" button to create your new VidaXL API.
Step 3: Create your product listings in Channable
Once you have created the VidaXL API you can setup your product data by following the steps of the API.
For your product data to be created your products need a category. Add categories to your products by using the generate categories feature or create new categories from scratch.
Create different rules to optimize your productdata. For examples take a look at our common rules support article.
Here you can find our preset template for the product listings. All you have to do is to fill it out by clicking on the field itself and selecting what you would like to go in there. For example, the field 'Title' should display the title of your product and so on. When you have finished setting up the product listings, just click 'save' on the bottom of the screen.
Tip! Notice the question mark behind every field, if you hover over the question mark you will see the description of the field and suggestions for possible values.
Almost done! Next up is filling in the fields in the Attributes step. Select the category you want to optimize first. An example of what should be in front of you now can be seen in the screenshot below. A more detailed explanation of what to do in the Attributes step can be found in our Attributes support article.
Note: For VidaXL Belgium and Switzerland, VidaXL only wants to receive the offer information from Channable and no content information. To only send the offers from Channable, skip the Categories and Attributes step of the API, and only fill out the item tab in the Build step of the API. For more information, read the VidaXL page on cross-border sales in same language countries.
Step 4: Send your product data to VidaXL
Almost there, your product listings are ready to be sent. If you have not activated your project go to Settings panel on the left hand side of the screen and click 'activate project'. After, go back to the APIs overview and go to "Your VidaXL API Name" > Settings where you activate the API by selecting "Activate API". After you have completed this step navigate back to then APIs overview and select the blue "Run now" button to sent your product listings to VidaXL.
Step 5: Check your product listings for errors
If you have sent you product listings to VidaXL go to the Preview tab of your VidaXL API. Click filter on 'error'. Now you can see which product listings have errors and are not placed. Click on a specific error to see more information on what is causing the error and check out our error solutions section on how to correct errors.
Note: At first your products might be sent to a test environment. After VidaXL accepts your products, you can send them to the live environment. Please contact our support team to make sure you are sending to the right environment.