> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/list-advertise/list-and-advertise-es/vende-en-marketplaces/marketplaces-mirakl/configuracion-de-una-api-de-fonq.md).
# Configurando una API de fonQ
{% hint style="warning" %}
Nota: Este artículo asume que ya has anunciado en fonQ con tus productos. Si eres nuevo en la publicidad en fonQ, asegúrate de conocer [cómo añadir códigos EAN desconocidos a fonQ](/list-advertise/list-and-advertise-es/vende-en-marketplaces/marketplaces-mirakl/guia-de-mirakl-configuracion-e-soluciones.md). Los códigos EAN son obligatorios para fonQ. 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 ellos.
{% endhint %}
Puedes ir directamente a los pasos detallados a continuación:
{% stepper %}
{% step %}
### 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.
| | |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [](https://helpcenter.channable.com/hc/article_attachments/7742486167570) | [](https://helpcenter.channable.com/hc/article_attachments/7742427569426) |
| {% endstep %} | |
{% step %}
### 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.
[](https://helpcenter.channable.com/hc/article_attachments/19237523625874)
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.
{% hint style="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.
{% endhint %}
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.
{% endstep %}
{% step %}
### 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:
{% stepper %}
{% step %}
#### 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"](/list-advertise/list-and-advertise-es/vende-en-marketplaces/marketplaces-mirakl/guia-de-mirakl-configuracion-e-soluciones.md).
{% endstep %}
{% step %}
#### Reglas
Crear [diferentes reglas](/manage-improve-product-data/manage-product-and-improve-data-es/reglas-edicion-masiva-y-enriquecimiento/uso-de-reglas.md) para optimizar tus listados de producto.
{% endstep %}
{% step %}
#### 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.
[](https://helpcenter.channable.com/hc/article_attachments/15230232201106)
{% endstep %}
{% endstepper %}
{% endstep %}
{% step %}
### Requisitos GPSR y DSA
La Unión Europea (UE) ha introducido nuevos [Requisitos GPSR y DSA](/list-advertise/list-and-advertise-es/vende-en-marketplaces/empezar-con-marketplaces/lo-que-necesitas-hacer-para-cumplir-con-gpsr-y-dsa.md) 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.
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% step %}
### 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.
{% endstep %}
{% endstepper %}
### Buenas prácticas
Haz clic para ampliar las mejores prácticas
* 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](/list-advertise/list-and-advertise-es/vende-en-marketplaces/marketplaces-mirakl/guia-de-mirakl-configuracion-e-soluciones.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-es/vende-en-marketplaces/marketplaces-mirakl/configuracion-de-una-api-de-fonq.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.