# 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** <a href="#h_01k1z2v46a02s6sdbkm31k77ys" id="h_01k1z2v46a02s6sdbkm31k77ys"></a>

**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** <a href="#h_01k1z1a9mhfyybvybfjy7gpqep" id="h_01k1z1a9mhfyybvybfjy7gpqep"></a>

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** <a href="#h_01k1z1a9mvbm6n7tzy9cdeja8h" id="h_01k1z1a9mvbm6n7tzy9cdeja8h"></a>

### **Additional requirements for Miravia** <a href="#h_01k1z1fw2dbynae6fa7kv4cm2d" id="h_01k1z1fw2dbynae6fa7kv4cm2d"></a>

The following section outlines specific requirements and considerations for creating product listings for Miravia.

#### **Shared attributes** <a href="#h_01k1z1fw2edg4sxpz5vmxgvnmd" id="h_01k1z1fw2edg4sxpz5vmxgvnmd"></a>

<details>

<summary><strong>Item</strong></summary>

**Item group ID**&#x20;

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.

</details>

<details>

<summary><strong>Shipping</strong></summary>

**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.\
&#x20;

**Delivery by seller**&#x20;

Set this option to “Yes” only with prior authorization from Miravia; otherwise, set it to “No” to avoid errors.&#x20;

Refer to [“Delivery by Miravia”](https://helpcenter.channable.com/hc/en-us/articles/9900447518866-How-do-I-use-Delivery-by-Miravia-through-Channable) for more information.\
&#x20;

**Default values**

&#x20;If the shipping values are unknown, set them all to 1 using a rule.

</details>

<details>

<summary><strong>Images</strong> </summary>

**Image linking**

&#x20;Link the field(s) containing your images in the **Images** attribute.

**Image requirements**

&#x20;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.&#x20;

</details>

#### **Attributes per category** <a href="#h_01k1z254sqgm6s0n0jrvwa49gp" id="h_01k1z254sqgm6s0n0jrvwa49gp"></a>

<details>

<summary><strong>DSA requirements</strong></summary>

**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.

&#x20;

**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.

{% hint style="info" %}
**Note:** If you work with multiple manufacturers or responsible persons, you’ll need to [create a new project field](https://channable-test.gitbook.io/channable-test-docs/getting-started/fields-in-channable/map-and-add-fields#add-a-new-project-field), populate it with a [rule](https://channable-test.gitbook.io/channable-test-docs/manage-improve-product-data/rules-bulk-edit-and-enrich/using-rules), and map it instead of filling in the ID.
{% endhint %}

</details>

<details>

<summary><strong>General Product Safety Regulations (GPSR)</strong></summary>

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)**&#x20;

You must provide a product label that includes the necessary details. Each item must also include a labeled picture.&#x20;

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.&#x20;

* **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.\
  &#x20;

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.\
  &#x20;

</details>

### **Step 3: Connect to Miravia** <a href="#h_01k1z1a9mqwqjhskvvh19mmbw1" id="h_01k1z1a9mqwqjhskvvh19mmbw1"></a>

To send your listings to Miravia, you need to connect your channel to your Miravia seller account.&#x20;

{% hint style="warning" %}
**Important:** Nothing will change by linking your account - any existing listings stay exactly the same until you activate.
{% endhint %}

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**.&#x20;
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**.&#x20;
5. We'll send you to Miravia to log in to your account and accept any required permissions.&#x20;
6. You will be asked to confirm several permissions. Fill in the requested details and click **Authorize**.&#x20;

### **Step 4: Send your product listings to Miravia** <a href="#h_01k1z1a9nfken0bd7n66x9a99f" id="h_01k1z1a9nfken0bd7n66x9a99f"></a>

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** <a href="#h_01k1z1a9nhw2avz6csgb79sj85" id="h_01k1z1a9nhw2avz6csgb79sj85"></a>

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.&#x20;

#### **Resolving errors:** <a href="#h_01k1z1a9njmrahvb0s1k99mazz" id="h_01k1z1a9njmrahvb0s1k99mazz"></a>

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. <br>

### Common Miravia errors

<details>

<summary>CHK_SKU_PROPS_DUPLICATE</summary>

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.

</details>

<details>

<summary>EAN_code</summary>

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](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/8tT6HoIw0reQDd8847om/28578180708882)

* 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](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/cu6JlH3z2wBDHv6ux42w/28578180709650)

* THE\_FIELD\_OF\_EAN\_CODE\_HAS\_AN\_ERROR\_PLEASE\_CHECK: Indicates that the format of the EAN is invalid. Please make the necessary corrections.

</details>

<details>

<summary>THD_IC_ERR_F_IC_SERVICE_EDIT_002</summary>

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

</details>
