Documentation

Aan de slag > Vereisten

Aan de slag

Vereisten

Controleer vóór installatie of je WooCommerce-webshop aan deze technische vereisten voldoet. Deze controle van 5 minuten voorkomt installatieproblemen en zorgt ervoor dat Bol.com-bestellingen vanaf het begin probleemloos synchroniseren.

Wat je nodig hebt Minimaal vereiste versie Hoe te controleren
WordPress 6.5 of nieuwer Controleer je WordPress-versie
WooCommerce 9.0 of nieuwer (vereist voor HPOS) Controleer je WooCommerce-versie
HPOS (High-Performance Order Storage) Moet ingeschakeld zijn in WooCommerce-instellingen Controleer of HPOS is ingeschakeld
PHP 8.1 of nieuwer (wordt beheerd door je hostingprovider) Controleer je PHP-versie
WP-Cron Moet actief zijn (verzorgt de automatische synchronisatie) Test de WP-Cron-status
Bol.com-verkopersaccount Actief verkopersaccount met API-toegang Haal je API-gegevens op

WordPress 6.5 of nieuwer

WordPress is het contentmanagementsysteem waarop je website draait. BridgeSync vereist WordPress 6.5 of hoger om correct te functioneren.

Waarom dit belangrijk is: WordPress 6.5 bevat essentiële beveiligingsupdates en prestatieverbeteringen waar BridgeSync op vertrouwt voor een stabiele Bol.com-integratie. Oudere versies kunnen synchronisatiefouten of beveiligingsproblemen veroorzaken.

WooCommerce 9.0 of nieuwer

WooCommerce is de e-commerce-plugin die je webshop aandrijft. Als je al producten verkoopt via WordPress, heb je WooCommerce geïnstalleerd.

Waarom dit belangrijk is: WooCommerce 9.0 introduceerde HPOS (hieronder uitgelegd), dat BridgeSync nodig heeft voor betrouwbare bestelsynchronisatie. Eerdere versies gebruiken een verouderd opslagsysteem voor bestellingen dat geautomatiseerde Bol.com-imports niet efficiënt aankan.

HPOS (High-Performance Order Storage)

HPOS is het moderne orderbeheersysteem van WooCommerce. In plaats van bestellingen op te slaan als WordPress-berichten (de oude methode), gebruikt HPOS een speciale databasestructuur die grote aantallen bestellingen veel sneller verwerkt.

Waarom dit belangrijk is: HPOS verwerkt bestellingen 10x sneller dan het verouderde systeem. Wanneer BridgeSync honderden Bol.com-bestellingen per dag importeert, voorkomt HPOS dat je webshop trager wordt. Zonder HPOS kan de automatische bestelsynchronisatie mislukken of een time-out geven.

Goed nieuws: Als je WooCommerce recent hebt opgezet (na eind 2023), is HPOS waarschijnlijk al standaard ingeschakeld. Je kunt dit in 2 minuten controleren met de instructies hieronder.

PHP 8.1 of nieuwer

PHP is de server-side programmeertaal achter WordPress en WooCommerce. Je hostingprovider bepaalt welke PHP-versie je website gebruikt (je hoeft zelf niets van PHP-code te weten).

Waarom dit belangrijk is: PHP 8.1 en nieuwere versies zijn aanzienlijk sneller en veiliger dan oudere versies. BridgeSync maakt gebruik van moderne PHP-functies die niet beschikbaar zijn in PHP 7.4 of eerder. Het gebruik van verouderde PHP vormt ook een beveiligingsrisico voor je hele webshop.

WP-Cron correct werkend

WP-Cron is de ingebouwde taakplanner van WordPress. Het voert geautomatiseerde achtergrondtaken uit zoals het versturen van e-mails, het publiceren van ingeplande berichten en (het belangrijkste voor jou) het synchroniseren van Bol.com-bestellingen op vaste intervallen.

Waarom dit belangrijk is: Zonder een werkende WP-Cron kan BridgeSync niet automatisch nieuwe Bol.com-bestellingen importeren. Je zou dan elke keer handmatig een synchronisatie moeten starten, en daarmee verliest automatisering zijn nut. WP-Cron verzorgt je synchronisatieschema (elke 5, 15 of 30 minuten, afhankelijk van je instellingen).

Bol.com-verkopersaccount with API access

Je hebt een actief Bol.com-verkopersaccount nodig (toegankelijk via partner.bol.com) met ingeschakelde API-gegevens. Dit is iets anders dan een gewoon Bol.com-winkelaccount waarmee je producten koopt.

Waarom dit belangrijk is: API-gegevens (Client ID en Client Secret) zijn de manier waarop BridgeSync beveiligd communiceert met Bol.com om bestellingen op te halen, voorraad bij te werken en facturen te versturen. Zonder geldige API-toegang kan BridgeSync helemaal geen verbinding maken met je Bol.com-webshop.

Stapsgewijze instructies om je configuratie te controleren

Zo controleer je je WordPress-versie

  1. Log in op je WordPress-beheerdashboard
  2. Scroll naar de onderkant van een willekeurige pagina in het WordPress-beheergebied
  3. Zoek rechtsonder naar tekst die zegt "WordPress 6.5.3" (of een vergelijkbaar versienummer)
WordPress-beheerdashboard met het versienummer 6.5 in de rechteronderhoek van de footer
Vind je WordPress-versie rechtsonder op elke beheerpagina

Moet je WordPress updaten? Ga naar Dashboard → Updates in de linkerzijbalk. Als er een nieuwere versie beschikbaar is, klik dan op "Nu updaten" en wacht tot de update voltooid is (duurt meestal 1-2 minuten).

Zo controleer je je WooCommerce-versie

  1. Ga naar Plugins → Geïnstalleerde plugins in je WordPress-zijbalk
  2. Scroll door de pluginlijst totdat je "WooCommerce" vindt
  3. Kijk direct onder de pluginnaam waar "Versie 9.0.2" staat (of je huidige versie)
WordPress Plugins-pagina met WooCommerce en versie 9.0 direct onder de pluginnaam
Je WooCommerce-versie staat onder de pluginnaam op de Plugins-pagina

Moet je WooCommerce updaten? Als je een link "Nu updaten" onder de WooCommerce-plugin ziet, klik er dan op. Maak altijd een back-up van je webshop voordat je WooCommerce bijwerkt (de meeste hostingproviders bieden back-ups met één klik).

Zo schakel je HPOS in bij WooCommerce

  1. Ga naar WooCommerce → Instellingen in je WordPress-zijbalk
  2. Klik op het tabblad Geavanceerd in de bovenste navigatiebalk
  3. Klik op Functies in de secundaire navigatie die verschijnt
  4. Scroll naar beneden totdat je "High-Performance Order Storage (HPOS)" vindt
  5. Vink het vakje aan naast "High-Performance Order Storage (HPOS)" als dat nog niet is aangevinkt
  6. Scroll naar onderen en klik op Wijzigingen opslaan
WooCommerce Instellingen Geavanceerd Functies-pagina met het aangevinkte selectievakje voor High-Performance Order Storage
Schakel HPOS in via WooCommerce → Instellingen → Geavanceerd → Functies

Zie je de HPOS-optie niet? Dit betekent meestal dat je WooCommerce-versie te oud is (lager dan 9.0). Werk eerst WooCommerce bij en kom dan terug naar deze pagina om HPOS in te schakelen.

Belangrijk voor webshops met bestaande bestellingen: Wanneer je HPOS voor het eerst inschakelt, migreert WooCommerce automatisch je bestaande bestellingen naar het nieuwe opslagsysteem. Dit proces draait op de achtergrond en kan 5-30 minuten duren, afhankelijk van het aantal bestellingen. Je webshop blijft gewoon online tijdens de migratie.

Zo controleer je je PHP-versie

Je kunt de PHP-versie niet zelf wijzigen (je hostingprovider beheert dit). Hier zijn twee manieren om te controleren welke PHP-versie je website momenteel gebruikt:

Methode 1: Via WordPress Site Health
  1. Ga naar Gereedschap → Site Health in je WordPress-zijbalk
  2. Klik bovenaan op het tabblad Info
  3. Klik om het onderdeel "Server" uit te klappen
  4. Zoek de regel "PHP-versie" gevolgd door een nummer zoals "8.1.25" of "8.2.14"
WordPress Site Health Info-tabblad met het uitgeklapte Server-onderdeel dat PHP-versie 8.1 toont
Controleer je PHP-versie via Gereedschap → Site Health → Info → Server
Methode 2: Neem contact op met je hostingprovider

Maak een supportticket aan of start een livechat met je hostingprovider en vraag: "Welke PHP-versie draait er momenteel op mijn website?" Ze kunnen je dit direct vertellen.

Moet je PHP upgraden? Neem contact op met je hostingprovider en vraag om een upgrade naar PHP 8.1 of nieuwer. De meeste providers bieden dit gratis aan via hun configuratiescherm (cPanel, Plesk, eigen dashboard) of via een supportticket. De upgrade duurt meestal 5-10 minuten en veroorzaakt geen downtime.

Hoe te controleren WP-Cron is working

WP-Cron draait automatisch wanneer iemand je WordPress-site bezoekt. Zo controleer je of het correct functioneert:

  1. Installeer en activeer BridgeSync (je kunt WP-Cron testen na de installatie)
  2. Ga naar BridgeSync → Instellingen in je WordPress-zijbalk
  3. Zoek naar het tijdstempel "Laatste succesvolle synchronisatie" bovenaan de instellingenpagina
  4. Als dit tijdstempel elke 5-30 minuten bijwerkt (afhankelijk van je synchronisatieschema), werkt WP-Cron
Probleemoplossing als synchronisaties niet automatisch starten:
  • Weinig verkeer: WP-Cron wordt alleen geactiveerd wanneer iemand je website bezoekt. Bij weinig bezoekers kunnen synchronisaties vertraging oplopen.
  • Uitgeschakelde WP-Cron: Sommige hostingproviders schakelen WP-Cron uit om de serverbelasting te verminderen. Controleer dit bij je host of zoek naar "DISABLE_WP_CRON" in je wp-config.php-bestand.
  • Serverconfiguratieproblemen: Firewallregels of beveiligingsplugins kunnen WP-Cron blokkeren.

Bekijk onze uitgebreide handleiding voor WP-Cron-problemen voor stapsgewijze oplossingen.

Zo haal je je Bol.com API-gegevens op

Met je Bol.com API-gegevens kan BridgeSync beveiligd toegang krijgen tot je bestellingen, voorraadniveaus en facturen. Zo maak je ze aan in je Bol.com-verkopersaccount:

  1. Ga naar login.bol.com en log in met het e-mailadres en wachtwoord van je verkopersaccount
  2. Klik rechtsboven op je accountnaam (met het pijltje naar beneden) en selecteer Instellingen
  3. Klik in de linkerzijbalk op Diensten om het menu uit te klappen
  4. Click API Instellingen
  5. Scroll naar het onderdeel Clientgegevens voor de Retailer API
  6. Klik op de knop + Aanmaken
  7. Vul een herkenbare naam in voor je nieuwe API-gebruiker (for example: BridgeSync) en klik op Aanmaken
  8. Je nieuwe gegevens verschijnen in de lijst. Kopieer de Client ID (the long code next to your chosen name)
  9. Klik op Secret tonen om het Client Secret zichtbaar te maken en kopieer het direct

Gebruik het juiste API-onderdeel

The Bol.com API Instellingen page shows multiple sections. Make sure you create credentials under Clientgegevens voor de Retailer API. Do not use "Client credentials for the Advertising API" or "Geautoriseerde partijen" sections — these won't work with BridgeSync.

Sla je Client Secret direct op

Kopieer je Client Secret direct na het klikken op "Secret tonen" en sla het op een veilige plek op. Bol.com toont het secret maar één keer. Als je het kwijtraakt, moet je de gegevens verwijderen en nieuwe aanmaken.

Bol.com partner portal API Instellingen page showing Clientgegevens voor de Retailer API section with Client ID visible and Show secret button
Create your API credentials under Instellingen → Services → API Instellingen in the Bol.com partner portal

Eerste keer dat je API-toegang instelt? Mogelijk moet je eerst het onderdeel "Technical representative" invullen (je naam, e-mailadres en telefoonnummer) en akkoord gaan met de API-gebruiksvoorwaarden voordat je gegevens kunt aanmaken.

Aanbevolen hostingvereisten voor BridgeSync

BridgeSync werkt met elke WordPress-hostingprovider. Voor optimale prestaties bij het automatisch synchroniseren van Bol.com-bestellingen kies je een host die het volgende biedt:

  • PHP 8.1 of nieuwer (faster order processing and better security)
  • Managed WordPress-hosting of WooCommerce-geoptimaliseerde servers (vooraf geconfigureerd voor e-commerce)
  • Standaard ingeschakelde WP-Cron-ondersteuning (vereist voor automatische synchronisatie-intervallen)
  • SSL-certificaat inbegrepen (zorgt voor beveiligde API-verbindingen met Bol.com)
  • Minimaal 512 MB PHP-geheugenlimiet (verwerkt batch-imports van bestellingen zonder time-outs)

Hostingproviders bevestigd compatibel met BridgeSync: SiteGround, Kinsta, Cloudways, TransIP, Antagonist, Savvii en de meeste grote WordPress-hostingproviders.

Weet je niet zeker of je website aan de vereisten voldoet?

Geen zorgen als je twijfelt over deze technische vereisten. Er zijn twee eenvoudige manieren om verder te gaan:

  1. Installeer BridgeSync gewoon. De plugin detecteert automatisch ontbrekende vereisten en toont duidelijke waarschuwingen die precies aangeven wat er moet worden opgelost.
  2. Neem contact op met ons supportteam en wij controleren je WordPress-configuratie voor je. Stuur ons je website-URL en we verifiëren alle vereisten binnen 24 uur.

Ons supportteam helpt elke week tientallen webshops bij het instellen van BridgeSync. We begeleiden je graag bij eventuele technische problemen.