> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-es/vende-en-marketplaces/marketplaces-mirakl/guia-de-mirakl-configuracion-e-soluciones.md).

# Guía de Mirakl: Configuración e soluciones

Aprende cómo A configurar marketplaces de Mirakl e resolver Errores comunes del canal.

Mirakl proporciona la Plataforma que usan muchos marketplaces, así que estos marketplaces suelen compartir Configuración, comportamiento e Errores comunes.&#x20;

Utiliza esta página A solucionar problemas de tus canales de Mirakl e corregir errores da la **Feedback** pestaña In la configuración de tu canal **Resultado** paso.

<details>

<summary><i class="fa-shop">:shop:</i> Marketplaces de Mirakl In Channable</summary>

* Decathlon
* Fnac
* Leroy Merlin
* fonQ
* Darty
* Bricoman
* Mediamarkt
* Conforama
* Carrefour Francia/España
* Manor
* PcComponentes
* Maxeda Brico\&Praxis
* Leen Bakker
* ePrice
* Douglas
* Galeries Lafayette
* Home24
* Sprinter
* Showroomprive
* Hornbach
* Conrad
* Vtwonen
* Galeries Lafayette

</details>

***

### Añade multiplo valores A un atributo&#x20;

Se un atributo acepta más de un valor, separa los valores con una barra vertical (`|`). Por ejemplo: `algodón|poliéster`. Mirakl lee cada valor entre barras verticales como una entrada separada.

### Errores comunes e Cómo arreglarlo

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Error</th><th>Qué significa</th><th>Cómo arreglarlo</th></tr></thead><tbody><tr><td><code>Oferta - producto no encontrado</code>, oppure <code>mirakl_unknown_error_code</code></td><td>El producto todavía no es reconocido por la base de datos de Mirakl.</td><td>Sigue <a href="#fix-product-not-found-errors">Corrige los Errores "product not found"</a>.</td></tr><tr><td><code>Producto - envío pendiente</code></td><td>El marketplace todavía está procesando el producto.</td><td>Espera, allora<a href="#download-the-non-integrated-products-report"> descarga un informe de productos no integrados</a> para el Estado más reciente.</td></tr><tr><td><code>Producto - error de datos</code>, oppure <code>Producto - error de integración</code></td><td>El marketplace rechazó los datos del producto.</td><td>Comprueba los otros Errores del producto en la <strong>Feedback</strong> pestaña y corrígelos primero.</td></tr><tr><td><code>1000: El atributo obligatorio è vuoto</code></td><td>Un atributo obligatorio no está mapeado, o el Campo mapeado tiene un valor vacío.</td><td><a href="#fix-an-attribute-value-in-the-build-step">Mapea un Campo que tenga valores admitidos</a>.</td></tr><tr><td><code>1001: Se proporcionó una Categoría desconocida</code></td><td>La Categoría no coincide con una Categoría del marketplace, o enviaste la Etichetta de la Categoría en lugar de su código.</td><td>Comprueba que el formato coincida con el de los marketplaces o verifica el código de Categoría del marketplace.</td></tr><tr><td><code>1004: Se proporcionó una Categoría desconocida</code></td><td>Un Mapeo de Categoría en tu Cuenta de Mirakl anula el Mapeo en Channable.</td><td>Sigue <a href="#remove-category-mapping-in-mirakl-error-1004">Elimina el Mapeo de Categoría en Mirakl</a>.</td></tr><tr><td><code>2004: Un atributo tiene un valor demasiado largo</code></td><td>El valor supera el límite de caracteres del marketplace.</td><td>Comprueba los requisitos del marketplace y añade una <a href="https://helpcenter.channable.com/manage-improve-product-data/manage-product-and-improve-data-es/reglas-edicion-masiva-y-enriquecimiento/how-to-use-actions-then-in-rules/acciones-de-texto/rule-action-maximum-length.md">Regla de lunghezza massima</a> al Campo mapeado.</td></tr><tr><td><code>2006: Un atributo tiene un valor que no es uno de los valores permitidos</code></td><td>El valor no está en el Elenco de valores admitidos del marketplace.</td><td>Utiliza reglas para cambiar el valor por uno admitido.</td></tr><tr><td><code>2007: Un valor de atributo no coincide con una expresión regular</code></td><td><p>El valor está en el formato incorrecto. </p><p></p><p>Por ejemplo, Carrefour España requiere un EAN de 13 dígitos.</p></td><td>Utiliza reglas para volver a dar formato al valor.</td></tr></tbody></table>

#### Más información

<details>

<summary>Corrige los Errores "product not found"</summary>

**Producto no encontrado** Estos Errores significan que Channable envió una oferta para un producto que no existe en el catálogo del marketplace.&#x20;

En la **Feedback** pestaña, suelen aparecer como `Oferta - producto no encontrado` o `mirakl_unknown_error_code`, con el mensaje "El producto no existe."

Esto suele ocurrir por una de estas razones:

* El identificador del producto es incorrecto. Por ejemplo, `EAN` está asignado al Campo incorrecto.
* El marketplace todavía está procesando el producto. El error aparece como `Producto - envío pendiente`.
* El producto no superó la validación porque faltan atributos obligatorios o no son válidos, así que el marketplace no lo creó. El error aparece como `Producto - error de datos` o `Producto - error de integración`.

Cada marketplace tiene su propio catálogo. Un producto que ya está activo en un marketplace de Mirakl puede seguir sin aparecer en otro.

**Para corregir el error:**

1. En el paso de tu canal **Resultado** ve a la **Feedback** pestaña.
2. Comprueba si los mismos productos tienen Errores de atributo, como `1000` o `2006`. Si es así, corrígelos primero. Consulta [**Corrige un valor de atributo en el Build** paso](#fix-an-attribute-value-in-the-build-step).
3. En la **Build** paso, comprueba que el **EAN** atributo esté asignado al Campo que contiene tus EANs.
4. En la **Categoría** paso, comprueba que tus Categorías estén mapeadas a las Categorías del marketplace y que los atributos de esas Categorías estén rellenados en la **Atributos por categoría** pestaña en la **Build** paso.
5. Haz clic en **Actualizar**.
6. Si el error cambia a `Producto - envío pendiente`, espera a que el marketplace procese el producto. Para ver el estado más reciente, [**descarga un informe de productos no integrados**](#download-the-non-integrated-products-report).

Si no puedes proporcionar un atributo obligatorio, contacta con el marketplace. Puede que el marketplace apruebe un producto aunque falten algunos atributos obligatorios.

</details>

<details>

<summary>Corrige el valor de un atributo en el paso Build</summary>

Sigue estos pasos para los siguientes errores:  `1000`, `1001`, `2004`, `2006`, y `2007`.

1. En el paso de tu canal **Resultado** ve a la **Feedback** pestaña y haz clic en el error.
2. En la **ID** columna, haz clic en un ID de producto.
3. Desplázate y busca el atributo marcado **Falta mapeo para "\[attribute]"** o **Valor no válido para "\[attribute]"**, luego haz clic en **Ver en crear**.&#x20;
   1. En los errores 2004, anota el límite de caracteres que aparece en la **Errores** columna.
4. Junto al atributo, haz clic en el icono de información para ver **Ejemplo** y **Valores posibles**.
5. Corrige el campo mapeado:
   * Si el atributo no está mapeado, mapea un campo que contiene valores aceptados.
   * Si el valor no es aceptado, usa reglas para cambiarlo a un valor aceptado. Para Categorías, usa el código de la categoría, no la Etichetta.
   * Si el valor es demasiado largo, añade una regla de lunghezza massima al campo mapeado.
   * Si el valor está en el formato incorrecto, usa reglas para reformatearlo.
6. Si no tienes un campo con valores compatibles, [Crea un campo nuevo, rellénalo usando reglas y asígnalo al atributo](https://helpcenter.channable.com/list-advertise/list-and-advertise-es/publica-articoli-en-canales/rellenar-datos-de-atributos-faltantes.md) en la **Build** paso.
7. Haz clic en **Guardar**.
8. Haz clic en **Actualizar**.

{% hint style="info" %}

#### Nota

Mientras estés en el **Build** paso, comprueba otros atributos marcados **Requerido por el Marketplace** (punto azul) y mapea esos atributos.
{% endhint %}

</details>

<details>

<summary>Eliminar el mapeo de Categorías en Mirakl (error 1004)</summary>

Error `1004` significa que un mapeo de Categorías en tu cuenta de Mirakl anula el mapeo de Categorías en Channable. Elimina el mapeo de Mirakl para que se apliquen las Categorías de Channable.&#x20;

1. En tu cuenta de Mirakl, ve a **Configuración > Mapeo de catálogo**.
2. Debajo de **Mi estructura de catálogo**, haz clic en **Raíz**, luego haz clic en **Categoría**.
3. Haz clic en **Categoría** otra vez, luego haz clic en **Eliminar Mapeo**.
4. In Channable, abre tu canal e haz clic **Actualizar**.

</details>

### Descargar informes de errores de Mirakl <a href="#download-mirakl-error-reports" id="download-mirakl-error-reports"></a>

Los informes de Mirakl muestran lo que el marketplace ha rechazado oppure sigue revisando. Puedes utilizza los informes para investigar diferentes Errores. Los encontrarás In tu Cuenta de Mirakl, debajo de **Catálogo > Importaciones de productos**.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Informe</th><th>Qué muestra</th><th>Utilizza esto cuando</th></tr></thead><tbody><tr><td>Informe de productos no integrados <mark style="color:$info;">(Recomendado)</mark></td><td>Productos que el marketplace rechazó oppure sigue revisando después de procesar tu importación.</td><td>Tu canal se ejecutó, pero los productos muestran <code>Producto - envío pendiente</code> oppure errores de datos.</td></tr><tr><td>Informe de errores del archivo target</td><td>Problemas con el contenido oppure formato di archivo de importación. Coincide con el Feedback In Channable.</td><td>Quieres el mismo Feedback fuera de Channable.</td></tr><tr><td>Informe de productos añadidos</td><td>Productos que el marketplace integró correctamente.</td><td>Quieres A confirmar qué productos están activos.</td></tr></tbody></table>

<details>

<summary><i class="fa-download">:download:</i> Descarga el informe de productos no integrados</summary>

{% hint style="info" %}
Mirakl puede prendi varios giorni A generar este informe. se es urgente, contacta con el soporte de Mirakl.
{% endhint %}

1. Inicia sesión In A tu Cuenta de Mirakl.
2. Ir A **Catálogo > Importaciones de productos**.
3. Encuentra los archivos de importación que Channable ha enviado. Sus nombres empiezan con `channable_Crea_update_`.
4. Junto A el archivo más reciente, haz clic **Ver detalles**.
5. Junto A **Informe de productos no integrados**, haz clic en **Descargar**.

<figure><img src="https://530953520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8GepmoSonQRG6RnHOxJ%2Fuploads%2FfC22oIB7wjoXwQkYyZMK%2Fimage.png?alt=media&amp;token=8ea429d0-3f5e-458d-abd0-616875e5108a" alt=""><figcaption></figcaption></figure>

6. Abre el archivo CSV. Se utilizza Microsoft Excel oppure Google Sheets, puede que necesites importar el archivo en lugar di abrirlo.
7. En la **Errores** columna, lee el error de cada producto.
8. Corrige los Errores In Channable, allora haz clic **Actualizar**.

{% hint style="warning" %}
El marketplace escribe estas descripciones de error. Se una no está clara, contacta con el marketplace en lugar di Mirakl oppure Channable.
{% endhint %}

</details>

### Comprueba el Estado del producto In Mirakl <a href="#check-product-status-in-mirakl" id="check-product-status-in-mirakl"></a>

Cada producto In Mirakl tiene un Estado de validación, un Estado de aceptación e un Estado de sincronización. Comprueba todo di ellos A ver dónde se queda atascado un producto.

1. En tu cuenta de Mirakl, ve a **Catálogo > Gestor de catálogo**.
2. En la **Estado del producto** columna, haz clic <i class="fa-circle-info">:circle-info:</i> junto a un Estado A ver qué significa.&#x20;
3. Para ver el estado detallado, abre la página del producto e haz clic <i class="fa-circle-question">:circle-question:</i>.

{% hint style="warning" icon="lightbulb" %}
A ver los estados In bloque, utilizza los filtros, como **Estado del producto**.

<img src="https://530953520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8GepmoSonQRG6RnHOxJ%2Fuploads%2FHrIY9o1Y0Tx5zcOKVLOK%2Fimage.png?alt=media&amp;token=fc756c34-cadb-4fdd-81b1-f19615b020ab" alt="" data-size="original">
{% endhint %}

| Estado         | Meta estado               | Qué significa                                                                                                                                                                                                                             |
| -------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Validación     | Datos válidos             | Los datos del producto cumplen los requisitos del marketplace.                                                                                                                                                                            |
| Validación     | Datos no válidos          | Los datos del producto no cumplen los requisitos del marketplace.                                                                                                                                                                         |
| Validación     | Medios pendientes         | Mirakl aún no ha procesado las imágenes, los vídeos oppure los documentos del producto.                                                                                                                                                   |
| Validación     | No calculado              | El marketplace activó la validación de datos, pero Mirakl todavía no ha recalculado el estado de este producto. Mirakl lo recalcula cuando se reconstruyen las fichas de datos del producto oppure cuando cambian los datos del producto. |
| Aceptación     | Nuevo                     | El producto es nuevo. El marketplace debe aceptarlo oppure rechazarlo.                                                                                                                                                                    |
| Aceptación     | Cambios requeridos        | El marketplace rechazó el producto por problemas de calidad de datos. Actualiza el producto para que el marketplace pueda revisarlo de nuevo. A ver el motivo, pasa el cursor sobre <i class="fa-circle-question">:circle-question:</i>.  |
| Aceptación     | Pendiente de verificación | Has actualizado de alguna manera los datos del producto enviados. Ahora el marketplace debe decidir si acepta oppure rechaza tus cambios.                                                                                                 |
| Aceptación     | Aceptado                  | El marketplace aceptó el producto.                                                                                                                                                                                                        |
| Aceptación     | Rechazado                 | El marketplace rechazó el producto. A ver el motivo, pasa el cursor sobre <i class="fa-circle-question">:circle-question:</i>.                                                                                                            |
| Sincronización | Sincronizado              | El producto está integrado en el marketplace.                                                                                                                                                                                             |
| Sincronización | No sincronizado           | El producto no está integrado en el marketplace.                                                                                                                                                                                          |
| Sincronización | Error de sincronización   | Se produjo un error al integrar el producto.                                                                                                                                                                                              |

{% hint style="warning" %}

#### La aceptación es separada da la validación.&#x20;

El marketplace revisa los productos In su propio flujo de trabajo, así que un Articolo puede tener **Datos válidos** e incluso mostrar **Nuevo** o **Cambios requeridos**.&#x20;

Se el estado de aceptación no cambia después de que corrijas los datos, contacta con el marketplace.
{% endhint %}

Para saber más sobre estos estados, consulta [Centro de Ayuda de Mirakl](https://help.mirakl.net/bundle/sellers/page/topics/Mirakl/mcm/seller/mcm_statuses_provider.htm).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-es/vende-en-marketplaces/marketplaces-mirakl/guia-de-mirakl-configuracion-e-soluciones.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
