Configurar una API de vtwonen
Actualización de interfaz: Hay una nueva página de selección de canales y una visión general para Feeds y Marketplaces (anteriormente llamadas API). Algunas imágenes e instrucciones pueden no estar actualizadas.
Paso 1: Crea una nueva conexión
Navega a [Tu proyecto] > Canales.
Haz clic en +Añadir nueva API. Esto te redirigirá a la página de conexiones de tu compañía.
En la página de conexiones, selecciona +Añadir una nueva conexión.
Busca la conexión "vtwonen" navegando por las páginas y selecciónala haciendo clic en ella.
Añade una etiqueta.
Haz clic en Crear. Serás redirigido a vtwonen para el siguiente paso.
Una vez redirigido, inicia sesión con tus credenciales de vtwonen.
Después de iniciar sesión correctamente, la conexión con vtwonen estará lista. A continuación, serás llevado de vuelta a la configuración de la API.
Paso 2: Crea la API
Una vez creada la conexión, debes seleccionar tu nueva conexión vtwonen y configurar los ajustes de tu API:
En la Nombre campo, introduce un nombre para tu API.
Elige el ID único por ítem del menú desplegable. Recomendamos el campo 'id'.
Selecciona el Idioma para tu API.
Haz clic en Continuar para crear tu API de vtwonen.
Paso 3: Crea tus listados de producto
Sigue estos pasos para configurar tu canal.
Categoriza tus productos
Para configurar tus datos de producto, asigna categorías a tus productos.
Categorización de productos con IA: Asigna automáticamente categorías de producto mediante nuestro algoritmo.
Categorización manual: Asigna manualmente categorías de producto con reglas personalizadas. Puedes crear filtros detallados para mapear cada producto a la categoría correcta.
Productos sin categorizar: Productos que aún necesitan ser revisados y categorizados
Configura reglas
Las reglas te ayudan a optimizar rápidamente los datos de tus productos para el marketplace donde quieres vender.
Plantillas de reglas: Reglas de uso común que puedes ajustar para tu caso.
Configuración de reglas: Configura reglas para refinar tus datos de producto. Esto puede incluir filtrar, modificar o mejorar campos de datos para cumplir con los requisitos del marketplace.
Construye tus listados
El Crear paso es donde configuras tus listados de producto para cumplir los requisitos del marketplace. Es un paso esencial para publicar tus productos y evitar errores.
Campos obligatorios y opcionales:
Campos obligatorios : Requeridos para listar tus productos en este marketplace
Recomendado : Recomendado para evitar errores
Opcional : No requerido para listar
Atributos compartidos
Los atributos compartidos son los campos comunes que aplican a tus productos, como EAN, precios y títulos. Este paso garantiza uniformidad en la información básica de tus listados.
Usa valores estáticos o dinámicos:
Valores estáticos: Valores fijos que no cambian (p. ej., nombre de la marca, fabricante)
Valores dinámicos: Campos que cambian automáticamente según los datos vinculados (p. ej., stock, precios)
Atributos específicos por categoría
Los atributos específicos por categoría son campos que se aplican concretamente a la categoría de tus productos. Este paso ayuda a ajustar tus listados para cumplir los requisitos por categoría del marketplace.
Rellena los atributos específicos de la categoría seleccionada (p. ej., talla para ropa o dimensiones para muebles).
Consejo: Haz clic en Auto-map fields para mapear automáticamente utilizando información de tus otros canales u otras configuraciones similares. Saber más.
Comprueba la calidad de tu configuración
El Calidad El paso ofrece feedback sobre tu canal antes de activarlo. Resalta errores obligatorios y opcionales para asegurar que los datos de tu producto cumplen los requisitos para listarse en el marketplace.
Soluciona errores, priorizando primero los errores obligatorios.
Acciones:
Ver ítems: Ver productos con problemas específicos.
Ver en crear: Redirige al Crear paso para mapear información faltante.
Asignar categorías: Dirige al Categorías paso para categorizar ítems.
Mostrar origen: Disponible para campos de ID. Dirige al Ajustes paso.
Vista previa antes de activar
El Vista previa El paso muestra los atributos que mapeaste en el Crear paso, ayudándote a comprobar si todo está configurado correctamente al ofrecer una visión general de tus productos y errores potenciales.
Filtrado:
Filtrar por error: Haz clic en el Todo desplegable y selecciona si quieres filtrar para mostrar solo productos con errores, o productos con un error específico.
Filtrar por categoría: Haz clic en el Todas las categorias desplegable y selecciona la categoría por la que quieres filtrar.
Antes de continuar:
Revisa Atributos compartidos: Asegúrate de que todos los atributos compartidos obligatorios estén completos.
Revisa Atributos específicos por categoría: Asegúrate de que todos los atributos específicos de categoría obligatorios estén completos.
Busca errores: Corrige cualquier campo marcado en rojo.
Requisitos adicionales para vtwonen
Estos requisitos de atributos son específicos de vtwonen y se aplican a los atributos en la Crear paso.
Pestaña de atributos compartidos
Clase de envío (clase logística): Las clases logísticas determinan los costes de envío correspondientes para tus ítems. Introduce la clase logística de tu producto.
Plazo de envío: El tiempo de preparación indica el tiempo necesario hasta que el paquete se entregue al servicio de transporte. Indica el tiempo de envío en días.
Requisitos del título
Los títulos de producto deben consistir en lo siguiente:
Marca
El nombre de la marca tal como está registrado
Tipo de producto
La categoría de producto, por ejemplo, "sofa". Esto debe escribirse en minúsculas
Serie/nombre del producto
La serie o nombre del producto que ayuda a identificar la variante del producto. Cada palabra debe escribirse con letra inicial mayúscula
Atributos
Las características distintivas del producto, por ejemplo, color, dimensiones o material
Estructura: Marca Tipo de producto Nombre - Atributos
Ejemplo: lámpara colgante vtwonen Titan - negra.
Descripción del producto
Las descripciones de producto para tu API de vtwonen deben:
dirigirse al cliente (“tú” y “tu”)
estar redactadas en un tono amable, útil y respetuoso
evitar jerga o términos técnicos, si no son relevantes para el público objetivo
describir las características del producto y los beneficios y la experiencia
usar palabras clave relevantes
no contener abreviaturas
Las descripciones de producto deben consistir en lo siguiente:
Descripción corta
Una visión general del producto para resaltar las características más importantes. No se permite HTML
Puntos clave
Las características y beneficios clave del producto. Mínimo 3 y máximo 5 puntos
Descripción larga
Información detallada sobre las características, especificaciones, materiales y uso del producto. Además, consejos de estilo y mantenimiento. Se permite HTML (negrita y listas)
Requisitos de imagen
Resolución mínima
800 x 800 px
Resolución máxima
4472 x 4472 px
Formatos compatibles
JPEG, PNG, WebP, GIF
Estilo
No usar marcas de agua, logotipos ni componentes de texto
Requisitos de vídeo
Duración
Entre 30 seg. y 2 min
Resolución
1080p o superior
Formatos compatibles
.mp4, .mov, .avi, .flv
Estilo
Sin bordes, bocetos, marcas de agua, logotipos, etiquetas ni precios
Buenas prácticas
Añadir múltiples valores de atributo: Al añadir varios valores en un campo de atributo para Mirakl Marketplaces, separa cada valor con una barra vertical "|" para asegurar la detección y el procesamiento correctos.
ID de producto del vendedor para productos individuales/simples: Hay dos atributos llamados 'SellerArticleId' y 'SellerProductId', respectivamente. 'SellerProductId' se refiere al ID padre, mientras que 'SellerArticleId' se refiere a los artículos variantes. Para productos individuales, ambos atributos deben completarse con el mismo valor.
Para más información sobre errores de Mirakl Marketplace, guías y buenas prácticas, consulta nuestra guía dedicada.
Paso 4: Envía tus listados de producto a vtwonen
Una vez que tus listados de producto estén listos, necesitas enviarlos a vtwonen:
Si no has activado tu proyecto, ve a [Tu proyecto] > Ajustes de compañía y haz clic Activar proyecto.
En [Tu proyecto] > APIs, ve a [Tu vtwonenAPI] > Ajustes de compañía.
Haz clic en Activar la API.
Una vez que hayas activado la API, ve de nuevo a APIs.
Haz clic en el Ejecutar ahora botón en la columna 'Estado' para enviar tus listados de producto a vtwonen.
Última actualización
¿Te fue útil?