Nieuw: de Retailer API V6!

Nieuws 5 oktober 2021

De nieuwe versie van de Retailer API is sinds 1 oktober beschikbaar. Ofwel het nieuwe systeem van de dienst Automatiseren via bol.com. In deze zesde versie zijn er niet alleen nieuwe mogelijkheden toegevoegd, ook zijn er verbeteringen doorgevoerd die jouw ervaring met Automatiseren via bol.com weer een stuk beter maakt.

We zetten voor jou op een rijtje wat er nieuw is in de Retailer API V6. Zoals je gewend bent is er ook een migratiegids opgesteld die je helpt met het overstappen. Ben je nog niet bekend met Automatiseren via bol.com? Op deze pagina lees je er meer over.

Nieuw

Abonneren op verzendinformatie
Via de Subscription API (zie ‘Abonneren’ onder de verbeteringen), is het mogelijk om je te abonneren op verzendinformatie. Hierdoor hoef je niet steeds verzendinformatie op te halen uit de koppeling, maar hoeft dit pas als je melding krijgt dat er iets veranderd is in de verzending.

Verbeteringen

Verzendzegels
Voor de verzendzegels via de API zijn er 2 verbeteringen:

  • Bij het ophalen van de leveropties doet bol.com een aanbeveling (‘recommended’) voor de beste verzendoptie.
  • Bij het ophalen van de leveropties wordt de naam van de verzendzegel mee terug gestuurd zodat het type verzendzegel beter inzichtelijk is.

Verzendingen
Wil je verzendinformatie ophalen via de API? Dan worden nu ook de ‘transport events’ weergegeven in het antwoord voor Verzenden via Bol.com bestellingen. Dit zijn updates die tijdens de verzending bekend zijn. Hierdoor heb je meer inzicht in de zendingen.

Abonneren
Met deze API kun je je abonneren op (meldingen over) de status van de acties die je hebt uitgevoerd. Bijvoorbeeld het aanmaken van nieuw aanbod of het bevestigen van een bestelling. Je ontvangt deze meldingen dan in je eigen webhooks. Dit was eerst een BETA versie, maar zal met de API V6 breed uitgerold worden!

Overige verbeteringen
Verder zijn er in de endpoints en documentatie nog verbeteringen doorgevoerd zodat deze gelijk staan aan elkaar. Daarnaast is er voor de Commissie API onterecht btw meegerekend in de commissie voor partners buiten Nederland. Dit is ook per 1 oktober aangepast. Meer informatie is in week 30 via de nieuwsbrief gemaild. Voor de API V7 staat gepland dat alle commissies zonder btw gecommuniceerd worden.

Migratiegids

Maak je gebruik van de API V4 of V5? Dan is het nog niet noodzakelijk om over te stappen op een nieuwe versie. Het is mogelijk om een versie over te slaan als dat beter voor jou als partner uitkomt. Alle migratiegidsen vind je via onderstaande knoppen: