gearConfigurar una API de fonQ

circle-exclamation
circle-info

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.

Puedes ir directamente a los pasos detallados a continuación:

1

Paso 1: Añadir una nueva conexión fonQ

La API de fonQ usa la plataforma Mirakl, lo que significa que necesitarás una cuenta Mirakl para empezar a enviar tus listados de productos a fonQ.

Cuando tengas una cuenta Mirakl fonQ, ve a Conexiones > Nueva conexión. Haz clic en "+ Añadir una nueva conexión" y selecciona fonQ. Rellena la etiqueta para tu conexión (por ejemplo: fonQ). Luego haz clic en "Conectar con fonQ". Serás redirigido al entorno donde podrás iniciar sesión con tus credenciales Mirakl. Tras iniciar sesión, volverás a Channable y la conexión estará disponible.

2

Paso 2: Crear una nueva API de fonQ en Channable

Ve a la vista general de APIs en tu proyecto y haz clic en "+ Añadir nueva API". Selecciona la conexión fonQ que creaste y ponle un nombre a tu nueva API.

arrow-up-right

Selecciona el campo que quieres usar como ID único por ítem (recomendamos el campo 'id') y el País en el que quieres vender. También puedes añadir aquí un grupo de reglas generales si lo deseas. Haz clic en Continuar para terminar de crear la nueva API de fonQ.

Diferencia entre una Oferta y un Producto en la API de fonQ:

  • Oferta: Una oferta solo incluye los campos del paso Crear (Build) de la API.

  • Producto: Un producto tiene más información que una oferta (por ejemplo, categorización y atributos rellenos) y se necesita cuando los ítems son desconocidos para fonQ.

circle-info

Nota: fonQ NL ACEPTA SÓLO envíos de Producto a tiendas con base en NL. Si tu tienda no es NL, deberías enviar ofertas sin categorizar tus datos.

Si tus productos no son conocidos por fonQ y no tienes una tienda NL, tendrás que crear una tienda NL y configurar una API de Producto para productos desconocidos (categorizar y enviarlos a la tienda NL). Una vez aceptados, puedes configurar una segunda API para crear ofertas en BE, pero esto también podría crear ofertas en la tienda NL; para evitarlo, es posible que necesites vaciar la API NL una vez que los productos hayan sido aceptados.

3

Paso 3: Crear tus listados de producto en Channable

Una vez creada la API de fonQ puedes configurar tus datos de producto siguiendo los pasos de la API:

1

Categorías

Aconsejamos intentar primero enviar tus productos sin hacer las categorías. Si fonQ ya conoce los códigos EAN de tus productos, no necesitarás hacer este paso. Si los productos aún no son conocidos, verás el siguiente error en el paso de Vista previa (Preview) de la API: "mirakl_unknown_error_code".

2

Reglas

Crear diferentes reglas para optimizar tus listados de producto.

3

El paso de

Aquí puedes encontrar nuestra plantilla predefinida para los listados de producto. Rellénala haciendo clic en un campo y seleccionando el valor con el que quieres llenarlo (por ejemplo, asignar el campo Title para que muestre el título del producto). Cuando termines, haz clic en Guardar en la parte inferior de la pantalla.

circle-check

1. FonQ.pngarrow-up-right

4

Requisitos GPSR y DSA

La Unión Europea (UE) ha introducido nuevos Requisitos GPSR y DSA para plataformas online, incluidos los marketplaces.

Para tu API de fonQ en Channable, asegúrate de rellenar la pestaña atributos por categoría en el paso Build:

  • Adres Marktdeelnemer: Proporciona la dirección completa del fabricante o importador.

  • Email Marktdeelnemer: Introduce la dirección de correo electrónico del fabricante o importador.

  • Naam Marktdeelnemer: Indica el nombre del fabricante o importador.

  • Telefoon Marktdeelnemer: Proporciona un número de teléfono válido del fabricante o importador.

5

Paso 4: Envía tus datos de producto a fonQ

Si no has activado tu proyecto, ve a Ajustes del proyecto en el menú izquierdo y haz clic en Activar proyecto. Luego vuelve a la vista general de Canales, abre "Tu nombre de API fonQ > Configuración" y activa la API seleccionando "Activar la API". Tras la activación, haz clic en el botón azul "Actualizar" para enviar tus listados de producto a fonQ.

6

Paso 5: Comprueba tus listados de producto en busca de errores

Después de enviar tus listados a fonQ, ve a la pestaña Vista previa de tu API fonQ y haz clic en Errores. Allí verás qué listados tienen errores y no se han creado. Haz clic en un error específico para ver más información.

Buenas prácticas

chevron-rightHaz clic para ampliar las mejores prácticashashtag
  • Añadir múltiples valores de atributo: al añadir varios valores en un campo de atributo para los marketplaces Mirakl, separa cada valor con una barra vertical "|" para asegurar su correcta detección y procesado.

  • ID de producto del vendedor para productos simples/sencillos: hay dos atributos llamados 'SellerArticleId' y 'SellerProductId'. 'SellerProductId' se refiere al ID padre, mientras que 'SellerArticleId' se refiere a las variantes. Para productos sencillos, ambos atributos deben rellenarse 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.

Última actualización

¿Te fue útil?