> 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-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/eine-manor-api-einrichten.md).

# Eine Manor API einrichten

Manor (Mirakl) — Einrichtungsanleitung

{% hint style="info" %}
**UI-Update:** Es gibt eine neue Kanalauswahlseite und Übersicht für **Feeds** und **Marktplätze** (früher APIs genannt)! Einige Grafiken und Anweisungen sind möglicherweise nicht mehr aktuell.&#x20;
{% endhint %}

{% hint style="warning" %}
**Wichtig:** EAN-Codes sind für Manor Pflicht. Stelle sicher, dass du gültige EAN-Codes für alle deine Produkte hast, sonst können keine Produktangebote für deine Produkte erstellt werden.
{% endhint %}

{% stepper %}
{% step %}

### Neue Manor-Verbindung hinzufügen

Die Manor-API nutzt die Mirakl-Plattform. Du brauchst daher ein Mirakl-Konto, um deine Produktangebote an Manor zu senden.

Wenn du ein Mirakl-Manor-Konto hast, gehe zu "Connections > Add connection". Klicke auf "+ Add a new connection" und wähle Manor aus. Fülle das Label für deine Verbindung aus (z. B.: Manor) und klicke dann auf "Connect with Manor". Du wirst in die Umgebung weitergeleitet, in der du dich mit deinen Mirakl-Zugangsdaten anmelden kannst. Nach dem Einloggen wirst du zurück zu Channable geleitet, wo die Verbindung dann verfügbar ist.

|                                                                                                                                                            |                                                                                                                                                             |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [![New\_connection\_-\_Manor.png](/files/e3e21eda7fbc3bb3ab4bd7e6ff5bd0e385b6f015)](https://helpcenter.channable.com/hc/article_attachments/7647187429650) | [![Sing\_in\_Mirakl\_-\_Oauth.png](/files/75529d3ebebc278454571d77f19c942784a49afa)](https://helpcenter.channable.com/hc/article_attachments/7647182828946) |
| {% endstep %}                                                                                                                                              |                                                                                                                                                             |

{% step %}

### Erstelle eine neue Manor-API in Channable

Gehe zur API-Übersicht in deinem Projekt. Klicke auf "+ Add new API", wähle die Manor-Verbindung aus, die du gerade erstellt hast, und gib deiner neuen API einen Namen.

[![](/files/4cd04cfbc88fdae22f2f347e8c4a3453c9981e8d)](https://helpcenter.channable.com/hc/article_attachments/19237568656018)

Wähle das Feld, das du verwenden möchtest für **Eigene ID pro Item** (wir empfehlen das Feld 'id), und das **Sprache**. Du musst außerdem die Sprache für die API auswählen, da die Schweiz drei Amtssprachen zur Auswahl hat (Deutsch, Französisch und Italienisch). Nachdem du einen Namen gewählt hast, klicke auf die Schaltfläche "Continue", um deine neue Manor-API zu erstellen.
{% endstep %}

{% step %}

### Erstelle deine Produkt-Listings in Channable

Nachdem du die Manor-API erstellt hast, richte deine Produktdaten ein, indem du den Schritten der API folgst.

{% stepper %}
{% step %}

#### Kategorien

Damit deine Produktlistings erstellt werden können, brauchen deine Produkte eine Kategorie. Füge deinen Produkten Kategorien hinzu, indem du die [Kategorien automatisch generieren-Funktion](/manage-improve-product-data/manage-product-and-improve-data-de/produkte-kategorisieren/produktkategorien-erstellen/verwende-die-funktion-kategorien-automatisch-generieren.md) oder [neue Kategorien von Grund auf erstellst](/manage-improve-product-data/manage-product-and-improve-data-de/produkte-kategorisieren/produktkategorien-erstellen/kategorien-manuell-hinzufugen.md).
{% endstep %}

{% step %}

#### Regeln

Erstellen [verschiedene Regeln](/manage-improve-product-data/manage-product-and-improve-data-de/regeln-massenbearbeitung-und-anreicherung/regeln-verwenden.md) um deine Produktlistings zu optimieren.&#x20;
{% endstep %}

{% step %}

#### Build - Gemeinsame Attribute

Gemeinsame Attribute sind Attribute, die für alle deine Items gelten, wie Preis und Bestand.&#x20;

1. Beginne damit, Felder zu Attributen zuzuordnen, die vom Marktplatz als erforderlich markiert sind.
2. Prüfe die übrigen Attribute und ordne Felder denjenigen zu, die für dein Unternehmen relevant sind.
3. Klicke auf **Speichern**.
   {% endstep %}

{% step %}

#### Build - Attribute pro Kategorie

Kategorieattribute sind Attribute, die für Items aus bestimmten Kategorien gelten, zum Beispiel Batteriedaten für elektronische Items oder Größenangaben für Kleidung.

1. Beginne damit, Felder zu Attributen zuzuordnen, die vom Marktplatz als erforderlich markiert sind.
2. Prüfe die übrigen Attribute und ordne Felder denjenigen zu, die für dein Unternehmen relevant sind.
3. Klicke auf **Speichern**.
   {% endstep %}
   {% endstepper %}
   {% endstep %}

{% step %}

### Sende deine Produktdaten an Manor

Falls du dein Projekt noch nicht aktiviert hast, gehe in den Projekteinstellungen links auf dem Bildschirm und klicke auf 'activate project'. Gehe dann zurück zu Channel und öffne deinen Manor-Kanal > Einstellungen, und aktiviere den Kanal, indem du "Activate API" auswählst. Klicke von dort aus **Aktualisieren** um deine Listings zu senden.
{% endstep %}

{% step %}

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

Nachdem du deine Produktlistings an Manor gesendet hast, gehe zum Vorschau-Tab deiner Manor-API. Klicke/filtern auf 'error'. Du siehst, welche Produktlistings Fehler haben und nicht in Manor erstellt wurden. Klicke auf einen konkreten Fehler, um weitere Informationen zu sehen.
{% endstep %}
{% endstepper %}

### 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's Product ID für Single-/Simple-Produkte: Es gibt zwei Attribute namens 'SellerArticleId' und 'SellerProductId'. 'SellerProductId' bezieht sich auf die Parent-ID, während 'SellerArticleId' die Varianten-Artikel bezeichnet. Bei Einzelprodukten müssen beide Attribute mit dem gleichen Wert gefüllt sein.

Für weitere Informationen zu Mirakl-Marktplatz-Fehlern, Anleitungen und Best Practices, sieh dir [unsere spezielle Anleitung](/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-leitfaden-einstellungen-und-losungen.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-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/eine-manor-api-einrichten.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.
