Guía Mirakl: ajustes y soluciones

Mirakl es una empresa que facilita una plataforma para marketplaces online. No opera un marketplace propio; en su lugar, provee la infraestructura sobre la que se pueden construir distintos Marketplaces.

Los Marketplaces construidos sobre la plataforma de Mirakl comparten un marco común, lo que significa que a menudo presentan comportamientos, ajustes y problemas similares.

Esta guía explica cómo solucionar obstáculos comunes y las mejores prácticas al gestionar un Marketplace construido sobre Mirakl con Channable.

---

Nuestros Marketplaces Mirakl compatibles

Decathlon	Fnac	Blokker Connect!
Leroy Merlin	fonQ	Darty
Bricoman	Mediamarkt	Conforama
Carrefour Francia/España	Manor	PcComponentes
Maxeda Brico&Praxis	Leen Bakker	ePrice
Douglas	Galeries Lafayette	Home24

Buenas prácticas y ajustes para Mirakl

Cómo 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 pipe "|". Este formato asegura que Mirakl reconozca y procese correctamente cada entrada por separado.

Errores de Mirakl

¿Qué es el mirakl_unknown_error_code y cómo solucionarlo?

Un error que puedes encontrar es el mirakl_unknown_error_code. Este error señala un conjunto de problemas que normalmente surgen cuando el EAN de un producto no es reconocido por la base de datos de Mirakl — lo que indica que el producto es nuevo en el marketplace o le faltan atributos obligatorios.

En resumen: falta algo que requiere el Marketplace o no está rellenado correctamente.

Aunque pueda parecer complejo, la solución suele implicar unos pasos sencillos:

• Categorías: Asegúrate de que las categorías de tus productos estén correctamente mapeadas en el paso Categorías de tu API. Si no lo están, mapealas con precisión.

• Crear: Verifica que el paso Build de tu API esté configurado correctamente. Por ejemplo, un campo EAN vinculado de forma incorrecta aquí puede causar errores. Ajusta cualquier desajuste.

• Atributos: En el paso Atributos de la API, vincula cada campo con su contraparte correcta y asegúrate de que los valores sean apropiados para la categoría seleccionada.

• Reglas: Usa reglas para refinar aún más tus datos. Consulta el artículo de soporte del constructor de atributos para mejorar el paso Atributos en tu API.

Una vez que las categorías y atributos estén rellenos en tu API, ve al resumen de APIs y ejecuta la API haciendo clic en el botón azul "Actualiza".

Error 1004: No se pudo identificar la categoría

El error 1004 indica que se están enviando ítems con un mapeo de categoría incorrecto que no puede coincidir con las categorías del Marketplace en Mirakl. Esto suele ser causado por un mapeo de categoría manual ya existente en tu Marketplace Mirakl.

Cómo resolver el problema:

Ve a Settings en la barra lateral izquierda y haz clic en 'Settings' > 'Catalog mapping'. Verás el mapeo. El campo marcado en naranja (Category) puede haber sido añadido manualmente. Selecciona el 'category' marcado en naranja y el mapeo se mostrará en el lado derecho. Haz clic en 'Category' de nuevo (es seguro eliminarlo porque Channable no lo puso allí) y luego haz clic en 'Remove mapping'. Después de eliminar el mapeo manual, vuelve a la API de Mirakl en Channable y ejecuta la API otra vez. Esto refresca las asociaciones de categorías y debería eliminar el error de discrepancia de categorías.

Obtener el informe de errores de Mirakl

Como los Marketplaces se construyen sobre la plataforma Mirakl, obtener un informe de errores sigue el mismo procedimiento en todos los marketplaces.

1. Inicia sesión en tu cuenta de Mirakl y ve a Catálogo > Product Imports.

1. Busca las importaciones realizadas por Channable y sus marcas temporales. Haz clic en el botón "See details" de la importación más reciente.

1. Selecciona "Non-integrated products report" para descargar automáticamente el informe de errores.

Nota: El archivo es un CSV. Si usas Microsoft Excel es posible que necesites transformar/importar el archivo.

Tras descargar y convertir el archivo, busca la columna "Status" para ver el/los error(es) específico(s) de cada ítem.

¿Cuáles son los estados en Mirakl?

Para ver el estado de producto, ve a Catalog Manager para obtener una visión general de todos tus productos.

• Para entender un estado general, haz clic en el icono de interrogación (?) junto al producto.

• Para ver el meta-estado (detallado), abre la página del producto y haz clic en (?).

• Usa los filtros de Catalog Manager para ver estados en bloque.

Los productos en la plataforma tienen tres estados principales: Validación, Aceptación y Sincronización. Las combinaciones de estos producen varios meta-estados.

Los estados en Mirakl Catalog Manager

Estado	Meta estado	Descripción
Validación	Datos válidos	Los datos del producto cumplen con los requisitos del Marketplace.
	Datos invá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 computado	Cuando el Marketplace activa la validación de datos de producto para un canal, los estados de validación de los productos no se vuelven a computar automáticamente. En este caso, esos productos obtienen el estado 'No computado' para el canal dado. Varias acciones pueden desencadenar la recomputación del estado de validación de un producto: - Después de la reconstrucción de las Fichas de Datos de Producto - cuando modificas la ficha de datos de producto de Origen y estas modificaciones se reflejan en la ficha de datos de producto Maestro - cuando modificas una ficha de datos de 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 requeridos	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 colocando el cursor sobre el icono de interrogación (?)
	Verificación pendiente	Se te ha pedido que actualices uno o varios productos. Se han realizado cambios. Ahora los marketplaces deben decidir aceptar o rechazar el/los producto(s).
	Aceptadas	Tu Marketplace ha aceptado el producto.
	Rechazado	Tu Marketplace ha rechazado el producto. Puedes ver la razón del rechazo colocando el cursor sobre el icono 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.