> ## 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-integratie

> Koppel een marktplaats op Mirakl aan WISEPIM. Voeg je API key toe, kies een hiërarchie en exporteer verrijkte listings die aan de eisen van de marktplaats voldoen.

Mirakl draait achter de marktplaatsen van veel grote retailers. Verkoop je op een van die marktplaatsen? Koppel hem dan aan WISEPIM om je listings één keer op te bouwen en ze naar buiten te pushen met de juiste content, de juiste afbeeldingen en de juiste categorieattributen.

<Note>
  Mirakl is een **export-only** integratie. WISEPIM stuurt je producten naar de marktplaats, maar leest listings niet terug. Houd WISEPIM als de plek waar je productdata leeft.
</Note>

<Info>
  De Mirakl-integratie is beschikbaar vanaf het **Pro-abonnement**.
</Info>

## Voordat je begint

Zorg dat je het volgende hebt:

* Een WISEPIM-account op het **Pro-abonnement** of hoger
* Een verkopersaccount op een marktplaats die op Mirakl draait, met API-toegang
* Je **API key** van die marktplaats
* De **marktplaats-URL** waarmee je koppelt

## Mirakl koppelen aan WISEPIM

<Steps>
  <Step title="Open de pagina Integraties">
    Ga in WISEPIM naar **Integraties** en zoek de tegel **Mirakl**.
  </Step>

  <Step title="Voer je referenties in">
    Vul je **API key** en de **marktplaats-URL** in. Elke Mirakl-marktplaats heeft zijn eigen adres, dus gebruik het adres van de marktplaats waarop je verkoopt.
  </Step>

  <Step title="Kies je standaardhiërarchie">
    Kies de categoriehiërarchie waar je producten bij horen. Dit is de tak van de categorieboom van de marktplaats die WISEPIM gebruikt bij het exporteren.
  </Step>

  <Step title="Testen en opslaan">
    Klik op **Verbinding testen**. Slaagt de test, klik dan op **Opslaan**.
  </Step>
</Steps>

<Warning>
  Producten worden alleen aan **leaf-categorieën** gekoppeld, oftewel het laagste niveau van de boom met niets eronder. Kies een hiërarchie die eindigt in echte, verkoopbare categorieën, niet in een groep op het hoogste niveau.
</Warning>

## Laat AI de categorieattributen invullen

Elke Mirakl-categorie vraagt om zijn eigen set attributen, en dat kunnen er veel zijn. WISEPIM kan die voor je afleiden uit de productdata die je al hebt.

Dit staat **standaard aan**. Laat het aan staan en AI leidt de attributen af die de gekozen categorie nodig heeft, zodat je ze niet voor elk product handmatig hoeft in te vullen.

<Tip>
  Verrijk eerst je beschrijvingen en attributen in WISEPIM. Hoe beter je brondata, hoe nauwkeuriger de afgeleide categorieattributen.
</Tip>

## Wat een listing nodig heeft

Mirakl weigert onvolledige listings. Vul deze velden in voordat je exporteert.

| Veld             | Verplicht?             |
| ---------------- | ---------------------- |
| **Naam**         | Verplicht              |
| **Beschrijving** | Verplicht              |
| **Prijs**        | Verplicht              |
| **SKU**          | Verplicht              |
| **EAN**          | Verplicht              |
| **Afbeeldingen** | Minimaal één verplicht |
| **Merk**         | Aanbevolen             |

<Info>
  Draai een datakwaliteitscontrole op je selectie voordat je exporteert. Een ontbrekende EAN of afbeelding in WISEPIM oplossen gaat veel sneller dan achteraf een afwijzing najagen.
</Info>

## Producten exporteren naar Mirakl

<Steps>
  <Step title="Selecteer je producten">
    Selecteer op de pagina **Producten** de producten die je wilt aanbieden.
  </Step>

  <Step title="Exporteer naar Mirakl">
    Klik op **Exporteren** en kies je Mirakl-marktplaats als bestemming.
  </Step>

  <Step title="Bekijk het resultaat">
    Controleer het exportresultaat op producten die de marktplaats heeft afgewezen, los ze op en exporteer opnieuw.
  </Step>
</Steps>

### Producten aanmaken die nog niet bestaan

Zet de optie voor automatisch aanmaken aan en WISEPIM maakt producten op de marktplaats aan die er nog niet zijn, in plaats van alleen de bestaande bij te werken. Laat het uit als je alleen je huidige listings wilt bijwerken en verder niets.

## Afgewezen producten oplossen

Weigert Mirakl een product, dan laat WISEPIM zien wat de marktplaats zei, tot **20 foutregels per product**. Elke regel noemt het veld en het probleem, zodat je er direct naartoe kunt.

<AccordionGroup>
  <Accordion title="Een product is afgewezen vanwege een ontbrekend attribuut">
    De categorie vraagt om een attribuut dat je product niet heeft. Vul het in op het product, of laat AI de categorieattributen voor je afleiden, en exporteer opnieuw.
  </Accordion>

  <Accordion title="De categorie accepteert mijn product niet">
    Controleer of je mapping naar een leaf-categorie wijst. Producten kunnen niet worden gekoppeld aan een bovenliggende categorie die zelf categorieën onder zich heeft.
  </Accordion>

  <Accordion title="Er wordt helemaal niets geëxporteerd">
    Controleer je API key en marktplaats-URL en draai daarna **Verbinding testen**. Marktplaatsen geven hun eigen keys uit, dus een key van de ene Mirakl-marktplaats werkt nooit op een andere.
  </Accordion>

  <Accordion title="Ik zie meer dan 20 problemen op één product">
    WISEPIM toont de eerste 20 foutregels. Los die op, exporteer opnieuw, en eventuele resterende fouten verschijnen bij de volgende run.
  </Accordion>
</AccordionGroup>

## Gerelateerd

<CardGroup cols={2}>
  <Card title="Producten verrijken" icon="sparkles" href="/nl/essentials/enriching-products">
    Verbeter titels, beschrijvingen en attributen met AI.
  </Card>

  <Card title="Producten exporteren" icon="upload" href="/nl/essentials/exporting-products">
    Push je listings naar de marktplaats.
  </Card>

  <Card title="Kaufland" icon="store" href="/nl/integrations/kaufland">
    Verkoop op de marktplaatsen van Kaufland vanuit dezelfde catalogus.
  </Card>

  <Card title="Ondersteunde platformen" icon="layout-grid" href="/nl/integrations/supported-platforms">
    Bekijk elk platform waarmee WISEPIM koppelt.
  </Card>
</CardGroup>