¿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.
Fnac Darty, destacado grupo minorista francés formado por la fusión de Fnac y Darty, está especializado en una amplia gama de productos. Fnac ofrece artículos culturales y electrónicos como libros, música, películas, videojuegos y electrónica de consumo, mientras que Darty se centra en electrodomésticos y electrónica de consumo.
Tabla de contenidos
- Explicación de las conexiones API de Fnac Darty
- Paso de preparación
- Crea una nueva conexión Fnac Darty Offers en Channable
- Crear una nueva API de Fnac Darty Offers
- Crea tu listado de productos en Channable
- Envia tus listados de productos a Fnac Darty
- Revisa posibles errores de tus listados de productos
Explicación de las conexiones API de Fnac Darty
Existen dos conexiones diferentes y, por tanto, APIs separadas para Fnac Darty que distinguen entre tu oferta de productos y tu contenido.
- La conexión Fnac Darty Offers: Esta API (que admite una conexión de pedidos) te permite vender productos ya conocidos por Fnac o Darty, basados en códigos EAN. Si tus códigos EAN/productos son desconocidos para Fnac o Darty, la API de Fnac Darty Offers mostrará un error en el paso Vista previa llamado "ERR_026: Producto no encontrado".
- La conexión API de Fnac Darty Products: Si Fnac Darty no está familiarizado con tus EAN/productos, debes añadir tu información a la base de datos de Fnac Darty a través de la API de productos de Fnac Darty. Esta API es esencial para enviar inicialmente tus EAN y para actualizar la información de los productos, pero no requiere una activación constante.
En este artículo, te guiaremos a través de la configuración de una API de ofertas con la plataforma Fnac Darty utilizando Channable.
Paso de preparación
Para garantizar una configuración sin problemas y evitar cualquier problema, revisa y sigue estas importantes directrices:
-
EAN desconocidos/conocidos de Fnac Darty.
Esta guía asume que tus EANs son conocidos por Fnac Darty. Si tus EAN/productos son nuevos para Fnac Darty, consulta nuestro artículo de soporte sobre cómo añadir códigos EAN/productos desconocidos a Fnac Darty. -
EANs obligatorios:
Los códigos EAN son obligatorios para Fnac y Darty. Asegúrate de tener códigos EAN válidos para todos tus productos, de lo contrario, no se podrán crear listados de productos para tus productos. -
Credenciales API:
Para vender tus productos en Fnac Darty, necesitarás una cuenta de vendedor profesional. Sigue las directrices de creación de cuentas aquí (en francés, en «Inscriptions et paramètres de compte»). Una vez que te hayas registrado, ponte en contacto con Fnac Darty para obtener el ID de tienda para Fnac y el ID de tienda para Darty. Guarda estos ID, ya que los necesitarás en el siguiente paso. -
Conexión con Channable:
Sólo puede crear una conexión con Fnac Darty Francia a través de Channable. Las conexiones con otros países Fnac Darty no son compatibles en este momento.
Después de completar y revisar todos los puntos de preparación, estás listo para ir al primer paso.
Paso 1: Crea una nueva conexión Fnac Darty Offers en Channable
Para crear una conexión Fnac Darty Offers, sigue estos pasos:
- Navigate to “Connections”.
- Haz clic en «+ Añadir una nueva conexión».
- Selecciona «Fnac Darty Offers» (no «Fnac Darty products»).
- Introduce un nombre de etiqueta, por ejemplo, «Fnac Darty Offers».
Introduce el ID de la tienda
- Si estás creando una API de Fnac Darty Offers para vender sólo productos en Fnac, introduce el ID de tienda Fnac que has recibido.
- Si estás creando una API de Fnac Darty Offers para vender sólo productos en Darty, introduce el ID de tienda de Darty que has recibido.
- Si deseas vender tus productos tanto en Fnac como en Darty, deberás crear dos conexiones distintas (una con el ID de tienda de Fnac y la segunda con el ID de tienda de Darty).
Haz clic en el botón de “Crear” para guardar la conexión.
Paso 2: Crear una nueva API de Fnac Darty Offers
Para crear una nueva API, ve a tu proyecto y a «APIs > + Añadir nueva API» y selecciona la conexión de Fnac Darty Offers que has creado previamente.
Se te redirigirá a la configuración de la API, donde podrás elegir el Nombre de tu API y seleccionar el ID único por ítem.
Opcionalmente, puedes decidir utilizar un grupo de reglas generales. A continuación, haz clic en "Continuar" para crear la nueva API de Fnac Darty.
Recuerda también aquí los escenarios anteriormente mencionados:
- Para vender tus productos en Fnac, crea una API utilizando la conexión con el ID de tienda Fnac que has configurado en el paso 1.
- Para vender tus productos en Darty, crea una API utilizando la conexión con el ID de tienda Darty que has configurado en el paso 1.
Paso 3: Crea tu listado de productos en Channable
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.
Paso 5: Envía tus listados de productos a Fnac Darty
Una vez completados todos los pasos, estarás listo para enviar tus listados de productos. Sigue las siguientes instrucciones para enviar tus listados de productos:
- Ve a Configuración > Configurar tienda en el lado derecho de la pantalla.
- Haz clic en 'Activar tienda'.
- Vuelve a la Vista general de APIs
- Ve a "Nombre de tu API" > Configuración
- Selecciona “Activar API” para activarla.
- Vuelve a Vista general de APIs y haz clic en el botón azul de “Actualizar” para enviar tus productos.
Paso 6: Revisa posibles errores de tus listados de productos
Si has enviado tus listados de productos a Fnac Darty ve a la pestaña Vista previa de tu API. Ahora puedes ver qué listados de productos tienen errores y aún no están publicados
Un error común en la API de Fnac Darty Offers es el error "ERR_026: Product not found", esto significa que tus productos no son conocidos en Fnac Darty. Para solucionar este error lee nuestro artículo de soporte sobre cómo añadir EANs/productos desconocidos a Fnac Darty..
Haz clic en un error específico para ver más información sobre la causa del error.
Mejores prácticas
Añadir varios valores a un atributo: cuando añadas varios valores en un campo de atributo para Mirakl Marketplaces, separa cada valor con un símbolo de barra vertical «|» para garantizar una detección y un procesamiento adecuados.
ID de producto del vendedor para productos simples: Ten en cuenta que hay dos atributos denominados 'SellerArticleId' y 'SellerProductId', respectivamente. SellerProductId' se refiere al ID de padre, mientras que 'SellerArticleId' se refiere a los artículos variantes. Para productos simples, ambos atributos deben rellenarse con el mismo valor.
Para obtener más información sobre los errores de Mirakl Marketplace, cómo hacerlo y las mejores prácticas, consulta nuestra guía específica. Haz clic aquí para leer más.