Your Tech Club
KOPPELINGENBOL

bol.com koppelen

Wie op bol verkoopt, werkt met strakke regels. Je leverbelofte telt, zendingen moeten op tijd gemeld zijn en je voorraad moet kloppen, anders volgen annuleringen en een slechtere prestatiescore. Een koppeling haalt orders automatisch binnen, meldt zendingen met track-and-trace en houdt je aanbod gelijk met je voorraad.

Alle koppelingen
4,8 uit 127 reviews
ISO 9001 & 27001
bolWebshop en betalen
  • Aanbod, prijs en voorraad gaat heen en weer met Je andere systemen
  • Orders en annuleringsverzoeken gaat heen en weer met Je andere systemen
  • Verzending en track-and-trace gaat heen en weer met Je andere systemen
  • Retouren gaat heen en weer met Je andere systemen
Je andere systemenZoals Exact Online, SnelStart, Shopify

Onder meer gebouwd voor Tata Steel, M&G Investments, Digistore24, Toppers in Concert, Bar-le-Duc en Loogman

Wat je uitwisselt

Dit zijn de gegevens die organisaties het vaakst tussen systemen laten lopen. Welke daarvan voor jou tellen, hangt af van waar het werk nu blijft liggen.

Aanbod, prijs en voorraad

Je aanbod op bol draait om de EAN. Per EAN geef je prijs, voorraad en leverbelofte door. Verandert je voorraad in je webshop of ERP, dan moet bol dat snel weten, anders verkoop je wat er niet meer is.

Orders en annuleringsverzoeken

Nieuwe bol-orders komen in je webshop, ERP of magazijnsysteem, met orderregels en afleveradres. Vraagt een klant om annulering, dan staat dat bij de orderregel. Je systeem moet dat oppakken voordat het pakket de deur uit gaat.

Verzending en track-and-trace

Zodra het pakket weg is, meld je de zending met vervoerder en track-and-trace, of met een verzendlabel van bol. Daarmee ziet de klant waar zijn pakket is en meet bol of je op tijd levert.

Retouren

Retouren komen per retourregel binnen. Na ontvangst geef je aan wat je ermee doet, zoals terugbetalen, omruilen of afwijzen. Is het product weer verkoopbaar, dan gaat je voorraad omhoog.

Logistiek via bol (LVB)

Bij LVB ligt je voorraad in het magazijn van bol en verzendt bol zelf. Je koppeling haalt dan de LVB-voorraad op, meldt nieuwe zendingen naar het magazijn aan en verwerkt LVB-orders alleen in je administratie.

Facturen en commissies

bol stuurt facturen met een specificatie van onder meer commissie en LVB-kosten. Haal je die automatisch op, dan sluit je boekhouding aan op je bol-verkopen.

Standaard of maatwerk

Niet altijd. Doet een bestaande koppeling voor bol precies wat je nodig hebt, dan zeggen we dat ook.

Wat er al bestaat

bol noemt twee routes om te koppelen: via apps en dienstverleners die al aan bol gekoppeld zijn, of zelf via de Retailer API. Op het bol Partnerplatform vind je apps voor onder meer voorraad- en orderbeheer, prijzen en productcontent. De eigen route geeft volgens bol de meeste flexibiliteit en controle, maar vraagt technische kennis en ontwikkelcapaciteit.

Voor Shopify en WooCommerce bestaan kant-en-klare koppelingen van andere partijen. Die dekken het basisproces: aanbod plaatsen, voorraad bijwerken, orders binnenhalen en track-and-trace terugmelden. Past je proces daarin, dan is dat een verstandige keuze.

Een standaardkoppeling wordt krap als bol-orders in een ERP of WMS moeten dat de koppeling niet kent, als je LVB en eigen verzending mengt, of als je voorraad per kanaal wilt verdelen. We kunnen bol aan elk systeem koppelen, ook als daar geen standaardkoppeling voor is.

Wanneer maatwerk nodig is
  • bol-orders moeten rechtstreeks naar je ERP of WMS, zonder omweg via je webshop.
  • Je combineert eigen verzending en LVB en wilt beide voorraden in één overzicht.
  • Je wilt een deel van je voorraad reserveren voor je eigen webshop of andere kanalen.
  • Je hebt een groot assortiment en wilt alleen gewijzigde prijzen en voorraden sturen, binnen de limieten van bol.
  • Facturen en commissies van bol moeten automatisch in je boekhouding komen.
Hoe het technisch werkt

Retailer API

bol heeft één API voor verkopers: de Retailer API. Versie 10 is de huidige stabiele versie; voor onder meer aanbod is er al versie 11. Via de API regel je aanbod, productcontent, orders, zendingen, retouren, LVB, facturen en commissies.

Inloggen met client credentials

API-gegevens maak je aan in je verkoopaccount, bij de API-instellingen onder Diensten. Met client-ID en secret vraag je via OAuth2 (client credentials) een token op bij login.bol.com. Een token is enkele minuten geldig. Vraag niet voor elk verzoek een nieuw token aan: dan kan bol je IP-adres blokkeren.

Asynchrone verwerking

Veel wijzigingen, zoals een zending melden, verwerkt bol niet direct. Je krijgt een processtatus terug die van PENDING naar SUCCESS of FAILURE gaat. bol bewaart die status maximaal een dag, dus je koppeling moet hem op tijd controleren.

Push-notificaties en ophalen

Met push-notificaties krijg je een bericht bij onder meer een nieuwe order, een annuleringsverzoek, een processtatus of een wijziging in een zending. Ze komen via een webhook, Google Cloud Pub/Sub of Amazon SQS, met een digitale handtekening die je controleert. Haal je orders zelf op, kies de parameter change-interval-minute dan ruimer dan de tijd tussen twee rondes.

Limieten en demo-omgeving

Elke response bevat headers met je resterende budget. Ga je erover, dan krijg je een 429. Stuur daarom alleen wat echt is veranderd. De demo-omgeving geeft vaste voorbeeldantwoorden met dezelfde validatie als productie, maar verwerkt niets echt: een compleet proces test je daar niet.

AI ertussen

Een koppeling verplaatst gegevens. AI kan daartussen lezen, sorteren en een voorstel klaarzetten. Waar het ertoe doet, beslist een mens.

Productcontent per EAN

Staat een product nog niet op bol, dan lever je zelf content aan. AI zet je bestaande productdata om naar titels en beschrijvingen in het Nederlands, en voor België ook in het Frans. Een medewerker controleert ze voordat de koppeling ze instuurt.

Retouren voorbereiden

AI leest de retourreden en de ordergegevens en stelt een afhandeling voor: terugbetalen, omruilen of eerst contact opnemen. De beslissing blijft bij een mens.

Facturen controleren

AI legt de specificatie van bol naast je orders en retouren en meldt wat niet klopt, zoals een verzonden order die niet op de specificatie staat. Je financiële team beslist wat er gebeurt.

Waar het misgaat

Voorraad die te laat bijwerkt

Delen je webshop en bol dezelfde voorraad en synchroniseert de koppeling maar af en toe, dan verkoop je hetzelfde product twee keer. Dan moet je annuleren, en annuleringen die niet van de klant komen, tellen negatief mee in je prestaties.

Annuleringsverzoeken missen

Pakt je magazijn een annuleringsverzoek niet op, dan gaat het pakket toch de deur uit. Een annulering op verzoek van de klant telt bij bol niet negatief mee, dus bevestig die snel met de juiste reden.

Zendingen te laat melden

bol gaat bij de leverbelofte uit van het moment van bestellen. Meldt je koppeling zendingen pas 's avonds in één keer, dan krijgt de klant zijn track-and-trace laat. Orderregels die je niet afhandelt, verlopen enkele dagen na de verwachte leverdatum en worden dan door bol geannuleerd.

EAN's die niet kloppen

Aanbod op bol hangt aan de EAN. Een verkeerde of ontbrekende EAN betekent dat je aanbod niet online komt of bij het verkeerde product staat. Identieke artikelen mag je niet onder verschillende EAN's aanbieden.

Zo bouwen we een koppeling

  1. Wat moet waarheen

    Welke gegevens gaan over, in welke richting, en welk systeem leidend is als twee waarden verschillen. Dat staat op papier voordat er iets gebouwd wordt. Voor deze koppeling gaat het om: Aanbod, prijs en voorraad, Orders en annuleringsverzoeken, Verzending en track-and-trace, Retouren, Logistiek via bol (LVB), Facturen en commissies.

  2. Velden en regels

    Per veld de vertaling tussen de systemen: statussen, btw-codes, grootboekrekeningen, artikelnummers. En wat er gebeurt bij een dubbel of een ontbrekend gegeven. Voor deze koppeling gaat het om: Retailer API, Inloggen met client credentials, Asynchrone verwerking, Push-notificaties en ophalen, Limieten en demo-omgeving.

  3. Testen met echte gevallen

    In een testomgeving of testadministratie, met de uitzonderingen die in de praktijk voorkomen: creditnota's, deelleveringen, gewijzigde klantgegevens.

  4. Live, met logging en bewaking

    Elke synchronisatie wordt gelogd en bij een fout krijgt iemand een melding. Verandert de API van een leverancier, dan passen wij de koppeling aan.

Het team van Your Tech Club op kantoor in Amsterdam
Amsterdam
Wie je spreekt

Geen accountmanager. Je spreekt iemand die zelf koppelingen bouwt, en die zegt het ook als een standaardkoppeling genoeg is.

Joey van VlietJoey van VlietOprichter
Yassine SeghrouchniYassine SeghrouchniOprichter
  • Kantoor aan de Duivendrechtsekade in Amsterdam
  • ISO 9001 en ISO 27001, gecertificeerd door Kiwa
  • 500 projecten opgeleverd
  • 4,8 uit 127 reviews
Veelgestelde vragen

Heeft bol een API voor verkopers?

Ja, de Retailer API. Daarmee regel je aanbod, voorraad, orders, zendingen, retouren, LVB en facturen vanuit je eigen systemen. De API-gegevens maak je aan in je verkoopaccount, bij de API-instellingen.

Kan ik bol koppelen aan mijn eigen webshop?

Ja. Voor Shopify en WooCommerce bestaan kant-en-klare apps en plugins van andere partijen, en via de Retailer API kan een koppeling met elk ander systeem. Bepaal vooraf welk systeem leidend is voor voorraad en prijs.

Werkt een koppeling ook met Logistiek via bol?

Ja. Voor LVB-producten verzendt bol zelf, en je koppeling verwerkt die orders alleen in je administratie. Via de API haal je de LVB-voorraad op en meld je nieuwe zendingen naar het magazijn van bol aan. Voor LVB meld je je wel apart aan bij bol.

Hoe vaak moet een koppeling bol-orders ophalen?

Dat hangt af van je leverbelofte. Beloof je 'voor 16.00 uur besteld, morgen in huis', dan wil je nieuwe orders binnen minuten zien. Met push-notificaties voor nieuwe orders hoef je niet steeds te vragen. Haal je toch op, stel change-interval-minute dan ruimer in dan de tijd tussen twee rondes, zodat je niets mist.

Kan ik een bol-koppeling testen zonder echte orders?

Deels. bol heeft een demo-omgeving met vaste voorbeeldantwoorden en dezelfde validatie als productie. Daarmee test je of je verzoeken kloppen, maar een compleet proces van order tot retour kan daar niet. Begin daarom live met een paar producten en breid daarna uit.

Wat gebeurt er als ik te veel verzoeken stuur?

Dan krijg je een 429-antwoord en wacht je tot je budget weer is aangevuld. In elke response staat hoeveel budget je nog hebt. Stuur alleen gewijzigde prijzen en voorraden, en vraag niet per verzoek een nieuw token aan.