Probleemoplossing

Veelvoorkomende problemen en oplossingen voor Bol.com Integratie.

---

Verbindingsproblemen

"Invalid client credentials"

Oorzaak: Verkeerde Client ID of Client Secret.

Oplossing:

1. Ga naar Bol.com Partner Portal → Instellingen → API Instellingen
2. Kopieer credentials exact (geen extra spaties)
3. Update in Magento onder Bol.com → Accounts
4. Test met: bin/magento magmodules-bol:test-connection

"Connection timeout"

Oorzaak: Netwerkproblemen of Bol.com API storing.

Oplossing:

1. Controleer uitgaande verbindingen van uw server
2. Verifieer dat firewall HTTPS naar api.bol.com toestaat
3. Controleer Bol.com statuspagina voor storingen
4. Probeer opnieuw na enkele minuten

"Demo mode vs Productie"

Oorzaak: Demo credentials gebruiken op productie of andersom.

Oplossing:

1. Controleer of "Is Demo" instelling overeenkomt met uw credentials
2. Demo credentials werken alleen met demo mode ingeschakeld
3. Productie credentials vereisen demo mode uitgeschakeld

---

Aanbieding Problemen

Aanbiedingen verschijnen niet op Bol.com

Controleer:

1. Profiel ingeschakeld? Product Profiel moet ingeschakeld zijn
2. Account ingeschakeld? Account moet ingeschakeld zijn
3. On Hold? Aanbiedingen kunnen on hold staan - check Offer Data instellingen
4. Geldige EAN? Product heeft geldige EAN/barcode nodig
5. Condities voldaan? Product moet aan profielcondities voldoen
6. Verwerkt? Run bin/magento magmodules-bol:process-product-profiles
7. Geëxporteerd? Run bin/magento magmodules-bol:export-offers

"EAN not found" fouten

Oorzaak: EAN bestaat niet in Bol.com catalogus.

Oplossing:

1. Verifieer dat EAN correct is (13 cijfers)
2. Controleer of product bestaat op Bol.com website
3. Voor nieuwe producten moet u mogelijk contentcreatie aanvragen

Prijzen updaten niet

Oorzaak: Sync heeft niet gedraaid of aanbieding zit vast in queue.

Oplossing:

1. Controleer aanbiedingstatus in Offers grid
2. Run bin/magento magmodules-bol:export-offers
3. Controleer op fouten in de Error Message kolom
4. Verifieer prijsattribuut in Product Profiel is correct

Voorraad synchroniseert niet

Oorzaak: Voorraadwijzigingen triggeren geen updates.

Oplossing:

1. Controleer of "Auto Push" ingeschakeld is in configuratie
2. Verifieer store view komt overeen met productvoorraad
3. Run handmatige export om te testen
4. Controleer of cron draait: bin/magento cron:run

---

Order Problemen

Orders importeren niet

Controleer:

1. Import ingeschakeld? Order Import moet ingeschakeld zijn op account
2. Datumbereik? "Import Orders From" datum is mogelijk te recent
3. Fulfilment type? FBR/FBB selectie kan orders uitsluiten
4. Cron draait? Controleer cron status

Debug:

bin/magento magmodules-bol:import-orders -vvv

"Product not found" tijdens import

Oorzaak: EAN in order matcht geen Magento product.

Oplossing:

1. Controleer of Product Identifier instelling overeenkomt met uw EAN attribuut
2. Verifieer dat product bestaat met die EAN waarde
3. Maak ontbrekende producten aan of map EANs correct

Order aangemaakt maar items ontbreken

Oorzaak: Sommige producten gevonden, andere niet.

Oplossing:

1. Controleer welke producten gefaald zijn in order notities
2. Voeg ontbrekende producten toe aan Magento
3. Map EANs correct voor alle producten

Dubbele orders

Oorzaak: Order ID mapping probleem of herimport.

Oplossing:

1. Schakel "Use Bol.com Order ID" in om duplicaten te voorkomen
2. Controleer bestaande orders voor handmatige import
3. Bol.com orders hebben unieke IDs die duplicaten voorkomen wanneer gemapt

---

Verzending Problemen

Zendingen exporteren niet

Controleer:

1. Vervoerder gemapt? Vervoerder moet gemapt zijn naar Bol.com transporter
2. Track code? Zending heeft tracking nummer nodig
3. Order bron? Alleen Bol.com orders exporteren zendingen

Oplossing:

1. Configureer vervoerder mapping in Configuration → Mappings
2. Zorg dat tracking nummers toegevoegd zijn aan zendingen
3. Run bin/magento magmodules-bol:export-shipments

"Invalid transporter code"

Oorzaak: Vervoerder niet correct gemapt.

Oplossing:

1. Ga naar Bol.com → Configuration → Mappings → Carrier Mapping
2. Map uw Magento vervoerder naar correcte Bol.com code
3. Veelgebruikte codes: BRIEFPOST, DHL, DPD, FEDEX, POSTNL, UPS

Track & Trace fouten

Oorzaak: Ongeldig tracking formaat of transporter mismatch.

Oplossing:

1. Verifieer tracking nummer formaat voldoet aan vervoerder vereisten
2. Zorg dat vervoerder code overeenkomt met daadwerkelijke verzendmethode
3. Controleer Track & Trace grid voor specifieke foutmeldingen

---

Prestatieproblemen

Trage aanbieding export

Oorzaak: Te veel aanbiedingen verwerken tegelijk.

Oplossing:

1. Verlaag batch sizes in Configuration → Limits
2. Verwerk profielen in kleinere batches
3. Controleer server resources tijdens export

Queue achterstand groeit

Oorzaak: Verwerking langzamer dan wijzigingen plaatsvinden.

Oplossing:

1. Verhoog cron frequentie
2. Run queue verwerking handmatig: bin/magento magmodules-bol:process-queue
3. Review en optimaliseer product profiel condities

Geheugenfouten

Oorzaak: Te veel data verwerken tegelijk.

Oplossing:

1. Verlaag batch sizes in Configuration → Limits
2. Verhoog PHP memory limit
3. Verwerk kleinere product sets

---

Cron Problemen

Cron draait niet

Controleer:

bin/magento cron:run --group=default -v

Oplossing:

1. Verifieer dat cron geconfigureerd is in systeem crontab
2. Controleer Magento cron_schedule tabel voor vastgelopen jobs
3. Wis oude cron entries: bin/magento cron:clean

Jobs draaien maar niets gebeurt

Oorzaak: Module uitgeschakeld of configuratieprobleem.

Oplossing:

1. Verifieer dat module ingeschakeld is
2. Controleer configuratie instellingen
3. Schakel debug logging in om te zien wat er gebeurt
4. Run commands handmatig om te testen

---

Debug Mode

Schakel gedetailleerde logging in:

1. Ga naar Bol.com → Configuration → Debug Settings
2. Schakel Debug Logging in
3. Controleer var/log/ voor module logs
4. Schakel uit na troubleshooting (beïnvloedt prestaties)

---

Nog Steeds Problemen?

Documentatie:

• Alle Help Artikelen - Compleet documentatie overzicht

Support:

• Contact Opnemen - Hulp van ons team