Koppeling · bol
Bol koppeling en Retailer API
Je verkoopt via bol. De orders komen binnen in het verkopersaccount, maar moeten ook naar je magazijn, je voorraad moet kloppen met de aanbiedingen en de facturen van bol moeten de boekhouding in.
Goodtomeet bouwt koppelingen tussen bol en je eigen systemen via de bol Retailer API. Orders en retouren komen automatisch binnen, voorraad en prijzen gaan automatisch terug. Een losse koppeling begint bij €3.500.
Wat we koppelen
Wat we met bol koppelen
Orders naar het magazijn
Bol-orders automatisch in je eigen ordersysteem of in Picqer, en de verzendbevestiging met track-en-trace terug naar bol.
ordersVoorraad en prijzen uit het ERP
Voorraad en prijzen vanuit AFAS of Exact Online naar je aanbiedingen op bol, zodat je niet meer verkoopt dan je hebt.
voorraadFacturen en commissies naar de boekhouding
Facturen, commissies en retouren van bol naar Exact Online of SnelStart, voor de afstemming aan het eind van de maand.
boekhoudingDe API
De bol API in het kort
Bol heeft de Retailer API voor verkopers (partners). Veel schrijfacties zijn asynchroon: je krijgt eerst een procesnummer en later de uitkomst. Sinds oktober 2023 heet het bedrijf officieel "bol".
- Soort API
- REST/JSON (Retailer API, versie 10, enkele onderdelen op versie 11).
- Toegang
- OAuth 2.0 via login.bol.com. Je maakt een client ID en secret aan in het verkopersaccount, onder Client credentials voor de Retailer API. Daarmee haalt de koppeling een kortlevend token op.
- Wat je nodig hebt
- Een bol-verkopersaccount. Bol raadt aan eerst in de demo-omgeving te testen voordat je live gaat.
- Wat erin kan
- orders
- zendingen en verzendlabels
- retouren
- aanbiedingen (prijs en voorraad)
- productcontent
- Logistiek via bol
- facturen
- commissies
- Limieten
- Per endpoint verschillend en gepubliceerd door bol. Orders ophalen mag bijvoorbeeld 25 keer per minuut, een zending aanmelden 25 keer per seconde. We lezen de actuele limieten bij de bouw opnieuw uit.
- Webhooks
- Ja, via de Subscriptions API, voor nieuwe orders, annuleringen, zendingen en processtatus. Prijs- en aanbiedingswijzigingen lopen via een berichtenwachtrij.
- Documentatie
- bol Retailer API-documentatie
Gecontroleerd in de officiële documentatie van bol op 2 november 2026. Verandert er iets aan de API, dan passen we dit aan.
Eerst de eerlijke vraag
Kant-en-klaar of laten bouwen?
Bol heeft een lijst gecertificeerde partners met kant-en-klare koppelingen, zoals Channable en pakketten voor het magazijn. Werk je al met een van die pakketten, kijk dan eerst daar.
Laten bouwen loont als je eigen ERP of magazijn er niet tussen staat, als je voorraad uit meerdere kanalen moet verdelen of als de boekhouding de bol-facturen per regel moet kunnen afstemmen.
Wat een bol koppeling kost
Een losse koppeling tussen twee systemen begint bij €3.500. Moet er eerst gelezen en gecontroleerd worden, zoals een order in een pdf of een mail, dan zit het hoger. Vooraf meten we wat het overtypen nu per jaar kost, zodat je weet of het loont.
De code staat op naam van jullie bedrijf. Een andere partij kan hem morgen overnemen.
Eerst controleren
Wat er klaar moet staan
Dit lopen we na voordat er een offerte ligt:
- Een verkopersaccount met API-toegang
Iemand met beheerrechten maakt de client credentials aan. Het secret delen we veilig, niet per mail. - EAN-codes die kloppen
Bol werkt met EAN. Staan die niet bij elk artikel in je eigen systeem, dan vullen we dat eerst aan. - Testen in de demo-omgeving
Bol biedt een demo-omgeving. Daar testen we de koppeling voordat er een echte order doorheen gaat.
Vragen
Wat mensen ons vragen
Heeft bol een API?
Ja, de bol Retailer API voor verkopers. Daarmee haal je orders en retouren op, meld je zendingen aan, beheer je je aanbiedingen en lees je facturen en commissies uit.
Wat kost de Retailer API van bol?
Bol noemt in de documentatie geen kosten voor de API zelf. Je hebt wel een verkopersaccount nodig. Onze koppeling begint bij €3.500.
Kunnen we voorraad uit meerdere kanalen bijhouden?
Ja. De koppeling haalt de voorraad uit je eigen systeem en zet die door naar bol. Verkoop je ook via een eigen webshop, dan houden we één voorraad bij voor allebei.
Wat als bol een limiet geeft?
Bol stuurt bij te veel verzoeken een foutcode met de wachttijd erbij. De koppeling wacht dan en gaat verder, er gaat niets verloren.
Wat kost een bol koppeling?
Een losse koppeling tussen twee systemen begint bij €3.500. Moet er eerst gelezen en gecontroleerd worden, zoals een order in een pdf of een mail, dan zit het hoger. Vooraf meten we wat het overtypen nu per jaar kost, zodat je weet of het loont.
Verder
Lees ook
Deze onderwerpen komen vaak in hetzelfde gesprek voorbij.
Bekijk wat AI voor jou kan doen
Een half uur met Marc over hoe het werk bij jullie loopt. Je gaat weg met een eerlijk antwoord en een eerste idee van wat het oplevert. Zonder voorbereiding, zonder verplichting.
Marc de MunnikOprichter van Goodtomeet