Stap op tijd over: de bol.com Retailer API v6 vervalt binnenkort
API-gebruikers opgelet: de Retailer API v6 wordt op 1 mei 2023 uitgeschakeld. Zorg er dus voor dat je op tijd overstapt naar v8 van de Retailer API. Die heeft een paar belangrijke voordelen.
De bol.com Retailer API verbindt je (web)winkelsystemen met bol.com. Elke 6 maanden komt er een nieuwe versie van de API uit. Oude versies worden na 19 maanden uitgefaseerd. Als je een versie van de API gebruikt die wordt uitgezet, vervalt de verbinding. Bestellingen komen dan bijvoorbeeld niet meer door of je voorraadbeheer klopt niet meer. Het kan ook tot problemen leiden bij het aanmaken van verzendlabels en track & trace-codes.
Zelf overstappen, of het laten doen door een derde partij
- Zelf overstappen? Gebruik dan onderstaande migratiegidsen om over te stappen van Retailer API v6 naar v8 (voor de overstap naar v8 zijn beide migratiegidsen nodig). Let op dat voor de overstap IT-kennis nodig is.
> Migratiegids v6 naar v7
> Migratiegids v7 naar v8Overstappen van API v6 naar v7 is ook mogelijk, hoewel direct overstappen naar v8 waarschijnlijk een betere keuze voor je is. API v7 wordt namelijk 1 november 2023 uitgezet. Met v8 kun je tot 1 mei 2024 vooruit. Houd ook rekening met de IT-tijd die nodig is om te migreren. Die kan, afhankelijk van de koppeling met je eigen systeem, tot een aantal weken duren.
- Gebruik je een van de derde partijen die op deze pagina vermeld staan? Dan hoef je zelf geen actie te ondernemen en ga je automatisch over naar een volgende API-versie. Kijk dit voor de zekerheid wel na. Zorg dat je koppeling ruim op tijd is aangepast, zodat deze na 1 mei nog goed werkt.
Hoe weet ik welke API-versie ik gebruik?
In onder andere de ‘Accept header’ van je API-requests kun je zien welke versie je gebruikt. Is het niet mogelijk om dit zelf in te zien? Vraag dan bij jouw technisch contactpersoon of integratiepartner na welke versie je gebruikt.
Voordelen van Retailer API v8
De Retailer API v8 biedt een aantal nieuwe functionaliteiten en verbeteringen ten opzichte van v6 en v7, bijvoorbeeld op het gebied van aanbod dat offline staat, het ophalen van beschikbare productinformatie en productcategorie-aanbevelingen. Ook kun je via API v8 bestellingen op een efficiëntere manier opvragen.
Schema voor verdere API-verbeteringen en vernieuwingen
Wil je weten wanneer je verdere API-updates kunt verwachten? Of wanneer bestaande API-versies worden uitgefaseerd? Dit vind je in het API release schedule. Houd deze planning in de gaten, zodat je weet wanneer je over moet stappen op een volgende versie.