Miravia es un marketplace español que combina el ecommerce tradicional con la creación de contenido. Permite a los clientes descubrir y comprar una variedad de productos, con un enfoque en moda, belleza y artículos de estilo de vida.
En este artículo, aprenderás cómo configurar un canal de Miravia en Channable para crear, gestionar y publicar productos en Miravia.
Antes de comenzar
Necesitarás:
- Una cuenta de vendedor de Miravia con solo la región de España habilitada.
Consideraciones importantes
- Actualmente, Channable solo admite el envío de un precio por producto.
- Italia y Portugal actualmente no son regiones compatibles.
- Habilitar la función de precios múltiples en tu cuenta de Miravia puede provocar inconsistencias en los precios que podrían afectar tus márgenes de beneficio.
Contenido
- Paso 1: Crear una conexión con Miravia
- Paso 2: Configurar los ajustes del canal
- Paso 3: Crear tus listados de productos
- Requisitos adicionales para Miravia
- Paso 4: Enviar tus listados de productos a Miravia
-
Paso 5: Verificar errores en tus listados de productos
Paso 1: Crear una conexión con Miravia
- En Channable, ve a Proyectos > [Tu proyecto] > Canales.
- Haz clic en + Crear canal.
- En la barra de búsqueda, escribe “Miravia” y selecciona Miravia.
- Haz clic en + Agregar nueva conexión.
- En Conectar con, haz clic en Miravia para seleccionarlo.
- En Etiqueta, asigna un nombre descriptivo a tu conexión (por ejemplo, “Miravia”).
- Haz clic en Conectarse con Miravia. Serás redirigido a Miravia para iniciar sesión y verificar tu conexión.
- Se te pedirá que confirmes varios permisos. Completa los datos solicitados y haz clic en Authorize. Serás redirigido de nuevo a Channable.
- Haz clic en Crear para finalizar tu conexión.
Paso 2: Configurar los ajustes del canal
- En Nombre, asigna un nombre descriptivo a tu canal.
- En Único ID por ítem, selecciona el campo que contiene los IDs de tus productos.
- En Idioma, selecciona el idioma en el que están tus datos de producto.
- En Utiliza el grupo de reglas generales, selecciona un grupo de reglas maestro para aplicar a tu canal (si tienes uno).
- Haz clic en Guardar.
Paso 3: Crear tus listados de productos
Para configurar tu API, sigue los pasos que se describen a continuación. Haz clic en cada paso para ampliar y ver las instrucciones detalladas, que te guiarán a través de todo el proceso.
1. Categorización
Para que se creen los datos de tus productos, estos necesitan una categoría. Añade categorías a tus productos utilizando la función de generar categorías, o crea nuevas categorías desde cero.
- Smart Categorization: Esta función asigna automáticamente categorías a tus productos basándose en criterios predefinidos, simplificando el proceso de categorización.
- Categorización manual: Asigna manualmente categorías a tus productos estableciendo reglas específicas. Puedes crear filtros detallados para mapear cada producto a la categoría correcta.
- Productos sin Categorizar: Revisa y categoriza cualquier ítem que permanezca sin categorizar para asegurar que todos los productos estén organizados correctamente.
Haz clic aquí para leer más sobre la Categorización en APIs.
2. Reglas
Crea diferentes reglas para optimizar los datos de tus productos. Para obtener ejemplos, consulta nuestro artículo de ayuda sobre reglas comunes.
- Configuración de reglas: Configura varias reglas para refinar los datos de tus productos. Esto puede incluir filtrar, modificar o mejorar los campos de datos para cumplir con los requisitos del Marketplace
3. Paso Crear
El paso Crear en Channable te permite configurar todos los atributos necesarios para tus ítems, asegurando que los datos de tu producto se alinean con los requisitos del Marketplace. Este paso es crucial para el éxito de los listados de productos y para evitar errores.
3.1 Visión general
- Accede al paso Crear: Comienza accediendo a la interfaz centralizada del paso Crear. Aquí es donde gestionarás y mapearás todos los atributos del producto.
- Identifica los campos obligatorios y opcionales: Los campos obligatorios están resaltados en rosa, lo que indica que son esenciales para listar tus productos. Los campos opcionales están marcados en naranja y pueden rellenarse en función de las necesidades específicas.
3.2 Rellenar atributos compartidos
-
Rellenar atributos compartidos: Introduce detalles comunes que se aplican a todos los productos, como EAN, precios y títulos. Este paso garantiza la uniformidad de la información básica del producto en todos tus listados.
-
Utiliza Valores estáticos o dinámicos:
- Valores estáticos: Introduce directamente valores que permanecen constantes, como la marca o el fabricante.
- Valores dinámicos: Utiliza campos que se actualizan automáticamente en función de los datos vinculados, ideales para variables como los niveles de stock o los precios.
-
Utiliza Valores estáticos o dinámicos:
Una vez introducidos los valores deseados para los atributos compartidos, procede a los atributos específicos de la categoría.
3.3 Especificar atributos específicos de la categoría
- Selecciona la categoría del producto: Elige la categoría relevante para tu producto, como ropa o muebles.
-
Introducir atributos específicos de la categoría: Rellena los atributos específicos de la categoría seleccionada, como la talla para la ropa o las dimensiones para los muebles. Este paso ayuda a afinar tus listados de acuerdo con los requisitos de la categoría. Aquí también puedes utilizar valores estáticos o dinámicos.
Haz clic aquí para leer más sobre el Paso Crear
4. Paso Calidad
El paso de Calidad proporciona información instantánea sobre la calidad de la configuración, destacando los errores obligatorios y opcionales para garantizar que los datos de tus productos cumplen las condiciones de los Marketplaces.
Acciones:
- Ver ítems: Ver productos con problemas específicos.
- Ver en Crear: Redirecciona al paso Crear para mapear la información que falta.
- Establecer categorías: Dirige al paso de categorías para categorizar los artículos.
- Mostrar fuente: Disponible para campos ID, redirige al paso de configuración.
5. Paso Vista Previa
El paso de vista previa muestra los atributos mapeados para múltiples ítems, resaltando los errores antes de exportar al Marketplace.
Características
- Búsqueda y filtrado: Encuentra productos específicos o filtra por mensaje de error/categoría.
- Resumen de ítems: Muestra todos los ítems a exportar; puedes filtrar para mostrar sólo los ítems con errores
- Vista previa detallada del producto: Muestra la información que falta y las acciones dinámicas para corregir errores.
Lista de verificación para finalizar los atributos
- Revisa los atributos compartidos: Comprueba que se han rellenado todos los atributos compartidos obligatorios.
- Revisar los atributos específicos de la categoría: Asegúrate de que se han rellenado todos los atributos obligatorios específicos de la categoría.
- Comprueba si hay errores: Corrige los campos marcados en rojo.
6. Paso de Resultados
La pestaña de resultados proporciona una visión general de los resultados de la configuración de la API, incluidas las cargas correctas, los errores y una vista previa de los productos que se mostrarán. Esta pestaña garantiza que los datos de tus productos se procesan correctamente e identifica cualquier problema que deba resolverse.
- Visión general: La pestaña de resultados muestra el estado de tus listados de productos, resaltando errores y problemas para obtener información detallada.
- Vista previa de productos: Muestra una visión general de los productos que se enviarán al Marketplace, permitiendo la verificación de los atributos rellenados correctamente.
- Exitosos: Enumera los productos procesados correctamente y listos para su inclusión en el listado, confirmando el cumplimiento de los requisitos del Marketplace.
- Errores: Identifica los errores durante el procesamiento, proporcionando información detallada para solucionar y resolver los problemas.
Las pestañas opcionales, como errores de repricer, historial de eventos de repricer, actualizaciones de stock y actualizaciones de cumplimiento, sólo aparecen si son relevantes para la API que estás utilizando. Haz clic aquí para leer más sobre el paso Resultado.
Requisitos adicionales para Miravia
La siguiente sección describe requisitos y consideraciones específicas para crear listados de productos para Miravia.
Atributos compartidos
Ítem
ID del grupo de ítems
Este campo se usa para agrupar múltiples variantes en un único listado. Si no hay variantes, selecciona el ID único del artículo para el campo item_group_id.
Envíos
Campos obligatorios
Asegúrate de que todos los campos de información de envío, como peso, longitud y contenido, tengan valores mayores que 0 y no más de 2 decimales. Si los valores son desconocidos, configúralos a 1 usando una regla.
Entrega por parte del Vendedor
Activa esta opción como “Sí” solo con autorización previa de Miravia; de lo contrario, configúrala como “No” para evitar errores.
Consulta “Delivery by Miravia” para más información.
Valores por defecto
Si los valores de envío son desconocidos, configúralos todos en 1 mediante una regla.
Imágenes
Vinculación de imágenes
Vincula el/los campo(s) que contienen tus imágenes en el atributo Imágenes.
Requerimientos de Imagen
Cumple con los estrictos requisitos de imagen de Miravia, tanto para la URL como para la imagen. Si no se cumple, se mostrará el error "Could not upload image due to: .. E302: 'Descripción del error'" en la pestaña Resultados.
Atributos por categoría
Normativa general sobre seguridad de los productos (GPSR)
Los vendedores deben indicar si el producto contiene advertencias de seguridad. Si es así, se deben completar los siguientes atributos:
Does the Product Have A Safety Warning?
Si es “Yes”, asegúrate de añadir la información necesaria en el atributo Safety Warning Content.
Safety Warning Content
Proporciona aquí el contenido de la advertencia de seguridad.
Package/Label Photo (EU)
Debes proporcionar una etiqueta del producto que incluya la información necesaria. Cada artículo también debe incluir una imagen etiquetada.
La etiqueta física del empaque debe contener:
- Información sobre el fabricante (y persona responsable en la UE si el fabricante no se encuentra en la UE)
- Información para identificar el producto
- Cualquier marcado o advertencia de seguridad
Certificaciones de conformidad de productos
Algunos atributos solo aparecerán si el producto pertenece a ciertas categorías. Estos permiten presentar certificaciones como CE, informes de pruebas, etc.
- Certificado CE
- Certificado CEPE
- Certificado CPNP
- Informe de ensayo RoHS: Verifica si los productos electrónicos cumplen con las normativas sobre sustancias peligrosas.
- Informe REACH: Confirma que los productos químicos cumplen con las normas de la UE en toda la cadena de suministro.
- Certificado de registro BPR: Muestra la aprobación para el uso de productos antibacterianos según la legislación de la UE.
-
Informe de prueba de materiales en contacto con alimentos (FCM) de la UE: Confirma que los materiales son seguros para el contacto con alimentos en la UE.
Para algunas categorías, también se requieren informes de pruebas específicos, como:
- Documento PIF: Archivo completo con la información necesaria para la venta de cosméticos en la UE.
- Informe de pruebas EMC/LVD: Valida el cumplimiento de las normas sobre seguridad electromagnética.
- Informe de pruebas EMC: Verifica que un producto no cause interferencias electromagnéticas.
- Informe de pruebas EN71: Demuestra que los juguetes son seguros según los estándares de la UE.
- Informe de pruebas R44: Certifica que las sillas infantiles para auto cumplen con las normas de seguridad de la ONU.
- Informe de pruebas de productos de construcción: Confirma que los materiales de construcción cumplen con los estándares de la UE.
- Informe de pruebas MDR: Indica que los dispositivos médicos cumplen con las normativas de la UE.
- Informe de pruebas de chupetes (EN1400:2013): Verifica que los chupetes son seguros según la normativa europea.
- Informe de pruebas de EPI: Asegura que los equipos de protección personal cumplen con las normas de la UE.
- EN62115: Garantiza que los juguetes eléctricos sean seguros.
-
Informe de pruebas RED: Confirma que los dispositivos inalámbricos cumplen con la Directiva de Equipos de Radio.
Requisitos DSA
Paso 1: Registrar los datos del fabricante y la persona responsable
- En tu cuenta de Miravia seller central, ve a Información del fabricante.
- En la pestaña Información del fabricante, proporciona los datos del fabricante y haz clic en Submit.
- Miravia generará un ID de fabricante. Anótalo, ya que lo necesitarás en el siguiente paso.
- Haz clic en la pestaña Información de la persona responsable de la EU.
- Proporciona los datos de la persona responsable en la EU. Haz clic en Submit.
- Miravia generará un ID de persona responsable en la EU. Anótalo, ya que lo necesitarás más adelante.
Paso 2: Proporciona tus IDs en Channable
- En [tu canal de Miravia], ve al paso Crear.
- Haz clic en la pestaña Atributos por categoría y selecciona una categoría. Aparecerá una lista de atributos específicos.
- Para EU Responsible, haz clic en el campo e ingresa tu ID de persona responsable en la UE.
- Para Manufacturer info, haz clic en el campo e ingresa tu ID de fabricante.
- Haz clic en Guardar.
- Repite esto para cada categoría.
Paso 4: Envía tus listados de productos a Miravia
- Selecciona el paso Configuración en [tu canal de Miravia].
- Haz clic en Activar API.
- Haz clic en Guardar.
- Haz clic en X para volver a la página de resumen del canal.
- Haz clic en Actualizar para enviar tus listados de productos a Miravia.
Paso 5: Revisa tus listados de productos en busca de errores
Ve al paso Resultado y haz clic en la pestaña Feedback. Esta página muestra todos los posibles errores de procesamiento que tienen tus datos de producto en un momento dado.
Cómo resolver errores:
- En Descripción, haz clic en el nombre del error. Esto te llevará a un resumen de los productos que presentan ese error.
-
En ID, haz clic en el número de ID y desplázate
hacia
abajo. Deberías ver un recuadro resaltado en rojo en la sección donde
ocurrió el error. Pasa el cursor sobre el recuadro para más información.
- Si el error es de asignación (mapping), haz clic en Ver en Crear para ir directamente al atributo que debes asignar o volver a asignar, el cual aparecerá resaltado en azul.
- Para obtener más información sobre el atributo y los valores aceptados, pasa el cursor sobre el ícono de ayuda.
- Resuelve el error.
- Repite los pasos para los errores restantes. Cuando estés listo, vuelve a ejecutar tu canal haciendo clic en Actualizar.
Puedes verificar tus productos publicados correctamente en la pestaña
Exitoso.
Errores comunes
CHK_SKU_PROPS_DUPLICATE
Cuando se intenta listar un producto con varios SKU, es necesario especificar una variación para cada uno. Una variación es un atributo distinto, como el tamaño o el color, que distingue un SKU de otro. Cada variación debe ser única dentro de su grupo. Por ejemplo, si una camiseta está disponible en talla M y color rojo, sólo puede haber una variación para esa combinación concreta.
Los errores etiquetados como color_family y Size están relacionados con este principio. Para rectificar estos errores, hay que asegurarse de que cada grupo contiene sólo una combinación específica.
EAN_code
Este error puede deberse a una de estas tres posibilidades:
- La primera posibilidad es que al producto le falta un EAN. Aparecerá un mensaje indicando que falta un campo obligatorio. Realiza las acciones necesarias para enviar el EAN de ese producto.
- La segunda posibilidad es que se intente listar un producto con un código EAN que ya está siendo utilizado por otro SKU en tu tienda. Este error también puede aparecer con el nombre: THD_IC_ERR_F_IC_INFRA_SPU_036 o con el código 4142. En este caso, no es necesaria ninguna acción, ya que se resolverá por sí solo en un plazo de hasta 24 horas.
- La tercera posibilidad podría ser un mensaje que diga THE_FIELD_OF_EAN_CODE_HAS_AN_ERROR_PLEASE_CHECK, indicando que el formato del EAN no es válido. Por favor, realiza las correcciones necesarias.
THD_IC_ERR_F_IC_SERVICE_EDIT_002
No se permite la edición simultánea de productos, inténtalo de nuevo. Normalmente, puede significar dos cosas:
- Producto sujeto a una promoción: Este producto es elegible para una promoción ofrecida por Miravia. No se requiere ninguna acción.
- Estás intentando actualizar la información de un grupo de productos al mismo tiempo que intentas añadir una nueva variación. Excluye la nueva variante, completa la actualización, y añádela posteriormente.
Aquí puedes encontrar la documentación para el resumen de errores de Miravia (sólo en inglés), así como su documentación para errores comunes.