Setting up a Fnac Darty products API

Fnac Darty, a prominent French retail group formed by the merger of Fnac and Darty, specializes in a wide range of products. Fnac offers cultural and electronic items like books, music, films, video games, and consumer electronics, while Darty focuses on household appliances and consumer electronics.

Table of contents

1. Fnac Darty API connections explained
2. Preparation Step
3. Create a new Fnac Darty Products connection in Channable
4. Create a new Fnac Darty Products API in Channable
5. Create your product data in Channable
6. Send your product data to Fnac Darty
7. Check your product data for errors
8. Deactivate the Fnac Darty Products API

Fnac Darty API connections explained

There are two different connections and therefore separate API's for Fnac Darty that make a distinction between your product offer and your content.

• The Fnac Darty Offers connection: This API (which supports an order connection) allows you to sell products that are already known to Fnac or Darty, based on EAN codes. If your EAN codes/products are unknown to Fnac or Darty, the Fnac Darty offers API will show an error in the Preview step called "ERR_026: Product not found".
• The Fnac Darty Products connection: If Fnac Darty is unfamiliar with your EANs/products, you must add their data to the Fnac Darty database through the Fnac Darty Products API. This API is essential for initially submitting your EANs and for updating product information but does not require continuous activation.

In this article, we will guide you through setting up a Products API with the Fnac Darty platform using Channable.

Preparation Step

To ensure a smooth setup and avoid any issues, please review and follow these important guidelines:

1. Unknown EANs on Fnac Darty:
   This article assumes your EANs are unknown by Fnac Darty. If your EANs/products are known to Fnac Darty, please refer to our support article on how to send your known EAN codes/products to Fnac Darty.
2. Mandatory EANs: 
   EAN codes are mandatory for Fnac and Darty. Make sure you have valid EAN codes for all your products, otherwise, no product listings can be created for your products.
3. API credentials:
   To sell your products on Fnac Darty, you will need a professional seller account. Follow the account creation guidelines here (in French, under "Inscription et paramètres de compte"). Once you have signed up, contact Fnac Darty to obtain the Shop ID for Fnac and the Shop ID for Darty. Save these IDs as you will need them in the next step.
4. Channable connection:
   You can only create a connection with Fnac Darty France through Channable. Connections to other Fnac Darty countries are not supported at this time.

After completing and reviewing all the preparation points, you are ready to go to the first step.

Step 1: Create a new Fnac Darty Products connection in Channable 

The Fnac Darty Products API uses the Mirakl platform, which means you will need a Mirakl account to start sending your product data to Fnac.

To create a Fnac Darty Products connection, follow these steps:

1. Navigate to "Connections".
2. Click "+ Add a new connection".
3. Select "FNAC Darty products (not "FNAC Darty Offers").
4. Enter a label name, e.g., "Fnac Darty Products".

Click the ''Connect with Fnac'' button to save your connection.

Step 2: Create a new Fnac Darty Products API in Channable

To create a new API, go to your project and "APIs > + Add new API" and select the Fnac Darty Products connection you have previously created.

You will be redirected to the API settings, where you can choose the Name of your API and select the unique ID per item and the Country of France.

You can optionally decide to use a master rule group. Then, click on “Continue” to create the new Fnac Darty Products API. 

Step 3: Create your product listings in Channable

To set up your API, follow the steps outlined below. Click on each step to expand and view the detailed instructions, which will guide you through the entire process.

1. Categorization

2. Rules

3. Build step

The Build step in Channable allows you to configure all necessary attributes for your items, ensuring your product data aligns with marketplace requirements. This step is crucial for successful product listings and avoiding errors.

3.1 Overview

1. Access the Build step: Start by accessing the centralized interface of the Build step. This is where you will manage and map all product attributes.
2. Identify mandatory and optional Fields: Mandatory fields are highlighted in pink, indicating they are essential for listing your products. Optional fields are marked in orange and can be filled based on specific needs.

3.2 Populate Shared Attributes

1. Fill Shared Attributes: Enter common details that apply to all products, such as EAN, prices, and titles. This step ensures uniformity in basic product information across your listings.
   • Use static or dynamic Values:
     • Static Values: Directly input values that remain constant, like brand name or manufacturer.
     • Dynamic Values: Utilize fields that automatically update based on linked data, ideal for variables like stock levels or prices.

After you have filled in the desired values for the Shared attributes, continue to the Category specific attributes below.

3.3 Specify Category-Specific Attributes

1. Select product category: Choose the relevant category for your product, such as clothing or furniture.
2. Input Category - specific attributes: Fill in attributes that are specific to the selected category, such as size for clothing or dimensions for furniture. This step helps in fine-tuning your listings according to category requirements. Here you can again use static or dynamic values.

Click here to read more about the Build step.

4. Quality step

The quality step provides instant feedback on setup quality, highlighting mandatory and optional errors to ensure your product data meets the marketplaces' standards.

Actions

• View items: See products with specific issues.
• View in build: Redirects to the build step to map missing information.
• Set categories: Directs to the categories step to categorize items.
• Show source: Available for ID fields, directing to the settings step.

Click here to read more about the Quality step.

5. Preview step

The preview step displays mapped attributes for multiple items, highlighting errors before exporting to the marketplace.

Features

• Search & filter: Find specific products or filter by error message/category.
• Item overview: Shows all items to be exported; it can filter to show only items with errors.
• Detailed product preview: Displays missing information and dynamic actions to correct errors.

Checklist for finalizing attributes

• Review shared attributes: Ensure all mandatory shared attributes are filled.
• Review category-specific attributes: Ensure all mandatory category-specific attributes are filled.
• Check for errors: Correct any red-marked fields.

Click here to read more about the Preview step.

6. Result step

Additional Info for Fnac Darty Products

For the Products API, you only have to select your EAN field in the Build step, by clicking on the attribute itself. When you have selected the right EAN field, click “Save” at the bottom of the screen.

Step 4: Send your product data to Fnac Darty

Once all steps are completed, you are ready to send your product listings. Follow the instructions below to send your product listings:

1. Go to Settings > Project settings on the left-hand side of the screen.
2. Click 'Activate project'.
3. Navigate back to the APIs overview.
4. Go to “Your API Name” > Settings.
5. Select “Activate API” to activate the API.
6. Return to the APIs overview and click the blue “Run now” button to send your product listings.

Step 5: Check your product data for errors

If you have submitted your product data, processed to the Preview tab of your Fnac Darty Products API. Select 'filter on error'. You will now be able to view which product listings contain errors and have not been placed. Click on a specific error to view an explanation of what is causing the error.

Occasionally, the Products API might not create any products, and Fnac Darty may not send back any error messages to Channable. If this happens, there are two ways to obtain a more detailed error report:

How to download the error report in the Fnac platform

1. Navigate to the Fnac platform and go to 'Offers' > 'Add an offer'.
   
2. In the last processing report section, you’ll find the summary of your latest import, click on Download report located beside the Processing report heading.
   

How to download the error report in Fnac Darty Mirakl:

1. Log in to your Mirakl account and navigate to 'Catalog' > 'Product Imports'.
2. In the 'Product Imports' section, you will find a list of imports performed by Channable, along with their timestamps.
3. Click on the 'See details' button corresponding to the most recent import to access the latest error details.
4. Select 'Non-integrated products report' from the options presented. This will automatically download the error report. This article explains in greater detail how to obtain a Mirakl error report.

By following these steps, you can efficiently track and resolve any issues with your product listings on the Fnac Darty platform(s).

Step 6: Deactivate the Fnac Darty Products API

As previously mentioned, the Fnac Darty Products API only needs to be active for the initial EAN submission and content updates.

• Look at the Preview step of the Fnac Darty Offers API. For more info on the Fnac Darty Offers API, read this article.
• If you see the error “ERR_026: Product not found”, activate the Fnac Darty Products API.
  

If the error is not present in the Preview step, proceed to deactivate the Fnac Darty Products API.