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.

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.

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 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, 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.
4. Controleer en koppel attributen die als verplicht zijn gemarkeerd in de Build stap. Controleer het 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.

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 en dit invullen met regels.

Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauwe stip). Klik op het icoon voor meer informatie/een voorbeeld van geaccepteerde waarden.

1. Klik op Opslaan.
2. 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 en dit invullen met regels.

Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauwe stip). Klik op het icoon voor meer informatie/een voorbeeld van geaccepteerde waarden.

1. Klik op Opslaan.
2. 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.

Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauwe stip). Klik op het icoon voor meer informatie/een voorbeeld van geaccepteerde waarden.

1. Ga naar de Regel stap.
2. Maak een regel voor maximale lengte 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.
3. 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.

Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauwe stip).

1. Klik op de icoon naast het getroffen attribuut om Voorbeeld en Mogelijke waarden te bekijken.
2. Gebruik regels 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.
3. 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.

Tip: controleer hier meteen ook eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauwe stip).

1. Klik op de icoon naast het getroffen attribuut om Voorbeeld en Mogelijke waarden te bekijken.
2. Gebruik regels 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.
3. 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.

Hoe je een rapport met niet-geïntegreerde producten downloadt

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.

1. Log in op je Mirakl-account.
2. Ga naar Catalogus > Productimports.

1. Zoek in de kolom Bestandsnaam welke items door Channable zijn geïmporteerd en wanneer.
2. Klik voor die items op Details bekijken om de meest recente importinformatie te bekijken.

1. Klik op Downloaden naast Rapport met niet-geïntegreerde producten om het foutrapport automatisch te downloaden.

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.

1. Open het bestand in je software.
2. Controleer de Fouten kolom om de specifieke fout(en) voor elk item te zien.
3. 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 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 .

Tip: gebruik de filters om statussen in bulk te bekijken.

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.