Documentation

Problemen oplossen > API‑verbinding mislukt

Problemen oplossen

API‑verbinding mislukt

Wat je ervaart:

Je WooCommerce-Bol.com-integratie kan geen verbinding maken met de servers van Bol.com. Zonder deze API-verbinding kan BridgeSync geen bestellingen importeren, voorraad synchroniseren of communiceren met je Bol.com-partneraccount. Je ziet mogelijk foutmeldingen zoals "Connection failed" (verbinding mislukt), "Authentication error" (authenticatiefout), "Invalid credentials" (ongeldige inloggegevens) of "Could not reach Bol.com API" (Bol.com API niet bereikbaar), waardoor je niet via je WooCommerce-webshop op Bol.com kunt verkopen.

Controleer je API-verbindingsstatus (duurt 2 minuten)

  1. Ga naar BridgeSync → Instellingen → API in je WordPress-dashboard
  2. Klik op de knop "Verbinding testen" om je Bol.com-connector API-gegevens te verifiëren
  3. Lees het resultaat zorgvuldig (het is groen bij succes of rood bij een fout)

→ Groene melding "Succesvol verbonden"? Je API-verbinding werkt correct. Als je toch synchronisatieproblemen hebt, ligt de oorzaak elders in je configuratie.

→ Rode foutmelding? Lees hieronder verder om je verbinding te herstellen en je WooCommerce-naar-Bol.com-synchronisatie weer werkend te krijgen.

Zo los je API-verbindingsfouten op

Fout: "Invalid credentials" of "Authentication failed"

Waarom deze fout optreedt: De Client ID of het Client Secret dat je hebt ingevoerd in BridgeSync komt niet overeen met de gegevens in je Bol.com-partneraccount. Hierdoor kan BridgeSync zich niet authenticeren bij de Bol.com API, waardoor alle synchronisatiefuncties worden geblokkeerd die nodig zijn om je WooCommerce-webshop aan Bol.com te koppelen.

Zo haal je de juiste API-gegevens op en voer je ze in:

  1. Log in op je Bol.com-partnerportaal via partner.bol.com
  2. Klik op het instellingenpictogram (tandwielpictogram rechtsboven) en ga naar de API-instellingen
  3. Selecteer zorgvuldig de volledige Client ID-tekenreeks en kopieer deze (gebruik Ctrl+C op Windows of Cmd+C op Mac)
  4. Plak de Client ID in het bijbehorende veld in BridgeSync → Instellingen → API (controleer of er geen extra spaties zijn meegekopieerd)
  5. Herhaal hetzelfde proces voor je Client Secret (kopieer de volledige code, plak zonder extra spaties)
  6. Klik op "Instellingen opslaan" en klik daarna direct op "Verbinding testen" om te controleren of de gegevens werken

Veelgemaakte fouten die authenticatieproblemen veroorzaken: Per ongeluk spaties meekopiëren voor of na de gegevensreeksen, niet de volledige code selecteren (ontbrekende tekens aan het begin of eind), Client ID in het Client Secret-veld plakken of andersom, verlopen gegevens gebruiken die opnieuw moeten worden aangemaakt in de Bol.com-instellingen.

Na succesvolle authenticatie werkt je automatische Bol.com-productsynchronisatie binnen enkele minuten weer.

Fout: "Connection timed out" of "Could not reach Bol.com"

Waarom deze fout optreedt: Je WordPress-server kan geen uitgaande verbinding maken met de API-servers van Bol.com (api.bol.com). Dit betekent meestal dat de Bol.com API tijdelijk niet beschikbaar is, je hostingprovider uitgaande verbindingen blokkeert, of een firewall de communicatie tussen je WooCommerce-webshop en Bol.com verhindert.

Zo stel je de diagnose en los je time-outproblemen op:

  1. Wacht 5-10 minuten en klik opnieuw op "Verbinding testen" (tijdelijke netwerkproblemen lossen zichzelf vaak op)
  2. Controleer de statuspagina van het Bol.com-partnerplatform op partnerstatus.bol.com om te verifiëren of de API operationeel is
  3. Als de Bol.com-status groen is maar de verbinding nog steeds mislukt, neem dan contact op met de technische support van je hostingprovider

Vraag je hostingprovider het volgende:

"Kun je controleren of uitgaande HTTPS-verbindingen naar api.bol.com zijn toegestaan vanaf mijn WordPress-server? Dit is nodig voor mijn WooCommerce-Bol.com-integratie om bestellingen en voorraad te synchroniseren."

De meeste hostingproviders kunnen api.bol.com binnen enkele minuten whitelisten. Zodra dat is gebeurd, synchroniseert je WooCommerce-Bol.com-voorraadbeheer weer automatisch volgens je schema.

Fout: "SSL certificate verification failed"

Waarom deze fout optreedt: Je WordPress-server kan het SSL-certificaat van Bol.com niet verifiëren, meestal omdat de SSL-certificaatbundel op je server verouderd is. Hierdoor is beveiligde communicatie tussen je webshop en de Bol.com API niet mogelijk.

Zo los je SSL-certificaatfouten op:

  1. Neem contact op met het supportteam van je hostingprovider
  2. Vraag hen om de SSL-certificaatbundel op je server bij te werken
  3. Vraag hen te controleren of uitgaande HTTPS-verbindingen naar api.bol.com correct werken

Dit is een probleem op serverniveau dat alleen je hostingprovider kan oplossen. De meeste providers lossen dit binnen 24 uur op.

Kun je nog steeds geen verbinding maken met de Bol.com API?

Neem contact op met ons supportteam en stuur de volgende diagnostische gegevens mee, zodat we het probleem snel kunnen identificeren:

  • De volledige foutmelding die verschijnt als je op "Verbinding testen" klikt (kopieer de exacte tekst)
  • Screenshot van de pagina BridgeSync → Instellingen → API (belangrijk: verberg of vervaag je Client ID en Client Secret voordat je het deelt)
  • De naam van je hostingprovider en het type hostingpakket (shared, VPS, dedicated, etc.)
  • Of je je hostingprovider al hebt gevraagd om api.bol.com te whitelisten

→ Hulp bij API-verbindingsproblemen