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 en elektronische producten. Daarnaast richt Darty zich op elektronische producten en huishoudelijke apparaten.
Inhoudsopgave
- De Fnac Darty API-koppelingen uitgelegd
- Voorbereidingen
- Maak een nieuwe Fnac Darty offers koppeling in Channable
- Maak een nieuwe Fnac Darty offers API
- Maak je productvermeldingen in Channable
- Stuur je productvermeldingen naar Fnac Darty
- Controleer je productvermeldingen op fouten
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 offer API met het Fnac Darty-platform via Channable.
Voorbereidingen
Om een soepele setup te garanderen en problemen te voorkomen, dien je de volgende belangrijke richtlijnen door te nemen en op te volgen:
-
Bekende EAN's bij Fnac Darty:
Dit artikel gaat ervan uit dat je EAN's bekend zijn bij Fnac Darty. Als je EAN's/producten nieuw zijn voor Fnac Darty, raadpleeg dan ons helpcenter artikel over het toevoegen van onbekende EAN-codes/producten aan 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 productvermeldingen 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 offers koppeling in Channable
Om een Fnac Darty Offers-koppeling aan te maken, volg je deze stappen:
- Navigeer naar “Koppelingen”.
- Klik op “+ Koppeling toevoegen”.
- Selecteer “FNAC Darty Offers” (niet “FNAC Darty Products”).
- Voer een labelnaam in, bijvoorbeeld “FNAC Darty Offers”.
Voer het Shop ID in:
- Als je een Fnac Darty Offers API maakt om alleen producten op Fnac te verkopen, vul dan het Fnac Shop ID in die je hebt ontvangen.
- Als je een Fnac Darty Offers API maakt om alleen producten op Darty te verkopen, vul dan de Darty Shop ID in die je hebt ontvangen.
- Als je je producten zowel op Fnac als Darty wilt verkopen, moet je twee aparte koppelingen aanmaken (één met de Fnac Shop ID en een tweede met de Darty Shop ID).
Klik op de "Maak aan" knop om de koppeling op te slaan.
Stap 2: Maak een nieuwe Fnac Darty offers API
Om een nieuwe API aan te maken, ga je naar je project en selecteer je “APIs > + API koppeling toevoegen” en kies je de Fnac Darty Offers-koppeling die je eerder hebt aangemaakt.
Je wordt doorgestuurd naar de API-instellingen, waar je de naam van je API kunt kiezen en een unieke ID per item moet selecteren.
Je kunt optioneel ervoor kiezen om een master regel groep te gebruiken. Klik vervolgens op "Volgende" om de nieuwe Fnac Darty API aan te maken.
Houd hierbij ook de eerder genoemde scenario’s in gedachten:
- Om je producten op Fnac te verkopen, maak je één API aan met de koppeling die de Fnac Shop ID gebruikt die je in Stap 1 hebt ingesteld.
- Om je producten op Darty te verkopen, maak je één API aan met de koppeling die de Darty Shop ID gebruikt die je in Stap 1 hebt ingesteld.
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.
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-naam" > 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 je productvermeldingen op fouten
Als je je productvermeldingen naar Fnac Darty hebt gestuurd, ga je naar het Preview-tabblad van je API. Hier kun je zien welke productvermeldingen fouten bevatten en nog niet online staan.
Een veelvoorkomende fout in de Fnac Darty Offers API is de foutmelding "ERR_026: Product not found". Dit betekent dat je producten niet bekend zijn op Fnac Darty. Om deze fout op te lossen, raadpleeg ons help center artikel over het toevoegen van onbekende EAN's/producten aan Fnac Darty.
Klik op een specifieke fout om meer informatie te zien over wat de fout veroorzaakt.
Best practices
Meerdere attributen toevoegen: Wanneer je meerdere waarden toevoegt in een attribuutveld 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.