Koppel je bol-account in 5 minuten
Om je bestellingen automatisch bij ons binnen te laten komen, maak je in je bol.com verkoopaccount één set API-gegevens aan: een Client ID en een secret. Die stuur je ons één keer toe, en daarna loopt alles vanzelf. Je hoeft er niets voor te installeren en het kost je niets bij bol.
- Inloggegevens van je bol.com verkoopaccount, met beheerrechten (meestal de hoofdgebruiker)
- Een computer (op de telefoon is het scherm met API-instellingen lastig)
- 5 minuten
Zo maak je de API-gegevens aan
Log in op je verkoopaccount
Ga naar partner.bol.com en log in zoals je altijd doet.
Open de API-instellingen
Klik rechtsboven op Instellingen en kies in het menu links, onder het kopje Diensten, voor API Instellingen.
InstellingenDienstenAPI Instellingen
Of ga er direct heen: partner.bol.com/sdd/preferences/services/api
Eenmalig: technisch contactpersoon invullen
Heb je nog nooit een API-koppeling gehad? Dan vraagt bol eerst om een technisch contactpersoon. Vul gewoon je eigen naam, e-mailadres en telefoonnummer in, zet een vinkje bij Ik ga akkoord met de API Terms of Service en klik op Opslaan.
Pas daarna verschijnt het blok met de client credentials. Staan daar al koppelingen? Dan heb je dit al eens gedaan en kun je door naar de volgende stap.
Maak nieuwe client credentials aan
Scrol naar Client credentials voor de Retailer API en klik op Aanmaken. Geef de nieuwe API-gebruiker een herkenbare naam, bijvoorbeeld ESKA Fulfilment, en klik nogmaals op Aanmaken.
Let op: kies het blok Retailer API. Het blok eronder, Advertising API, is voor advertenties en daar kunnen wij je orders niet mee ophalen.
Kopieer de Client ID en het secret
De nieuwe regel staat nu in de lijst. Kopieer de Client ID en klik op Toon secret om ook het secret te kopiëren. Dat zijn de twee gegevens die wij nodig hebben.
Stuur ze naar ons per e-mail
Mail de Client ID en het secret naar info@eskafulfilment.nl, met de naam van je winkel in het onderwerp. Stuur ze liever niet via WhatsApp: het secret is net zo gevoelig als een wachtwoord.
Wij testen de koppeling en laten je weten zodra alles werkt.
Eerst kijken, dan pas schrijven
We zetten de koppeling in twee fases aan, zodat er aan je bol-winkel niets verandert voordat jij er klaar voor bent.
- Tot de start alleen lezen. We halen je artikelen en bestellingen op, zodat ze al in je portaal staan. Aan je voorraad op bol verandert niets.
- Vanaf de startdatum verwerken wij je orders, maken we de verzendlabels aan en melden we de zendingen bij bol af met track & trace.
- Voorraad terugschrijven zetten we pas aan als je voorraad bij ons is ingeboekt en jij akkoord geeft. Dan klopt je stand op bol altijd met wat er echt op de plank ligt.
- We passen geen prijzen, productteksten of advertenties aan.
Handig om te weten
Blijf ik zelf eigenaar van de koppeling?
Ja. De API-gegevens staan in je eigen bol-account en je ziet de koppeling daar altijd terug. Wil je stoppen, dan verwijder je de regel met het prullenbakje ernaast en is de toegang direct ingetrokken.
Ik zie geen "API Instellingen" in het menu.
Dan heeft je gebruiker waarschijnlijk geen beheerrechten. Log in met de hoofdgebruiker van het account, of laat die je de juiste rol geven via Instellingen > Gebruikers & rollen.
Ik zie de knop "Aanmaken" niet.
bol laat de client credentials pas zien nadat de technisch contactpersoon is ingevuld en je akkoord hebt gegeven op de API Terms of Service (stap 3). Vul dat in, klik op Opslaan en ververs de pagina.
Ik gebruik al een andere tool met een bol-koppeling. Kan dat samen?
Ja. Maak voor ons wel een eigen set aan en deel geen bestaande: zo kun je elke partij los intrekken. Laat ons wel weten als een andere tool ook je voorraad op bol bijwerkt, zodat jullie elkaar niet overschrijven.
Verzend ik via bol (VVB)? Moet ik daar nog iets voor doen?
Als je Verzenden via bol gebruikt, maken wij de VVB-labels via dezelfde koppeling aan. Controleer onder Instellingen > Diensten > Verzenden via bol of VVB aanstaat. Je aanbod moet op eigen verzending staan en niet op Logistiek via bol (LVB), anders verstuurt bol het zelf vanuit hun magazijn.
Kost de koppeling iets?
Niet bij bol: de Retailer API is gratis voor verkopers. Bij ons valt de koppeling onder software & portaal, zie de tarieven.
Kom je er niet uit?
App ons even, dan lopen we het samen met je door. Of mail je gegevens direct naar info@eskafulfilment.nl.