Fnac Darty, is een vooraanstaande Franse retailgroep die is ontstaan uit de fusie van Fnac en Darty, ze zijn gespecialiseerd in een breed scala aan producten. Fnac biedt culturele en elektronische producten aan zoals boeken, muziek, films, videogames. Darty zich op elektronische producten in combinatie met huishoudelijke apparaten.
Inhoudsopgave
- De Fnac Darty API-koppelingen uitgelegd
- Voorbereiding
- Maak een nieuwe Fnac Darty Products koppeling
- Maak een nieuwe Fnac Darty Products API
- Maak je productvermeldingen in Channable
- Stuur je productvermeldingen naar Fnac Darty
- Controleer de productvermeldingen op fouten
- Deactiveer de Fnac Darty Products API
De Fnac Darty API-koppelingen uitgelegd
Er zijn twee verschillende koppelingen en daarom dus ook twee aparte API's voor Fnac Darty die een onderscheid maken tussen je offer en je content data.
- De Fnac Darty Offers koppeling: Deze API (die ook een orderkoppeling ondersteunt) stelt je in staat om producten te verkopen die al bekend zijn bij Fnac of Darty, op basis van EAN-codes. Als je EAN-codes/producten niet bekend zijn bij Fnac of Darty, zal de Fnac Darty Offers API een fout weergeven in de Preview-stap genaamd “ERR_026: Product not found”.
- De Fnac Darty Products API-koppeling: Als Fnac Darty je EAN's/producten niet kent, moet je je gegevens toevoegen aan de Fnac Darty database via de Fnac Darty Products API. Deze API is essentieel voor het aanvankelijk indienen van je EAN's en voor het bijwerken van productinformatie, maar hoeft niet constant geactiveerd te zijn.
In dit artikel zullen we je begeleiden bij het opzetten van een Products API met het Fnac Darty-platform via Channable.
Voorbereiding
Lees en volg deze richtlijnen om problemen bij de installatie te voorkomen:
-
Onbekende EAN's bij Fnac Darty:
In dit artikel wordt ervan uitgegaan dat je EAN's onbekend zijn bij Fnac Darty. Als jouw EAN's/producten bekend zijn bij Fnac Darty, raadpleeg dan dit artikel over het verzenden van je bekende EAN-codes/producten naar Fnac Darty. -
Verplichte EAN's:
EAN-codes zijn verplicht voor Fnac en Darty. Zorg ervoor dat je geldige EAN-codes hebt voor al je producten, anders kunnen er geen product vermeldingen voor je producten worden aangemaakt. -
API-gegevens:
Om je producten op Fnac Darty te verkopen, heb je een professioneel verkopersaccount nodig. Volg de richtlijnen voor het aanmaken van een account hier (in het Frans, onder "Inscription et paramètres de compte"). Nadat je je hebt aangemeld, neem je contact op met Fnac Darty om de Shop ID's voor beide platformen te verkrijgen. Bewaar deze ID's, want je hebt ze nodig in de volgende stap. -
Channable koppeling:
Je kunt alleen een koppeling maken met Fnac Darty, Frankrijk via Channable. Koppelingen met andere Fnac Darty-landen worden op dit moment (nog) niet ondersteund.
Na het voltooien en controleren van alle voorbereidende punten, ben je klaar om naar de eerste stap te gaan.
Stap 1: Maak een nieuwe Fnac Darty Products koppeling
De Fnac Darty Products API maakt gebruik van het Mirakl platform, wat betekent dat je een Mirakl-account nodig hebt om je productgegevens naar Fnac te sturen.
Volg onderstaande stappen om een Fnac Darty connectie aan te maken.
- Navigeer naar 'Koppelingen';
- Klik op '+ Koppeling toevoegen';
- Selecteer 'FNAC Darty Products' (niet 'FNAC Darty Offers');
- Voer een labelnaam in, bijvoorbeeld 'FNAC Darty Products';
- Klik op 'Maak aan' en volg de stappen binnen Mirakl.
Klik op de knop ''Verbinden met Fnac'' om je verbinding op te slaan.
Stap 2: Maak een nieuwe Fnac Darty Products API
Ga om een nieuwe API te maken naar je project, navigeer naar API's > + Nieuwe API toevoegen en selecteer de Fnac Darty Products-verbinding die je eerder hebt gemaakt.
Je wordt doorgestuurd naar de API-instellingen, waar je de naam van je API-koppeling kunt invoeren, de unieke ID per item selecteert en voor de taal France kiest.
Je kunt optioneel beslissen om een master regelgroep te gebruiken. Klik vervolgens op 'Doorgaan' om de nieuwe Fnac Darty Products API aan te maken.
Stap 3: Maak je productvermeldingen in Channable
Volg de onderstaande stappen om je API in te stellen. Klik op elke stap om deze uit te klappen en de gedetailleerde instructies te bekijken, die je door het hele proces zullen leiden.
1. Categorieën
Om je productgegevens aan te maken, hebben je producten een categorie nodig. Voeg categorieën aan je producten toe met de functie 'categorieën genereren' of maak nieuwe categorieën aan.
- Smart categorization: Deze functie wijst automatisch categorieën aan je producten toe op basis van vooraf gedefinieerde criteria, wat het categorisatie proces vereenvoudigt.
- Handmatige categorieën: Wijs handmatig categorieën toe aan je producten door specifieke regels in te stellen. Je kunt gedetailleerde filters maken om elk product aan de juiste categorie toe te wijzen.
- Niet-gecategoriseerde items: Controleer en categoriseer alle items die nog niet gecategoriseerd zijn om ervoor te zorgen dat alle producten goed gecategoriseerd zijn.
2. Regels
Maak verschillende regels om je productgegevens te optimaliseren. Raadpleeg voor voorbeelden ons helpcenter artikel voor algemene regels.
- Regels setup: Stel verschillende regels in om je productgegevens te verfijnen. Dit kan het filteren, wijzigen of verbeteren van datavelden omvatten om te voldoen aan de vereisten van de marketplace.
3. Opbouw stap
Met de Opbouw stap in Channable kun je alle benodigde attributen voor je items configureren, zodat je productgegevens overeenkomen met de vereisten van de marketplace. Deze stap is cruciaal voor succesvolle product listings en het vermijden van fouten.
3.1 Overzicht
- Ga naar de Opbouw stap: Begin met het openen van de gecentraliseerde interface van de Opbouw stap. Hier kun je alle productattributen beheren en in kaart brengen.
- Identificeer verplichte en optionele velden: Verplichte velden zijn roze gemarkeerd om aan te geven dat ze essentieel zijn. Optionele velden zijn oranje gemarkeerd en kunnen worden ingevuld op basis van specifieke behoeften.
3.2 Gedeelde attributen vullen
-
Gedeelde attributen vullen: Voer algemene gegevens in die van toepassing zijn op alle producten, zoals EAN, prijzen en titels. Deze stap zorgt voor uniformiteit in de basisproductinformatie voor al je listings.
-
Gebruik statische of dynamische waarden:
- Statische waarden: Direct waarden invoeren die constant blijven, zoals merknaam of fabrikant.
- Dynamische waarden: Gebruik velden die automatisch worden bijgewerkt op basis van gekoppelde gegevens, ideaal voor variabelen zoals voorraadniveaus of prijzen.
-
Gebruik statische of dynamische waarden:
Nadat je de gewenste waarden voor de gedeelde attributen hebt ingevuld, ga je verder met de categoriespecifieke attributen hieronder.
3.3 Categoriespecifieke attributen opgeven
- Selecteer een productcategorie: Kies de relevante categorie voor je product, zoals kleding of meubels.
- Invullen van categoriespecifieke attributen: Vul de attributen in die specifiek zijn voor de geselecteerde categorie, zoals maten voor kleding of afmetingen voor meubels. Deze stap helpt bij het afstemmen van je listings op de categorie vereisten. Ook hier kun je statische of dynamische waarden gebruiken.
4. Kwaliteitsstap
De kwaliteitsstap geeft direct feedback over de kwaliteit van de instellingen en markeert verplichte en optionele fouten om ervoor te zorgen dat je productgegevens voldoen aan de standaarden van de marketplaces.
Acties
- Bekijk items: Bekijk producten met specifieke problemen.
- Bekijk in de opbouw stap: Leidt je door naar de opbouw stap om ontbrekende informatie in kaart te brengen.
- Categorieën instellen: Hiermee ga je naar de Categorieën stap om items te categoriseren.
- Toon Bron: Beschikbaar voor ID-velden, hiermee ga je direct naar de instellen stap.
Klik hier om meer te lezen over de kwaliteitsstap in de API.
5. Bekijk stap
De Bekijk stap toont in kaart gebrachte attributen voor meerdere items en markeert fouten voordat er naar de marketplace wordt geëxporteerd.
Features
- Zoek & filter: Zoek specifieke producten of filter op foutmelding/categorie.
- Item overzicht: Toont alle items die geëxporteerd moeten worden; het kan filteren om alleen items met fouten te tonen.
- Gedetailleerd productoverzicht: Toont ontbrekende informatie en dynamische acties om fouten te corrigeren.
Checklist voor het afronden van attributen
- Gedeelde kenmerken bekijken: Zorg ervoor dat alle verplichte gedeelde attributen zijn ingevuld.
- Categoriespecifieke kenmerken bekijken: Zorg ervoor dat alle verplichte categoriespecifieke attributen zijn ingevuld.
- Contoleer op fouten: Corrigeer rood gemarkeerde velden.
6. Resultaat stap
Het tabblad Resultaat geeft een overzicht van de resultaten van je API-instelling, inclusief succesvolle uploads, fouten en een voorbeeld van de producten die worden weergegeven. Dit tabblad zorgt ervoor dat je productgegevens correct worden verwerkt en identificeert eventuele problemen die moeten worden opgelost.
- Overzicht: Het resultaat tabblad toont de status van je productvermeldingen en markeert fouten en problemen voor een gedetailleerd inzicht.
- Preview van producten: Toont een overzicht van producten die naar de marketplace moeten worden verstuurd, zodat kan worden gecontroleerd of attributen correct zijn ingevuld.
- Succesvol: Toont producten die met succes zijn verwerkt en klaar zijn om gelist te worden, en bevestigt dat ze voldoen aan de vereisten van de marketplace.
- Fouten: Identificeert fouten tijdens de verwerking en geeft gedetailleerde informatie om problemen op te lossen.
Optionele tabbladen zoals Repricer fouten, Repricer event geschiedenis, Voorraadupdates en Leveringstype updates verschijnen alleen als ze relevant zijn voor de API die je gebruikt. Klik hier om meer te lezen over de Resultaat stap.
Additionele info voor Fnac Darty Products
Voor de Fnac Darty Products API hoef je enkel het EAN veld te selecteren in de Opbouw-stap. Als je het juiste EAN-veld hebt geselecteerd, klik je op 'Opslaan'.
Stap 4: Stuur je productvermeldingen naar Fnac Darty
Zodra alle stappen zijn voltooid, ben je klaar om je productvermeldingen te versturen. Volg de onderstaande instructies om dit te doen.
- Ga naar Configuratie > Projectconfiguratie aan de linkerkant van het scherm;
- Klik op 'Activeer project';
- Navigeer terug naar het APIs-overzicht;
- Ga naar je API-kanaal > 'Instellen';
- Selecteer 'Activeer API'om de API te activeren;
- Keer terug naar het APIs-overzicht en klik op de blauwe knop 'Uitvoeren' om je productvermeldingen te versturen.
Stap 5: Controleer de productgegevens op fouten
Zodra je de productgegevens hebt ingediend, navigeer je naar de Resultaat-stap van je Fnac Darty Products API. Selecteer 'Fouten', waar je kunt zien welke productvermeldingen fouten bevatten en niet zijn opgenomen door Mirakl. Klik op een specifieke fout om een uitleg te zien over de oorzaak van de fout.
Het kan voorkomen dat de Products API geen producten aanmaakt en Fnac Darty geen foutmeldingen terugstuurt naar Channable. Als dit gebeurt, zijn er twee manieren om een meer gedetailleerd foutrapport te krijgen.
Download het foutenrapport in het Fnac platform
- Navigeer naar het Fnac-platform en ga naar 'Offers' > 'Add an offer';
- In de Last processing report-sectie vind je een samenvatting van je laatste import. Klik hier op Download report, naast Processing report.
Download het foutenrapport in Fnac Darty Mirakl
- Log in binnen Mirakl en navigeer naar Catalog > Product imports;
- In de Product Imports-sectie vind je een lijst met de imports vanuit Channable;
- Klik op de See details-knop naast de meest recente import om de laatste foutmeldingen te downloaden;
- Selecteer de Non-integrated products report, waarna deze automatisch wordt gedownload. Hier lees je meer over het downloaden van dit rapport.
Door deze stappen te volgen, kun je eventuele problemen met je productvermeldingen op het Fnac Darty platform efficiënt opsporen en oplossen.
Stap 6: Deactiveer de Fnac Darty Products API
Zoals eerder vermeld, hoeft de Fnac Darty Products API alleen actief te zijn voor de eerste EAN-upload en content-updates.
- Navigeer naar de Resultaat-stap van de Fnac Darty Offers API. Lees dit artikel voor meer informatie over deze API.
- Als je daar de foutmelding ERR_026: Product not found ziet, dien je de Fnac Darty Products API te activeren.
Als de fout niet aanwezig is in de Resultaat-stap, kun je de Fnac Darty Products API deactiveren.
Best practices
Meerdere attributen toevoegen: Wanneer je meerdere waarden in een attribuutveld toevoegt voor Mirakl Marketplaces, scheid elke waarde met een pipe-symbool "|" om ervoor te zorgen dat ze correct worden gedetecteerd en verwerkt.
Seller's Product ID voor enkele/simpele producten: Let op dat er twee attributen zijn genaamd 'SellerArticleId' en 'SellerProductId'. 'SellerProductId' verwijst naar de Parent ID, terwijl 'SellerArticleId' verwijst naar de varianten. Voor enkele producten moeten beide attributen met dezelfde waarde worden ingevuld.
Voor meer informatie over fouten, instructies en best practices voor Mirakl Marketplaces, bekijk onze speciale gids. Klik hier om meer te lezen.