De bol API en koppelingen: zo automatiseer je je verkoopaccount

02

Koppelen vanuit Lightspeed, WooCommerce of Shopify

Welke koppeling het handigst is, hangt ook af van het platform waarop je webshop draait. Voor Lightspeed, WooCommerce en Shopify hebben we elk een aparte gids, met de routes naar bol en Amazon en de punten waar je op let.

03

Wat je via de Retailer API kunt regelen

Bol noemt het geheel van zijn koppelingen de Partner API. Voor verkopers is de Retailer API het belangrijkste deel. Daarmee regel je vrijwel alles wat je ook in je verkoopaccount doet.

04

Zo begin je met de API

1. 1

   Maak API-credentials aan

   In je verkoopaccount maak je client credentials voor de Retailer API aan. Je krijgt een client ID en een secret. Geef ze een herkenbare naam, bijvoorbeeld die van de partij die de koppeling bouwt.

2. 2

   Vraag een token op

   Met die gegevens vraag je een token op bij bol. Gebruik dat token tot het verloopt, want bol beperkt het aanvragen van nieuwe tokens streng.

3. 3

   Test in de demo-omgeving

   Bol heeft een demo-omgeving waarin je je verzoeken test zonder dat er iets live op de site verschijnt.

4. 4

   Houd rekening met limieten

   Elk onderdeel van de API heeft een eigen limiet. Bouw je koppeling zo dat hij rustiger wordt zodra hij de grens nadert.

5. 5

   Laat bol je iets melden

   In plaats van steeds zelf te vragen of er iets nieuws is, kun je je abonneren op meldingen, via een webhook of een wachtrij bij Google Cloud of AWS.

05

Wat we in de praktijk tegenkwamen

We hebben zelf koppelingen met bol gebouwd, voor prijzen, voorraad, bestellingen en facturen. Dit zijn de punten die niet meteen in de documentatie opvallen.

• Geaccepteerd is nog niet verwerkt

  Veel wijzigingen verwerkt bol op de achtergrond. Een antwoord dat je verzoek ontvangen is, zegt nog niets over de uitkomst. Controleer het resultaat via de processtatus of lees de gegevens daarna terug.

• Een prijs zet je met de hele volumekorting tegelijk

  Stuur je een nieuwe prijs zonder de bundelprijzen mee te sturen, dan verdwijnt je volumekorting.

• Wijzig aanbod via het offer-ID

  Bol vraagt om voorraad en prijzen te wijzigen via het vaste nummer van je aanbieding en niet via de EAN.

• Commissie met en zonder btw

  De commissietarieven die je vooraf opvraagt, zijn exclusief btw. Op een bestelregel staat de commissie inclusief btw. Wie die twee door elkaar haalt, rekent zijn marge verkeerd uit.

• Facturen zijn de controlebron

  Bestellingen via de API laten alleen recente orders zien. De specificatie van je facturen toont per bestelregel wat bol echt heeft gerekend, en is daarmee de betrouwbaarste bron om je cijfers te controleren.

• Meldingen kunnen dubbel binnenkomen

  Bol levert een melding minstens één keer af. Je koppeling moet er dus tegen kunnen dat hetzelfde bericht twee keer binnenkomt.

06

Wanneer een eigen koppeling loont

Een certified partner of feedtool is vaak genoeg. Bol laat zelf zien dat er partners zijn die bestellingen, aanbod, productinformatie, voorraad, verzendlabels en repricing al hebben gekoppeld aan veel webshop- en voorraadsystemen. Dan vul je gegevens in en werkt het.

Een eigen koppeling loont als je iets wilt wat een standaardtool niet kan. Denk aan prijzen die rekenen met je echte inkoop uit de boekhouding, voorraad die over meerdere kanalen en magazijnen klopt, of een rapportage die laat zien wat bol je per bestelling echt oplevert. Ook bij een groot aanbod betaalt een eigen koppeling zich vaak terug, omdat de maandprijs van tools meestal meegroeit met het aantal artikelen of bestellingen.

Houd er wel rekening mee dat een koppeling onderhoud vraagt. Bol brengt nieuwe versies uit en stopt na verloop van tijd met oude. Wie zelf bouwt, moet dat bijhouden.