Setting up a Galeries LaFayette API
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.
Galeries LaFayette welcomes more than one million visitors per day in its 280 stores and its online shopping websites. The Galeries Lafayette group is actively engaged in promoting and spreading the French “Art of Living”.
Important: EAN codes are mandatory for Galeries LaFayette. Make sure you have valid EAN codes for all your products; otherwise, no product listings can be created for them.
Step 1: Add a new Galeries LaFayette connection
The Galeries LaFayette API uses the Mirakl platform, which means you will need a Mirakl account to start sending your product listings to Galeries LaFayette.
When you have a Mirakl Galeries LaFayette account, go to “Connections > Add connection”. Click on “+ Add a new connection” and select Galeries LaFayette. Fill in the label for your connection (for example, Galeries LaFayette) and click on "Connect with Galeries LaFayette". 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 Galeries LaFayette API in Channable
Go to the APIs overview in your project. Click on "+ Add new API", select the Galeries LaFayette 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 for categories (currently only French is available). You can also add a master rule group here if you want. Click “Continue” to finish creating the new Galeries LaFayette API.
Step 3: Create your product listings in Channable
Follow these steps to set up your channel:
Categorize your products
To set up your product data, assign categories to your products.
AI product categorization: Automatically assigns product categories through our algorithm.
Manual Categorization: Manually assign product categories with custom rules. Create detailed filters to map each product to the correct category.
Uncategorized Items: Products that still need to be reviewed and categorized.
Set up rules
Rules help you quickly optimize your product data for the marketplace you want to sell on.
Rule templates: Commonly used rules you can adjust for your use case.
Rules setup: Set up rules to refine your product data (filtering, modifying, or enhancing data fields to meet marketplace requirements).
Build your listings
The Build step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.
Mandatory and optional fields:
Mandatory fields: Required to list your products on this marketplace
Recommended: Recommended to avoid errors
Optional: Not required to list
Shared attributes:
Shared attributes are the common fields that apply across your products (e.g., EAN, prices, titles).
Use static or dynamic values:
Static values: Fixed values that don’t change (e.g., brand name)
Dynamic values: Fields that change based on linked data (e.g., stock, prices)
Category-specific attributes:
Fill in attributes that are specific to the selected category (e.g., size for clothing or dimensions for furniture).
Tip: Click Auto-map fields to automatically map using information using information from your other channels or other similar setups. Learn more.
Check the quality of your setup
The Quality step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.
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. Directs to the Settings step.
Prioritize solving mandatory errors first.
Preview before activating
The Preview step displays the attributes you mapped in the Build step and provides an overview of your products and potential errors.
Filtering:
Filter by error: Use the All dropdown to display only products with errors, or products with a specific error.
Filter by category: Use the categories dropdown to select the category you want to filter by.
Before you continue:
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.
Additional information for Galeries LaFayette
Shipping class: Logistic classes for Galeries LaFayette are available as static values under the “Shipping class” field. Shipping classes are configured for each seller with your Onboarding Manager for Galeries LaFayette.
Event code: Unique code to identify offers for specific promotions. Your Account Manager at Galeries LaFayette will provide this code before promotional events; enter it in the Event code attribute.
Private copy levy: Sellers must specify the amount of the "copie-privée" levy in euros for applicable blank media items.
Eco-contributions: If operating in France, you must add eco-contributions to your offers. See available EPR categories in this article.
Private Sales Channel: To use different pricing for loyalty customers in the 'vp' channel, channel-specific pricing (Private Sales Channel) is enabled. Follow the steps in this article.
Step 4: Send your product data to Galeries LaFayette
If your product listings are ready, activate your project in Project settings (left-hand side) by clicking "activate project". Then go back to the APIs overview, open “Your Galeries LaFayette API Name > Settings” and activate the API by selecting “Activate API”. After that, navigate back to the APIs overview and select the blue “Run now” button to send your product listings to Galeries LaFayette.
Step 5: Check your product listings for errors
After sending your product listings to Galeries LaFayette, go to the Preview tab of your Galeries LaFayette API and filter by "error". You can see which product listings have errors and are not placed. Click on a specific error for more information about what is causing it.
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
SellerArticleIdandSellerProductId.SellerProductIdrefers to the Parent ID, whileSellerArticleIdrefers to 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.
Last updated
Was this helpful?