Je Bol.com API-sleutel aanmaken
Bol.com geeft je een Client ID en een Client Secret waarmee Schakel namens jou bestellingen, voorraad en verzendingen mag ophalen en bijwerken. Je maakt ze zelf aan in je verkoopaccount, in ongeveer twee minuten.
Wat je overhoudtAan het eind heb je twee waarden: een Client ID en een Client Secret voor de Retailer API.
- 01
Ga naar je Bol.com verkoopaccount
Log in op je Bol.com partneraccount en klik rechtsboven op je naam. Klik vervolgens op Instellingen.
Of ga direct naar https://partner.bol.com/sdd/preferences/shop/details
- 02
Open API Instellingen
Scroll naar beneden op de instellingenpagina. Onder het kopje Diensten vind je API Instellingen. Klik hierop.
Of ga direct naar https://partner.bol.com/sdd/preferences/services/api
- 03
Maak nieuwe API-credentials aan
Scroll naar Client credentials voor de Retailer API en klik op de knop + Aanmaken.
- 04
Geef de sleutel een naam
Geef de API-sleutel een herkenbare naam, bijvoorbeeld Schakel. Zo zie je later meteen waar hij bij hoort als je meerdere sleutels hebt. Klik op opslaan.
- 05
Kopieer je Client ID en Secret
Na het aanmaken zie je je nieuwe credentials in de lijst. Kopieer de Client ID en klik op Toon secret om je Client Secret te bekijken en te kopiëren.
- 06
Vul de gegevens in bij Schakel
Plak de Client ID en het Client Secret in Schakel onder Connecties. Schakel test de verbinding meteen, dus je weet direct of het klopt. Staat de verbinding op groen, dan gaat de koppeling die je hebt opgezet deze toegang gebruiken en draait de eerste synchronisatie binnen een paar minuten.
Goed om te weten
- Je Client Secret is een wachtwoord. Deel het niet per mail en zet het niet in een gedeeld document. Raak je het kwijt, dan maak je gewoon een nieuw paar aan en verwijder je het oude.
- Eén sleutelpaar per koppeling houdt het overzichtelijk: je kunt er dan één intrekken zonder dat de rest stopt met werken.
- De Retailer API is iets anders dan de Advertiser API. Schakel heeft de Retailer API nodig.
Als er iets misgaat
- Schakel meldt dat de gegevens ongeldig zijn.
- Kopieer de Client ID en het Client Secret opnieuw, zonder spatie ervoor of erachter. Het secret zie je alleen achter Toon secret. Weet je het niet zeker, maak dan een vers paar aan en plak die.
- De sleutel is aangemaakt onder de Advertiser API.
- Schakel gebruikt de Retailer API. Maak het paar aan onder Client credentials voor de Retailer API; een Advertiser-sleutel werkt niet.
- Je verkoopt via meerdere Bol.com-winkels.
- Elke winkel heeft een eigen sleutelpaar in het eigen account. Maak per winkel één paar aan en voeg ze los toe in Schakel, zodat je er één kunt intrekken zonder de rest te raken.
Koppelingen die je Bol.com-toegang gebruiken
Heb je de sleutels binnen, dan gaan ze hierheen. Elke koppeling hieronder praat met Bol.com.
Loop je vast op een stap?
Schermen verschuiven weleens. Ziet het er bij jou anders uit dan op de schermafbeeldingen, stuur ons dan een bericht. Dan kijken we mee en passen we de pagina aan.