Mirakl-gids: instellingen en oplossingen

In deze gids lees je hoe je veelvoorkomende problemen oplost en best practices volgt bij het draaien van een Mirakl-marketplace met Channable.

Mirakl runt zelf geen marktplaats. In plaats daarvan biedt het de infrastructuur die anderen gebruiken om hun marktplaats te creëren en te beheren.

Omdat veel Mirakl-marktplaatsen dezelfde opzet gebruiken, hebben ze vaak vergelijkbare instellingen, gedrag en veelvoorkomende problemen.

Mirakl-marktplaatsen 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

---

Best practices en instellingen voor Mirakl

Meerdere attribuutwaarden toevoegen

Als je meerdere waarden voor één attribuutveld moet invoeren voor een Mirakl-marktplaats, scheid dan elke waarde met een pipe-symbool "|". Deze opmaak zorgt ervoor dat Mirakl elke afzonderlijke invoer correct herkent en verwerkt.

Veelvoorkomende Mirakl-fouten en hoe je ze oplost

Aanbod - product niet gevonden

Deze fout treedt op wanneer de EAN van een product niet wordt herkend door de Mirakl-database.

Dit gebeurt meestal wanneer:

• Het product nog door Mirakl wordt verwerkt (aangegeven als Product - inzending in behandeling).

• De productimport is mislukt vanwege ontbrekende of ongeldige verplichte gegevens (bijvoorbeeld categorie-specifieke attributen). Dit wordt meestal weergegeven als Product - gegevensfout of Product - integratiefout.

Hoe op te lossen

1. In de Resultaat stap van je Mirakl-marktplaatskanaal, ga naar het Feedback tabblad.

2. Bekijk andere productgerelateerde fouten in de lijst.

3. Controleer de foutmelding in de Fout kolom. Pas waar nodig je gegevens aan met behulp van regels.

4. Bekijk en map attributen die als verplicht zijn gemarkeerd in de Opbouw stap. Controleer het pictogram en de tooltips om geaccepteerde waarden te zien.

5. Klik Uitvoeren om je kanaal opnieuw uit te voeren.

Product - inzending in behandeling

Deze fout treedt op wanneer de marktplaats je productinformatie nog aan het verwerken is.

Voor de meest recente statusinformatie, download een rapport van niet-geïntegreerde producten in Mirakl.

1000: Verplicht attribuut is leeg

Een verplicht attribuut voor deze marktplaats is niet gemapt of heeft een lege waarde.

Hoe op te lossen:

1. In de Feedback tabblad in de Resultaat stap, klik op de fout.

2. Klik op de gekoppelde ID in de ID kolom.

3. Scroll om velden te zien die zijn gemarkeerd als Ontbrekende mapping voor [voeg attribuut in].

4. Klik Bekijk in opbouw. Dit brengt je naar het getroffen attribuut in de Opbouw stap.

5. Map het ontbrekende veld. Als je geen veld met geaccepteerde waarden hebt, kun je een nieuw veld aanmaken en het vullen met behulp van regels.

Tip: Terwijl je hier toch bezig bent, controleer eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauw bolletje). Klik op het pictogram voor meer informatie/een voorbeeld van geaccepteerde waarden.

1. Klik Opslaan.

2. Klik Uitvoeren.

1001: Onbekende categorie opgegeven

De opgegeven categoriewaarde komt niet overeen met een categorie van de marktplaats, of er is een label opgegeven in plaats van de code.

Hoe op te lossen:

1. In de Feedback tabblad in de Resultaat stap, klik op de fout.

2. Klik op de gekoppelde ID in de ID kolom.

3. Klik Bekijk in opbouw. Dit brengt je naar het getroffen attribuut in de Opbouw stap.

4. Map het ontbrekende veld. Als je geen veld met geaccepteerde waarden hebt, kun je een nieuw veld aanmaken en het vullen met behulp van regels.

Tip: Terwijl je hier toch bezig bent, controleer eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauw bolletje). Klik op het pictogram voor meer informatie/een voorbeeld van geaccepteerde waarden.

1. Klik Opslaan.

2. Klik Uitvoeren.

2004: Een attribuut heeft een waarde die te lang is

Het gemapte veld voor dit attribuut moet onder de opgegeven limiet voor tekens blijven.

Hoe op te lossen:

1. In de Feedback tabblad in de Resultaat stap, klik op fout 2004.

2. Noteer het getroffen attribuut dat wordt genoemd in de Fouten kolom, en de tekenlimiet.

3. Ga naar de Opbouw stap en controleer welk veld je hebt gemapt voor het getroffen attribuut.

Tip: Terwijl je hier toch bezig bent, controleer eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauw bolletje). Klik op het pictogram voor meer informatie/een voorbeeld van geaccepteerde waarden.

1. Ga naar de Regel stap.

2. Maak een regel voor maximale lengte op het veld dat je gebruikt om ervoor te zorgen dat het binnen de tekenlimiet past. Klik zeker op Opslaan om wijzigingen toe te passen.

3. Klik Uitvoeren.

2006: Een attribuut heeft een waarde die niet een van de toegestane waarden is

Deze fout treedt op wanneer het veld dat je hebt gemapt een waarde bevat die niet wordt geaccepteerd.

Hoe op te lossen:

1. In de Feedback tabblad in de Resultaat stap, klik op fout 2006.

2. Klik op de gekoppelde ID in de ID kolom.

3. Scroll om velden te zien die zijn gemarkeerd als Ongeldige waarde voor [attribuutnaam]. Klik ernaast op Bekijk in opbouw. Dit brengt je naar het getroffen attribuut in de Opbouw stap.

4. Noteer welk veld je hebt gemapt voor het getroffen attribuut.

Tip: Terwijl je hier toch bezig bent, controleer eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauw bolletje).

1. Klik op het pictogram naast het getroffen attribuut om Voorbeeld en Mogelijke waarden te bekijken.

2. Gebruik regels om een nieuw projectveld bij te werken of aan te maken met de geaccepteerde waarden. Klik zeker op Opslaan om wijzigingen toe te passen.

   1. Als je een nieuw projectveld aanmaakt, zorg er dan voor dat je het opnieuw mapt in de Opbouw stap naar dat nieuwe veld.

3. Klik Uitvoeren.

2007: Een attribuutwaarde komt niet overeen met een reguliere expressie

Deze fout treedt op als de waarde in het attribuut niet in het verwachte formaat is.

Hoe op te lossen:

1. In de Feedback tabblad in de Resultaat stap, klik op fout 2007.

2. Klik op de gekoppelde ID in de ID kolom.

3. Scroll om velden te zien die zijn gemarkeerd als Ongeldige waarde voor [attribuutnaam]. Klik ernaast op Bekijk in opbouw. Dit brengt je naar het getroffen attribuut in de Opbouw stap.

4. Noteer welk veld je hebt gemapt voor het getroffen attribuut.

Tip: Terwijl je hier toch bezig bent, controleer eventuele resterende fouten die zijn gemarkeerd als Vereist door de marketplace (aangegeven met een blauw bolletje).

1. Klik op het pictogram naast het getroffen attribuut om Voorbeeld en Mogelijke waarden te bekijken.

2. Gebruik regels om een nieuw projectveld bij te werken of aan te maken met de geaccepteerde waarden. Klik zeker op Opslaan om wijzigingen toe te passen.

   1. Als je een nieuw projectveld aanmaakt, zorg er dan voor dat je het opnieuw mapt in de Opbouw stap naar dat nieuwe veld.

3. Klik Uitvoeren.

Mirakl-foutrapporten

Je kunt verschillende foutrapporten downloaden in Mirakl om fouten te onderzoeken. Je vindt ze allemaal onder Catalogus > Productimports.

• Bronbestand foutrapport: Toont wat er mis is in je bronbestand of -formaat. De weergegeven gegevens geven exact dezelfde feedback als in je marktplaatskanaal in Channable.

• Rapport niet-geïntegreerde producten (aanbevolen): Vertelt je wat de marktplaats heeft afgewezen/aan het beoordelen is nadat je inzending is verwerkt.

  • Te gebruiken wanneer: Je kanaal succesvol is uitgevoerd, maar je ziet ‘Product - inzending in behandeling’ fouten.

• Toegevoegde producten rapport: Bevestigt welke producten/regels succesvol zijn geïntegreerd

  • Te gebruiken wanneer: Je wilt bewijs van wat live staat, of reconciliëren wat is gemaakt versus wat is verzonden.

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

Opmerking: Dit is een gedetailleerd rapport dat enkele dagen kan duren voordat Mirakl het genereert. Voor dringende zaken, neem contact op met het supportteam van Mirakl.

1. Log in op je Mirakl-account.

2. Ga naar Catalogus > Productimports.

1. In de kolom Bestandsnaam vind je welke items door Channable zijn geïmporteerd en hun tijdstempels.

2. Klik voor die items op Bekijk details om de meest recente importinformatie te bekijken.

1. Klik Download naast Rapport 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 mogelijk transformeren/importeren om het te bekijken.

1. Open het bestand in je software.

2. Controleer de Fouten kolom om specifieke fout(en) voor elk item te zien.

3. Los op wat je kunt op basis van de foutomschrijving. Mirakl ontvangt deze feedback van de marktplaats.

Als je niet zeker weet wat de beschrijving betekent, neem dan contact op met de marktplaats voor meer informatie.

Controleer de productstatus in Mirakl

Producten op het platform hebben drie primaire statussen:

• Validatie

• Acceptatie

• Synchronisatie

Combinaties hiervan produceren verschillende meta-statussen.

1. Ga in je Mirakl-backend naar Catalogus > Catalogusbeheer. Je ziet een overzicht van al je items.

2. In de Product updates kolom, klik voor meer informatie over wat een bepaalde status betekent.

3. Om een meer gedetailleerde omschrijving te bekijken, open de productpagina en klik .

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

Producten op het platform hebben drie primaire statussen: Validatie, Acceptatie en Synchronisatie. Combinaties hiervan produceren verschillende meta-statussen.

Mirakl Catalogusbeheer statussen

Status	Meta status	Beschrijving
Validatie	Geldige gegevens	De productgegevens voldoen aan de vereisten van de marktplaats.
	Ongeldige gegevens	De productgegevens voldoen niet aan de vereisten van de marktplaats.
	In afwachting van media	De media (afbeeldingen, video’s, documenten) van de productgegevens is nog niet verwerkt door het Mirakl-platform.
	Niet berekend	Wanneer de marktplaats productdatavalidatie activeert voor een kanaal, worden de validatiestatussen voor de producten niet automatisch opnieuw berekend. In dat geval krijgen deze producten de status 'Niet berekend' voor het betreffende kanaal. Meerdere acties kunnen de herberekening van de validatiestatus van een product triggeren: - Na de heropbouw van de Product Data Sheets - wanneer je de Source Product Data Sheet wijzigt en deze wijzigingen worden weerspiegeld in de Master Product Data Sheet - wanneer je een Master Product Data Sheet wijzigt Alle nieuwe producten krijgen de geschikte validatiestatus voor elk geactiveerd kanaal.
Acceptatie	Nieuw	Het product is nieuw en de marktplaats moet het accepteren of afwijzen.
	Wijzigingen vereist	Je marktplaats heeft het product afgewezen vanwege problemen met de datakwaliteit. Je moet je producten bijwerken voordat de marktplaats het product opnieuw beoordeelt. Je kunt de afwijzingsreden bekijken door met je muis over het vraagteken (?) te bewegen
	In afwachting van verificatie	Je bent gevraagd om een product of producten bij te werken. Er zijn wijzigingen aangebracht. De marktplaatsen moeten nu beslissen om het product/de producten te accepteren of af te wijzen.
	Geaccepteerd	Je marktplaats heeft het product geaccepteerd.
	Afgewezen	Je marktplaats heeft het product afgewezen. Je kunt de afwijzingsreden bekijken door met je muis over het vraagteken (?) te bewegen
Synchronisatie	Gesynchroniseerd	Het product is geïntegreerd in het marktplaatsplatform.
	Niet gesynchroniseerd	Het product is niet geïntegreerd in het marktplaatsplatform.
	Synchronisatiefout	Er is een fout opgetreden tijdens de integratie van het product.

Voor meer informatie over Mirakl-statussen kun je terecht bij hun helpcentrum.