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.

Step 1: 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 you will see a screen, where you can 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.

Step 2: Add a new Obelink API in Channable

Now go to the API's overview, in your project. And click on Add new API, Select the Obelink connection you just made, 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 on "Continue" to finish creating the new Obelink API.

Step 3: Create your product listings in Channable

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

1. Categories
   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.
   
   
2. Rules
   Create different rules to optimize your product data. Take a look at our common rules support article for some examples.
   
   
3. Build
   In the build step, you have to set up the offer information for your products. 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 'Price' 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 behind every field, if you hover over the question mark you will see the description of the field and suggestions for possible values.
   Under Static values for shipping class 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)

   Of course, if this value is different for some of your products, you can dynamically fill this field.
   
   Note I: Obelink also has an additional offer field, called Supplier SKU. Obelink specified that some partners require this attribute to complete the order. So this field is added as an additional offer field in the build step. If you have this Supplier SKU, you can fill it in here, if you don't you can leave it empty. 
   Note II: Obelink has multiple sales channels: obelink.nl, obelink.be and obelink.de, however they don't support channel specific pricing, so we don't show the channel selection pop-up on the API settings page and the extra tab in the build step. Channels need to be enabled/disabled in your Mirakl back-end here or go to settings > Partner > Channels
4. Attributes
   Next up is filling in the fields in the Attributes step. This is very important if you want to sell new products that do not exist on the marketplace yet, and it will prevent the 'mirakl_unknown_error_code'. 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.

Step 4: Send your products to Obelink

Almost there, your product listings are ready to be sent. If you have not activated your project, go to Setup > 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 Obelink API Name" > Settings, where you activate the API by selecting "Activate API". After you have completed this step, navigate back to the APIs overview and select the blue "Run now" button to send your product listings to Obelink.

Step 5: Check your product listings for errors

After you have sent your product listings to Obelink, go to the Results tab of your Obelink API. Click in the 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. If you have solved some errors by changing the settings or product information, re-run the Obelink API to see the new results. Creating new products always results in errors in the result 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: 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.