Mirakl is een bedrijf dat een platform biedt voor online marketplaces. Mirakl beheert zelf geen marketplaces, maar levert de infrastructuur waarop verschillende marketplaces kunnen worden gebouwd.
Als gevolg hiervan delen marketplaces die op het Mirakl-platform zijn gebouwd gemeenschappelijke elementen, wat betekent dat ze vaak vergelijkbare eigenschappen, instellingen en dus ook soortgelijke problemen hebben.
Dit is waar ons Mirakl artikel van pas komt. In dit artikel bespreken we hoe je obstakels kunt oplossen die je kunt tegenkomen of wat enkele best practices zijn bij het runnen van een marketplace gebouwd op het Mirakl-platform.
- De Mirakl marketplaces die we momenteel ondersteunen
- Best practices en instellingen voor Mirakl
- Mirakl-fouten
- Het Mirakl-foutenrapport ophalen
- Wat zijn de statussen in Mirakl?
- De statussen in Mirakl Catalog Manager
De Mirakl marketplaces die we momenteel ondersteunen
Decathlon | Fnac | Blokker Connect! |
Leroy Merlin | fonQ | Darty |
Bricoman | Mediamarkt | Conforama |
Carrefour France/Spain | Manor | PcComponentes |
Maxeda Brico&Praxis | Leen Bakker | ePrice |
Douglass | Galeries Lafayette | Home24 |
Best practices en instellingen voor Mirakl
Hoe je meerdere attribuutwaarden kan toevoegen
Als je meerdere waarden voor een enkel attribuutveld, voor een Mirakl-marketplace, wilt invoeren, is het belangrijk om elke waarde te scheiden met een pijpsymbool "|". Deze opmaak is cruciaal om ervoor te zorgen dat Mirakl elke afzonderlijke invoer correct herkent en verwerkt. Door dit eenvoudige scheidingsteken te gebruiken, kun je tijd besparen bij het beheren van je content.
Mirakl-fouten
Wat is de 'mirakl_unknown_error_code' en hoe los je deze op?
Een fout die je kunt tegenkomen is de 'mirakl_unknown_error_code'. Deze fout is het gevolg van een groep fouten die meestal optreden wanneer de EAN van een product niet door de Mirakl-database wordt herkend.
Dit betekent dat het product nieuw is op de marketplace of dat er attributen ontbreken die nog niet aan het product zijn toegevoegd.
In het kort: er ontbreekt iets wat vereist is door de marketplace of het is niet correct ingevuld.
De oplossing voor dit probleem is vaak eenvoudig, met enkele simpele stappen kun je deze fout oplossen:
- Categorieën: Zorg ervoor dat je productcategorieën correct zijn gekoppeld in de Categorieën stap van je API in Channable. Als ze dat niet zijn, neem dan even de tijd om ze nauwkeurig te koppelen. Voor gedetailleerde instructies over dit proces kun je ons artikel over categorie mapping raadplegen.
- Opbouw stap: Controleer vervolgens of de Opbouw stap van je API correct is geconfigureerd. Als er bijvoorbeeld een onjuist EAN-veld is gekoppeld kan dit leiden tot fouten. Breng de nodige aanpassingen aan om eventuele mismatches te corrigeren.
- Attributen stap: In de Attributen stap van de API in Channable is het cruciaal om elk veld aan de juiste tegenhanger te koppelen en ervoor te zorgen dat de waarden geschikt zijn voor de geselecteerde categorie. Voor een dieper begrip van het beheren van attributen, bekijk ons artikel over attribuut optimalisatie.
- Regels: Gebruik regels om je data verder te verfijnen. Ons artikel over de attributen kan dienen als een uitgebreide bron om de attributen in je API te verbeteren.
Zodra je de categorieën en attributen in je API hebt ingevuld, kun je naar het API-overzicht gaan en de API uitvoeren door op de blauwe knop 'Uitvoeren' te klikken.
Error 1004: The category could not be identified
Als je de fout 1004 ontvangt in je Mirakl API, betekent dit dat je problemen hebt met items die worden verzonden met onjuiste categorie mapping die niet kan worden gekoppeld aan de categorieën van de marketplace op het Mirakl-platform.
De meest waarschijnlijke oorzaak hiervan is bestaande handmatige categorie mapping in je Mirakl marketplace. Deze bestaande mapping is mogelijk handmatig toegevoegd en moet worden aangepakt om deze fout op te lossen.
Hoe je het probleem oplost:
1. Navigeer naar instellingen in de linkerzijbalk en klik op 'Instellingen' > 'Catalogusmapping'.
2. Eenmaal daar zie je de mapping uit het screenshot hieronder, het in oranje omrande veld (Categorie) is handmatig toegevoegd.
3. Selecteer het in oranje omrande 'categorie' en de mapping wordt aan de rechterkant van het scherm weergegeven.
4. Klik nogmaals op 'Categorie', dit is veilig om te verwijderen, omdat Channable het niet heeft toegevoegd. Klik vervolgens op de knop 'Mapping verwijderen'.
5. Nadat de handmatige mapping is verwijderd, ga je terug naar de Mirakl API in Channable en voer je de API opnieuw uit.
Deze actie zal resulteren in het vernieuwen van de categorie associaties en zou de error met betrekking tot categorie mismatches moeten oplossen.
Het Mirakl-foutenrapport ophalen
Omdat de marketplaces zijn gebouwd op hetzelfde Mirakl-platform, is het verkrijgen van een foutenrapport hetzelfde. Hier is hoe je dit moet doen:
Log simpelweg in op je Mirakl-account en ga naar 'Catalogus' > 'Productinvoer'.
Vervolgens vind je een lijst met imports die door Channable zijn gedaan, samen met hun tijdstempels.
Om de nieuwste en nauwkeurigste details van fouten voor je producten te krijgen, klik je op de knop 'Zie details' die overeenkomt met de meest recente import.
Van de getoonde opties selecteer je 'Niet-geïntegreerd productenrapport' om het foutenrapport te bekijken. Dit zal resulteren in een automatische download van het rapport.
Nadat je het bestand hebt gedownload en correct hebt omgezet, zoek je in het bestand naar de kolom 'Status'. Deze kolom toont de specifieke fout(en) die aan elk item zijn gekoppeld.
Wat zijn de statussen in Mirakl?
Om de status van je product te zien, kun je naar Catalog Manager navigeren. Hier zie je een overzicht van al je producten.
Om te begrijpen wat overkoepelende status betekent, klik je op het vraagteken (?), naast het product. Om de meta-status (Gedetailleerder) van het product te zien, navigeer je naar de productpagina en klik je op (?) voor een uitleg.
Voor het bekijken van statussen in bulk zijn de filteropties van de Catalog Manager nuttig. Deze filters kunnen worden gecombineerd om een specifieke groep producten met een bepaalde status te identificeren.
Producten op het platform worden onderverdeeld in drie primaire statussen: 'Validatie', 'Acceptatie' en 'Synchronisatie'. De combinatie van deze statussen creëert verschillende 'meta statussen', die zichtbaar zijn voor de gebruikers.
Hieronder vind je een overzicht van de statussen en meta statussen die door Mirakl op hun platform worden gebruikt.
De statussen in Mirakl Catalog Manager
Status | Meta status | Description |
Validation (Validatie) |
Valid data (Geldige data) | De productgegevens voldoen aan de vereisten van de marketplace. |
Invalid data (Ongeldige data) | De productgegevens voldoen niet aan de vereisten van de marketplace. | |
Pending media (In afwachting van media) | De media (afbeeldingen, video's, documenten) van de productgegevens zijn nog niet verwerkt door het Mirakl platform. | |
Not computed (Niet berekend) |
Wanneer de marketplace de validatie van productgegevens voor een kanaal activeert, worden de validatiestatussen voor de producten niet automatisch opnieuw berekend. In dit geval krijgen deze producten de status 'Niet berekend' voor het betreffende kanaal.
|
|
Acceptance (Acceptatie) |
New (Nieuw) | Het product is nieuw en de marketplace moet het accepteren of afwijzen. |
Changes required (Vereiste wijzigingen) |
De marketplace heeft het product afgekeurd vanwege problemen met de datakwaliteit. Je moet je producten bijwerken voordat de marketplace het product opnieuw beoordeelt. Je kunt de reden van afwijzing bekijken door met je muis over het vraagteken (?) te bewegen. |
|
Pending verification (In afwachting van verificatie) |
je bent gevraagd om een product of producten bij te werken. Er zijn wijzigingen aangebracht. De marketplace moeten nu beslissen of ze het product of de producten accepteren of afwijzen. |
|
Accepted (Geaccepteerd) | De marketplace heeft het product geaccepteerd. | |
Rejected (Afgewezen) |
De marketplace heeft het product afgewezen. Je kunt de reden van afwijzing bekijken door met je muis over het vraagteken (?) te bewegen. |
|
Synchronization (Synchronisatie) |
Synchronized (gesynchroniseerd) | Het product is geïntegreerd in het marketplace-platform. |
Not synchronized (Niet gesynchroniseerd) |
Het product is niet geïntegreerd in het marketplace-platform. | |
Synchronization error (Fout bij synchronisatie) | Er is een fout opgetreden tijdens de integratie van het product. |
Voor meer informatie over Mirakl-statussen, kun je hun helpcenter bezoeken.