Guía de Mirakl: ajustes y soluciones

Esta guía explica cómo solucionar problemas comunes y seguir las mejores prácticas al gestionar un marketplace de Mirakl con Channable.

Mirakl no gestiona su propio marketplace. En su lugar, proporciona la infraestructura que otros usan para crear y administrar el suyo.

Como muchos marketplaces de Mirakl usan la misma configuración, a menudo tienen ajustes, comportamientos y problemas comunes similares.

Marketplaces 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

---

Buenas prácticas y ajustes para Mirakl

Añadir múltiples valores de atributo

Si necesitas introducir varios valores para un mismo campo de atributo en un Marketplace Mirakl, separa cada valor con el símbolo de barra vertical "|". Este formato asegura que Mirakl reconozca y procese correctamente cada entrada por separado.

Errores comunes de Mirakl y cómo solucionarlos

Oferta - producto no encontrado

Este error ocurre cuando el EAN de un producto no es reconocido por la base de datos de Mirakl.

Normalmente sucede cuando:

• El producto aún está siendo procesado por Mirakl (mostrado como Producto - envío pendiente).

• La importación del producto falló por datos obligatorios faltantes o inválidos (por ejemplo, atributos específicos de categoría). Normalmente se muestra como Producto - error de datos o Producto - error de integración.

Cómo solucionar

1. En el Resultado paso de tu canal marketplace Mirakl, ve a la Feedback pestaña.

2. Revisa otros errores relacionados con productos listados.

3. Consulta la retroalimentación de errores en la columna Error . Donde sea necesario, ajusta tus datos usando reglas.

4. Revisa y mapea los atributos marcados como obligatorios en el Crear paso. Comprueba el icono y las descripciones emergentes para ver los valores aceptados.

5. Haz clic Actualizar para volver a ejecutar tu canal.

Producto - envío pendiente

Este error ocurre cuando el marketplace aún está procesando la información de tu producto.

Para obtener la información de estado más reciente, descarga un informe de productos no integrados en Mirakl.

1000: Atributo obligatorio vacío

Un atributo obligatorio para este marketplace no se ha mapeado o tiene un valor vacío.

Cómo arreglarlo:

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 Falta el mapeo para [insertar atributo].

4. Haz clic Ver en crear. Esto te dirigirá al atributo afectado en el Crear paso.

5. Mapea el campo faltante. Si no tienes un campo con valores aceptados, puedes crear un nuevo campo y rellenarlo usando reglas.

Consejo: Mientras estés aquí, revisa los errores restantes marcados como Requerido por el Marketplace (indicado por un punto azul). Haz clic en el icono para más información/un ejemplo de valores aceptados.

1. Haz clic Guardar.

2. Haz clic Actualizar.

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 arreglarlo:

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 Ver en crear. Esto te dirigirá al atributo afectado en el Crear paso.

4. Mapea el campo faltante. Si no tienes un campo con valores aceptados, puedes crear un nuevo campo y rellenarlo usando reglas.

Consejo: Mientras estés aquí, revisa los errores restantes marcados como Requerido por el Marketplace (indicado por un punto azul). Haz clic en el icono para más información/un ejemplo de valores aceptados.

1. Haz clic Guardar.

2. Haz clic Actualizar.

2004: Un atributo tiene un valor que es demasiado largo

El campo mapeado para este atributo debe estar por debajo del límite de caracteres especificado.

Cómo arreglarlo:

1. En el Feedback pestaña en el Resultado en el 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 Crear paso y comprueba qué campo has mapeado para el atributo afectado.

Consejo: Mientras estés aquí, revisa los errores restantes marcados como Requerido por el Marketplace (indicado por un punto azul). Haz clic en el icono para más información/un ejemplo de valores aceptados.

1. Ve al Regla paso.

2. Crea una regla de longitud máxima en el campo que estás usando para asegurarte de que cumple el límite de caracteres. Asegúrate de hacer clic en Guardar para aplicar los cambios.

3. Haz clic Actualizar.

2006: Un atributo tiene un valor que no está entre los valores permitidos

Este error ocurre cuando el campo que mapeaste contiene un valor que no está aceptado.

Cómo arreglarlo:

1. En el Feedback pestaña en el Resultado en el 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 Valor inválido para [nombre del atributo]. Junto a él, haz clic en Ver en crear. Esto te dirigirá al atributo afectado en el Crear paso.

4. Toma nota del campo que mapeaste para el atributo afectado.

Consejo: Mientras estés aquí, revisa los errores restantes marcados 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 Crear paso a ese nuevo campo.

3. Haz clic Actualizar.

2007: Un valor de atributo no coincide con una expresión regular

Este error ocurre si el valor del atributo no tiene el formato esperado.

Cómo arreglarlo:

1. En el Feedback pestaña en el Resultado en el 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 Valor inválido para [nombre del atributo]. Junto a él, haz clic en Ver en crear. Esto te dirigirá al atributo afectado en el Crear paso.

4. Toma nota del campo que mapeaste para el atributo afectado.

Consejo: Mientras estés aquí, revisa los errores restantes marcados 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 Crear paso a ese nuevo campo.

3. Haz clic Actualizar.

Informes de errores de Mirakl

Puedes descargar distintos informes de errores en Mirakl para investigar diferentes errores. Los puedes encontrar todos en Catálogo > Importaciones de producto.

• Informe de error de archivo fuente: Muestra qué está mal en tu archivo fuente o formato. Los datos mostrados ofrecerán la misma retroalimentación exacta que aparece en tu canal del marketplace en Channable.

• Informe de productos no integrados (recomendado): Te indica qué rechazó/está revisando el marketplace después de que se procesó tu envío.

  • Usar cuando: Has ejecutado correctamente tu canal, pero ves errores de ‘Producto - envío pendiente’.

• Informe de productos añadidos: Confirma qué productos/lineas se integraron correctamente

  • Usar cuando: Quieres prueba de qué está en vivo, o conciliar lo creado vs lo enviado.

Cómo descargar un informe de productos no integrados

Nota: Este es un informe detallado que puede tardar varios días en generarse por Mirakl. Para asuntos urgentes, contacta con el equipo de soporte de Mirakl.

1. Inicia sesión en tu cuenta de Mirakl.

2. Ve a Catálogo > Importaciones de producto.

1. En la columna Nombre de archivo, encuentra qué ítems fueron importados por Channable y sus marcas de tiempo.

2. Para esos ítems, haz clic en Ver detalles para ver la información de importación más reciente.

1. Haz clic Descargar junto a Informe de productos no integrados para descargar el informe de errores automáticamente.

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

1. Abre el archivo en tu software.

2. Comprueba la columna Errores para ver el/los error(es) específico(s) de cada ítem.

3. Corrige lo que puedas según la descripción del error. Mirakl recibe esta retroalimentación del marketplace.

Si no tienes claro qué significa la descripción, contacta con el marketplace para más información.

Comprobar el estado del producto en Mirakl

Los productos en la plataforma tienen tres estados principales:

• Validación

• Aceptación

• Sincronización

Combinaciones de estos producen varios metarestados.

1. En tu backend de Mirakl, ve a Catálogo > Gestor de catálogo. Verás una visión general de todos tus ítems.

2. En el Novedades herramienta columna, haz clic para más información sobre lo que significa cierto estado.

3. Para ver una descripción más detallada, abre la página del producto y haz clic .

Consejo: Usa los filtros para ver estados en bloque.

Los productos en la plataforma tienen tres estados principales: Validación, Aceptación y Sincronización. Combinaciones de estos producen varios metarestados.

Estados del Gestor de Catálogo de Mirakl

Estado	Metarestado	Descripción
Validación	Datos válidos	Los datos del producto cumplen con los requisitos del Marketplace.
	Datos no válidos	Los datos del producto no cumplen con los requisitos del Marketplace.
	Medios pendientes	Los medios (imágenes, vídeos, documentos) de los datos del producto aún no han sido procesados por la plataforma Mirakl.
	No calculado	Cuando el Marketplace activa la validación de datos del producto para un canal, los estados de validación de los productos no se recalculan automáticamente. En ese caso, estos productos obtienen el estado 'No calculado' para el canal dado. Varias acciones pueden activar el recálculo del estado de validación de un producto: - Después de la reconstrucción de las Hojas de Datos de Producto - cuando modificas la Hoja de Datos de Producto de Origen y estas modificaciones se reflejan en la Hoja de Datos Maestra del Producto - cuando modificas una Hoja de Datos Maestra del Producto 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.
	Se requieren cambios	Tu Marketplace ha rechazado el producto por problemas de calidad de datos. Debes actualizar tus productos antes de que el Marketplace revise el producto de nuevo. Puedes ver la razón del rechazo pasando el ratón por encima del signo de interrogación (?)
	Verificación pendiente	Se te ha pedido que actualices un producto o productos. Se han realizado cambios. Ahora los marketplaces deben decidir si aceptan o rechazan el/los producto(s).
	Aceptado	Tu Marketplace ha aceptado el producto.
	Rechazado	Tu Marketplace ha rechazado el producto. Puedes ver la razón 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	Ocurrió un error durante la integración del producto.

Para más información sobre los estados de Mirakl, puedes visitar su centro de ayuda.