How to set up a Miravia channel

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.

Step 1: Create a Miravia channel

1. In Channable, go to Projects > [Your project] > Channels.
2. Click + Create channel.
3. In the search bar, enter “Miravia” and select Miravia.
4. Set your channel settings:

   1. For Name, give your channel a descriptive name.
   2. For Unique ID per item, select the field containing your product ids.
   3. For Language, select the language your product data is in.
   4. For Use master rule group, select a master rule group to apply to your channel (if you have one).
5. Click Save.

Step 2: Create product listings

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

1. In your Miravia seller central account, go to Manufacturer Information Management.
2. In the Manufacturer information tab, provide your manufacturer details and click Submit.
3. Miravia will generate a Manufacturer ID. Note this ID, as you’ll need it in the next step.
4. Click on the EU responsible person information tab.
5. Provide details for your responsible person within the EU. Click Submit.
6. 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

1. In [your Miravia channel], go to the Build step.
2. Click on the Attributes per category tab and select a category. A list of category-specific attributes will appear.
3. For EU Responsible, click the field and paste/fill in your EU responsible person information ID.
4. For Manufacturer info, click the field and paste/fill in your Manufacturer ID.
5. Click Save.
6. Repeat this for each category.

Note: If you work with multiple manufacturers or responsible persons, you’ll need to create a new project field, populate it with a rule, and map it instead of filling in the ID.

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.

Important: Nothing will change by linking your account - any existing listings stay exactly the same until you activate.

1. Log in to your Miravia seller account.
2. In [your Miravia channel], go to Settings.
3. At Linked seller account, click Select seller account.
4. Select an existing seller account, or click + Add new connection to add a new seller account.

   1. If adding a new seller account:

      1. For Label: Name your seller account connection.
      2. Click Connect with Miravia.
5. We'll send you to Miravia to log in to your account and accept any required permissions.
6. You will be asked to confirm several permissions. Fill in the requested details and click Authorize.

Step 4: Send your product listings to Miravia

1. Select the Settings step in [your Miravia channel].
2. Click Activate API.
3. Click Save.
4. 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:

Important: Not all errors prevent your products from listing. We recommend following the steps and using your Successful tab as the source of truth.

1. In Description, click on the error name. This takes you to an overview of the products with that error.
2. 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.

   1. 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.
   2. For more information about the attribute and its accepted values, hover over .
3. Resolve the error.
4. 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

CHK_SKU_PROPS_DUPLICATE

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.

EAN_code

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 missing image

• EAN already used by another SKU in your store: EAN codes need 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 this option, no action is required, as the error will resolve on its own within up to 24 hours.

EAN duplicate image

• THE_FIELD_OF_EAN_CODE_HAS_AN_ERROR_PLEASE_CHECK: Indicates that the format of the EAN is invalid. Please make the necessary corrections.

THD_IC_ERR_F_IC_SERVICE_EDIT_002

Description: Concurrent product edit is not allowed.

Possible reasons:

• 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).