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.

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.

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 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, 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.
4. Revisa y mapea los atributos marcados como obligatorios en el Construye paso. Comprueba el 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.

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 y rellenarlo usando reglas.

Consejo: mientras estás aquí, revisa cualquier otro error marcado como Requerido por el Marketplace (indicado por un punto azul). Haz clic en el icono para ver más información o un ejemplo de valores aceptados.

1. Haz clic en Guardar.
2. 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 y rellenarlo usando reglas.

Consejo: mientras estás aquí, revisa cualquier otro error marcado como Requerido por el Marketplace (indicado por un punto azul). Haz clic en el icono para ver más información o un ejemplo de valores aceptados.

1. Haz clic en Guardar.
2. 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.

Consejo: mientras estás aquí, revisa cualquier otro error marcado como Requerido por el Marketplace (indicado por un punto azul). Haz clic en el icono para ver más información o un ejemplo de valores aceptados.

1. Ve al paso de Regla .
2. Crea una regla de longitud máxima 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.
3. 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.

Consejo: mientras estás aquí, revisa cualquier otro error marcado como Requerido por el Marketplace (indicado por un punto azul).

1. Haz clic en el icono junto al atributo afectado para ver Ejemplo y Valores posibles.
2. Usa reglas 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.
3. 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.

Consejo: mientras estás aquí, revisa cualquier otro error marcado como Requerido por el Marketplace (indicado por un punto azul).

1. Haz clic en el icono junto al atributo afectado para ver Ejemplo y Valores posibles.
2. Usa reglas 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.
3. 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ó.

Cómo descargar un informe de productos no integrados

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.

1. Inicia sesión en tu cuenta de Mirakl.
2. Ve a Catalog > Product Imports.

1. En la columna File name, busca qué elementos fueron importados por Channable y sus marcas de tiempo.
2. Para esos elementos, haz clic en See details para ver la información de importación más reciente.

1. Haz clic en Download junto a Non-integrated products report para descargar automáticamente el informe de errores.

Nota: El archivo es un CSV. Si usas Microsoft Excel o Google Sheets, puede que tengas que transformar o importar el archivo para verlo.

1. Abre el archivo en tu software.
2. Comprueba la columna Errores para ver los errores concretos de cada elemento.
3. 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 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 .

Consejo: usa los filtros para ver los estados en bloque.

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.