Setting up an Obelink API

Obelink is one of the largest camping stores with a huge range of tents, caravans, motor homes, camping supplies, accessories, garden furniture and sports. This article will go through the steps of setting up an Obelink API within the Channable tool.

UI update: There is a new channel selection page and overview for Feeds and Marketplaces (previously called APIs)! Some visuals and instructions may not be up-to-date.

Add a new Obelink connection

The Obelink API uses the Mirakl platform, which means you will need a Mirakl account to start sending your product listings to Obelink.

When you have a Mirakl Obelink account, go to "[Your company] settings menu > Connections > Add connection". Click on "+ Add a new connection" and select Obelink. Fill in the label for your connection (for example, Obelink). Then click on "Connect with Obelink". You will be redirected to the environment where you can log in with your Mirakl credentials. After logging in, you will be redirected back to Channable where the connection will be available.

Add a new Obelink API in Channable

Go to the APIs overview in your project and click Add new API. Select the Obelink connection you just created and give your new API a name

Select the field you want to use for Unique ID per item (we recommend the 'id' field), and the Language in which you do categorizations and setup attributes. You can also add a master rule group here if you want. Click Continue to finish creating the new Obelink API.

Create your product listings in Channable

Once you have created the Obelink API, set up your product data by following the steps of the API:

1

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.

2

Rules

Create different rules to optimize your products listings.

3

Build - Shared attributes

Shared attributes are attributes that apply across all your items, like price and stock.

1. Start by mapping fields to attributes marked as required by the marketplace.

2. Check the remaining attributes and map fields to ones relevant for your business.

3. Click Save.

4

Build - Attributes per category

Category attributes are attributes that apply to items from specific categories, like battery information for electronic items, or sizing information for clothing.

1. Start by mapping fields to attributes marked as required by the marketplace.

2. Check the remaining attributes and map fields to ones relevant for your business.

3. Click Save.

1

Under Static values for shipping class there are 3 values. In the table below you will find these values and their explanations:

Code	Label	Explanation
SP	Small parcel	Max weight 3 kg; max length 50 cm and a max circumference (2xw + 2xh + 1xl) of 111 cm
NP	Normal parcel	Max weight 31,5 kg; max length 175 cm and a max circumference (2xw +2xh +1xl) of 300 cm
NSP	Non standard parcel	Parcel has longer length or diagonal than 130 cm; and/or weight >35 kg; and/or parcel unstable, irregular shape (sphere, cylinder, roll)

If this value differs for some products, you can dynamically fill this field.

Notes:

• Obelink also has an additional offer field called Supplier SKU. Some partners require this attribute to complete the order. This field is added as an additional offer field in the build step. If you have a Supplier SKU, fill it in here; otherwise you can leave it empty.

• Obelink has multiple sales channels: obelink.nl, obelink.be and obelink.de. They don't support channel-specific pricing, so the channel selection pop-up on the API settings page and the extra tab in the build step are not shown. Channels need to be enabled/disabled in your Mirakl back-end here or go to settings > Partner > Channels

2

Attributes

Fill in the fields in the Attributes step. This is important when selling new products that do not exist on the marketplace yet — it helps prevent the mirakl_unknown_error_code. Select the category you want to optimize first.

A more detailed explanation of what to do in the Attributes step can be found here: Marketplaces: Build step

Send your products to Obelink

If you have not activated your project, go to Setup > Project settings on the left-hand side of the screen and click Activate project. Then go back to the APIs overview, open "Your Obelink API Name > Settings" and activate the API by selecting Activate API. After that, go back to the APIs overview and select the blue "Run now" button to send your product listings to Obelink.

Check your product listings for errors

After sending your product listings to Obelink, go to the Results tab of your Obelink API. Use the filter on 'error' to see which product listings have errors and are not placed. Click a specific error to see more information about the cause. If you solve errors by changing settings or product information, re-run the Obelink API to see the updated results. Creating new products often results in errors in the Results tab until they are approved by Obelink.

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: There are two attributes named SellerArticleId and SellerProductId. 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, see the Mirakl guide: Mirakl guide: settings and solutions