Setting up a Miravia API

To get started on selling your products on the Miravia Marketplace, you will need to have a Miravia seller account. If you don't have a Miravia seller account yet, we advise you to reach out to Miravia to obtain this. Once you have a Miravia seller account, you can connect with Channable.

Table of contents

• Step 1: Create a new connection
• Step 2: Create the API
• Step 3: Create your product listings
• GPSR requirements
• Step 4: Send your product listings to Miravia
• Step 5: Check your product listings for errors

Step 1: Create a new connection

To create a new Miravia connection, follow the steps below:

1. Begin by navigating to the API page within your project and click on the "+Add new API" button. This action will redirect you to your company's connections page.
   
2. On the connections page, select "+Add a new connection".
3. Search for the 'Miravia' connection by clicking through the pages, after finding the 'Miravia' connection, provide a label for this new connection.
   
4. Click on "Connect with Miravia" You will be redirected to Miravia for the next step. Once redirected, log in using Miravia credentials.

After successfully logging in, the connection with Miravia is established and available for use! You will be brought back to the API setup.

Step 2: Create the API

Once back, you have to select your new connection with Miravia and continue setting up your API.

1. Configure API settings:
   • Name your API
   • Select the language of your API
   • Choose the "Unique ID per item". (we recommend the 'id' field)
     
     
2. Create API: Click on "Continue" to create the new Miravia API.

Step 3: Create your product listings

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

1. Categorization

2. Rules

3. Build step

The Build step 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.

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.

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.

Read more about the Preview step.

6. Result step

Additional requirements for Miravia

The following information is specific to Miravia, we discuss what you should look out for.

Item tab

• Item group ID: This field is used to group multiple variant items into a single listing. If there are no multiple variants, select the item’s unique ID for the item_group_id.

Shipping tab

• Required fields: Ensure all shipping information fields, such as weight, length, and content, are completed with values greater than 0 and with no more than 2 decimals. If unknown, set these values to 1 using a rule.
• Delivery by seller: Set this option to “Yes” only with prior authorization from Miravia; otherwise, set it to “No” to avoid errors. Refer to the article on utilizing “Delivery by Miravia” in Channable for detailed information.
• Default values: If the shipping values are unknown, set them all to 1 using a rule.

Images tab

• Image linking: Link the field(s) containing your images in the Images tab.
• Image requirements: Adhere to Miravia’s strict image requirements for both the URL and the image itself. Non-compliance will result in a "Could not upload image due to: .. E302: "Description of error" error, in the results tab. 
  

GPSR and DSA requirements

How to add DSA information In Channable

The European Union (EU) has introduced new GPSR and DSA requirements for online platforms, including marketplaces.

Step 1: Register Manufacturer & Responsible Person Details

Create profiles in Seller Central and navigate to the Manufacturer Information management page. You will find two tabs:

• Manufacturer Information
• EU Responsible Person Information

In the Manufacturer Information tab, add the details of the manufacturer. In the EU Responsible Person tab, add the details for the responsible person within the EU. Below are screenshots of the process.

Once completed, you will receive a Manufacturer ID and an EU Responsible Person ID. These IDs are crucial for the next step. If anything is unclear, you can reach out to Miravia for more information.

Step 2: Fill in the the Manufacturer & Responsible Person attributes with the newly received ID's

With the required IDs from Step 1, you can begin filling out the attributes in Channable. In Channable, use the following attribute names:

• Manufacturer Info: The registered ID of the manufacturer.
• EU Responsible: The registered ID of the responsible person associated with the product.

To fill in these attributes, navigate to [Your Miravia API] > Build > Category-Specific Attributes. Click on a category and search for the mentioned attributes. Enter the IDs obtained from Seller Central in the attributes and click Save.

General Product Safety Regulations (GPSR)

In addition to DSA compliance, Miravia has added fields related to product safety.

Safety Warnings

Sellers must indicate if the product has safety warnings. If yes, the following attributes must be filled in:

• Does the Product Have Safety Warning?: Add "Yes/No". If "Yes", make sure to add the necessary safety information at the Safety Warning Content attribute.
• Safety Warning Content: Provide the safety warning content here.

Physical Packaging Label

You must provide a product label that includes the necessary details, each item must also include a labeled picture. The physical packaging label must contain:

• Information about the manufacturer (and EU responsible person, if the manufacturer is not based in the EU)
• Product identification information
• Any markings or safety warnings

In Channable, you can find this attribute in the Category-Specific attributes section under Package/Label Photo (EU).

Product Compliance Certifications

Miravia has introduced additional category-specific attributes that will only appear in Channable if your products belong to certain categories. These attributes allow you to submit relevant certifications, such as CE certificates and testing reports. Available attributes vary based on the product category.

• CE Certificate
• ECE Certificate
• CPNP Certificate
• RoHS Testing Report: Checks if electronic products comply with regulations on harmful substances.
• REACH Report: Confirms chemicals in products meet EU rules across the supply chain.
• BPR Registration Certificate: Shows approval for using antibacterial products under EU laws.
• EU Food Contact Materials Test Report (FCM): Confirms materials are safe for food contact in the EU.

For certain categories, specific test reports are also required, such as:

• PIF document: Complete file with info needed for EU cosmetic sales.
• EMC/LVD test report: Validates compliance with rules on electromagnetic safety.
• EMC test report: Checks a product doesn't cause electromagnetic interference.
• EN71 test report: Proves toys are safe according to EU standards.
• R44 test report: Certifies child car seats meet UN safety rules.
• Building product test report: Confirms construction materials meet EU standards.
• MDR test report: Shows medical devices follow EU regulations.
• Soother test report (EN1400:2013): Verifies pacifiers are EU-safe.
• PPE test report: Ensures personal protection gear meets EU standards.
• EN62115: Makes sure electric toys are safe.
• RED test report: Confirms wireless devices follow the Radio Equipment Directive.

For further details about the EU regulations and compliance, please refer to this article or contact Miravia for assistance.

Step 4: Send your product listings to Miravia

Almost there, your product listings are ready to be sent. If you have not activated your project, go to your project settings on the left-hand side of the screen and click "Activate project". 

After, go back to the APIs overview and go to [Your Miravia API] > Settings, where you activate the API by clicking "Activate API".

Once you have activated the API, navigate back to the API overview and click on the blue "Run now" button to send your product listings to Miravia.

Step 5: Check your product listings for errors

To check for errors, navigate to the [Result page of the API] > Errors tab, where you see which product listings have errors. By clicking on the specific, it will display more information on what is causing the error. For more information about what the errors mean, read this article.