Setting up a fonQ API

Note: This article assumes you have already advertised on fonQ with your products. If you are new to advertising on fonQ, make sure you know how to add unknown EAN codes to fonQ. EAN codes are mandatory for fonQ. Ensure that you have valid EAN codes for all your products, otherwise no product listings can be created for your products.

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.

You can jump to the detailed steps below:

1

Step 1: Add a new fonQ connection

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

When you have a Mirakl fonQ account, go to Connections > Add connection. Click on "+ Add a new connection" and select fonQ. Fill in the label for your connection (for example: fonQ). Then click "Connect with fonQ". 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.

2

Step 2: Create a new fonQ API in Channable

Go to the APIs overview in your project and click "+ Add new API". Select the fonQ connection you 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 Country you want to sell in. You can also add a master rule group here if desired. Click Continue to finish creating the new fonQ API.

Difference between an Offer and a Product in the fonQ API:

• Offer: An offer only includes the fields in the Build step of the API.

• Product: A product has more information than an offer (such as filled-out categorisation and attributes) and is needed when items are unknown to fonQ.

Note: fonQ NL ONLY accepts Product submissions to NL-based shops. If your shop is not an NL shop then you should send offers by not categorizing your data.

If your products are not known to fonQ and you do not have an NL shop, you'll need to create an NL shop and set up a Product API for unknown products (categorize and push them to the NL shop). Once accepted, you can set up a second API to create BE offers, but this may also create offers in the NL store; to avoid that, you might need to clear the NL API once the products have been accepted.

3

Step 3: Create your product listings in Channable

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

1

Categories

We advise to first try to send your products without doing the categories. If fonQ is already familiar with the EAN codes of your products, you will not need to do this step. If the products are not yet known, you will see the following error in the Preview step of the API: "mirakl_unknown_error_code".

2

Rules

Create different rules to optimize your product listings.

3

Build

Here you can find our preset template for the product listings. Fill it out by clicking on a field and selecting the value you want it to be filled with (for example, set the Title field to display your product title). When finished, click Save at the bottom of the screen.

Tip: Hover over for more information on specific field requirements.

4

GPSR and DSA requirements

The European Union (EU) has introduced new GPSR and DSA requirements for online platforms, including marketplaces.

For your fonQ API in Channable, make sure to fill attributes per category tab in the Build step :

• Adres Marktdeelnemer: Provide the complete address of the manufacturer or importer.

• Email Marktdeelnemer: Enter the email address of the manufacturer or importer.

• Naam Marktdeelnemer: Provide the name of the manufacturer or importer.

• Telefoon Marktdeelnemer: Provide a valid phone number for the manufacturer or importer.

5

Step 4: Send your product data to fonQ

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

6

Step 5: Check your product listings for errors

After sending your product listings to fonQ, go to the Preview tab of your fonQ API and click on Errors. You can see which product listings have errors and are not created. Click on a specific error to see more information.

Best practices

Click to expand 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, check out our dedicated guide.