Paso 1: Genera tus credenciales API en tu cuenta de fonQ
La API de fonQ utiliza 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, inicia sesión y navega a Mi configuración de usuario haciendo clic en tu dirección de correo electrónico en la esquina superior derecha. Después de eso, ve a la pestaña "API key" y haz clic en "generate API key" si todavía no hay ninguna clave disponible. Si hay una clave de API disponible, puedes usarla, no tienes que crear una nueva. Copia la clave de la API, ya que la necesitarás para el siguiente paso.
A continuación, deberás buscar tu identificación de la tienda en tu central de ventas. Primero selecciona la tienda a la que deseas enviar los productos en la esquina superior derecha. A continuación, ve a Mi cuenta > Configuración para encontrar tu ID de la tienda. Copia también tu ID de la tienda, lo necesitarás para el siguiente paso.
Paso 2: Crear una nueva API de fonQ en Channable
Ve a Channable, abre tu proyecto y ve a APIs > Añadir nueva API. Se abrirá una nueva pantalla con la configuración de la API en la que podrás hacer clic en el botón "+ Añadir nueva conexión".
Se te enviará a una vista en la que podrás seleccionar "fonQ" para crear una nueva conexión. Introduce un nombre para la conexión en "Etiqueta", recomendamos nombrar tu conexión "fonQ API". Rellena los campos con la clave de la API y el ID de la tienda que has copiado en el paso 1, y haz clic en el botón "Crear" para guardar tu conexión.
A continuación, se te redirigirá de nuevo al paso Configuración de la API, donde podrás dar un nombre a la API. Después de elegir un nombre, haz clic en el botón "Continuar" para crear tu nueva API de fonQ.
Diferencia entre una oferta y un producto en la API de fonQ
Antes de crear tus listados de productos es importante entender la diferencia entre enviar una oferta y un producto a través de la API de fonQ.
- Oferta: Una oferta solamente incluye los campos del paso "Crear" de la API
- Producto: Un producto tiene más información que una oferta, como un paso de categorización y atributos rellenados, y es necesario cuando los artículos son nuevos en fonQ
Si no tienes una tienda con sede en los Países Bajos y tus productos no son conocidos por fonQ, tendrás que crear una tienda de Países Bajos y configurar una API de producto para estos productos desconocidos. Tendrás que categorizar estos productos y enviarlos a la tienda de los Países Bajos para que estos productos se conviertan en conocidos. Una vez hecho esto, podrás configurar una segunda API para crear ofertas de Bélgica, pero esto hará que se creen ofertas en la tienda de los Países Bajos también. Por lo tanto, para evitar esto, tendrás que borrar la API de Países Bajos una vez que los productos hayan sido aceptados.
Paso 3: Crea tu listado de productos en Channable
Una vez creada la API de fonQ, puede configurar los datos de tus productos siguiendo los pasos de la API:
- Categorías
Aconsejamos que primero intentes enviar tus productos sin rellenar las categorías. Si fonQ ya está familiarizado con los códigos EAN de tus productos, no necesitarás hacer este paso. Si los productos son nuevos para la plataforma, verás el siguiente error en el paso de previsualización de la API: "mirakl_unknown_error_code". - Reglas
Crea diversas reglas para optimizar tus listados de productos. Para ver ejemplos, echa un vistazo a nuestro artículo de apoyo a las reglas comunes. - Crea
Aquí puedes encontrar nuestra plantilla preestablecida para los listados de productos. Todo lo que tienes que hacer es rellenarlo haciendo clic en el campo de tu elección y seleccionar el valor que te gustaría añadir a este. Por ejemplo, el campo "Título" debería mostrar el título de tu producto y así sucesivamente. Cuando hayas terminado de configurar los listados de productos, sólo tienes que hacer clic en "Guardar" en la parte inferior de la pantalla.
¡Consejo! Fíjate en el signo de interrogación que hay al lado de cada campo; si pasas el cursor por encima del signo de interrogación, verás la descripción del campo y sugerencias de posibles valores.
- Atributos
Al igual que con el paso de las categorías, aconsejamos que primero intentes enviar tus productos sin rellenar los atributos. Si fonQ ya está familiarizado con los códigos EAN de tus productos, no necesitarás hacer este paso.
Paso 4: Envía tu listado de productos a fonQ
¡Ya casi está! tus listados de productos están listos para ser enviados. Si no has activado tu proyecto, ve al panel de configuración en la parte izquierda de la pantalla y haz clic en "activar proyecto". Después, vuelve a la vista general de las API y ve a "(Nombre API) de fonQ" > Configuración, donde activas la API seleccionando "Activar API". Una vez completado este paso, vuelve a la vista general de APIs y selecciona el botón azul "Ejecutar ahora" para enviar tus listados de productos a fonQ.
Paso 5: Comprueba que no haya errores en tus listados de productos
Si has enviado tus listados de productos a fonQ, ve a la pestaña Previsualización de tu API de fonQ. Haz clic en "error". Ahora puedes ver qué listados de productos tienen errores y no están creados. Haz clic en un error específico para ver más información sobre la causa del mismo y consulta nuestra sección de soluciones a errores para más información sobre cómo corregirlos. Si ves el "mirakle_unkown_error_code" para productos, sigue esta guía sobre cómo resolver este error.