Miravia is a Spanish marketplace that blends traditional ecommerce with content creation. It allows customers to both discover and purchase a range of products, with a focus on fashion, beauty and lifestyle goods.
In this article, you’ll learn how to set up a Miravia channel in Channable to create, manage, and list products on Miravia.
Before you start
You’ll need:
- A Miravia seller account with only one region (Spain) enabled
Important considerations
- Currently, Channable only supports sending one price per item.
- Italy and Portugal are currently not supported regions
- Enabling the multi-pricing feature in Miravia may lead to pricing inconsistencies that could impact your profit margins.
Contents
- Step 1: Create a Miravia channel
- Step 2: Create your product listings
- Additional requirements for Miravia
- Step 3: Connect to Miravia
- Step 4: Send your product listings to Miravia
-
Step 5: Check your product listings for errors
Step 1: Create a Miravia channel
- In Channable, go to Projects > [Your project] > Channels.
- Click + Create channel.
- In the search bar, enter “Miravia” and select Miravia.
- Set your channel settings:
- For Name, give your channel a descriptive name.
- For Unique ID per item, select the field containing your product ids.
- 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 2: Create 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.
- AI product 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 section outlines specific requirements and considerations for creating product listings for Miravia.
Shared attributes
Item
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 field.
Shipping
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 the values are unknown, set them 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 “Delivery by Miravia” for more information.
Default values
If the shipping values are unknown, set them all to 1 using a rule.
Images
Image linking
Link the field(s) containing your images in the Images attribute.
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.
Attributes per category
DSA requirements
Step 1: Register Manufacturer & Responsible Person Details
- In your Miravia seller central account, go to Manufacturer Information Management.
- In the Manufacturer information tab, provide your manufacturer details and click Submit.
- Miravia will generate a Manufacturer ID. Note this ID, as you’ll need it in the next step.
- Click on the EU responsible person information tab.
- Provide details for your responsible person within the EU. Click Submit.
- Miravia will generate a EU responsible person ID. Note this ID, as you’ll need it in the next step.
Step 2: Provide your IDs in Channable
- In [your Miravia channel], go to the Build step.
- Click on the Attributes per category tab and select a category. A list of category-specific attributes will appear.
- For EU Responsible, click the field and paste/fill in your EU responsible person information ID.
- For Manufacturer info, click the field and paste/fill in your Manufacturer ID.
- Click Save.
- Repeat this for each category.
General Product Safety Regulations (GPSR)
Sellers must indicate if the product has safety warnings. If yes, the following attributes must be filled in:
Does the Product Have A Safety Warning?
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.
Package/Label Photo (EU)
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
Product Compliance Certifications
Some attributes only appear if your product belongs to certain categories. These attributes allow you to submit relevant certifications, such as CE certificates and testing reports.
- 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.
Step 3: Connect to Miravia
To send your listings to Miravia, you need to connect your channel to your Miravia seller account.
- Log in to your Miravia seller account.
- In [your Miravia channel], go to Settings.
- At Linked seller account, click Select seller account.
-
Select an existing seller account, or click + Add new connection to add a new seller account.
-
If adding a new seller account:
- For Label: Name your seller account connection.
- Click Connect with Miravia.
-
If adding a new seller account:
- We'll send you to Miravia to log in to your account and accept any required permissions.
- You will be asked to confirm several permissions. Fill in the requested details and click Authorize.
Step 4: Send your product listings to Miravia
- Select the Settings step in [your Miravia channel].
- Click Activate API.
- Click Save.
- Click Run now to send your product listings to Miravia.
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.
Common Miravia errors
Description:
This error occurs when you’re trying to list products with the same SKU (e.g. a shirt with different size options), but Miravia can’t distinguish between the different types.
To list a product with multiple SKUs, you need to create specific variants (e.g. different size, color) so they are distinguishable from one another.
Each variant must be unique within its group. For example, if a red shirt is available in size M, it must be the only variant with that combination in that group.
Solution:
Ensure any products using the same base SKU are in groups that contain unique combinations for each variant.
This error may be caused by one of three possibilities:
- Product missing an EAN: A message will appear stating that a mandatory field is missing.
- EAN already used by another SKU in your store: EAN codes need to be unique for each product. The second possibility is if you try to list a product with an EAN code that is already being used by another SKU in your store. The reasoning behind this error is that an EAN code needs to be unique for each product. You might also see this error with the name: THD_IC_ERR_F_IC_INFRA_SPU_036 or with error code 4142. For the second option, no action is required, as the error will resolve on its own within a period of up to 24 hours.
- The third possibility could be a message stating THE_FIELD_OF_EAN_CODE_HAS_AN_ERROR_PLEASE_CHECK, indicating that the format of the EAN is invalid. Please make the necessary corrections.
Concurrent product edit is not allowed.
Product subject to a promotion: This product is eligible for a promotion offered by Miravia, where the product data is frozen to ensure it meets the criteria for the promotion. No action is required.
You are attempting to update the information of a product group while simultaneously trying to add a new variation.
Solution
Exclude the new variant you want to add, run your channel to update it, and include the new variation in your next run (after ensuring that the rest of the variants have no errors).