¿Quieres aprender de forma interactiva todos los aspectos básicos relacionados con la creación de una exportación de API, o cómo realizar una configuración avanzada para una API en Channable? Aprende a hacerlo creando una cuenta Channacademy en la App de Channable utilizando este artículo del Centro de Ayuda, y comienza con el curso APIs Básicas o APIs Expertas.
Para empezar a vender tus productos en el marketplace de Miravia, deberás tener una cuenta de vendedor en 'Miravia' . Al configurar los productos en Miravia, empezarás a vender en el marketplace de Miravia. Si aún no tienes una cuenta de vendedor en Miravia, te aconsejamos ponerte en contacto con MIravia para obtenerla. Una vez que hayas creado una cuenta de vendedor en Miravia, podrás empezar a conectarte con Channable.
Tabla de Contenido
- Crea una nueva conexión
- Crea la API
- Crea tus listados de Productos
- Envía tus listados de productos a Miravia
- Comprueba si hay errores en los listados de productos
Paso 1 - Crea una nueva conexión
Para crear una nueva conexión con Miravia, sigue los pasos que se indican a continuación:
- Comienza navegando a la página de API dentro de tu proyecto y haz clic en el botón "+Añadir nueva API". Esta acción te redirigirá a la página de conexiones de tu compañía.
2. En la página de conexiones, selecciona "+Añadir una nueva conexión".
3. Busca la conexión «Miravia» haciendo clic a través de las páginas, después de encontrar la conexión "Miravia", proporciona una etiqueta para esta nueva conexión.
4. Haz clic en "Conectar con Miravia" Se te redirigirá a Miravia para el siguiente paso. Una vez redirigido, inicia sesión con tus credenciales de Miravia.
Después de autorizar la conexión, se te transferirá de nuevo a Channable. Aquí, puedes terminar de crear la conexión haciendo clic en "Agregar nueva conexión".
Paso 2 - Crea la API
Una vez de vuelta, deberás seleccionar tu nueva conexión con Miravia y continuar configurando tu API.
-
Configuración de la API:
- Nombra tu API
- Selecciona el idioma de tu API
- Elige el ID único por ítem. (recomendamos el campo 'id')
2. Crea la API: Haz clic en "Continuar" para crear la nueva API de Miravia.
Paso 3 - Crea 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 información es específica de Miravia, en cada pestaña se explica lo que debe tener en cuenta.
Pestaña de ítem
- ID del grupo de ítems: Este campo se utiliza para agrupar artículos con múltiples variantes en un único listado. Si no hay múltiples variantes, selecciona el ID único del producto para item_group_id.
Pestaña de envíos
- Campos obligatorios: Asegúrate de que todos los campos de información de envío, como peso, longitud y contenido, se completan con valores mayores que 0 y con no más de 2 decimales. Si no tienes estos datos, defínelos como valores 1 mediante una regla.
- Entrega por el vendedor: Configura esta opción en "Sí" sólo con autorización previa de Miravia; en caso contrario, configúrala en «No» para evitar errores. Consulta el artículo sobre cómo utilizar "Delivery by Miravia" en Channable para obtener información detallada..
- Valores por defecto: Si los valores de envío son desconocidos, configuralos todos a 1 mediante una regla.
Pestaña de Imágenes
- Vinculación de imágenes: Vincula el campo o campos que contienen tus imágenes en la pestaña Imágenes.
- Requerimientos de Imagen:Es necesario cumplir con los estrictos requisitos de Miravia tanto para la URL como para la propia imagen. En caso contrario, aparecerá el mensaje «No se ha podido cargar la imagen debido a...»: .. E302: «Descripción del error», en la pestaña de resultados.
Seguir estas directrices te ayudará a asegurarte de que tus listados de Miravia están configurados correctamente y de acuerdo con sus requisitos.
Paso 4 - Envía tus listados de productos a Miravia
Ya casi está, tus listados de productos están listos para ser enviados. Si no has activado tu proyecto, ve a la pestaña Configuración de tu proyecto en la parte izquierda de la pantalla y haz clic en "Activar Tienda".
Después, vuelve a la vista general de APIs y ve a [Tu API de Miravia] > Configuración, donde activarás la API haciendo clic en "Activar API".
Una vez activada la API, vuelve a la vista general de APIs y haz clic en el botón azul "Actualizar" para enviar tus listados de productos a Miravia.
Paso 5 - Comprueba si hay errores en los listados de productos
Para comprobar si hay errores, ve a la página de Resultados de la API > pestaña Errores, donde verás qué productos tienen errores. Al hacer clic en el específico, se mostrará más información sobre lo que está causando el error. Para más información sobre el significado de los errores, lee este artículo.