Setting up an ePrice API – Channable

Would you like to learn interactively about all the basics related to creating an API export, or how to set up an advanced API in Channable? Start by creating a Channacademy account in the Channable app by following the instructions provided in this Help Center article. Once you have created an account, you can get started with either the Basic APIs or the Expert APIs course.

Important: EAN codes are mandatory for ePrice. Make sure you have valid EAN codes for all your products; without them, listings cannot be created.

Step 1: Add a new ePrice connection

The ePrice API uses the Mirakl platform, requiring you to have a Mirakl account in order to begin sending your product listings to ePrice.

Once you have a Mirakl ePrice account, go to “Connections > Add connection: Click on “+ Add a new connection” and you will see a screen, where you can select ePrice. Fill in the label for your connection, for example: ePrice. And then click on ''Connect with ePrice''. You will be redirected to the environment where you can log in with your Mirakl-credentials. After successfully logging in, you will be redirected back to Channable where the connection will be available.

Step 2: Create a new ePrice API in Channable

Now, navigate to the API's overview in your project. Click on “+ Add new API” and select the ePrice connection you just created. Next, name your new API.

Select the field you want to use for Unique ID per item (we recommend the 'id' field) and the Country you want to sell. Additionally, you have the option to add a master rule group here if desired. Click on “Continue” to finish creating the new ePrice API.

Important: ePrice requires that IDs have a minimum of 5 digits. They will not accept anything with fewer than 5 digits, as this may result in errors or the listing being rejected by ePrice.

Note: Magento users need to be aware that IDs in Magento start counting from 1 and increase from there. Consequently, customers will be unable to utilize Magento via Channable to ePrice for products with fewer than 5 digits. This issue must be addressed and resolved within Magento.

Step 3: Create your product listings in Channable

Once you have created the ePrice API, you can set up your product data by following the steps of the API.

Categories
For your product listings 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.
Rules
Create different rules to optimize your products listings. For examples, take a look at our common rules support article.
Build
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 instance, the 'Price' field should display the price of your product and so on. When you have finished setting up the product listings, just click 'save' at the bottom of the screen.
Tip! Notice the question mark following every field. Hovering over the question mark will display the field's description and suggestion for possible values.

Note: ePrice has a fulfillment latency field that indicates, which indicates the number of days it takes for the package to arrive. ePrice always adds +3 days on their end. Therefore, you can also select negative days in Channable for this field. For instance: -1 means -1 + 3 = in 2 days at home.
Attributes
You're almost done! Next, you will need to fill in the fields in the Attributes step. For a more detailed explanation of what to do in the Attributes step can be found in our Attributes support article.

Step 4: Send your product data to ePrice!

Almost there, your product listings are ready to be sent. If you have not activated your project, go to your project settings on the left-hand side of the screen and click 'activate project'. After, go back to the APIs overview and go to “Your ePrice API Name” > Settings, where you activate the API by selecting “Activate API”. After you have completed this step, navigates back to then APIs overview and select the blue “Run now” button to sent your product listings to ePrice.

Step 5: Check your product listings for errors

If you have sent your product listings to ePrice, navigate to the Preview tab of your ePrice API. Click filter on 'error'. Now you can see which product listings have errors and are not created. 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.

Best practices

Adding multiple attribute values: when adding multiple values in an attribute field for Mirakl Marketplaces, separate each value with a pipe symbol "|" to ensure proper detection and processing.

Seller's Product ID for Single/simple products: Please note that there are two attributes named 'SellerArticleId' and 'SellerProductId,' respectively. 'SellerProductId' refers to the Parent ID, while 'SellerArticleId' refers to the variant items. For single products, both attributes must be filled with the same value.

For more information on Mirakl Marketplace errors, how-to's, and best practices, check out our dedicated guide. Click here to read more.