In het kort:
– De Retailer API is de officiële “personeelsingang” van bol: software mag daar namens jou orders ophalen, voorraad bijwerken, zendingen melden en facturen uploaden.
– Een API is niets engs: het is een afsprakenstelsel waarmee twee systemen elkaar verstaan — de ober tussen jouw webshop en bols keuken.
– Jij hoeft niet te programmeren; je geeft een koppeling toegang met twee sleutels (Client ID en Secret) uit je verkoopaccount.
– Wie grofweg snapt wat de API kan, snapt ook meteen wat elke bol-koppeling wel en niet kán beloven.
Je hoeft geen verstand van motoren te hebben om auto te rijden — maar weten dat er een motor ís, en ongeveer wat hij doet, maakt je een betere bestuurder. Zo is het ook met de bol Retailer API: de motor onder elke serieuze bol-koppeling. Vijf minuten normale taal.
Een API is een afsprakenstelsel waarmee het ene computersysteem het andere om iets mag vragen. Denk aan een restaurant: jij (je webshop) mag niet zelf de keuken (bols systemen) inlopen, maar je mag wél bestellen bij de ober (de API). De ober kent het menu — precies díe verzoeken die zijn toegestaan — brengt je vraag naar de keuken en komt terug met het antwoord. Netjes, veilig, en voor iedereen volgens dezelfde regels.
De Retailer API is bols officiële menukaart voor verkopers-software. De voor jou relevante gerechten:
| Verzoek | In mensentaal |
|---|---|
| Orders ophalen | “Welke nieuwe bestellingen heb ik?” — inclusief klantgegevens en verzendwijze |
| Voorraad bijwerken | “Zet de voorraad van EAN X op 11” |
| Zending melden | “Order Y is verzonden met deze trackingcode bij deze vervoerder” |
| Verzendetiketten (VVB) | “Geef me een etiket voor deze zending” |
| Retouren ophalen en afhandelen | “Welke retouren zijn aangemeld?” |
| Facturen uploaden | “Hier is de PDF-factuur voor order Y” |
| Productcontent opvragen | “Wat weet de catalogus over EAN X?” |
Alles wat een koppeling zoals GoStockr voor je doet, is een nette samenstelling van precies deze verzoeken — automatisch, op het juiste moment, met controles eromheen. En andersom is het ook waar: wat de API níet aanbiedt, kan géén enkele koppeling — beloften daarbuiten zijn marketing, geen techniek.
Software mag pas namens jou bestellen na identificatie. Daarvoor maak je in je verkoopaccount API-credentials aan: een Client ID (gebruikersnaam, zeg maar) en een Client Secret (het wachtwoord). Die twee vul je éénmalig in bij je koppeling — dat is letterlijk het hele “technische” werk dat jij doet. Twee huisregels: het Secret is geheim (deel het nooit per mail of screenshot, en maak het opnieuw aan als het ooit gelekt is), en de credentials zijn intrekbaar — raak je een apparaat of partij kwijt waar ze stonden, dan trek je ze in en maakt nieuwe.
Bol bewaakt zijn keuken: er zitten limieten op hoe vaak software per tijdseenheid mag aankloppen, en verzoeken worden gevalideerd. Daarom werkt een goede koppeling met slimme intervallen (orders elke paar minuten ophalen in plaats van duizend keer per seconde) en controleert hij antwoorden — bijvoorbeeld of een voorraad-update écht verwerkt is. Dat is geen traagheid maar beleefdheid, en het is de reden dat een doordachte koppeling betrouwbaarder is dan een haastig gebouwd script.
Is de API gevaarlijk — kan een koppeling mijn account slopen?
De API kan alleen wat op het menu staat, en jij bepaalt via je credentials wie er mag bestellen. Kies een koppeling die controleert wat hij doet (en logt wát hij deed), en je hebt méér grip dan bij handwerk, niet minder.
Kan ik zonder koppeling toch de API gebruiken?
Technisch ja, met programmeerwerk. Maar het onderhoud (API-versies wijzigen!) is een blijvende klus — precies de reden dat kant-en-klare koppelingen bestaan.
Waar vind ik mijn Client ID en Secret?
In je bol-verkoopaccount bij de API-/integratie-instellingen. Onze installatiehandleiding loopt er stap voor stap doorheen — het is twee minuten werk.