# Guía de Mirakl: Configuración y soluciones Mirakl no ejecuta su propio marketplace. En su lugar, ofrece la infraestructura que otros usan para crear y gestionar el suyo. Como muchos marketplaces de Mirakl usan la misma configuración, suelen tener ajustes, comportamiento y problemas comunes parecidos.
:shop: Marketplaces de Mirakl en Channable * 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
***
¿Qué es el mirakl_unknown_error_code y cómo solucionarlo? Cuando aparece este error, significa que Mirakl no reconoce el producto. Las posibles razones incluyen: 1. Faltan detalles del producto, como atributos específicos de la categoría. 2. La información del producto sigue pendiente y aparece como "Product - submission pending". 3. Errores en los datos enviados, indicados como "Product - data error" o "Product - integration error". En resumen: falta algo que el Marketplace requiere o no está rellenado correctamente. [![](/files/e99c41ba40b64e6bbf6137f5c0abcd0f96078437)](https://helpcenter.channable.com/hc/article_attachments/19168742250514) Aunque parezca complejo, normalmente la solución pasa por unos pocos pasos sencillos: * **Categorías**: Asegúrate de que las categorías de tus productos estén bien asignadas en el [paso Categories](/manage-improve-product-data/manage-product-and-improve-data-es/categoriza-productos.md) de tu API. Si no lo están, asígnalas correctamente. * **Construye**: Verifica que el paso Build de tu API esté configurado correctamente. Por ejemplo, un campo EAN incorrecto vinculado aquí puede provocar errores. Corrige cualquier discrepancia. * **Attributes**: En el [paso Attributes de la API](/list-advertise/list-and-advertise-es/vende-en-marketplaces/primeros-pasos-con-marketplaces/marketplaces-paso-de-creacion.md), vincula cada campo con su correspondiente correcto y asegúrate de que los valores sean adecuados para la categoría seleccionada. * **Reglas**: Usa reglas para afinar aún más tus datos. Consulta el artículo de soporte del generador de atributos para mejorar el paso Attributes de tu API. Una vez que las categorías y los atributos estén rellenados en tu API, ve al resumen de APIs y ejecuta la API haciendo clic en el botón azul "Run now".
### Buenas prácticas y ajustes para Mirakl #### Añadir varios valores de atributo Si necesitas introducir varios valores para un solo campo de atributo en un Marketplace de Mirakl, separa cada valor con el símbolo de barra vertical "|". Este formato garantiza que Mirakl reconozca y procese correctamente cada entrada por separado. ### Errores comunes de Mirakl y cómo solucionarlos
Oferta - producto no encontrado Este error aparece cuando el EAN de un producto no se reconoce en la base de datos de Mirakl. Suele pasar cuando: * El producto aún está siendo procesado por Mirakl (aparece como `Product - submission pending`). * La importación del producto ha fallado por datos obligatorios que faltan o no son válidos (por ejemplo, atributos específicos de la categoría). Normalmente se muestra como `Product - data error` o `Product - integration error`. **Cómo solucionarlo** 1. En el **Resultado** paso de tu canal de marketplace de Mirakl, ve a **Feedback** . 2. Revisa otros errores relacionados con productos ya publicados. 3. Comprueba el feedback del error en la columna **Error** . Si hace falta, ajusta tus datos usando [reglas](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). 4. Revisa y mapea los atributos marcados como obligatorios en el **Construye** paso. Comprueba el :circle-info: icono y los tooltips para ver los valores aceptados. 5. Haz clic en **Actualizar ahora** para volver a ejecutar tu canal.
Product - submission pending Este error aparece cuando el marketplace aún está procesando la información de tu producto. Para ver la información de estado más reciente, [descarga en Mirakl un informe de productos no integrados](#how-to-download-a-non-integrated-products-report).
1000: El atributo obligatorio está vacío No se ha mapeado un atributo obligatorio para este marketplace, o tiene un valor vacío. Cómo solucionarlo: 1. En el **Feedback** pestaña en el **Resultado** paso, haz clic en el error. 2. Haz clic en el ID vinculado en la columna **ID** . 3. Desplázate para ver los campos marcados como **Falta el mapeo de \[insert attribute]**. 4. Haz clic en **Ver en crear**. Esto te llevará al atributo afectado en el **Construye** . 5. Mapea el campo que falta. Si no tienes un campo con valores aceptados, puedes [crear un nuevo campo](/get-started/get-started-space-es/empezando/campos-in-channable/mapea-e-anade-campos.md) y rellenarlo usando [reglas](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} Consejo: mientras estás aquí, revisa cualquier otro error marcado como **Requerido por el Marketplace** (indicado por un punto azul). Haz clic en el :circle-info: icono para ver más información o un ejemplo de valores aceptados. {% endhint %} 6. Haz clic en **Guardar**. 7. Haz clic en **Actualizar ahora**.
1001: Categoría desconocida proporcionada El valor de categoría proporcionado no coincide con una categoría del marketplace, o se ha proporcionado una etiqueta en lugar del código. **Cómo solucionarlo:** 1. En el **Feedback** pestaña en el **Resultado** paso, haz clic en el error. 2. Haz clic en el ID vinculado en la columna **ID** . 3. Haz clic en **Ver en crear**. Esto te llevará al atributo afectado en el **Construye** . 4. Mapea el campo que falta. Si no tienes un campo con valores aceptados, puedes [crear un nuevo campo](/get-started/get-started-space-es/empezando/campos-in-channable/mapea-e-anade-campos.md) y rellenarlo usando [reglas](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} Consejo: mientras estás aquí, revisa cualquier otro error marcado como **Requerido por el Marketplace** (indicado por un punto azul). Haz clic en el :circle-info: icono para ver más información o un ejemplo de valores aceptados. {% endhint %} 5. Haz clic en **Guardar**. 6. Haz clic en **Actualizar ahora**.
2004: Un atributo tiene un valor demasiado largo El campo mapeado para este atributo debe estar por debajo del límite de caracteres especificado. **Cómo solucionarlo:** 1. En el **Feedback** pestaña en el **Resultado** paso, haz clic en el error 2004. 2. Toma nota del atributo afectado indicado en la columna **Errores** y del límite de caracteres. 3. Ve al paso de **Construye** paso y comprueba qué campo has mapeado para el atributo afectado. {% hint style="success" %} Consejo: mientras estás aquí, revisa cualquier otro error marcado como **Requerido por el Marketplace** (indicado por un punto azul). Haz clic en el :circle-info: icono para ver más información o un ejemplo de valores aceptados. {% endhint %} 4. Ve al paso de **Regla** . 5. Crea una [regla de longitud máxima](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/how-to-use-actions-then-in-rules/rule-action-maximum-length) para el campo que estás usando y asegúrate de que cumple el límite de caracteres. Asegúrate de hacer clic en **Guardar** para aplicar los cambios. 6. Haz clic en **Actualizar ahora**.
2006: Un atributo tiene un valor que no es uno de los valores permitidos Este error aparece cuando el campo que has mapeado contiene un valor que no se acepta. **Cómo solucionarlo:** 1. En el **Feedback** pestaña en el **Resultado** paso, haz clic en el error 2006. 2. Haz clic en el ID vinculado en la columna **ID** . 3. Desplázate para ver los campos marcados como **Valor no válido para \[attribute name]**. A su lado, haz clic en **Ver en crear**. Esto te llevará al atributo afectado en el **Construye** . 4. Toma nota del campo que has mapeado para el atributo afectado. {% hint style="success" %} Consejo: mientras estás aquí, revisa cualquier otro error marcado como **Requerido por el Marketplace** (indicado por un punto azul). {% endhint %} 4. Haz clic en el :circle-info: icono junto al atributo afectado para ver Ejemplo y Valores posibles. 5. Usa [reglas](/manage-improve-product-data/manage-product-and-improve-data-es/reglas-edicion-masiva-y-enriquecimiento/usando-regolas.md) para actualizar o crear un nuevo campo de proyecto con los valores aceptados. Asegúrate de hacer clic en **Guardar** para aplicar los cambios. 1. Si creas un nuevo campo de proyecto, asegúrate de volver a mapearlo en el **Construye** paso a ese nuevo campo. 6. Haz clic en **Actualizar ahora**.
2007: Un valor de atributo no coincide con una expresión regular Este error aparece si el valor del atributo no tiene el formato esperado. **Cómo solucionarlo:** 1. En el **Feedback** pestaña en el **Resultado** paso, haz clic en el error 2007. 2. Haz clic en el ID vinculado en la columna **ID** . 3. Desplázate para ver los campos marcados como **Valor no válido para \[attribute name]**. A su lado, haz clic en **Ver en crear**. Esto te llevará al atributo afectado en el **Construye** . 4. Toma nota del campo que has mapeado para el atributo afectado. {% hint style="success" %} Consejo: mientras estás aquí, revisa cualquier otro error marcado como **Requerido por el Marketplace** (indicado por un punto azul). {% endhint %} 4. Haz clic en el :circle-info: icono junto al atributo afectado para ver Ejemplo y Valores posibles. 5. Usa [reglas](/manage-improve-product-data/manage-product-and-improve-data-es/reglas-edicion-masiva-y-enriquecimiento/usando-regolas.md) para actualizar o crear un nuevo campo de proyecto con los valores aceptados. Asegúrate de hacer clic en **Guardar** para aplicar los cambios. 1. Si creas un nuevo campo de proyecto, asegúrate de volver a mapearlo en el **Construye** paso a ese nuevo campo. 6. Haz clic en **Actualizar ahora**.
### Informes de error de Mirakl Puedes descargar distintos informes de error en Mirakl para investigar diferentes problemas. Los encontrarás todos en **Catalog > Product imports**. * **Informe de errores del archivo de origen:** Muestra qué falla en tu archivo de origen o en el formato. Los datos mostrados enseñarán exactamente el mismo feedback que aparece en tu canal de marketplace en Channable. * **Informe de productos no integrados (recomendado):** Te dice qué ha rechazado o está revisando el marketplace después de procesar tu envío. * **Úsalo cuando:** Has ejecutado tu canal correctamente, pero ves errores de ‘Product - submission pending’. * **Informe de productos añadidos:** Confirma qué productos o líneas se integraron correctamente * **Úsalo cuando:** Quieres tener prueba de lo que está activo, o reconciliar lo que se creó frente a lo que se envió.
:download: Cómo descargar un informe de productos no integrados {% hint style="info" %} Nota: Este es un informe detallado que Mirakl puede tardar varios días en generar. Para asuntos urgentes, contacta con el equipo de soporte de Mirakl. {% endhint %} 1. Inicia sesión en tu cuenta de Mirakl. 2. Ve a **Catalog** > **Product Imports**.
3. En la columna File name, busca qué elementos fueron importados por Channable y sus marcas de tiempo. 4. Para esos elementos, haz clic en **See details** para ver la información de importación más reciente.
5. Haz clic en **Download** junto a **Non-integrated products report** para descargar automáticamente el informe de errores.
{% hint style="info" %} **Nota:** El archivo es un CSV. Si usas Microsoft Excel o Google Sheets, puede que tengas que transformar o importar el archivo para verlo. {% endhint %} 6. Abre el archivo en tu software. 7. Comprueba la columna **Errores** para ver los errores concretos de cada elemento. 8. Corrige lo que puedas según la descripción del error. Mirakl recibe este feedback del marketplace. Si no tienes claro qué significa la descripción, contacta con el marketplace para obtener más información.
### Comprueba el estado de los productos en Mirakl
Los productos en la plataforma tienen tres estados principales: * Validación * Aceptación * Sincronización Las combinaciones de estos generan varios metainstados. 1. En el backend de tu Mirakl, ve a **Catalog > Catalog Manager**. Verás un resumen de todos tus ítems. 2. En el **Novedades herramienta** columna, haz clic en :circle-info: para obtener más información sobre lo que significa un determinado estado. 3. Para ver una descripción más detallada, abre la página del producto y haz clic en :circle-question:.
{% hint style="success" %} Consejo: usa los filtros para ver los estados en bloque. {% endhint %} Los productos en la plataforma tienen tres estados principales: Validación, Aceptación y Sincronización. Las combinaciones de estos generan varios metainstados. #### Estados de Mirakl Catalog Manager | | | | | ------------------ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Estado** | **Metainstado** | **Descripción** | | **Validación** | Datos válidos | *Los datos del producto cumplen los requisitos del Marketplace.* | | | Datos inválidos | *Los datos del producto no cumplen los requisitos del Marketplace.* | | | Medios pendientes | *Los medios (imágenes, vídeos, documentos) de los datos del producto todavía no han sido procesados por la plataforma de Mirakl.* | | | No calculado |

Cuando el Marketplace activa la validación de datos de producto para un canal, los estados de validación de los productos no se recalculan automáticamente. En este caso, estos productos obtienen el estado 'No calculado' para ese canal.
Varias acciones pueden activar el recálculo del estado de validación de un producto:
- Después de reconstruir las hojas de datos del producto
- cuando modificas la hoja de datos del producto de origen y esos cambios se reflejan en la hoja de datos del producto maestro
- cuando modificas una hoja de datos del producto maestro
Todos los productos nuevos obtienen el estado de validación adecuado para cada canal activado.

| | **Aceptación** | Nuevo | *El producto es nuevo y el Marketplace debe aceptarlo o rechazarlo.* | | | Cambios necesarios |

Tu Marketplace ha rechazado el producto por problemas de calidad de datos. Debes actualizar tus productos antes de que tu Marketplace vuelva a revisar el producto.
Puedes ver el motivo del rechazo pasando el ratón por encima del signo de interrogación (?)

| | | Pendiente de verificación |

Se te ha pedido que actualices uno o varios productos. Ya se han hecho cambios.
Ahora los marketplaces deben decidir si aceptan o rechazan el/los producto(s).

| | | Aceptada | *Tu Marketplace ha aceptado el producto.* | | | Rechazado |

Tu Marketplace ha rechazado el producto.
Puedes ver el motivo del rechazo pasando el ratón por encima del signo de interrogación (?)

| | **Sincronización** | Sincronizado | *El producto está integrado en la plataforma del Marketplace.* | | | No sincronizado | *El producto no está integrado en la plataforma del Marketplace.* | | | Error de sincronización | *Se produjo un error durante la integración del producto.* | Para obtener más información sobre los estados de Mirakl, puedes visitar [su centro de ayuda](https://help.mirakl.net/bundle/sellers/page/topics/Mirakl/mcm/seller/mcm_statuses_provider.htm). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://helpcenter.channable.com/list-advertise/list-and-advertise-es/vende-en-marketplaces/marketplaces-de-mirakl/guia-de-mirakl-configuracion-y-soluciones.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.