Volledige handleiding voor het installeren, configureren en gebruiken van de GoStockr Bol.com Sync plugin.
Andere plugin? Bekijk de GoedGeplaatst Connector documentatie.
Webhooks zorgen ervoor dat nieuwe orders binnen seconden in WooCommerce verschijnen in plaats van te wachten op de volgende sync-ronde. Dit is de aanbevolen instelling voor alle verkopers.
Let op: webhooks vereisen dat je website bereikbaar is via HTTPS. Op sites zonder SSL-certificaat werken webhooks niet en valt de plugin terug op periodieke polling (elke 5-120 minuten, instelbaar).
Onder Instellingen → Sync-modus kies je hoe de plugin synchroniseert:
Onder Instellingen → Markt kies je op welke Bol-markt(en) je verkoopt. Bij Nederland + België worden orders en retouren van beide markten gesynchroniseerd in één WooCommerce-installatie.
Nieuwe Bol-bestellingen worden automatisch aangemaakt in WooCommerce met de status Besteld via Bol.com (paars). Wanneer de bestelling is verzonden en afgerond op Bol, verandert de status naar Afgerond via Bol.com (groen).
Elke order bevat: klantgegevens, factuur- en verzendadres, bestelregels met prijzen, BTW-berekening, Bol order-ID, commissie en fulfilment-type (FBR/VVB).
Het sync-interval is instelbaar van 5 tot 120 minuten. Met webhooks (zie hieronder) komen orders binnen seconden binnen.
WooCommerce is altijd de bron van waarheid voor de voorraad. De plugin pusht de WooCommerce-voorraadstand naar Bol, nooit andersom. Als er een verschil is tussen Woo en Bol, wordt de Bol-voorraad overschreven met de WooCommerce-waarde.
Het voorraad sync-interval is instelbaar van 15 minuten tot 6 uur. Bij grote catalogi (2000+ producten) adviseren we een interval van 2 uur of meer om rate limits te voorkomen.
Facturen worden automatisch naar Bol geüpload wanneer een order wordt afgerond. De plugin gebruikt je factuur-plugin om de PDF te genereren. Ondersteunde factuur-plugins:
Je kunt ook handmatig een factuur uploaden via Bestelling → Bestelacties → Factuur uploaden naar Bol.
Bij FBR-orders (eigen verzending) stuurt de plugin automatisch het trackingnummer naar Bol wanneer de order op Afgerond wordt gezet. De plugin leest het trackingnummer uit je verzendplugin:
SendCloud schrijft het trackingnummer pas terug naar WooCommerce als je de webhook-feedback activeert. Zonder deze instelling werkt track & trace niet:
Zonder deze instelling wordt het trackingnummer niet opgeslagen in WooCommerce en kan de Bol Sync plugin het niet doorsturen naar Bol.
MyParcel schrijft het trackingnummer automatisch naar de order-meta. Geen extra instelling nodig — het werkt direct na installatie van de MyParcel WooCommerce plugin.
Sendy schrijft het trackingnummer automatisch naar de order-meta. Geen extra instelling nodig.
Gebruik de WooCommerce Shipment Tracking plugin of de eigen plugin van de vervoerder. Het trackingnummer wordt automatisch uitgelezen.
Als je een verzendplugin gebruikt die niet hierboven staat, controleer dan of het trackingnummer wordt opgeslagen in een van deze WooCommerce order-metavelden: _tracking_number, _tracking_code, of _wc_shipment_tracking_items. Als je plugin een ander veld gebruikt, neem contact op met support.
De vervoerder wordt automatisch gemapt naar de juiste Bol transporter-code (PostNL → POSTNL, DHL → DHL, DPD → DPD-NL, UPS → UPS, etc.). Als de vervoerder niet wordt herkend, wordt OTHER gebruikt.
Als het trackingnummer niet direct beschikbaar is (sommige verzendplugins schrijven het pas later weg via een webhook van de vervoerder), probeert de plugin het tot 5 keer opnieuw met 2 minuten tussentijd. In het logboek zie je: “Geen trackingnummer gevonden, retry ingepland.”
Retouren worden automatisch elke 30 minuten opgehaald. Bij een retour:
Voor VVB-orders (Verzend via Bol) kun je vanuit WooCommerce een verzendlabel aanmaken. Ga naar de orderpagina → klik op Verzendetiket aanmaken → kies een verzendoptie → het label wordt gegenereerd als PDF.
Bij FBR-orders zijn er geen Bol-verzendlabels. Je verzendt via je eigen vervoerder (SendCloud, MyParcel, etc.).
Webhooks zorgen ervoor dat Bol je website direct informeert wanneer er iets verandert (nieuwe order, statuswijziging). Dit is sneller dan polling (wachten tot de volgende sync-ronde).
Activeren: Instellingen → Webhooks → Webhooks activeren. Vereist: je website moet publiek bereikbaar zijn via HTTPS. Op localhost of sites zonder SSL werken webhooks niet.
Het dashboard (Bol.com Sync → Dashboard) toont in één oogopslag: orders vandaag, orders deze week, omzet, Bol-commissie, actieve producten, en recente fouten. Gebruik dit om snel te controleren of alles goed draait.
Het logboek (Bol.com Sync → Logboek) toont alle activiteit: imports, sync-runs, factuur-uploads, fouten, en waarschuwingen. Filter op niveau (Info, Warning, Error) om snel problemen te vinden.
Rate limit bereikt
Bol hanteert rate limits per account (niet per API-key). De plugin spreidt calls automatisch. Als je dit bericht vaak ziet: verhoog het sync-interval in de instellingen, of schakel de dagelijkse vangnet-scan uit als webhooks actief zijn.
Factuur niet geüpload
Controleer of je een compatibele factuur-plugin hebt geïnstalleerd (WooCommerce PDF Invoices & Packing Slips). Controleer het logboek voor specifieke foutmeldingen. Een veelvoorkomende oorzaak: een orderregel verwijst naar een product dat is verwijderd uit WooCommerce.
Geen verzendopties bij label aanmaken
Verzendlabels zijn alleen beschikbaar voor VVB-orders. Als je een FBR-order hebt, gebruik je je eigen vervoerder. De plugin toont bij FBR-orders de melding: Deze order is FBR — Bol biedt geen verzendlabels aan.
Trackingnummer niet gevonden
De meest voorkomende oorzaak: bij SendCloud is de webhook-feedback niet ingeschakeld. Ga naar SendCloud → Instellingen → Integraties → je WooCommerce-koppeling → “Enable webhook feedback” → AAN. Zonder deze instelling schrijft SendCloud het trackingnummer niet naar WooCommerce. Bij MyParcel, Sendy en andere plugins werkt het automatisch zonder extra instellingen. Controleer het logboek — je ziet daar “Geen trackingnummer gevonden, retry ingepland” als het nummer nog niet beschikbaar is.
Voorraad klopt niet
De plugin pusht WooCommerce-voorraad naar Bol. Als de Bol-voorraad afwijkt, wordt deze overschreven. Controleer of er geen andere plugin of proces is dat de WooCommerce-voorraad onverwacht wijzigt. Check het logboek onder Voorraadcorrecties voor details.
Order niet geïmporteerd
Controleer of de sync-modus niet op Alleen voorraad staat. Controleer of het sync-interval niet te lang is. Controleer het logboek op foutmeldingen. Als webhooks actief zijn, controleer of je website bereikbaar is via HTTPS.
Plugin werkt niet meer na licentie-verloop
Na het verlopen van de licentie wordt de plugin gedeactiveerd. Verleng je licentie via je GoStockr-account om de plugin opnieuw te activeren.