> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mirakl-Integration

> Verbinde einen Mirakl-basierten Marktplatz mit WISEPIM. Füge deinen API-Key hinzu, wähle eine Hierarchie und exportiere angereicherte Listings, die die Anforderungen des Marktplatzes erfüllen.

Mirakl betreibt die Marktplätze vieler großer Händler. Wenn du auf einem davon verkaufst, verbinde ihn mit WISEPIM, um deine Listings einmal aufzubauen und sie mit den richtigen Inhalten, den richtigen Bildern und den richtigen Kategorieattributen zu übertragen.

<Note>
  Mirakl ist eine **Export-only**-Integration. WISEPIM sendet deine Produkte an den Marktplatz, liest aber keine Listings zurück. Behalte WISEPIM als den Ort, an dem deine Produktdaten leben.
</Note>

<Info>
  Die Mirakl-Integration ist ab dem **Pro-Plan** verfügbar.
</Info>

## Bevor du startest

Stelle sicher, dass du Folgendes hast:

* Ein WISEPIM-Konto im **Pro-Plan** oder höher
* Ein Verkäuferkonto auf einem Mirakl-basierten Marktplatz mit API-Zugang
* Deinen **API-Key** von diesem Marktplatz
* Die **Marktplatz-URL**, mit der du dich verbindest

## Mirakl mit WISEPIM verbinden

<Steps>
  <Step title="Öffne die Seite Integrationen">
    Gehe in WISEPIM zu **Integrationen** und suche die Kachel **Mirakl**.
  </Step>

  <Step title="Gib deine Zugangsdaten ein">
    Trage deinen **API-Key** und die **Marktplatz-URL** ein. Jeder Mirakl-Marktplatz hat seine eigene Adresse, nutze also die des Marktplatzes, auf dem du verkaufst.
  </Step>

  <Step title="Wähle deine Standard-Hierarchie">
    Wähle die Kategoriehierarchie, zu der deine Produkte gehören. Das ist der Ast des Kategoriebaums des Marktplatzes, den WISEPIM beim Export nutzt.
  </Step>

  <Step title="Teste und speichere">
    Klicke auf **Verbindung testen**. Wenn der Test erfolgreich ist, klicke auf **Speichern**.
  </Step>
</Steps>

<Warning>
  Produkte hängen nur an **Blattkategorien**, also der untersten Ebene des Baums, unter der nichts mehr liegt. Wähle eine Hierarchie, die in echten, verkaufbaren Kategorien endet, nicht in einer Gruppe auf oberster Ebene.
</Warning>

## Die Kategorieattribute von AI füllen lassen

Jede Mirakl-Kategorie verlangt ihren eigenen Satz an Attributen, und das können viele sein. WISEPIM kann sie aus den Produktdaten ableiten, die du bereits hast.

Das ist **standardmäßig an**. Lass es an, und AI leitet die Attribute ab, die die gewählte Kategorie verlangt, sodass du sie nicht für jedes Produkt von Hand ausfüllen musst.

<Tip>
  Reichere zuerst deine Beschreibungen und Attribute in WISEPIM an. Je besser deine Quelldaten, desto genauer sind die abgeleiteten Kategorieattribute.
</Tip>

## Was ein Listing braucht

Mirakl lehnt unvollständige Listings ab. Fülle diese Felder aus, bevor du exportierst.

| Feld             | Erforderlich?                 |
| ---------------- | ----------------------------- |
| **Name**         | Erforderlich                  |
| **Beschreibung** | Erforderlich                  |
| **Preis**        | Erforderlich                  |
| **SKU**          | Erforderlich                  |
| **EAN**          | Erforderlich                  |
| **Bilder**       | Mindestens eines erforderlich |
| **Marke**        | Empfohlen                     |

<Info>
  Führe vor dem Export eine Datenqualitätsprüfung für deine Auswahl durch. Eine fehlende EAN oder ein fehlendes Bild in WISEPIM zu beheben, geht viel schneller, als einer Ablehnung hinterherzulaufen.
</Info>

## Produkte nach Mirakl exportieren

<Steps>
  <Step title="Wähle deine Produkte">
    Wähle auf der Seite **Produkte** die Produkte aus, die du listen möchtest.
  </Step>

  <Step title="Exportiere nach Mirakl">
    Klicke auf **Exportieren** und wähle deinen Mirakl-Marktplatz als Ziel.
  </Step>

  <Step title="Prüfe das Ergebnis">
    Sieh dir das Exportergebnis nach Produkten an, die der Marktplatz zurückgewiesen hat, behebe die Ursache und exportiere erneut.
  </Step>
</Steps>

### Produkte anlegen, die es noch nicht gibt

Schalte die Auto-Anlegen-Option ein, und WISEPIM legt Produkte auf dem Marktplatz an, die dort noch nicht existieren, statt nur die bereits vorhandenen zu aktualisieren. Lass sie aus, wenn du nur deine aktuellen Listings aktualisieren willst und sonst nichts.

## Abgelehnte Produkte korrigieren

Wenn Mirakl ein Produkt ablehnt, zeigt dir WISEPIM, was der Marktplatz gemeldet hat, bis zu **20 Fehlerzeilen pro Produkt**. Jede Zeile nennt das Feld und das Problem, sodass du direkt dorthin springen kannst.

<AccordionGroup>
  <Accordion title="Ein Produkt wurde wegen eines fehlenden Attributs abgelehnt">
    Die Kategorie verlangt ein Attribut, das dein Produkt nicht hat. Fülle es am Produkt aus oder lass AI die Kategorieattribute für dich ableiten, und exportiere dann erneut.
  </Accordion>

  <Accordion title="Die Kategorie nimmt mein Produkt nicht an">
    Prüfe, ob deine Zuordnung auf eine Blattkategorie zeigt. Produkte können nicht an eine übergeordnete Kategorie gehängt werden, unter der weitere Kategorien liegen.
  </Accordion>

  <Accordion title="Es wird überhaupt nichts exportiert">
    Prüfe deinen API-Key und die Marktplatz-URL und führe dann **Verbindung testen** aus. Marktplätze vergeben ihre eigenen Keys, ein Key von einem Mirakl-Marktplatz funktioniert also nie auf einem anderen.
  </Accordion>

  <Accordion title="Ich sehe mehr als 20 Probleme bei einem Produkt">
    WISEPIM zeigt die ersten 20 Fehlerzeilen. Behebe diese, exportiere erneut, und verbleibende Fehler erscheinen beim nächsten Lauf.
  </Accordion>
</AccordionGroup>

## Verwandt

<CardGroup cols={2}>
  <Card title="Produkte anreichern" icon="sparkles" href="/de/essentials/enriching-products">
    Verbessere Titel, Beschreibungen und Attribute mit AI.
  </Card>

  <Card title="Produkte exportieren" icon="upload" href="/de/essentials/exporting-products">
    Übertrage deine Listings auf den Marktplatz.
  </Card>

  <Card title="Kaufland" icon="store" href="/de/integrations/kaufland">
    Verkaufe aus demselben Katalog auf den Marktplätzen von Kaufland.
  </Card>

  <Card title="Unterstützte Plattformen" icon="layout-grid" href="/de/integrations/supported-platforms">
    Sieh alle Plattformen, mit denen WISEPIM sich verbindet.
  </Card>
</CardGroup>