How do the two different Fnac API connections work?
These two connections make a distinction between your offer and your content. The Offers+Orders API allows you to send through products that are already known by Fnac, based on EAN codes.
If your EAN-codes are unknown, the Offers+Orders API will show an error in the Preview step called "ERR_026: Product not found". This implies that Fnac doesn't know your products and you will have to add the product data of these products to the Fnac database. To add this product data to Fnac we have developed the Fnac Products API. Follow the steps below to set up this API.
Setting up the fnac Products API
Important! For now, it's possible to use Fnac Products API only for the Fnac French accounts. If your Fnac account is from another country you will not be able to create an API key from your account, so you will not be able to use the Fnac Products API. To send new products you will have to do it through the templates Fnac provides and you can get them from your Fnac contact person.
Step 1: Add a new Fnac Products connection
The Fnac Products API uses the Mirakl platform, which means you will need a Mirakl- account to start sending your product data to Fnac.
When you have a Mirakl Fnac account, go to "[Your company] settings menu (in the top right corner) > Connections > Add connection". Click on "+ Add a new connection" and you will see a screen, where you can select Fnac Products. Fill in the label for your connection, for example: Fnac products. And then click on ''Connect with Fnac''. You will be redirected to the environment where you can login with your Mirakl-credentials. After logging in, you will be redirected back to Channable where the connection will be available.
Step 2: Create a new fnac Products API in Channable
Now go to the API's overview, in your project. And click on add new API, select the fnac products connection you just made. You will see an overview where you will see two Fnac connections that you can select. Be sure to select the connection named "Fnac Products", not the one named "Fnac Offers".
Fill in the name for the connection under "Name", we recommend naming the connection Fnac Products 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. You can also add a master rule group here if you would like. Click on "Continue" to finish creating the new fnac API.
Step 3: Create your product data in Channable
Once you have created the Fnac Products API you can set up 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 product data. For example, 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' 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.
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.
Step 4: Send your product data to fnac
Almost there, your product listings are ready to be sent. If you have not activated your webshop go to Settings > Project settings on the left-hand side of the screen and click 'activate webshop'. After, go back to the APIs overview and go to "Your Fnac 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 Fnac.
Step 5: Check your product data for errors
If you have sent your product data to Fnac go to the Preview tab of your Fnac Products 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.
Step 6: Deactivate the fnac Products API
It is not necessary for the Products API to be activated the entire time since it is only used for updating the content of the products. Check the Preview step of the Fnac Offers+Orders API (if you do not have a Fnac Offers+Orders API yet, see our support article) to see if there is an error called "ERR_026: Product not found". If the Preview shows this error the Fnac Content API should be activated. If the Preview does not show this error, the Fnac Content API should be deactivated.