Je hoeft geen programmeur te zijn om de uitleg van Bol over koppelingen te lezen. Je moet vooral weten welke vraag je wilt beantwoorden: welk werk wil je niet meer met de hand doen, en wie bouwt en onderhoudt de verbinding? In de praktijk kies je uit drie routes: handmatig werken in je verkoopaccount, een kant-en-klare koppeling van een App of Dienstverlener, of een eigen koppeling op de Retailer API. Bol beschrijft zelf de laatste twee als de manieren om te automatiseren.
Wat Bol bedoelt met koppelen
Op de pagina Automatiseren legt Bol uit dat je je eigen systemen, zoals ERP-, content-, order- of verzendsoftware, aan je verkoopaccount koppelt. Voorraden, prijzen, productinformatie en bestellingen kunnen dan onder andere automatisch worden gesynchroniseerd. Bol noemt zes soorten werk die je zo kunt automatiseren:
- Aanbodbeheer: producten aanmaken en bijwerken, met prijzen, voorraden en levertijden.
- Contentbeheer: titels, beschrijvingen en afbeeldingen centraal beheren.
- Orderverwerking: bestellingen automatisch ontvangen en bevestigen.
- Verzendzegels: zegels voor Verzenden via Bol automatisch maken en verwerken.
- Facturatie en rapportages: inzicht in omzet, kosten en prestaties.
- Adverteren: Sponsored Products-campagnes automatisch beheren.
Lees die lijst als een menukaart, niet als een opdracht. Schrijf bij elk punt op hoeveel tijd het jou nu per week kost en hoe vaak er iets misgaat. Kost een punt je weinig tijd en gaat er zelden iets mis? Dan is een koppeling daar minder dringend. Wil je eerst weten waar je wat regelt in je account, lees dan wat je waar regelt op het Partnerplatform.
De drie routes naast elkaar
| Route | Wie doet het technische werk | Wat Bol erover zegt |
|---|---|---|
| Handmatig in je verkoopaccount | Niemand: jij voert wijzigingen zelf in | Volgens Bol levert automatiseren minder handmatig werk en minder fouten in voorraden, prijzen en bestellingen op |
| Via Apps & Dienstverleners | De externe partij levert de koppeling of software | Kant-en-klare koppelingen waarmee je kunt starten zonder zelf te ontwikkelen; je kiest zelf met wie je werkt |
| Zelf bouwen op de Retailer API | Jij, je eigen ontwikkelaar of iemand die je inhuurt | Maximale flexibiliteit en controle, maar het vraagt technische kennis en ontwikkelcapaciteit |
Bol voegt eraan toe dat de beste keuze afhangt van je organisatie, je schaal en je technische mogelijkheden. Bol kiest dus niet voor je. Op de pagina Hulp van Apps & Dienstverleners beschrijft Bol het netwerk als gecertificeerde externe partijen. Het gaat om apps voor onder meer prijs- en margeoptimalisatie, voorraad- en orderbeheer, productcontent (PIM) en adverteren, en om diensten voor wie kennis of capaciteit mist. Op die pagina staat ook een formulier waarmee Bol je helpt een agency te kiezen. Prijzen van apps noemt Bol op deze pagina's niet. Die vraag je dus bij de aanbieder zelf op. Twijfel je of je een feedtool nodig hebt, lees dan wanneer een feedtool of koppeling voor Bol zinvol is.
Zo lees je de documentatie in twee lagen
Laag 1: het Nederlandstalige overzicht
Begin bij Automatiseren via Bol. Die pagina bestaat uit vier blokken, zodat je alleen hoeft te lezen wat voor jou van belang is:
- Starten met automatiseren: hoe zelf automatiseren werkt, hoe je toegang krijgt met API Client credentials en hoe automatiseren via een certified partner gaat. Dit blok is voor jou als eigenaar het belangrijkst.
- Uitleg over de API-begrippen: pagina's over Process Status, rate limits en de Retailer API zelf. Dit hoef je niet te beheersen, maar je bouwer of aanbieder moet het wel kennen.
- Problemen met de API: een FAQ voor als er iets niet werkt.
- Mogelijkheden met de API: per onderwerp, zoals adverteren, promoties, content, bestellingen, aanbod, retouren en de combinatie met Verzenden via Bol en Logistiek via Bol.
Zoek in dat laatste blok alleen de onderwerpen op die op je eigen menukaart staan. Wil je alleen je bestellingen automatisch binnenhalen? Dan hoef je de pagina's over content en adverteren voorlopig niet te lezen.
Laag 2: de Engelstalige site voor ontwikkelaars
De site van de Retailer API is Engelstalig en bedoeld voor bouwers. De opbouw in vijf stappen kun je toch goed volgen: een verkoopaccount hebben, een integratiemethode kiezen, de API leren kennen, een demo-omgeving opzetten en dan bouwen. Bij de tweede stap staat dat er naast een eigen oplossing ook oplossingen van derden zijn die het makkelijker kunnen maken. Daar maak jij dus je keuze, nog voordat er een regel code geschreven is.
Drie dingen op die site zijn ook voor jou als niet-programmeur van belang:
- Terms of Service: Bol vraagt je die voorwaarden te lezen en te begrijpen voordat je koppelt. Ze gaan over jouw account, dus doe dit ook als iemand anders de koppeling bouwt.
- Demo environment: Bol raadt aan koppelingen eerst in een demo-omgeving te testen. Vraag je bouwer of dat gebeurd is voordat er echte aanbiedingen of bestellingen doorheen gaan.
- Volgorde: Bol adviseert de ontwikkeling te beginnen met Offers (je aanbod), dan Orders (bestellingen) en daarna het meer geavanceerde contentbeheer. Die volgorde kun je ook gebruiken om je eigen project in fases te plannen.
Termen als Swagger/OpenAPI spec, Redoc en Postman op die site horen bij technische hulpmiddelen voor ontwikkelaars, zoals documentatietools en een app om verzoeken mee uit te voeren. Die kun je overslaan.
Versies: het stuk dat je niet mag overslaan
Volgens de site voor ontwikkelaars kunnen functies per versie van de API verschillen. In de versietabel staan Retailer API v10, Advertising API v11 en Economic Operators API v1. Ook staan er migratiegidsen en release notes voor de overstap vanaf oudere versies. Op de homepage van het Partnerplatform staat daarnaast een bericht van 3 november 2026: Offers API v10 stopt op 1 februari 2027. Wat dat betekent voor een koppeling die je al hebt, lees je in wat je nu controleert nu Offers API v10 stopt.
Vijf vragen voor je aanbieder of bouwer
Met deze kennis stel je de volgende vijf vragen voordat je kiest:
- Welke processen uit de lijst van Bol neemt de koppeling over, en welke blijven handwerk?
- Op welke API-versie draait de koppeling, en wie past hem aan als Bol een versie stopzet?
- Is de koppeling in de demo-omgeving van Bol getest voordat hij live ging?
- Wie beheert de API Client credentials, en hoe trek je de toegang in als je stopt met de aanbieder?
- Hoort de aanbieder bij het netwerk van Apps & Dienstverleners? Controleer dat zelf in het overzicht van Bol.
Wat je hiermee nu beslist
Heb je een klein aanbod en gaat het handwerk goed? Dan hoef je je niet door API-documentatie te worstelen. Gaat je tijd vooral naar het bijwerken van voorraad en prijzen of het verwerken van bestellingen? Dan heb je voor een kant-en-klare koppeling geen eigen ontwikkelcapaciteit nodig. Een eigen koppeling op de Retailer API past pas als je die flexibiliteit echt nodig hebt én iemand hebt die hem bouwt, test en bijhoudt. Op de pagina's die we openden, noemt Bol geen kosten en geen bouwtijd voor een eigen koppeling. Die hangen dus af van wie hem voor je maakt. Wil je weten welke taken je als kleine verkoper het eerst uit handen geeft, lees dan wat je als kleine verkoper het eerst automatiseert.
