A la página principal
  1. Channable
  2. APIs
  3. API Mirakl

Artículos en esta sección

Más información

Configurar una API Fnac Darty Products

¿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

  1. Explicación de las conexiones API de Fnac Darty
  2. Paso de preparación
  3. Crea una nueva conexión Fnac Darty Products en Channable
  4. Crear una nueva API de Fnac Darty Products
  5. Crea tu listado de productos en Channable
  6. Envia tus listados de productos a Fnac Darty
  7. 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 Productos 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:

  1. 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. 
  2. 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.
  3. 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. 
  4. 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 Products en Channable

Para crear una conexión Fnac Darty Products, sigue estos pasos:

  1. Navigate to “Connections”.
  2. Haz clic en «+ Añadir una nueva conexión».
  3. Selecciona «Fnac Darty Products» (no «Fnac Darty Offers»).
  4. Introduce un nombre de etiqueta, por ejemplo, «Fnac Darty Products».
Sing_in_Mirakl_-_Oauth.png

Haz clic en el botón de “Crear” para guardar la conexión.

Paso 2: Crear una nueva API de Fnac Darty Products

Para crear una nueva API, ve a tu proyecto y a «APIs > + Añadir nueva API» y selecciona la conexión de Fnac Darty products 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.

Paso 3: Crea tu listado de productos en Channable

Nota: En los próximos meses iremos desplegando gradualmente Marketplaces V2. Si tu API está en Marketplaces V1, estos pasos pueden ser diferentes. Consulta este artículo para obtener más información. 

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

Haz clic aquí para leer más sobre las Reglas en las API.

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

  1. 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.
  2. 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

  1. 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.

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

  1. Selecciona la categoría del producto: Elige la categoría relevante para tu producto, como ropa o muebles.
  2. 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.

Haz clic aquí para leer más sobre el paso Calidad

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.

Haz clic aquí para leer más sobre el paso Vista previa.

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. 

Información adicional para Fnac Darty Products

Para la API de Productos, sólo tienes que seleccionar tu campo EAN en el paso Crear, haciendo clic en el propio atributo. Cuando hayas seleccionado el campo EAN correcto, haz clic en «Guardar» en la parte inferior de la pantalla.

Paso 4: 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:

  1. Ve a Configuración > Configurar tienda en el lado derecho de la pantalla.
  2. Haz clic en 'Activar tienda'.
  3. Vuelve a la Vista general de APIs
  4. Ve a "Nombre de tu API" > Configuración
  5. Selecciona “Activar API” para activarla.
  6. Vuelve a Vista general de APIs y haz clic en el botón azul de “Actualizar” para enviar tus productos.

Paso 5: Comprueba si hay errores en los datos de tus productos

Si has enviado los datos de tus productos, ve a la pestaña Resultados de tu API de Fnac Darty Products. Haz clic en 'filtrar por error'. Ahora puedes ver qué listados de productos tienen errores y no están publicados. Haz clic en un error específico para ver una explicación de la causa del error.

En ocasiones, es posible que la API de productos no cree ningún producto y que Fnac Darty no envíe ningún mensaje de error a Channable. Si esto ocurre, hay dos formas de obtener un informe de error más detallado:

¿Cómo descargar el informe de errores en la plataforma de Fnac?

  1. Accede a la plataforma Fnac y ve a 'Mi inventario' > 'Importar desde archivo'.
  2. Selecciona 'Seguimiento de importaciones de productos'.
  3. Descarga el/los informe/s de error desde la parte derecha de la pantalla.

¿Cómo descargar el informe de errores en Fnac Darty Mirakl?

  1. Inicia sesión en tu cuenta Mirakl y ve a 'Catalog' > 'Product Imports'.
  2. En la sección 'Product Imports', encontrarás una lista de las importaciones realizadas por Channable, junto con sus fechas y horas.
  3. Haz clic en el botón 'See details' correspondiente a la importación más reciente para acceder a los últimos detalles del error.
  4. Selecciona 'Non-integrated products report' de las opciones presentadas. Esto descargará automáticamente el informe de errores. En este artículo se explica con más detalle cómo obtener un informe de errores de Mirakl.

Siguiendo estos pasos, podrás realizar un seguimiento eficiente y resolver cualquier problema con tus listados de productos en la(s) plataforma(s) de Fnac Darty.

Paso 6: Desactivar la API de Fnac Darty Products

Como se ha mencionado anteriormente, la API de Fnac Darty Products sólo tiene que estar activa para el envío inicial de EAN y las actualizaciones de contenido.

  • Ve al paso Vista previa de la API de Fnac Darty Offers. Para más información sobre la API de Fnac Darty Offers, lee este artículo.
  • Si aparece el error «ERR_026: Producto no encontrado», activa la API de Fnac Darty Products.

Si el error no aparece en el paso Vista previa, procede a desactivar la API de Fnac Darty Products.

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.