Wat is de bol.com Retailer API en wat heb je eraan als verkoper?

Wat de Retailer API is

Een API is een koppeling waarmee programma’s met elkaar praten, zonder dat er iemand op een scherm klikt. De Retailer API is die van bol voor verkopers. Op developers.bol.com zet bol er twee naast elkaar: de Retailer API voor bestellingen, aanbod, productinformatie en meer, en de Advertising API voor advertenties.

Volgens het overzicht voor verkopers automatiseer je er je hele verkoopproces mee. Je beheert er je producten, je aanbod, je bestellingen en verzendingen mee, en ook annuleringen, retouren, facturen en verzendlabels. Voor Logistiek via bol zijn er aparte onderdelen.

Bol waarschuwt er zelf bij dat het geen kant-en-klare oplossing is. Elke manier om te koppelen vraagt kennis van softwareontwikkeling. Daarom gebruiken de meeste verkopers de API via een tool die dat werk al gedaan heeft.

Wat erin zit

De API quick reference somt de onderdelen voor verkopers op. Bol noemt ze Offers, Orders, Shipments, Shipping Labels, Transports, Returns, Replenishments, Inventory, Invoices, Commissions, Promotions, Subscriptions, Retailers, Insights, Economic Operators, Delivery Promise, Product Content en Products.

Voor een verkoper tellen vooral deze:

• Orders en Shipments: je bestellingen en wat je ermee doet, zoals verzenden en annuleren.
• Offers: je aanbod, met prijs en voorraad.
• Returns en Invoices: je retouren en je facturen van bol.
• Inventory en Replenishments: je voorraad bij Logistiek via bol en de zendingen daarheen.
• Subscriptions: berichten van bol bij een gebeurtenis, zoals een nieuwe bestelling.

Wat FBR, FBB en LVB in die onderdelen betekenen, lees je in FBR, FBB en LVB uitgelegd.

Wie de API gebruikt

Er zijn twee soorten gebruikers. Verkopers die zelf software bouwen, en bedrijven die namens verkopers koppelen: integrators, repricers en tools zoals BluePing. Welke soorten tools er zijn, zie je in de manieren om een melding van een bestelling te krijgen.

Bol kent daarvoor twee routes, volgens de documentatie over toegang. Bouw je zelf, of gebruik je een tool die niet bij bol als partner staat, dan gebruik je client credentials. Vermelde integratiepartners krijgen toegang via een aparte route waarbij jij één keer per jaar toestemming geeft.

Hoe toegang werkt

Voor client credentials maak je in je verkoopaccount een client id en een secret aan, bij API Instellingen. Hoe dat gaat, staat stap voor stap in client credentials aanmaken. Geef elke tool een eigen set, dan trek je de toegang per tool weer in.

Met die set vraagt een tool bij bol een toegangsbewijs aan dat een beperkte tijd geldig is, en dat bewijs gaat mee met elke vraag aan de API. Bol stelt grenzen aan hoeveel vragen een tool mag stellen; wie daar overheen gaat, krijgt een foutmelding 429, staat in Rate Limits. Een goede tool houdt daar rekening mee, zodat je er als verkoper niets van merkt.

Nieuwe bestellingen: zelf kijken of een seintje

Een tool kan op vaste momenten bij de API vragen of er nieuwe bestellingen zijn. Sinds mei 2026 kan bol ook zelf een seintje geven zodra er een nieuwe of gewijzigde bestelling is. Bol noemt dat bestelnotificaties, in het nieuwsbericht van mei 2026. Heb je een eigen koppeling, dan moet je dat zelf inbouwen.

BluePing kijkt op vaste momenten: ongeveer elke 60 minuten op Starter en elke 15 minuten op Plus. Met /blueping sync laat je BluePing meteen kijken. De andere commando’s staan bij de Slack-commando’s.

Wat BluePing via de API leest en bewaart

BluePing gebruikt de Retailer API met de client credentials die jij aanmaakt. Het leest je bestellingen en hun status, je aanbod met de voorraad voor de voorraadmelding, en de namen van je producten. Het verandert niets: geen verzending, geen prijs en geen voorraad.

Bij het koppelen controleert BluePing je set meteen bij bol. Daarna staan je client id en secret versleuteld opgeslagen. Van je bestellingen bewaart BluePing alleen een beknopte bestelsamenvatting, geen klantnamen, adressen of betaalgegevens. Bij welke diensten je gegevens staan, lees je bij de subverwerkers.

Officieel, maar niet van bol

De Retailer API is van bol zelf. BluePing bouwt erop, maar is een onafhankelijk product van Hakkens Trading uit Reusel. Het is niet verbonden aan bol.com of aan Slack. Meer over wie BluePing maakt, lees je op Over BluePing. Wat BluePing in Slack plaatst, staat in bol.com-bestellingen automatisch in Slack.