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:
- 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.
- On the connections page, select "+Add a new connection".
- Search for the 'Miravia' connection by clicking through the pages, after finding the 'Miravia' connection, provide a label for this new connection.
- 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.
-
Configure API settings:
- Name your API
- Select the language of your API
- Choose the "Unique ID per item". (we recommend the 'id' field)
- Create API: Click on "Continue" to create the new Miravia API.
Step 3: Create your product listings
Follow these steps to set up your channel:
1. Categorize your products
To set up your product data, assign categories to your products.
- Smart Categorization: Automatically assigns product categories through our algorithm.
- Manual Categorization: Manually assign product categories with custom rules. You can create detailed filters to map each product to the 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 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. This can include filtering, modifying, or enhancing 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 : Recommended 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. This step ensures uniformity in basic 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 change based on the linked data (e.g. stock, prices)
Category-specific attributes
Category-specific attributes fields that specifically apply to the category for your products .This step helps in fine-tune your listings to meet category requirements for your marketplace.
Fill in attributes that are specific to the selected category (e.g. such size for clothing or dimensions for furniture.)
Learn more about the Build step for marketplaces
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 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] > Feedback 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.