bol.com koppelen met je webshop, voorraad en boekhouding

Wat je met bol.com koppelt

• Nieuwe orders ophalen en doorzetten naar je magazijn of webshop
• Verzendingen melden met track-and-trace
• Voorraad en aanbiedingen bijwerken vanuit je centrale voorraad
• Retouren verwerken in voorraad en boekhouding
• Orders en kosten naar je boekhouding

Hoe de koppeling werkt

De Retailer API werkt met een client-ID en geheim per verkopersaccount. Sommige acties, zoals een verzending melden, verwerkt bol asynchroon: de koppeling vraagt daarna de status op en meldt het als iets niet is gelukt. Alles draait in n8n op je eigen server, met logging en alarm.

Feiten over de API van bol.com

Gecontroleerd op 2 november 2026 tegen de officiële documentatie. Limieten, prijzen en versies veranderen; de bron staat per regel erbij.

Feit	Wat de documentatie zegt	Bron
Authenticatie	OAuth 2 client credentials met een client-ID en geheim uit het Seller Dashboard; een bol retailer-account is vereist.	bol.com: Authentication
Geldigheid token	299 seconden. Geen refresh-token; je vraagt een nieuw token aan, maar niet per aanvraag, want het tokenendpoint heeft een lagere limiet.	bol.com: Authentication
Limieten	Per endpoint, gepubliceerd door bol: bijvoorbeeld 25 per minuut voor het ophalen van de orderlijst en 25 per seconde voor verzendmeldingen. Bij overschrijding 429 met Retry-After.	bol.com: Rate limits
Asynchroon	Schrijfacties zoals een verzendmelding geven een proces-status terug; de koppeling vraagt die status op tot SUCCESS, FAILURE of TIMEOUT.	bol.com: Conventions
Push-notificaties	Via de Subscriptions API v11: ORDER, SHIPMENT en PROCESS_STATUS als webhook (alleen ID's, RSA-SHA256-handtekening). Tien pogingen; daarna wordt de subscription uitgeschakeld.	bol.com: Subscriptions API
Testomgeving	Demo-omgeving met vaste voorbeeldantwoorden (paden /retailer-demo/), met echte authenticatie.	bol.com: Demo
Versie	Versie per resource in URL en Accept-header; Retailer API v10 is actueel, v8 en v9 zijn sinds 11 december 2024 uitgeschakeld. Afgeschafte resources verdwijnen na minimaal twaalf maanden.	bol.com: Versioning
n8n	Geen ingebouwde node; één community-node op npm (juni 2025). Ik koppel via de Retailer API met een HTTP-stap.	n8n-documentatie

Wat jij nodig hebt

• Een bol retailer-account en een beheerder die in het Seller Dashboard API-gegevens kan aanmaken
• Eén plek die de voorraad leidend houdt: je webshop, je WMS of de boekhouding
• Een lijst van je verzendmethoden en de vervoerder per land
• Afspraken over wie retouren beoordeelt voordat voorraad en boekhouding worden bijgewerkt

Waar het vaak misgaat, en hoe ik dat voorkom

• Oververkoop: als de voorraad niet op tijd wordt bijgewerkt, verkoop je wat je niet hebt. Voorraad gaat daarom direct door na elke verkoop elders.
• Asynchrone verwerking: een melding is pas gelukt als bol dat bevestigt. De koppeling controleert die status.
• Leverbeloftes: te late verzendmeldingen tellen mee in je prestaties bij bol. Een alarm waarschuwt bij vertraging.
• Retouren: een retour moet voorraad en boekhouding allebei bijwerken.

Uit de praktijk

In mijn eigen e-commerce draaien bol.com-pipelines voor orders en voorraad naast de webshop, zodat beide kanalen dezelfde voorraad zien.

Wat het kost

Een koppeling met bol.com bouw ik als één afgebakend proces voor een vaste prijs, vanaf €750. Onderhoud en bewaking zijn een maandbedrag: n8n-beheer vanaf €250 per maand, serverbeheer €145 per server. In de gratis scan rekenen we jouw proces door. Alle prijzen en wat erin zit →

Wat ik niet doe

• Ik beheer je bol-account en je aanbiedingen niet; de koppeling verwerkt orders, verzendingen en voorraad volgens jouw regels.
• Ik vraag niet per aanroep een nieuw token aan; dat is tegen de regels van bol en levert blokkades op.
• Ik beschouw een schrijfactie pas als gelukt als bol dat via de proces-status bevestigt.

Veelgestelde vragen over bol.com koppelen

Heeft n8n een bol.com-node?

Nee. Ik koppel bol.com via de officiële Retailer API in n8n. Dat is maatwerk, maar draait op je eigen server en wordt bewaakt.

Werkt dit ook als ik via Channable verkoop?

Ja, dan kijken we welke kant leidend is: Channable voor feeds, of een directe koppeling voor orders en voorraad. Dubbele routes vermijd ik.

Wat als bol de API wijzigt?

bol kondigt nieuwe API-versies vooraf aan. Met onderhoud werk ik de koppeling bij voordat een oude versie verdwijnt.

Waarom is een verzendmelding bij bol niet meteen definitief?

bol verwerkt schrijfacties asynchroon. Je krijgt een proces-status terug die later SUCCESS, FAILURE of TIMEOUT wordt. De koppeling vraagt die status op en meldt het als een verzending niet is verwerkt, zodat een order niet onterecht als verzonden telt.

Hoe lang is een token van bol geldig?

299 seconden. De koppeling hergebruikt het token tot vlak voor het verloopt en vraagt dan pas een nieuw aan, want het tokenendpoint heeft een lagere limiet dan de rest van de API.