Mirakl-gids: instellingen en oplossingen

Mirakl is een bedrijf dat een platform faciliteert voor online marktplaatsen. Het exploiteert zelf geen marktplaats; in plaats daarvan biedt het de infrastructuur waarop verschillende marktplaatsen gebouwd kunnen worden.

Marktplaatsen die op Mirakl’s platform zijn gebouwd delen een gemeenschappelijk kader, wat betekent dat ze vaak vergelijkbaar gedrag, instellingen en vergelijkbare problemen hebben.

Deze gids legt uit hoe je veelvoorkomende obstakels oplost en welke best practices je kunt volgen bij het runnen van een marktplaats die op Mirakl is gebouwd met Channable.

---

Onze ondersteunde Mirakl-marktplaatsen

Decathlon	Fnac	Blokker Connect!
Leroy Merlin	fonQ	Darty
Bricoman	Mediamarkt	Conforama
Carrefour Frankrijk/Spanje	Manor	PcComponentes
Maxeda Brico&Praxis	Leen Bakker	ePrice
Douglas	Galeries Lafayette	Home24

Best practices en instellingen voor Mirakl

Hoe je meerdere attribuutwaarden toevoegt

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

Mirakl-fouten

Wat is de mirakl_unknown_error_code en hoe los je het op?

Een fout die je kunt tegenkomen is de mirakl_unknown_error_code. Deze fout duidt op een groep problemen die meestal optreden wanneer de EAN van een product niet wordt herkend door de Mirakl-database — wat aangeeft dat het product ofwel nieuw is op de marktplaats of dat er verplichte attributen ontbreken.

Kort gezegd: iets dat door de marktplaats vereist is ontbreekt of is niet correct ingevuld.

Hoewel dit complex kan lijken, bestaat de oplossing vaak uit een paar eenvoudige stappen:

• Categorieën: Zorg dat je productcategorieën correct zijn gekoppeld in de Categorieën stap van je API. Als dat niet zo is, map ze dan nauwkeurig.

• Bouw: Controleer of de Build-stap van je API correct is geconfigureerd. Bijvoorbeeld, een verkeerd gekoppeld EAN-veld kan fouten veroorzaken. Pas eventuele afwijkingen aan.

• Attributen: In de Attribuutstap van de API, koppel elk veld aan de juiste tegenhanger en zorg dat de waarden geschikt zijn voor de geselecteerde categorie.

• Regels: Gebruik regels om je data verder te verfijnen. Zie het supportartikel over de attribuutbouwer voor het verbeteren van de Attributen-stap in je API.

Zodra categorieën en attributen in je API zijn ingevuld, ga naar het overzicht van API's en voer de API uit door op de blauwe "Uitvoeren" knop te klikken.

Fout 1004: De categorie kon niet worden geïdentificeerd

Fout 1004 geeft aan dat items worden verzonden met onjuiste categoriekeuze die niet overeenkomt met de categorieën van de marktplaats op Mirakl. Dit wordt vaak veroorzaakt door eerder handmatig ingestelde categorie-mapping in je Mirakl-marktplaats.

Hoe los je het probleem op:

Navigeer naar Settings in de linker zijbalk en klik op 'Settings' > 'Catalog mapping'. Je ziet daar de mapping. Het oranje omlijnde veld (Category) kan handmatig zijn toegevoegd. Selecteer het oranje omlijnde 'category' en de mapping wordt aan de rechterkant weergegeven. Klik nogmaals op 'Category' (dit is veilig om te verwijderen omdat Channable het daar niet heeft geplaatst), en klik vervolgens op 'Remove mapping'. Nadat je de handmatige mapping hebt verwijderd, ga terug naar de Mirakl API in Channable en voer de API opnieuw uit. Dit ververst de categorie-associaties en zou de categorie-onverenigbaarheidsfout moeten oplossen.

Krijg het Mirakl-foutrapport

Omdat marktplaatsen zijn gebouwd op het Mirakl-platform, volgt het verkrijgen van een foutrapport voor alle marktplaatsen dezelfde procedure.

1. Log in op je Mirakl-account en ga naar Catalogus > Product Imports.

1. Vind de imports die door Channable zijn uitgevoerd en hun tijdstempels. Klik op de knop "See details" voor de meest recente import.

1. Selecteer "Non-integrated products report" om het foutrapport automatisch te downloaden.

Opmerking: het bestand is een CSV. Als je Microsoft Excel gebruikt, moet je het bestand mogelijk transformeren/importeren.

Na het downloaden en converteren van het bestand, zoek je de kolom "Status" om specifieke fout(en) per item te zien.

Wat betekenen de statussen in Mirakl?

Om de productstatus te zien, ga naar Catalog Manager voor een overzicht van al je producten.

• Om een overkoepelende status te begrijpen, klik op het vraagteken (?) naast het product.

• Om de meta-status (gedetailleerd) te zien, open je de productpagina en klik je op (?).

• Gebruik de filters in Catalog Manager om statussen in bulk te bekijken.

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

De statussen in Mirakl Catalog Manager

Status	Meta status	Beschrijving
Validatie	Geldige data	De productgegevens voldoen aan de vereisten van de marktplaats.
	Ongeldige data	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 voor een kanaal activeert, worden de validatiestatussen voor de producten niet automatisch opnieuw berekend. In dat geval krijgen deze producten de status 'Niet berekend' voor het betreffende kanaal. Verschillende acties kunnen de herberekening van de validatiestatus van een product triggeren: - Na het herbouwen van de Product Data Sheets - wanneer je het Source Product Data Sheet wijzigt en deze wijzigingen worden weerspiegeld in het 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 marktplaats moet het accepteren of afwijzen.
	Wijzigingen vereist	Je marktplaats heeft het product afgewezen vanwege datakwaliteitsproblemen. Je moet je producten bijwerken voordat je marktplaats het product opnieuw beoordeelt. Je kunt de reden van afwijzing bekijken door met je muis over het vraagteken (?) te bewegen
	In afwachting van verificatie	Je bent gevraagd 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 reden van afwijzing 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 hun helpcentrum bezoeken.