To main website
  1. Help Center - Channable
  2. API's
  3. Mirakl API

Articles in this section

See more

Setting up a Fnac Darty offers API

Do you want to learn interactively all basics related to the creation of an API export, or how to make an advanced setup for an API in Channable? Learn how to create a Channacademy account in the Channable app through this Help Center article and start with the Basic APIs or Expert APIs course.

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 Offers connection in Channable
  4. Create a new Fnac Darty Offers API
  5. Create your product listings in Channable
  6. Send your product listings to Fnac Darty
  7. Check your product listings for errors

Fnac Darty API connections explained

There are two different connections and therefore separate APIs 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 API connection: If Fnac Darty is unfamiliar with your EANs/products, you must add your 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 constant activation.

In this article, we will guide you through setting up an offer 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. Known EANs on Fnac Darty:
    This article assumes your EANs are known by Fnac Darty. If your EANs/products are new to Fnac Darty, please refer to our helpcenter article on how to add unknown 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 Offers connection in Channable

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

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

Enter Shop ID

  • If you are creating a Fnac Darty Offers API to only sell products on Fnac, please fill in the Fnac Shop ID you have received. 
  • If you are creating a Fnac Darty Offers API to only sell products on Darty, please fill in the Darty Shop ID you have received.
  • If you wish to sell your products on both Fnac and Darty, you need to create two separate connections (one with Fnac Shop ID and the second with Darty Shop ID).
Sing_in_Mirakl_-_Oauth.png

Click the “Create” button to save your connection.

Step 2: Create a new Fnac Darty Offers API

To create a new API, go to your project and “APIs > + Add new API” and select the Fnac Darty offers 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.

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

Here as well, remember the scenarios previously mentioned: 

  1. To sell your products on Fnac, please create one API using the connection with the Fnac Shop ID you have set up in Step 1. 
  2. To sell your products on Darty, please create one API using the connection with the Darty Shop ID you have set up in Step 1. 

Step 3: Create your product listings in Channable

Note: In the coming months, we are gradually rolling out Marketplaces V2. If your API is on Marketplaces V1, these steps might be different. Refer to this article for more information!

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

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.

  • Smart Categorization: This feature automatically assigns categories to your products based on predefined criteria, simplifying the categorization process.
  • Manual Categorization: Manually assign categories to your products by setting specific rules. You can create detailed filters to map each product to the correct category.
  • Uncategorized Items: Review and categorize any items that remain uncategorized to ensure all products are properly organized.

Click here to read more about the Categorization in APIs.

2. Rules

Create different rules to optimize your product data. For examples, refer to our common rules support article for guidance.

  • Rules Setup: Set up various rules to refine your product data. This can include filtering, modifying, or enhancing data fields to meet marketplace requirements.

Click here to read more about the Rules in APIs.

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

The result tab provides an overview of your API setup outcomes, including successful uploads, errors, and a preview of the products to be listed. This tab ensures your product data is correctly processed and identifies any issues that need resolution.

  • Overview: The result tab shows the status of your product listings, highlighting errors and issues for detailed insights.
  • Preview products: Displays an overview of products to be sent to the marketplace, allowing verification of correctly filled attributes.
  • Successful: Lists products successfully processed and ready for listing, confirming compliance with marketplace requirements.
  • Errors: Identifies errors during processing, providing detailed information to troubleshoot and resolve issues.

Optional tabs like repricer errors, repricer event history, stock updates, and fulfillment updates appear only if relevant to the API you are using. Click here to read more about the Result step.

Step 4: Send your product listings 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 listings for errors

If you have sent your product listings to Fnac Darty go to the Preview tab of your API. Now you can see which product listings have errors and are not online yet.

A common error in the Fnac Darty offers API is the "ERR_026: Product not found" error, this means that your products are not known on Fnac Darty. To solve this error read our support article on how to add unknown EANs/products to Fnac Darty.

Click on a specific error to see more information on what is causing the error. 

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.