But is a French online store specializing in furniture, home decor, and interior equipment. They offer a wide range of affordable products, including high-tech items and household appliances.
In this article, you'll learn how to set up a But channel to create and manage listings on But.
Before you start
You'll need:
- A Mirakl SSO account
Good to know
- But requires all listing descriptions to include important information related to the delivery of the product (e.g. shipping time, delivery method. Without this information, But will reject your listing.
Contents
- Step 1: Create a But connection
- Step 2: Configure your channel settings
- Step 3: Set up your product listings
- Additional requirements for But
- Step 4: Send your product listings to But
- Step 5: Check your product listings for errors
Step 1: Create a But connection
- In Channable, go to Projects > [Your project] > Channels.
- Click + Create channel.
- In the search bar, enter “But” and select But.
- Click + Add a new connection.
- At Connect with, click But to select it.
- For Label, give your connection a descriptive name (e.g. “But FR”)
- For Shop ID, paste the Shop ID for the platform you want to list on.
- Click Connect with But. You will be redirected to Mirakl to log in to your account and verify your connection.
- Confirm any permissions. You will be redirected back to Channable.
- Click Create to finalize your connection.
Step 2: Configure your channel settings
After creating your connection, you can set your But channel settings.
- For Name, give your channel a descriptive name.
- For Unique ID per item, select the field containing your product ids (this is often 'id').
- For Language, select the language your product data is in.
- For Use master rule group, select a master rule group to apply to your channel (if you have one).
- Click Save.
Step 3: Create your product listings in Channable
Follow these steps to set up your channel:
1) Categorize your products
Set up your product data by assigning categories to your products.
- Smart Categorization: Automatically assigns product categories using our algorithm.
- Manual Categorization: Manually assign product categories with custom rules. You can create detailed filters to map each product to their correct category.
- Uncategorized Items: Products that still need to be reviewed and categorized.
2) Set up rules
Rules help you quickly optimize your product data for your target marketplace.
- Rule templates: Commonly used rules you can adjust and customize for your needs.
- Rules setup: Set up rules to refine your product data. With rules, you can filter, modify, and/or enhance data fields to meet marketplace requirements.
3) 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 : Suggested to avoid errors
- Optional : Not required to list
Shared attributes
Shared attributes are the common fields that apply across your products, such as EAN, prices, and titles. Mapping your shared attributes ensures uniform and consistent product information across your listings.
-
Use static or dynamic Values:
- Static values: Fixed values that don’t change (e.g. brand name, manufacturer)
- Dynamic values: Fields that automatically update based on the linked data (e.g. stock, prices)
Category-specific attributes
Category-specific attributes fields that specifically apply to your product's categories. This step helps fine-tune your listings to meet category requirements for your marketplace.
Fill in attributes that are specific to the selected category (e.g. size for clothing or dimensions for furniture.)
Learn more about the Build step for marketplaces
Best practices for Mirakl marketplaces
Adding multiple attribute values: Separate multiple values in an attribute with a pipe symbol "|" for proper detection and processing.
Seller's Product ID for single/simple products: There are two attributes called SellerArticleId and SellerProductId. SellerProductId is the Parent ID, while SellerArticleId refers to variant items.
- For single products, both
SellerArticleIdandSellerProductIdmust be filled with the same value.
For more information on Mirakl Marketplace errors, how-to's, and best practices, check out our dedicated guide.
4) Check the quality of your set up
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.
- Solve errors, prioritizing mandatory errors first.
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.
5) Preview before activating
The Preview step displays the attributes you mapped in the Build step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.
Filtering:
- Filter by error: Click the All dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
- Filter by category: Click the All categories dropdown and 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 requirements for But
The following information is specific to But and includes details about the item tab and additional requirements.
Shared attributes
Item section
- Shipping class (logistic class): The logistic classes determine the respective shipping costs for your items. Enter the logistic class of your product.
- Lead time to ship: The shipping lead time indicates the time required until the package is handed over to the shipping. Indicate the shipping time in days.
- Eco-contributions: France introduced legislation for eco-participation. If your company is operating in France, you must add eco-contributions to your offers on the marketplace. In this article, you can find a list of available EPR categories.
- Price excl. VAT: Indicate the VAT, set the value to "20".
- Private Copy Tax: In France, the private copying levy is a legal requirement compensating authors and rights holders for private copies made using blank media such as CDs, DVDs, external hard drives, and USB drives. This levy is included in the sale price of these blank media items and is then distributed to the creators and rights holders through collective management organizations. Sellers must specify the amount of the ''copie-privée'' levy in euros for each applicable item in this category.
- Warranty list: Indicate the legal guarantee of 2 years, the "2-years" has to have a dash in between.
Title Requirements
- Maximum number of characters: 100 Characters Maximum
- Title structure: Product type, function, style, color, material, dimensions
- Brand name exclusion: Do not include the brand name in the title. Note: The trademark field is automatically placed before the title on the site.
- Dimensions: Specify units of measurement (e.g., H.10 cm). Do not use acronyms. Example: Ø
- No Commercial terms: Do not display terms like "Exclusive", "New", "Top seller", etc.
- Special characters: Do not include special characters (e.g., Greek letters, etc.).
- No leading dash: Do not start the title with a dash.
Image Requirements
- First visual: Must be on a white background, detoured (cut out)
- Positioning: Must be positioned either from the front or from a ¾ angle
- Number of visuals: Up to 6 visuals showcasing different angles (background photo, diagram, accessories, details, etc.)
- Recommended formats: 2000×2000 pixels, 3000×3000 pixels
Description Requirements
- Character limit: Ensure your product description does not exceed 8,000 characters to stay within the platform's guidelines.
- No External Links: Avoid including any links or references to external sites or shops within the product description.
- Use HTML for enhancement: HTML can be used to enrich your description, adding formatting and visual elements (Note: HTML is blocked on Mirakl by default; contact your account manager to enable it).
Step 4: Send your product listings to But
Once all steps are completed, you are ready to send your listings to But. Follow the instructions below to send your product listings:
- Select the Settings step in [your But channel].
- Click Activate API.
- Click Save.
- Click X to return to the Channel overview page.
- Click Run now to send your product listings to But.
Step 5: Check your product listings for errors
Go to the Result step and click on the Feedback tab. This page displays all possible processing errors your product data has at a given moment.
Resolving errors:
- In Description, click on the error name. This takes you to an overview of the products with that error.
-
In ID, click the ID number and scroll. You should see a red highlighted callout in the section where the error occurred. Hover over the callout for more information.
- If the error is a mapping error, click View in build to be directed to the attribute you need to map/re-map, which is highlighted in blue.
- For more information about the attribute and its accepted values, hover over .
- Resolve the error.
- Repeat for remaining errors. When you're ready, run your channel again by clicking Run now.
You can check your successfully listed products in the Successful tab.