Bol.com API koppelen aan WooCommerce

De verbinding tussen je webshop en Bol.com loopt via de Retailer API: de officiële schakel waarmee externe software artikelen, voorraad en bestellingen mag uitlezen en bijwerken. Je geeft BolSync daarvoor twee gegevens uit je verkoopaccount, een client ID en een client secret. Daarna verloopt al het verkeer automatisch.

Je API-gegevens aanmaken

De sleutels maak je aan in je eigen Bol-verkoopaccount, onder de ontwikkelaars- of API-instellingen. Bol.com toont de secret één keer bij het aanmaken — bewaar hem meteen veilig, want later is hij niet meer op te vragen. Ben je hem kwijt, dan draai je simpelweg een nieuwe sleutel en werk je die in BolSync bij.

Verkoop je op meerdere markten, houd er dan rekening mee dat elk verkoopaccount zijn eigen sleutelpaar heeft. Een set gegevens hoort altijd bij precies één account.

De koppeling tot stand brengen

1. Installeer de plugin in WordPress en activeer je licentie. Je krijgt dan een BolSync-onderdeel in je beheeromgeving.
2. Open de Bol-instellingen en plak het client ID en de secret in de daarvoor bestemde velden.
3. Sla op en laat de verbinding testen. BolSync haalt je accountgegevens op; komen die terug, dan staat de koppeling.
4. Bepaal daarna pas wat er synchroniseert. Verbinding maken en synchronisatie aanzetten zijn twee losse stappen, zodat je rustig kunt instellen voordat er iets naar Bol.com gaat.

Meerdere verkoopaccounts naast elkaar

Eén WooCommerce-webshop kan aan meerdere Bol-verkoopaccounts hangen. Dat is handig in twee situaties:

• Gescheiden markten. Draai je Nederland en België onder aparte accounts, dan koppel je ze allebei en houd je per markt eigen prijzen en levertijden aan.
• Meerdere handelsnamen. Verkoop je onder verschillende labels, dan bedien je die vanuit dezelfde catalogus zonder je WooCommerce-installatie te dupliceren.

Je voegt per account een eigen sleutelpaar toe. In het overzicht zie je vervolgens per account welke artikelen eraan gekoppeld zijn en wat de laatste synchronisatie deed.

Controleren of alles loopt

Het logboek is je belangrijkste controlemiddel. Daar staat per gebeurtenis wat er wanneer is verstuurd: een voorraadmutatie, een geïmporteerde bestelling, een prijsaanpassing door een regel. Zo zie je niet alleen dát er iets gebeurt, maar ook of het het juiste account betreft.

Loopt er iets mis aan de API-kant, dan komt dat als foutmelding in hetzelfde logboek terecht en krijg je er bericht over. In de praktijk komen vier oorzaken het vaakst voor:

• De secret is verkeerd overgenomen — vaak een spatie die is meegekopieerd.
• De sleutel is ingetrokken of opnieuw gegenereerd in het verkoopaccount.
• De sleutels horen bij een ander verkoopaccount dan je bedoelde.
• Het account heeft nog niet de rechten die de Retailer API vereist.

En daarna

Staat de verbinding, dan bepaal je welke kant de gegevens op gaan. Begin klein: kies een beperkte productgroep, laat die een dag meelopen en controleer het logboek voordat je je hele catalogus aanzet.