> 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/vender-en-marketplaces/marketplaces-de-mirakl/configuracion-de-una-api-de-maisons-du-monde.md).

# Configuración de una API de Maisons du Monde

{% hint style="info" %}
**Actualización de la interfaz:** Ahora puedes encontrar la información sobre errores en la **Feedback** pestaña (antes la **Errores** pestaña) de la **Build** paso.
{% endhint %}

{% hint style="info" %}
**Actualización de la interfaz:** Hay una nueva página de selección de canal y visión general para **Feeds** e **Marketplaces** (antes llamadas APIs). Algunas imágenes y instrucciones pueden no estar actualizadas.&#x20;
{% endhint %}

Maisons du Monde es una empresa francesa de muebles y decoración para el hogar con casi 250 tiendas en Francia, Italia, España, Luxemburgo, Bélgica, Alemania y Suiza. Más de 190 de estas tiendas están en Francia.

{% stepper %}
{% step %}

### Nueva conexión de Maisons du Monde

Maisons du Monde utiliza la plataforma Mirakl, lo que significa que necesitarás una cuenta de Mirakl para empezar a enviar tus listados de productos a Maisons du Monde.

Cuando tengas una cuenta de Mirakl de Maisons du Monde, abre **Ajustes de compañía**:

{% tabs %}
{% tab title="Versión moderna" %}
En el desplegable de la empresa, Seleziona **Ajustes de compañía**.
{% endtab %}

{% tab title="Versión antigua" %}
In la barra lateral mientras estés In la compañía, Seleziona **Ajustes de compañía**.
{% endtab %}
{% endtabs %}

allora ve a **Conexiones** y haz clic en **+ Nueva conexión**. Seleziona Maisons du Monde. Completa la etiqueta de la conexión, por ejemplo, Maisons du Monde. Luego haz clic en **Conectar con Maisons du Monde**. Se te redirige al entorno donde inicias sesión con tus credenciales de Mirakl. Después de iniciar sesión, vuelves a Channable, donde la conexión estará disponible.

\[Necesita revisión: no se ha podido confirmar la ruta de la versión moderna para “Conexiones”.]

| ![Maisons 1.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/YAMrWWxmslkPHzV9c9mj/14624671065618) | [![Mirakl API - Worten.png](broken://files/fd647850d0cd4bc0cec233c2e2458eb5732f70e2)](https://helpcenter.channable.com/hc/article_attachments/21017891330194) |
| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |

\[Necesita revisión: la captura de pantalla puede mostrar la navegación de la versión heredada]
{% endstep %}

{% step %}

### Añade una nueva API de Maisons du Monde en Channable

Ve a la visión general de la API de tu proyecto y Seleziona Añadir nueva API. Seleziona la conexión de Maisons du Monde que acabas de crear y dale un nombre a la nueva API.

\[Necesita revisión: no se ha podido confirmar la ruta de la versión moderna para “visión general de la API”.]

![Maisons 2.png](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/JDB546Gzl8U1u8m2DOht/14624660556562)

Seleziona el campo que quieras usar para **ID único por ítem** (recomendamos el campo 'id'), y Seleziona la **Idioma** para la configuración de categorizaciones y atributos. Además, tienes la opción de incluir un Grupo de regole maestro si lo deseas. Haz clic en "Continuar" para terminar de crear la nueva API de Maisons du Monde.

{% hint style="info" %}
**Importante:** Maisons du Monde tiene la opción de definir Canales de venta en nuestra API. Si quieres saber más sobre los canales o sobre cómo configurarlo, sigue los pasos de [este artículo](https://helpcenter.channable.com/hc/en-us/articles/11883675662482). Es importante tener en cuenta que configurar APIs separadas de Maisons du Monde para distintos países usando la misma conexión no funcionará, porque las APIs se sobrescribirán entre sí.
{% endhint %}
{% endstep %}

{% step %}

### Crea tus listados de productos en Channable

Sigue estos pasos para configurar tu canal.

{% stepper %}
{% step %}

#### Categoriza tus productos

Para configurar los datos de tus productos, asigna Categorías a tus productos.

* **Categorización de productos con IA:** Asigna automáticamente categorías de producto mediante nuestro algoritmo.
* **Categorización manual:** Asigna manualmente las categorías de producto con reglas personalizadas. Puedes crear filtros detallados para asignar cada producto a la categoría correcta.
* **Productos sin categorizar:** Productos que todavía hay que revisar y categorizar

[Más información sobre cómo categorizar para marketplaces](/list-advertise/list-and-advertise-es/vender-en-marketplaces/empieza-con-marketplaces/marketplaces-paso-di-categorizacion.md)
{% endstep %}

{% step %}

#### Configura las reglas

Las reglas te ayudan a optimizar rápidamente los datos de tus productos para el marketplace en el que quieres vender.

* **Modelli di regole:** Reglas de uso común que puedes adaptar a tu caso.
* **Instalación de reglas:** Configura reglas para refinar los datos de tus productos. Esto puede incluir filtrar, modificar o mejorar campos de datos para cumplir los requisitos del marketplace.

[Más información sobre el uso de reglas para marketplaces](/list-advertise/list-and-advertise-es/vender-en-marketplaces/empieza-con-marketplaces/marketplaces-paso-di-reglas.md)
{% endstep %}

{% step %}

#### Configura tus listados

El **Build** paso es donde configuras tus listados de productos para que cumplan los requisitos del marketplace. Es un paso esencial para publicar tus productos y evitar errores.

Campos obligatorios y opcionales:

* **Campos obligatorios** : Necesarios para publicar tus productos en este marketplace
* **Recomendado** : Recomendado para evitar errores
* **Opcional** : No necesarios para publicar

Atributos compartidos: los atributos compartidos son los campos comunes que se aplican a todos tus productos, como el EAN, los precios y los títulos. Este paso garantiza la uniformidad de la información básica de los productos en tus listados.

* **Utiliza valores estáticos o dinámicos**
  * **Valores estáticos:** Valores fijos que no cambian (por ejemplo, nombre de la marca, fabricante)
  * **Valores dinámicos:** Campos que cambian automáticamente en función de los datos vinculados (por ejemplo, stock, precios)

Atributos específicos de la categoría: los atributos específicos de la categoría son campos que se aplican específicamente a la categoría de tus productos. Este paso ayuda a ajustar tus listados para cumplir los requisitos de la categoría de tu marketplace.

Rellena los atributos específicos de la categoría seleccionada (por ejemplo, la talla en ropa o las dimensiones en muebles).

{% hint style="success" %}
Consejo: haz clic en **Mapear campos automáticamente** para asignar automáticamente las categorías con la información proporcionada previamente en el mismo canal.
{% endhint %}

[Más información sobre el paso de configuración para marketplaces](/list-advertise/list-and-advertise-es/vender-en-marketplaces/empieza-con-marketplaces/marketplaces-paso-de-creacion.md)
{% endstep %}

{% step %}

#### Comprueba la calidad de tu configuración

El **Calidad** El paso proporciona feedback sobre tu canal antes de activarlo. Resalta los errores obligatorios y opcionales para garantizar que los datos de tus productos cumplan los requisitos para publicarlos en el marketplace.

* Soluciona los errores, priorizando primero los errores obligatorios.

Acciones:

* **Visualizza articoli**: Mira los productos con errores específicos.
* **Ver en crear**: Te redirige al **Build** paso para mapear la información que falta.
* **Define categorías**: Te lleva al **Categorías** paso para categorizar los Articoli.
* **Muestra target**: Disponible para campos ID. Te lleva al **Configuración** paso.

[Más información sobre el paso de Calidad para marketplaces](/list-advertise/list-and-advertise-es/vender-en-marketplaces/empieza-con-marketplaces/marketplaces-paso-de-calidad.md)
{% endstep %}

{% step %}

#### Anteprima antes de activar

El **Anteprima** paso muestra los atributos que mapeaste en el **Build** paso, ayudándote a comprobar si todo está configurado correctamente al ofrecer una visión general de tus productos y posibles errores.

Filtrado:

* **Filtrar por error:** Haz clic en el **todo** desplegable y selecciona si quieres filtrar para mostrar solo productos con errores, o productos con un error específico.
* **Filtrar por categoría:** Haz clic en el **Todas las categorias** desplegable y selecciona la categoría por la que quieres filtrar.

Antes de continuar:

* **Revisa Atributos compartidos**: Asegúrate de rellenar todos los atributos compartidos obligatorios.
* **Revisa los atributos específicos de la categoría**: Asegúrate de rellenar todos los atributos específicos obligatorios de la categoría.
* **Comprueba si hay errores**: Corrige cualquier campo marcado en rojo.

[Más información sobre el paso de Anteprima para marketplaces](/list-advertise/list-and-advertise-es/vender-en-marketplaces/empieza-con-marketplaces/marketplaces-paso-de-anteprima.md)
{% endstep %}
{% endstepper %}

### Información adicional sobre Maisons du Monde:

Las APIs de Mirakl no tienen un 'title' en el paso de configuración. Hay un campo "Product Title" en el paso de atributos para conectar el título.

Canales de venta: en el paso de configuración, también puedes encontrar la *Canales de venta* pestaña donde puedes completar la información de precios para cada canal de venta independiente en Maisons du Monde. Más información sobre estos Canales de venta [puedes encontrarla aquí](/list-advertise/list-and-advertise-es/vender-en-marketplaces/marketplaces-de-mirakl/configuracion-de-canales-de-venta-de-mirakl.md).
{% endstep %}

{% step %}

### Envía tus productos a Maisons du Monde

Ya casi está, tus listados de productos están listos para enviarse. Si no has activado tu proyecto, ve a *Instalación > Configuración del proyecto* en el lado izquierdo de la pantalla y haz clic en "activar proyecto". Después, vuelve a la *APIs* visión general y ve a *"Tu nombre de API de Maisons du Monde" > Configuración*, donde activas la API seleccionando "Activar la API". Después de completar este paso, vuelve a la *APIs* visión general y selecciona el botón azul "Actualizar" para enviar tus listados de productos a Maisons du Monde.

\[Necesita revisión: no se han podido confirmar las rutas de la versión moderna para “Instalación > Configuración del proyecto” y “visión general de las APIs”.]
{% endstep %}

{% step %}

### Comprueba si hay errores en tus listados de productos

Después de haber enviado tus listados de productos a Maisons du Monde, ve a la *Resultados* pestaña de tu API de Maisons du Monde. Haz clic en el filtro de 'error'. Ahora puedes ver qué listados de productos tienen errores y no se publican. Haz clic en un error específico para ver más información sobre lo que está causando el error. Si has solucionado algunos errores cambiando la configuración o la información del producto, vuelve a ejecutar la API de Maisons du Monde para ver los nuevos resultados.

#### Buenas prácticas

* Añadir varios valores de atributo: cuando añades varios valores en un campo de atributo para Mirakl Marketplaces, separa cada valor con el símbolo de barra vertical "|" para garantizar una detección y un procesamiento correctos.
* ID de producto del vendedor para productos individuales/simples: hay dos atributos llamados 'SellerArticleId' y 'SellerProductId', respectivamente. 'SellerProductId' se refiere al ID principal, mientras que 'SellerArticleId' se refiere a los Articoli de variante. En los productos individuales, ambos atributos deben rellenarse con el mismo valor.

Para obtener más información sobre errores de Mirakl Marketplace, guías prácticas y buenas prácticas, consulta [nuestra guía dedicada](/list-advertise/list-and-advertise-es/vender-en-marketplaces/marketplaces-de-mirakl/guia-de-mirakl-configuracion-y-soluciones.md).
{% endstep %}
{% endstepper %}

<figure><img src="https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/RQUkTH33rJJc9OS5VqyC/14624671073682" alt=""><figcaption></figcaption></figure>


---

# 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/vender-en-marketplaces/marketplaces-de-mirakl/configuracion-de-una-api-de-maisons-du-monde.md?ask=<question>&goal=<endgoal>
```

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