> 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/so-richtest-du-einen-but-kanal-ein.md).

# So richtest du einen But-Kanal ein

But ist ein französischer Online-Shop in den Bereichen Möbel, Wohnaccessoires und Einrichtungsausstattung. Sie bieten eine große Auswahl von erschwinglichen Produkten, darunter Hightech-Items und Haushaltsgeräte.

In diesem Artikel lernst du, wie du einen But-Kanal einrichtest, um Listings auf But zum Erstellen und Verwalten zu nutzen.

***

### Bevor du startest

**Du brauchst**

* Ein Mirakl-SSO-Account
* Ein Projekt in Channable mit deinen importierten Produkten

**Gut zu wissen**

* But verlangt, dass alle Listing-Beschreibungen wichtige Informationen zur Lieferung von Produkten enthalten (z. B. Lieferzeit, Versandart). Ohne diese Informationen lehnt But dein Listing ab.

{% stepper %}
{% step %}

### Erstellen eines But-Kanals

{% tabs %}
{% tab title="Moderne Version" %}

1. Gehe in Channable zu **alle Projekte**.
2. Auswählen **\[dein Projekt]**.
3. Zu **Kanäle**.
   {% endtab %}

{% tab title="Alte Version" %}

1. Gehe in Channable zu **Projekte > \[dein Projekt] > Kanäle**.
   {% endtab %}
   {% endtabs %}

2. Klicke **+ Kanal erstellen**.

3. Gib in der Suchleiste „But“ ein und wähle aus **But**.

4. Lege deine Kanal-Einstellungen fest:
   1. Für **Name**gib deinem Kanal einen aussagekräftigen Namen.
   2. Für **Eigene ID pro Item**, wähle das Feld aus, das deine Produkt-IDs enthält. Das ist oft `id`.
   3. Für **Sprache**wähle die Sprache aus, in der deine Produktdaten vorliegen.
   4. Für **Masterregel-Gruppe nutzen**, wähle eine Masterregel-Gruppe aus, wenn du eine hast.

5. Klicke **Speichern**.
   {% endstep %}

{% step %}

### Ordne deine Items Kategorien zu

Ordne deine Items so zu, dass sie zu Buts Taxonomie passen und an der richtigen Stelle erscheinen.

1. Gehe zu den **Kategorien** Schritt.
2. Wähle deine Kategorisierungsmethode:
   1. **Generiere von Feld:** Auswählen eines Kategorie-Felds, zum Beispiel `Produkttyp` oder `Kategorie`.
   2. **+ Kategorie hinzufügen Regel:** Füge Textbasierte Bedingungen zum Zuweisen von Kategorien in großen Mengen hinzu.
   3. **kopieren von Kanal:** Verwende Kategorien von einem anderen Kanal erneut.
3. Klicke **Speichern**.
   {% endstep %}

{% step %}

### Erstellen Sie Regeln, um Datenlücken Zu füllen

Verwende Regeln, um Produktdaten für But vorzubereiten. Erstellen Projektfelder für fehlende Daten. Fülle sie dann mit Regeln. Du kannst auch bestehende Felder an die Anforderungen von But anpassen.

* **Regelvorlagen:** Verwende gängige Regeln und passe sie dann an deine Bedürfnisse an.
* **Regel-Setup:** Filtere, ändere oder ergänze Daten entsprechend den Marktplatzanforderungen.
  {% endstep %}

{% step %}

### Gemeinsame Attribute zuordnen

Verknüpfe Projektfelder mit Attributen, die für deinen gesamten But-Katalog gelten.

1. Gehe zu den **Erstellen** Schritt.
2. Ordne Attribute zu, die als **Erforderlich laut Marktplatz**.
   1. Klicke auf das Dropdown-Menü und wähle das Projektfeld aus, das die Daten enthält.

{% hint style="info" %}
Einige Attribute unterstützen benutzerdefinierte oder unterstützte Werte. Diese Werte gelten für jedes Item.
{% endhint %}
{% endstep %}

{% step %}

### Kategorieattribute zuordnen

Kategorieattribute gelten für Produkte in bestimmten Kategorien.

1. Im **Erstellen** Schritt klicke auf den Tab **Attribute pro Kategorie** .
2. Wähle eine Kategorie aus der Liste aus.
3. Ordne Attribute zu, die als **Erforderlich laut Marktplatz**.
   1. Klicke auf das Dropdown-Menü und wähle das Projektfeld aus, das die Daten enthält.
4. Klicke **Speichern**.

<details>

<summary><strong>Hinzufügen mehrfacher Attributwerte in Mirakl</strong></summary>

Trenne mehrfache Attributwerte mit einem Pipe-Symbol (`|`). Dadurch kann Mirakl jeden Wert erkennen und verarbeiten.

</details>

**Gib an, ob ein Item ein einzelnes Item oder eine übergeordnete/untergeordnete Variante ist**

Ordne die folgenden Attribute für übergeordnete und untergeordnete Items zu:

* Für **SellerProductId**, ordne das Feld zu, das die übergeordnete ID enthält.
* Für **SellerArticleId**, ordne das Feld zu, das die IDs der Varianten-Items enthält.

Gib bei einzelnen Produkten ohne Varianten denselben Wert für **SellerArticleId** und **SellerProductId**.
{% endstep %}

{% step %}

### Zusätzliche Anforderungen für But

Die folgenden Anforderungen gelten speziell für But.

#### Gemeinsame Attribute — Abschnitt „Item“

* Versandklasse (Logistikklasse): Gib die Logistikklasse deines Produkts an, um die Versandkosten zu bestimmen.
* Versandzeit: Gib die Versandzeit in Tage an (Zeit bis das Paket an den Versand übergeben wird).
* Ökobeiträge: Wenn du in Frankreich tätig bist, füge deinen Angeboten Ökobeiträge hinzu. Siehe die Liste von [verfügbaren EPR-Kategorien](/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/mirakl-eco-contributions-einrichten.md).
* Preis ohne MwSt.: Gib die MwSt. an; setze den Wert auf „20“.
* Abgabe für Privatkopien: Gib für zutreffende Leermedien-Items den Betrag der Abgabe „copie-privée“ in Euro an.
* Garantieliste: Gib die gesetzliche Garantie von 2 Jahren an (von „2-years“ mit Bindestrich).

#### Anforderungen an den Titel

* Maximale Nummer an Zeichen: 100
* Titelstruktur: Produkttyp, Funktion, Stil, Farbe, Material, Maße
* Ausschluss des Marken-Name: Nimm den Marken-Name nicht in den Titel auf (das Markenfeld wird auf der Website automatisch vor dem Titel platziert).
* Maße: Gib Einheiten an (z. B. H.10 cm). Keine Verwendung von Abkürzungen. Beispiel: Ø
* Keine werblichen Begriffe: Zeige keine Begriffe wie „Exklusiv“, „Neu“, „Top-Verkäufer“ usw. an.
* Sonderzeichen: Füge keine Sonderzeichen hinzu (z. B. griechische Buchstaben).
* Kein führender Bindestrich: Beginne den Titel nicht mit einem Bindestrich.

#### Bildanforderungen

* Erstes Bild: Muss einen weißen Hintergrund haben und freigestellt sein (ausgeschnitten).
* Positionierung: Von vorne oder aus einem ¾-Winkel.
* Anzahl der Visuals: Bis zu 6 Visuals, die verschiedene Blickwinkel zeigen (Hintergrundfoto, Diagramm, Zubehör, Details usw.).
* Empfohlen: 2000×2000 Pixel, 3000×3000 Pixel.

#### Anforderungen an die Beschreibung

{% hint style="warning" %}
**Wichtig:** Das Attribut Beschreibung ist Pflicht. Es muss Informationen über Lieferzeit, Versandart und alle weiteren Lieferdetails enthalten. Ohne diese Informationen lehnt But dein Listing ab.
{% endhint %}

* Zeichenbegrenzung: Max. 8.000 Zeichen.
* Keine externen Links: Vermeide Links oder Verweise auf externe Websites oder Shops.
* HTML zur Verbesserung verwenden: HTML kann verwendet werden, um Beschreibungen anzureichern (HTML ist in Mirakl standardmäßig blockiert; wende dich an deinen Account Manager, um es zu aktivieren).
  {% endstep %}

{% step %}

### Prüfe die Qualität deines Setups

Die **Qualität** Schritt gibt dir vor der Aktivierung Feedback. Er hebt Pflicht- und Optional-Fehler in deinen Produktdaten hervor.

Behebe zuerst die Pflicht-Fehler.

**Aktionen**

* **Artikel anzeigen:** Produkte mit einem bestimmten Fehler anzeigen.
* **Im Aufbau-Schritt anzeigen:** Öffne den **Erstellen** Schritt, um fehlende Informationen zuzuordnen.
* **Kategorien festlegen:** Öffne den **Kategorien** Schritt, um Produkte zu kategorisieren.
* **Quelle anzeigen:** Für ID-Felder öffne den **Einstellungen** Schritt.
  {% endstep %}

{% step %}

### Vor der Aktivierung prüfen

Die **Vorschau** Schritt zeigt die im **Erstellen** Schritt. Verwende ihn, um Produktdaten und mögliche Fehler zu prüfen.

**Filtern**

* **Nach Fehler filtern:** Verwende das **alle** Dropdown, um Produkte mit Fehlern anzuzeigen.
* **Nach Kategorie filtern:** Verwende das **Alle Kategorien** Dropdown, um eine Kategorie anzuzeigen.
  {% endstep %}

{% step %}

### Mit But verbinden

Verbinde deinen Kanal vor dem Senden von Listings mit deinem Mirakl SSO-Account.

{% hint style="success" %}
Das Verknüpfen deines Accounts ändert bestehende Listings nicht. Listings ändern sich erst nach der Aktivierung.
{% endhint %}

1. In **\[dein But-Kanal]**, gehe zu **Einstellungen**.
2. Bei **Verknüpfte Verbindung**, klicke auf **Verkäufer-Account auswählen**.
3. Wähle einen vorhandenen Verkäufer-Account aus oder klicke auf **+ Verbindung hinzufügen**.
4. Wenn du einen Verkäufer-Account hinzufügst:
   1. Bei **Verbinden mit**, klicke auf **But** um es auszuwählen.
   2. Für **Label**, gib deiner Verbindung einen beschreibenden Namen, z. B. „But FR“.
   3. Für **Shop-ID**, füge die Shop-ID für die Plattform ein, auf der du listest.
   4. Klicke **Verbinden mit But**.

Du wirst zu Mirakl weitergeleitet, um dich anzumelden und deine Verbindung zu verifizieren. Bestätige alle Berechtigungen. Danach kehrst du zu Channable zurück.

5. Klicke **Erstellen** um deine Verbindung abzuschließen.
   {% endstep %}

{% step %}

### Aktiviere und starte deinen Kanal

1. Wähle die **Einstellungen** Schritt in **\[dein But-Kanal]**.
2. Klicke **Aktiviere API**.
3. Klicke **Speichern**.
4. Klicke **Aktualisieren** um deine Produktlistings an But zu senden.
   {% endstep %}

{% step %}

### Listing-Fehler überprüfen und beheben

Nachdem du deinen Kanal gestartet hast, gibt But Feedback zu fehlenden Listing-Daten.

Gehe zu den **Resultat** Schritt und klicke auf die **Feedback** .

#### Fehler beheben

1. In **Beschreibung**, klicke auf den Fehlernamen. So siehst du eine Übersicht der Produkte mit diesem Fehler.
2. In **ID**, klicke auf die ID-Nummer und scrolle zum roten Fehlerhinweis. Fahre für weitere Informationen mit der Maus darüber.
3. Wenn der Fehler ein Mapping-Fehler ist, klicke auf **Im Aufbau-Schritt anzeigen**. Dadurch öffnest du das Attribut zum Mappen oder Remappen.
4. Informationen zum Attribut und zu den akzeptierten Werten erhältst du, wenn du mit der Maus über das Hilfe-Symbol des Attributs fährst.
5. Behebe den Fehler, dann klicke auf **Aktualisieren** um deine Listings erneut zu senden.
   {% endstep %}
   {% endstepper %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/mirakl-marktplatze/so-richtest-du-einen-but-kanal-ein.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
