> 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-nl/verkopen-op-marktplaatsen/mirakl-marktplaatsen/mirakl-gids-instellingen-en-oplossingen.md). # Mirakl-gids: Instellingen en oplossingen Mirakl runt geen eigen marketplace. In plaats daarvan biedt het de infrastructuur die anderen gebruiken om hun marketplace op te zetten en te beheren. Omdat veel Mirakl-marketplaces dezelfde opzet gebruiken, hebben ze vaak vergelijkbare instellingen, gedrag en veelvoorkomende problemen.
:shop: Mirakl-marketplaces in Channable * Decathlon * Fnac * Leroy Merlin * fonQ * Darty * Bricoman * Mediamarkt * Conforama * Carrefour Frankrijk/Spanje * Manor * PcComponentes * Maxeda Brico\&Praxis * Leen Bakker * ePrice * Douglas * Galeries Lafayette * Home24 * Sprinter * Showroomprive * Hornbach * Conrad * Vtwonen * Galeries Lafayette
***
Wat is de mirakl_unknown_error_code en hoe los je die op? Als deze fout optreedt, betekent dit dat het product niet wordt herkend door Mirakl. Mogelijke redenen zijn: 1. Ontbrekende productdetails, zoals categorie-specifieke attributen. 2. Productinformatie staat nog open, weergegeven als "Product - submission pending." 3. Fouten in de aangeleverde gegevens, aangegeven als "Product - data error" of "Product - integration error." Kort gezegd: er ontbreekt iets dat vereist is door de marketplace, of het is niet सही ingevuld. [![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/IE9hp5pWJka6o7jGhIo3/19168742250514)](https://helpcenter.channable.com/hc/article_attachments/19168742250514) Ook al lijkt dit misschien ingewikkeld, de oplossing bestaat vaak uit een paar eenvoudige stappen: * **Categorieën**: Zorg ervoor dat je productcategorieën correct zijn gekoppeld in de [Categorieën-stap](/manage-improve-product-data/manage-product-and-improve-data-nl/categorize-products.md) van je API. Als dat niet zo is, koppel ze dan correct. * **Build**: Controleer of de Build-stap van je API goed is ingesteld. Een onjuist EAN-veld dat hier is gekoppeld, kan bijvoorbeeld fouten veroorzaken. Pas eventuele verschillen aan. * **Attributen**: In de [Attributen-stap van je API](/list-advertise/list-and-advertise-nl/verkopen-op-marktplaatsen/aan-de-slag-met-marktplaatsen/marktplaatsen-opbouwstap.md), koppel je elk veld aan het juiste tegenveld en zorg je ervoor dat de waarden geschikt zijn voor de gekozen categorie. * **Regels**: Gebruik regels om je gegevens verder te verfijnen. Zie het supportartikel over de attribute builder voor het verbeteren van de Attributen-stap in je API. Zodra categorieën en attributen in je API zijn ingevuld, ga je naar het API-overzicht en voer je de API uit door op de blauwe knop "Nu uitvoeren" te klikken.
### Best practices en instellingen voor Mirakl #### Voeg meerdere attribuutwaarden toe Als je meerdere waarden voor één attribuutveld moet invoeren voor een Mirakl-marketplace, scheid dan elke waarde met een pipesymbool "|". Door deze opmaak herkent en verwerkt Mirakl elke aparte invoer correct. ### Veelvoorkomende Mirakl-fouten en hoe je ze oplost
Aanbod - product niet gevonden Deze fout treedt op wanneer een EAN van een product niet wordt herkend door de Mirakl-database. Dit gebeurt meestal wanneer: * Het product wordt nog verwerkt door Mirakl (weergegeven als `Product - submission pending`). * De productimport is mislukt door ontbrekende of ongeldige verplichte gegevens (bijvoorbeeld categorie-specifieke attributen). Dit wordt meestal weergegeven als `Product - data error` of `Product - integration error`. **Hoe je dit oplost** 1. Klik in de **Resultaat** stap van je Mirakl-marketplacekanaal, ga naar de **Feedback** tabblad. 2. Controleer andere weergegeven productgerelateerde fouten. 3. Controleer de foutfeedback in de **Fout** kolom. Pas waar nodig je gegevens aan met [regels](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). 4. Controleer en koppel attributen die als verplicht zijn gemarkeerd in de **Build** stap. Controleer het :circle-info: icoon en de tooltips om te zien welke waarden worden geaccepteerd. 5. Klik op **Uitvoeren** om je kanaal opnieuw uit te voeren.
Product - submission pending Deze fout treedt op wanneer de marketplace je productinformatie nog verwerkt. Voor de meest recente statusinformatie, [download een rapport met niet-geïntegreerde producten in Mirakl](#how-to-download-a-non-integrated-products-report).
1000: Verplicht attribuut is leeg Een verplicht attribuut voor deze marketplace is niet gekoppeld, of heeft een lege waarde. Hoe je dit oplost: 1. Klik in de **Feedback** tabblad in de **Resultaat** stap op de fout. 2. Klik op de gekoppelde ID in de **ID** kolom. 3. Scrol om eventuele velden te zien die zijn gemarkeerd als **Ontbrekende mapping voor \[attribuut invoegen]**. 4. Klik op **Bekijk in de opbouw stap**. Dit brengt je naar het getroffen attribuut in de **Build** stap. 5. Koppel het ontbrekende veld. Als je geen veld hebt met geaccepteerde waarden, kun je [een nieuw veld aanmaken](/get-started/get-started-nl/aan-de-slag/velden-in-channable/velden-mappen-en-toevoegen.md) en dit invullen met [regels](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als **Vereist door de marketplace** (aangegeven met een blauwe stip). Klik op het :circle-info: icoon voor meer informatie/een voorbeeld van geaccepteerde waarden. {% endhint %} 6. Klik op **Opslaan**. 7. Klik op **Uitvoeren**.
1001: Onbekende categorie opgegeven De opgegeven categoriewaarde komt niet overeen met een categorie uit de marketplace, of er is een label opgegeven in plaats van de code. **Hoe je dit oplost:** 1. Klik in de **Feedback** tabblad in de **Resultaat** stap op de fout. 2. Klik op de gekoppelde ID in de **ID** kolom. 3. Klik op **Bekijk in de opbouw stap**. Dit brengt je naar het getroffen attribuut in de **Build** stap. 4. Koppel het ontbrekende veld. Als je geen veld hebt met geaccepteerde waarden, kun je [een nieuw veld aanmaken](/get-started/get-started-nl/aan-de-slag/velden-in-channable/velden-mappen-en-toevoegen.md) en dit invullen met [regels](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als **Vereist door de marketplace** (aangegeven met een blauwe stip). Klik op het :circle-info: icoon voor meer informatie/een voorbeeld van geaccepteerde waarden. {% endhint %} 5. Klik op **Opslaan**. 6. Klik op **Uitvoeren**.
2004: Een attribuut heeft een waarde die te lang is Het gekoppelde veld voor dit attribuut moet onder de opgegeven tekenlimiet blijven. **Hoe je dit oplost:** 1. Klik in de **Feedback** tabblad in de **Resultaat** stap en klik op de fout 2004. 2. Maak een notitie van het getroffen attribuut dat staat vermeld in de **Fouten** kolom, en van de tekenlimiet. 3. Ga naar de **Build** stap en controleer welk veld je hebt gekoppeld voor het getroffen attribuut. {% hint style="success" %} Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als **Vereist door de marketplace** (aangegeven met een blauwe stip). Klik op het :circle-info: icoon voor meer informatie/een voorbeeld van geaccepteerde waarden. {% endhint %} 4. Ga naar de **Regel** stap. 5. Maak een [regel voor maximale lengte](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/how-to-use-actions-then-in-rules/rule-action-maximum-length) voor het veld dat je gebruikt om ervoor te zorgen dat het binnen de tekenlimiet past. Klik op **Opslaan** om de wijzigingen toe te passen. 6. Klik op **Uitvoeren**.
2006: Een attribuut heeft een waarde die niet een van de toegestane waarden is Deze fout treedt op wanneer de waarde in het veld dat je hebt gekoppeld niet wordt geaccepteerd. **Hoe je dit oplost:** 1. Klik in de **Feedback** tabblad in de **Resultaat** stap, klik op de fout 2006. 2. Klik op de gekoppelde ID in de **ID** kolom. 3. Scrol om eventuele velden te zien die zijn gemarkeerd als **Ongeldige waarde voor \[attribuutnaam]**. Klik ernaast op **Bekijk in de opbouw stap**. Dit brengt je naar het getroffen attribuut in de **Build** stap. 4. Maak een notitie van het veld dat je hebt gekoppeld voor het getroffen attribuut. {% hint style="success" %} Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als **Vereist door de marketplace** (aangegeven met een blauwe stip). {% endhint %} 4. Klik op de :circle-info: icoon naast het getroffen attribuut om Voorbeeld en Mogelijke waarden te bekijken. 5. Gebruik [regels](/manage-improve-product-data/manage-product-and-improve-data-nl/regels-bulkbewerken-en-verrijken/regels-gebruiken.md) om een nieuw projectveld met de geaccepteerde waarden bij te werken of aan te maken. Klik op **Opslaan** om de wijzigingen toe te passen. 1. Als je een nieuw projectveld aanmaakt, koppel het dan opnieuw in de **Build** stap aan dat nieuwe veld. 6. Klik op **Uitvoeren**.
2007: Een attribuutwaarde komt niet overeen met een reguliere expressie Deze fout treedt op als de waarde in het attribuut niet het verwachte formaat heeft. **Hoe je dit oplost:** 1. Klik in de **Feedback** tabblad in de **Resultaat** stap, klik op de fout 2007. 2. Klik op de gekoppelde ID in de **ID** kolom. 3. Scrol om eventuele velden te zien die zijn gemarkeerd als **Ongeldige waarde voor \[attribuutnaam]**. Klik ernaast op **Bekijk in de opbouw stap**. Dit brengt je naar het getroffen attribuut in de **Build** stap. 4. Maak een notitie van het veld dat je hebt gekoppeld voor het getroffen attribuut. {% hint style="success" %} Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als **Vereist door de marketplace** (aangegeven met een blauwe stip). {% endhint %} 4. Klik op de :circle-info: icoon naast het getroffen attribuut om Voorbeeld en Mogelijke waarden te bekijken. 5. Gebruik [regels](/manage-improve-product-data/manage-product-and-improve-data-nl/regels-bulkbewerken-en-verrijken/regels-gebruiken.md) om een nieuw projectveld met de geaccepteerde waarden bij te werken of aan te maken. Klik op **Opslaan** om de wijzigingen toe te passen. 1. Als je een nieuw projectveld aanmaakt, koppel het dan opnieuw in de **Build** stap aan dat nieuwe veld. 6. Klik op **Uitvoeren**.
### Mirakl-foutrapporten Je kunt verschillende foutrapporten downloaden in Mirakl om verschillende fouten te onderzoeken. Je vindt ze allemaal onder **Catalogus > Productimports**. * **Foutrapport bronbestand:** Toont wat er mis is in je bronbestand of opmaak. De getoonde gegevens geven exact dezelfde feedback als die in je marketplacekanaal in Channable verschijnt. * **Rapport met niet-geïntegreerde producten (aanbevolen):** Laat zien wat de marketplace heeft afgewezen/beoordeelt nadat je inzending is verwerkt. * **Gebruik wanneer:** Je hebt je kanaal succesvol uitgevoerd, maar je ziet fouten als ‘Product - submission pending’. * **Rapport met toegevoegde producten:** Bevestigt welke producten/regels succesvol zijn geïntegreerd * **Gebruik wanneer:** Je wilt bewijs van wat live staat, of controleren wat er is aangemaakt versus verzonden.
:download: Hoe je een rapport met niet-geïntegreerde producten downloadt {% hint style="info" %} Opmerking: dit is een gedetailleerd rapport dat Mirakl mogelijk enkele dagen nodig heeft om te genereren. Neem bij urgente zaken contact op met het supportteam van Mirakl. {% endhint %} 1. Log in op je Mirakl-account. 2. Ga naar **Catalogus** > **Productimports**.
3. Zoek in de kolom Bestandsnaam welke items door Channable zijn geïmporteerd en wanneer. 4. Klik voor die items op **Details bekijken** om de meest recente importinformatie te bekijken.
5. Klik op **Downloaden** naast **Rapport met niet-geïntegreerde producten** om het foutrapport automatisch te downloaden.
{% hint style="info" %} **Opmerking:** Het bestand is een CSV. Als je Microsoft Excel of Google Sheets gebruikt, moet je het bestand misschien omzetten/importeren om het te kunnen bekijken. {% endhint %} 6. Open het bestand in je software. 7. Controleer de **Fouten** kolom om de specifieke fout(en) voor elk item te zien. 8. Los op wat je kunt op basis van de foutbeschrijving. Mirakl krijgt deze feedback van de marketplace. Als je niet zeker weet wat de beschrijving betekent, neem dan contact op met de marketplace voor meer informatie.
### Productstatus controleren in Mirakl
Producten op het platform hebben drie hoofstatussen: * Validatie * Acceptatie * Synchronisatie Combinaties hiervan zorgen voor verschillende metastatussen. 1. Ga in je Mirakl-backend naar **Catalogus > Catalogusbeheer**. Je ziet daar een overzicht van al je items. 2. Klik in de **Product updates** kolom, klik op :circle-info: voor meer informatie over wat een bepaalde status betekent. 3. Om een meer gedetailleerde beschrijving te bekijken, open je de productpagina en klik je op :circle-question:.
{% hint style="success" %} Tip: gebruik de filters om statussen in bulk te bekijken. {% endhint %} Producten op het platform hebben drie hoofstatussen: Validatie, Acceptatie en Synchronisatie. Combinaties hiervan zorgen voor verschillende metastatussen. #### Statussen in Mirakl Catalogusbeheer | | | | | ------------------ | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Status** | **Metastatus** | **Beschrijving** | | **Validatie** | Geldige gegevens | *De productgegevens voldoen aan de vereisten van de marketplace.* | | | Ongeldige gegevens | *De productgegevens voldoen niet aan de vereisten van de marketplace.* | | | Media in afwachting | *De media (afbeeldingen, video's, documenten) van de productgegevens zijn nog niet verwerkt door het Mirakl-platform.* | | | Niet berekend |

Wanneer de marketplace productgegevensvalidatie activeert voor een kanaal, worden de validatiestatussen van de producten niet automatisch opnieuw berekend. In dat geval krijgen deze producten voor het betreffende kanaal de status 'Niet berekend'.
Verschillende acties kunnen het opnieuw berekenen van de validatiestatus van een product activeren:
- Na het opnieuw opbouwen van de Product Data Sheets
- wanneer je de Bron Product Data Sheet wijzigt en deze wijzigingen worden doorgevoerd in de Master Product Data Sheet
- wanneer je een Master Product Data Sheet wijzigt
Alle nieuwe producten krijgen de juiste validatiestatus voor elk geactiveerd kanaal.

| | **Acceptatie** | Nieuw | *Het product is nieuw en de marketplace moet het accepteren of afwijzen.* | | | Wijzigingen vereist |

Je marketplace heeft het product afgewezen vanwege problemen met de gegevenskwaliteit. Je moet je producten bijwerken voordat je marketplace het product opnieuw beoordeelt.
Je kunt de afwijzingsreden bekijken door met je muis boven het vraagteken (?) te zweven

| | | In afwachting van verificatie |

Je bent gevraagd om een product of meerdere producten bij te werken. Er zijn wijzigingen doorgevoerd.
De marketplaces moeten nu beslissen of ze het product/de producten accepteren of afwijzen.

| | | Geaccepteerd | *Je marketplace heeft het product geaccepteerd.* | | | Afgewezen |

Je marketplace heeft het product afgewezen.
Je kunt de afwijzingsreden bekijken door met je muis boven het vraagteken (?) te zweven

| | **Synchronisatie** | Gesynchroniseerd | *Het product is geïntegreerd in het marketplace-platform.* | | | Niet gesynchroniseerd | *Het product is niet geïntegreerd in het marketplace-platform.* | | | Synchronisatiefout | *Er is een fout opgetreden tijdens de integratie van het product.* | Voor meer informatie over Mirakl-statussen kun je terecht bij [hun helpcenter](https://help.mirakl.net/bundle/sellers/page/topics/Mirakl/mcm/seller/mcm_statuses_provider.htm). --- # 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-nl/verkopen-op-marktplaatsen/mirakl-marktplaatsen/mirakl-gids-instellingen-en-oplossingen.md?ask=&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.