Nota I: Este artículo asume que ya has anunciado tus productos en fonQ. Si eres nuevo en la promoción de artículos a través de fonQ, por favor lee también nuestro artículo de apoyo sobre cómo añadir códigos EAN desconocidos a fonQ.
Nota II: Los códigos EAN son obligatorios para fonQ. Asegúrate de que tienes códigos EAN válidos para todos tus productos, de lo contrario no se podrán crear listados de productos para tus productos.
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 bsucar 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.
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.