Je bol-account koppelen aan een tool: client ID en secret

Het korte antwoord

Wil je een tool laten werken met je verkoopaccount op bol.com, bijvoorbeeld voor facturen, voorraad of prijzen, dan koppel je die via de Retailer API. Je geeft de tool daarvoor een client ID en een client secret: een soort gebruikersnaam en wachtwoord die alleen voor die koppeling gelden. Je eigen inlog bij bol deel je nooit.

In dit artikel lees je hoe je die gegevens aanmaakt, wat een tool ermee kan, hoe je de toegang weer intrekt en waar je op let voordat je een tool toegang geeft.

Wat is de Retailer API?

De Retailer API is de technische verbinding tussen software en je verkoopaccount bij bol. Via de Retailer API kan software onder meer werken met:

• je aanbod: prijzen, voorraad en levertijden;
• bestellingen en zendingen;
• retouren;
• facturen, waaronder het uploaden van de factuur voor de klant;
• commissies, promoties en voorraad bij Logistiek via bol;
• inzichten, zoals bezoeken en je aandeel in het koopblok.

Er zijn twee manieren om een tool te koppelen. Bij de eerste maak jij client credentials aan en vul je die in bij de tool. Bij de tweede start je de koppeling in de tool, log je in op de pagina van bol en klik je op "Toestaan". Die tweede route (bol noemt het SSO) is er alleen voor tools die door bol als partner zijn toegelaten. Dit artikel gaat vooral over de eerste.

Client ID en secret aanmaken, stap voor stap

Zo beschrijft bol het op het partnerplatform:

1. Log in op je verkoopaccount en open de instellingen.
2. Ga onder het kopje "Diensten" naar "API Instellingen".
3. Vul de gegevens van een technisch contactpersoon in en klik op "Opslaan". bol gebruikt die voor belangrijke berichten over de API.
4. Klik onder "Client credentials voor de Retailer API" op "Aanmaken".
5. Geef de credentials een naam. Gebruik de naam van de tool of de partij die hem gaat gebruiken. Klik weer op "Aanmaken".
6. De client ID staat nu in de lijst. Klik op "Toon secret" om het secret te zien.
7. Kopieer de client ID en het secret naar de koppelpagina van de tool.

Na het koppelen controleert een goede tool meteen of de gegevens werken, bijvoorbeeld door je recente bestellingen op te halen. Lukt dat niet, controleer dan of je de client ID en het secret volledig hebt gekopieerd, zonder spatie aan het begin of eind.

Waarom je nooit je wachtwoord deelt

Een tool heeft je wachtwoord niet nodig. De API werkt met client credentials of met de inlogpagina van bol zelf. Vraagt een dienst toch om je inloggegevens, dan is dat een reden om niet verder te gaan.

Met aparte client credentials houd je de controle:

• Je ziet per koppeling wie toegang heeft, omdat elke set de naam van de tool draagt.
• Je trekt één koppeling in zonder de rest te raken. Stop je met een tool, dan verwijder je alleen die set.
• Je blijft verantwoordelijk. In de API-voorwaarden van bol staat dat de toegangsgegevens strikt persoonlijk zijn, dat jij ze geheim moet houden, en dat het gebruik door een tussenpartij voor jouw rekening en risico is.

Wat een gekoppelde tool kan zien en doen

Met client credentials geef je een tool toegang tot de Retailer API van je account. bol schreef in september 2026 over de nieuwe koppelingen via SSO: "Je geeft niet langer toegang tot de hele API, maar kiest alleen de onderdelen die nodig zijn." Daarbij kies je per onderdeel tussen alleen lezen en beheren, verdeeld over vijf groepen: Assortimentbeheer, Logistiek, Inzichten, Financiën en Subscriptions. Voor koppelingen met client credentials verandert er volgens bol voorlopig niets; bol verwachtte dat die later zouden volgen. Kijk in je API-instellingen hoe het er nu voor jouw account voor staat.

Wat betekent dat in de praktijk? Een tool kan, afhankelijk van wat hij doet:

• klantgegevens zien die bij een bestelling horen, zoals naam en adres. Het e-mailadres van de klant geeft de API na 61 dagen niet meer, en de factuurgegevens na ongeveer een maand ook niet;
• je aanbod wijzigen, zoals prijs en voorraad (een repricer doet precies dat);
• facturen uploaden bij een zending;
• cijfers lezen, zoals je verkoopfacturen van bol en je prestaties.

Heeft een klant zijn gegevens afgeschermd, dan geeft de API "ANONYMISED" terug. bol schrijft voor dat je dan alle klantgegevens uit je eigen database verwijdert. Dat geldt ook voor de tool die je gebruikt.

Toegang intrekken

Stop je met een tool, of vertrouw je hem niet meer, trek dan de toegang in:

• Client credentials: verwijder de set met de naam van die tool in je API-instellingen. bol noemt dat de manier om met een derde partij te stoppen.
• Koppeling via SSO: verwijder de partij onder "Authorized parties voor de Retailer API". Zo'n toestemming geldt een jaar en moet daarna opnieuw worden gegeven.

Vraag de tool daarnaast om je gegevens te verwijderen, en bewaar die bevestiging. Denk ook aan facturen die je nodig hebt voor je eigen administratie: exporteer die eerst.

Rate limits in gewone taal

bol beperkt hoeveel verzoeken software per minuut of per seconde mag doen. Dat heet een rate limit. Een paar voorbeelden uit de lijst van bol:

Gaat software over de limiet, dan antwoordt bol met foutcode 429 en moet de software even wachten. bol vraagt om alleen echte wijzigingen te sturen, liever een rustige stroom dan grote pieken, en te stoppen bij een 429. bol houdt bij welke koppelingen vaak tegen de limiet aanlopen en neemt dan contact op. In de API-voorwaarden staat dat overschrijding kan leiden tot een (tijdelijke) blokkade.

Ook het inloggen zelf is beperkt. Een toegangstoken van bol is maar kort geldig (in het voorbeeld van bol 299 seconden) en is bedoeld om opnieuw te gebruiken. Wie voor elk verzoek een nieuw token vraagt, riskeert volgens bol een blokkade van zijn IP-adres. Voor jou als verkoper is dit vooral een vraag aan je tool: gaat hij hier netjes mee om?

Waar je op let bij het kiezen van een tool

1. Verwerkersovereenkomst. Verwerkt een tool klantgegevens van bol, dan ben je volgens bol verplicht een verwerkersovereenkomst met die partij te sluiten. Jij blijft verantwoordelijk voor de gegevens. Vraag er dus naar.
2. Alleen wat nodig is. Een factuurtool hoeft je prijzen niet te wijzigen. Kun je bij een koppeling kiezen welke onderdelen je deelt, geef dan alleen wat de tool echt nodig heeft.
3. Waar staan je gegevens? Vraag waar de tool je gegevens opslaat en hoe lang. bol staat niet toe dat je klantgegevens langer bewaart dan nodig is om de overeenkomst uit te voeren, en ook niet dat je ze voor marketing gebruikt.
4. Datalekken. Een datalek met gegevens van bol-klanten moet je direct bij bol melden via partnerservice. Vraag hoe de tool jou op de hoogte brengt als er iets misgaat.
5. Netjes met de API. Vraag hoe de tool omgaat met rate limits en tokens. Een tool die bol overbelast, kan jouw koppeling in gevaar brengen.
6. Makkelijk stoppen. Kun je je gegevens exporteren en je account verwijderen zonder gedoe?

Bkoppeling werkt met client credentials: je maakt een aparte set aan met de naam Bkoppeling, en die kun je op elk moment weer verwijderen. Je kunt het 14 dagen gratis proberen, zonder betaalgegevens. Wil je eerst zien hoe het werkt, bekijk dan de demo.