# Einrichten einer Maisons du Monde API

{% hint style="info" %}
**UI-Aktualisierung:** Du findest jetzt Fehlermeldungen im **Feedback** Tab (ehemals der **Fehler** Tab) des **Der Build-** Schritt.&#x20;
{% endhint %}

Maisons du Monde ist ein französisches Möbel- und Wohnaccessoire-Unternehmen mit fast 250 Filialen in Frankreich, Italien, Spanien, Luxemburg, Belgien, Deutschland und der Schweiz. Über 190 dieser Filialen befinden sich in Frankreich.

{% stepper %}
{% step %}

### Eine neue Maisons du Monde-Verbindung hinzufügen

Maisons du Monde nutzt die Mirakl-Plattform. Du benötigst daher ein Mirakl-Konto, um deine Produktangebote an Maisons du Monde zu senden.

Wenn du ein Mirakl Maisons du Monde-Konto hast, gehe zu „\[Dein Unternehmen] > Einstellungen > Verbindungen > Verbindung hinzufügen“. Klicke auf „+ Verbindung hinzufügen“ und wähle Maisons du Monde aus. Trage ein Label für deine Verbindung ein, z. B. Maisons du Monde. Klicke dann auf „Mit Maisons du Monde verbinden“. Du wirst in die Umgebung weitergeleitet, in der du dich mit deinen Mirakl-Zugangsdaten einloggen kannst. Nach dem Login wirst du zurück zu Channable geleitet, wo die Verbindung verfügbar ist.

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

{% step %}

### Eine neue Maisons du Monde-API in Channable hinzufügen

Gehe zur API-Übersicht deines Projekts und wähle „Neue API hinzufügen“. Wähle die soeben erstellte Maisons du Monde-Verbindung aus und gib der neuen API einen Namen.

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

Wähle das Feld, das du verwenden möchtest für **Eigene ID pro Item** (wir empfehlen das Feld 'id'), und wähle das **Sprache** für die Kategorisierungen und Attribute aus. Zusätzlich kannst du optional eine Masterregel-Gruppe hinzufügen. Klicke auf „Weiter“, um die Erstellung der neuen Maisons du Monde-API abzuschließen.

{% hint style="info" %}
**Wichtig:** Maisons du Monde bietet in unserer API die Möglichkeit, Vertriebskanäle (Sales Channels) zu definieren. Wenn du mehr zu Kanälen erfahren oder wissen möchtest, wie du das einrichtest, folge bitte den Schritten in [diesem Artikel](https://helpcenter.channable.com/hc/en-us/articles/11883675662482). Wichtig: Mehrere separate Maisons du Monde-APIs für verschiedene Länder über dieselbe Verbindung einzurichten funktioniert nicht, da sich die APIs sonst gegenseitig überschreiben.
{% endhint %}
{% endstep %}

{% step %}

### Erstelle deine Produkt-Listings in Channable

Folge diesen Schritten, um deinen Kanal einzurichten.

{% stepper %}
{% step %}

#### Kategorisiere deine Produkte

Weise deinen Produkten Kategorien zu, um die Produktdaten einzurichten.

* **KI-Produktkategorisierung:** Weist automatisch Produktkategorien per Algorithmus zu.
* **Manuelle Kategorisierung:** Ordne Produktkategorien manuell mit benutzerdefinierten Regeln zu. Du kannst detaillierte Filter erstellen, um jedes Produkt der richtigen Kategorie zuzuordnen.
* **Nicht kategorisierte Artikel:** Produkte, die noch überprüft und kategorisiert werden müssen

[Erfahre mehr über die Kategorisierung für Marktplätze](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-kategorisierung)
{% endstep %}

{% step %}

#### Regeln einrichten

Regeln helfen dir, deine Produktdaten schnell für den gewünschten Marktplatz zu optimieren.

* **Regelvorlagen:** Häufig genutzte Regeln, die du für deinen Anwendungsfall anpassen kannst.
* **Regel-Setup:** Richte Regeln ein, um deine Produktdaten zu verfeinern. Das kann Filtern, Bearbeiten oder Ergänzen von Datenfeldern umfassen, damit sie den Anforderungen des Marktplatzes entsprechen.

[Lies mehr darüber, wie man Regeln für Marktplätze nutzt](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-regeln)
{% endstep %}

{% step %}

#### Erstelle deine Listings

Der **Der Build-** Schritt, in dem du deine Produktlistings so konfigurierst, dass sie den Marktplatzanforderungen entsprechen. Dieser Schritt ist wichtig, damit deine Produkte live gehen und Fehler vermieden werden.

Pflicht- und optionale Felder:

* **Pflichtfelder** : Erforderlich, um deine Produkte auf diesem Marktplatz zu listen
* **Empfohlen** : Empfohlen, um Fehler zu vermeiden
* **Optional** : Nicht erforderlich für die Listung

Geteilte Attribute: Geteilte Attribute sind die gemeinsamen Felder, die für deine Produkte gelten, wie EAN, Preise und Titel. Dieser Schritt sorgt für Einheitlichkeit der grundlegenden Produktinformationen in deinen Angeboten.

* **Verwende statische oder dynamische Werte**
  * **Statische Werte:** Feste Werte, die sich nicht ändern (z. B. Markenname, Hersteller)
  * **Dynamische Werte:** Felder, die sich automatisch basierend auf den verknüpften Daten ändern (z. B. Lagerbestand, Preise)

Kategoriespezifische Attribute: Kategoriespezifische Attribute sind Felder, die speziell für die Kategorie deiner Produkte gelten. Dieser Schritt hilft dir, deine Angebote an die Kategorieanforderungen des Marktplatzes anzupassen.

Fülle Attribute aus, die für die ausgewählte Kategorie spezifisch sind (z. B. Größe bei Kleidung oder Maße bei Möbeln).

{% hint style="success" %}
Tipp: Klicke **Auto-map fields** um Kategorien automatisch mit Informationen zuzuordnen, die bereits im selben Kanal angegeben wurden.&#x20;
{% endhint %}

[Erfahre mehr über den Build-Schritt für Marktplätze](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-erstellen)
{% endstep %}

{% step %}

#### Überprüfe die Qualität deiner Einrichtung

Der **Qualität** Dieser Schritt gibt Feedback zu deinem Kanal, bevor du ihn aktivierst. Er hebt Pflicht- und optionale Fehler hervor, damit deine Produktdaten den Anforderungen für die Listung auf dem Marktplatz entsprechen.

* Behebe Fehler und priorisiere dabei zuerst Pflichtfehler.

Aktionen:

* **Artikel anzeigen**: Zeigt Produkte mit bestimmten Problemen an.
* **Im Aufbau-Schritt anzeigen**: Leitet weiter zu den **Der Build-** Schritt, um fehlende Informationen zuzuordnen.
* **Kategorien festlegen**: Führt zu den **Kategorien** Schritt, um Artikel zu kategorisieren.
* **Quelle anzeigen**: Verfügbar für ID-Felder. Führt zu den **Einstellungen** Schritt.

[Erfahre mehr über den Quality-Schritt für Marktplätze](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-qualitat)
{% endstep %}

{% step %}

#### Vorschau vor Aktivierung

Der **Vorschau** Der Schritt zeigt die Attribute an, die du im **Der Build-** Schritt zugeordnet hast, und hilft dir zu prüfen, ob alles korrekt konfiguriert ist, indem er eine Übersicht deiner Produkte und möglicher Fehler bietet.

Filterung:

* **Nach Fehler filtern:** 10. Starte deine Kampagne **alle** Dropdown und wähle aus, ob nur Produkte mit Fehlern oder Produkte mit einem bestimmten Fehler angezeigt werden sollen.
* **Nach Kategorie filtern:** 10. Starte deine Kampagne **Alle Kategorien** Dropdown und wähle die Kategorie, nach der du filtern möchtest.

Bevor du fortfährst:

* **Geteilte Attribute prüfen**: Stelle sicher, dass alle Pflichtfelder für geteilte Attribute ausgefüllt sind.
* **Kategoriespezifische Attribute prüfen**: Stelle sicher, dass alle Pflichtfelder für kategoriespezifische Attribute ausgefüllt sind.
* **Auf Fehler prüfen**: Korrigiere alle rot markierten Felder.

[Erfahre mehr über den Vorschau-Schritt für Marktplätze](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-schritt-vorschau)
{% endstep %}
{% endstepper %}

### Zusätzliche Informationen zu Maisons du Monde:

Mirakl-APIs haben im Build-Schritt kein ‚title‘-Feld. Im Attribut-Schritt gibt es ein Feld „Product Title“, das mit dem Titel verknüpft werden muss!

Vertriebskanäle: Im Build-Schritt findest du außerdem den *Vertriebskanäle* Tab, in dem du die Preisangaben für die einzelnen Vertriebskanäle auf Maisons du Monde hinterlegen kannst. Mehr Informationen zu diesen Vertriebskanälen [findest du hier](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-vertriebskanale-einrichten).
{% endstep %}

{% step %}

### Sende deine Produkte an Maisons du Monde

Fast fertig — deine Produktangebote sind bereit zum Senden. Falls du dein Projekt noch nicht aktiviert hast, gehe zu *Setup > Projekteinstellungen* in der linken Seitenleiste und klicke auf „Projekt aktivieren“. Gehe danach zurück zur *APIs* Übersicht und navigiere zu *„Dein Maisons du Monde API-Name" > Einstellungen*, wo du die API durch Auswahl von „API aktivieren“ aktivierst. Nachdem du diesen Schritt abgeschlossen hast, kehre zur *APIs* Übersicht zurück und klicke auf den blauen Button „Jetzt aktualisieren“, um deine Produktangebote an Maisons du Monde zu senden.
{% endstep %}

{% step %}

### Prüfe deine Produkt-Listings auf Fehler

Nachdem du deine Produktangebote an Maisons du Monde gesendet hast, gehe zum *Ergebnisse* Tab deiner Maisons du Monde-API. Klicke im Filter auf ‚Fehler‘. Nun siehst du, welche Produktangebote Fehler haben und nicht veröffentlicht wurden. Klicke auf einen konkreten Fehler, um weitere Informationen zur Ursache zu sehen. Hast du Fehler durch Anpassung der Einstellungen oder Produktdaten behoben, führe die Maisons du Monde-API erneut aus, um die neuen Ergebnisse zu sehen.

#### Best Practices

* Mehrere Attributwerte hinzufügen: Wenn du bei Mirakl-Marktplätzen mehrere Werte in einem Attributfeld angibst, trenne jeden Wert mit einem senkrechten Strich "|", damit die Werte korrekt erkannt und verarbeitet werden.
* Seller-Produkt-ID für Einzel-/einfache Produkte: Es gibt zwei Attribute namens 'SellerArticleId' bzw. 'SellerProductId'. 'SellerProductId' bezieht sich auf die Parent-ID, während 'SellerArticleId' die Variantenartikel bezeichnet. Bei Einzelprodukten müssen beide Attribute mit demselben Wert gefüllt werden.

Für weitere Informationen zu Mirakl-Marktplatz-Fehlern, Anleitungen und Best Practices, sieh dir [unsere spezielle Anleitung](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-anleitung-einstellungen-und-losungen).
{% endstep %}
{% endstepper %}

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


---

# Agent Instructions: 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:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/einrichten-einer-maisons-du-monde-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
