APIs voor Brico & Praxis opzetten

Maxeda, de organisatie achter Praxis (Nederland) en Brico (België), biedt een belangrijke marketplace voor doe-het-zelfproducten in de Benelux-regio. Via Mirakl kunnen externe verkopers producten aanbieden op beide platformen, waarmee ze een breed publiek bereiken en tegelijkertijd kwaliteitsnormen handhaven.

Deze handleiding biedt stapsgewijze instructies voor het instellen van de Praxis- en Brico-API’s via Mirakl in Channable, samen met richtlijnen voor een effectieve implementatie.

Inhoudsopgave

• Uitleg over de Praxis en Brico-API's
• Accountacceptatie
• Koppelingen maken met Praxis en Brico
• De API’s aanmaken voor Praxis en Brico
• Productvermeldingen aanmaken
• API’s activeren
• Setup voltooien en accountverificatie
• Productvermeldingen controleren op fouten

Uitleg over de Praxis- en Brico-API's

Om producten te verkopen op zowel Praxis als Brico, moet je jouw producten op beide platformen aanbieden. In Channable wordt dit beheerd via twee aparte API's, één voor elk platform. Deze API's koppelen zich met hetzelfde Mirakl-verkoopaccount, dat vervolgens wordt gekoppeld aan de individuele winkels voor Brico en Praxis.

Maxeda werkt anders dan andere marketplaces, omdat het vereist dat alle gegevens identiek zijn in beide API's. Dit is een belangrijke overweging bij het instellen van je productvermeldingen en het maken van regels, aangezien consistentie essentieel is voor een succesvolle integratie.

Accountacceptatie

Om producten succesvol op het Maxeda-platform te vermelden en voordat je de API’s instelt, moeten enkele stappen worden voltooid om aan de Maxeda-richtlijnen te voldoen. We bespreken deze hieronder:

• Maak de Praxis NL-winkel aan: Begin met het aanmaken van de Praxis NL-winkel.
• Maak gebruikers aan in de Praxis NL-winkel: Informeer het Maxeda Marketplaces-team om de Brico BE-winkel te openen en de NL-accountgebruikers te dupliceren.
• Accountinformatie verifiëren: Nadat beide winkels zijn aangemaakt, zorg ervoor dat alle informatie in je Mirakl-account is ingevuld volgens de richtlijnen.
• Winkelstatus controleren: Controleer de status van elke winkel in Mirakl. Als een winkel niet actief is, kan er aanvullende informatie nodig zijn. Neem contact op met Maxeda voor ondersteuning.

Maxeda moet ook je producten beoordelen. Dit gebeurt pas wanneer je winkels actief zijn en alle benodigde productinformatie is verstrekt. Raadpleeg voor meer informatie de documenten onderaan dit artikel of neem rechtstreeks contact op met Maxeda.

Stap 1: Koppelingen maken met Praxis en Brico

Om de instellingen voor de Maxeda Praxis- en Maxeda Brico-koppelingen te voltooien, dien je de volgende stappen voor elk platform te herhalen:

1. Navigeer naar Koppelingen in Channable.
2. Klik op + Koppeling toevoegen.
3. Selecteer ofwel Maxeda Praxis of Maxeda Brico.
   
4. Voer een labelnaam in, bijvoorbeeld "Praxis" voor Praxis of "Brico" voor Brico.
5. Klik op Maak verbinding met Maxeda Praxis/Brico. Je wordt doorgestuurd naar Maxeda/Mirakl voor de volgende stap. Log daar in met je Maxeda/Mirakl-gegevens.

Na een succesvolle login is de koppeling met Maxeda tot stand gebracht en beschikbaar voor gebruik.

Stap 2: De API’s aanmaken voor Praxis en Brico

Eenmaal terug in Channable, navigeer je naar de API’s-pagina in je project.

1. Klik op +API koppeling toevoegen. Selecteer de Praxis- of Brico-koppeling die je eerder hebt gemaakt en begin met het configureren van de API-instellingen:

   • Geef je API een naam.
   • Selecteer de Unieke ID per item; we raden aan het veld ‘id’ te selecteren.
   • Selecteer de taal van je API. De gekozen taal heeft geen invloed op de taal van de gegevens die naar Maxeda worden verzonden.
   • We raden sterk aan om een master regel groep te gebruiken om synergie tussen de twee API’s te creëren.
     

2. Om de nieuwe API aan te maken, klik op Volgende.

Belangrijk: Deze stappen moeten afzonderlijk worden uitgevoerd voor zowel Maxeda Praxis als Maxeda Brico.

Stap 3: Productvermeldingen aanmaken

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

2. Regels

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

1. 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.
2. 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

1. 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.

Nadat je de gewenste waarden voor de gedeelde attributen hebt ingevuld, ga je verder met de categoriespecifieke attributen hieronder.

3.3 Categoriespecifieke attributen opgeven

1. Selecteer een productcategorie: Kies de relevante categorie voor je product, zoals kleding of meubels.
2. 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.

Klik hier om meer te lezen over de Opbouw stap in een API.

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.

Klik hier om meer te lezen over de Bekijk stap in een API.

6. Resultaat stap

Aanvullende informatie voor Praxis & Brico

De volgende informatie is specifiek voor Maxeda. Hieronder geven we belangrijke informatie over de Praxis- en Brico-API’s en de belangrijkste regels die gevolgd moeten worden.

• Zorg voor consistentie tussen beide API’s
  Om fouten te voorkomen en een soepele productvermelding te garanderen voor zowel Praxis als Brico, is het essentieel om consistente productgegevens op beide platformen te handhaven. Inconsistente gegevens kunnen leiden tot fouten, zoals:
  
  "Afgekeurd product: Verplichte velden zijn niet ingevuld; voeg content toe aan beide kanalen (BE+NL)."
  Om deze problemen te voorkomen, gebruik je de functie Master Regels in Channable. Hiermee kun je consistentie in je productvermeldingen voor beide API’s centraliseren en afdwingen. Je kunt een master-regelgroep aanmaken en toepassen op zowel de Praxis- als Brico-API, zodat alle verplichte velden en belangrijke gegevens gesynchroniseerd blijven.
  Voor meer informatie over het gebruik van master Regels, raadpleeg ons artikel over gemeenschappelijke master regels.

• Afbeeldingen
  Hoewel beide API’s aangeven dat afbeeldingen moeten worden toegevoegd in de attributen, verzoekt Maxeda specifiek om alleen afbeeldingen via de Praxis-API te sturen. Voor de Brico-API laat je de afbeeldingsattributen leeg.
  
  
• De Gouden Regels
  Maxeda voert initiële controles uit op basis van de Gouden Regels. Zodra je product aan deze criteria voldoet, volgen verdere beoordelingen. Hieronder staan de Gouden Regels:

  Vereiste	Beschrijving	Toepasselijk voor
  Verplichte Velden Voltooiing	Productgegevens moeten volledig zijn voor zowel de verplichte velden van Praxis als Brico.	Praxis, Brico
  Titel Samenstelling (BE-NL, NL-NL)	'merk' – 'producttype' – 'serienummer' – 'attribuut 1' en/of 'afmetingen' – 'andere zoekwoorden' (Max. 85 tekens).	Praxis, Brico
  Titel Samenstelling (BE-FR)	'producttype' – 'merk' – 'serienummer' – 'attribuut 1' en/of 'afmetingen'(Max. 100 tekens).	Brico
  Productbeschrijving	Gebruik alleen basis-HTML (geen CSS). Benadruk de belangrijkste voordelen van het product. Vermeld duidelijk wat er in de doos zit (of wat er niet bij zit). Beschrijf het gebruik van het product en de beoogde doelgroep. Herhaal de belangrijkste zoekwoorden en het merk in de tekst. Spreek de klant aan met 'u' (Min. 150 tekens).	Praxis, Brico
  Unique Selling Points (USPs)	3 USP's in alle talen zijn verplicht. Benadruk kenmerken die het product doen opvallen (Max. 65 tekens).	Praxis, Brico
  Afbeeldingen	Minimaal 2 afbeeldingen met een minimale grootte van 500x500px. Voeg afmetingen of een handleiding toe indien relevant.	Praxis, Brico
  Getalnotatie	Gebruik altijd '.' (punt) voor getallen in plaats van ',' (komma).	Praxis, Brico

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.

Stap 4: API’s Activeren

Volg de onderstaande stappen om je API’s te activeren:

1. Ga naar Configuratie > Projectconfiguratie aan de linkerzijde van het scherm.
2. Klik op Activeer project.
3. Navigeer terug naar het API-overzicht.
4. Ga naar [Jouw API-naam] > Instellen.
5. Selecteer Activeer API om de API te activeren.
6. Keer terug naar het API-overzicht en klik op de blauwe knop Uitvoeren om je productvermeldingen te versturen.

Stap 5: Setup Voltooien en Accountverificatie

Nadat je API’s zijn ingesteld, is het essentieel om te verifiëren dat je producten succesvol zijn verstuurd en correct zijn vermeld op de marketplace. Volg deze stappen om de setup af te ronden:

Productstatus verifiëren op de marketplace

Nadat je API’s zijn ingesteld, kan het zijn dat producten succesvol naar de marketplace zijn verstuurd, maar nog niet live zijn. Zorg ervoor dat je Maxeda-account in Mirakl alle vereiste stappen heeft voltooid, zoals besproken in de sectie Accountacceptatie van dit artikel.

Wanneer je inlogt bij Mirakl, kun je de status van elke winkel zien. Als een winkel niet live is, kan dit betekenen dat er aanvullende informatie nodig is. Neem in dat geval contact op met Maxeda voor ondersteuning.

"Golden Rules"-fouten

Bij het voor de eerste keer versturen van producten naar Maxeda, kun je de foutmelding ontvangen: "mirakl_unknown_error_code" gevolgd door "Het product bestaat niet". Deze fout treedt op wanneer sommige of alle EAN’s/producten nog niet door Maxeda zijn beoordeeld en geaccepteerd. Deze producten worden door Maxeda beoordeeld volgens hun gouden regels-beleid.

Product beoordelingstijd

Het content team van Maxeda doet er meestal ongeveer een week over om producten te beoordelen. Als de producten aan hun beleid voldoen, wordt de foutmelding opgelost en gaan de producten live.

Stap 6: Productvermeldingen controleren op fouten

Zodra je de foutmeldingen "mirakl_unknown_error_code" en "Het product bestaat niet" hebt opgelost, kun je de API’s beheren zoals je dat ook voor andere marketplaces in Channable zou doen. Vergeet echter niet om wijzigingen in beide API’s te synchroniseren wanneer je aanpassingen maakt.

Om je fouten te controleren, ga je naar de Resultaat-tabbladen van je API’s. Hier kun je zien welke productvermeldingen fouten bevatten en welke correcties nodig zijn.