Probleemoplossing

Heeft u problemen met Channable Connect? Deze pagina behandelt de meest voorkomende problemen en hoe u ze kunt oplossen. Begin met de snelle diagnostiek sectie om te bepalen wat er mis is, spring dan naar het relevante probleem. We hebben ook debugging tips toegevoegd en wat te controleren wanneer dingen niet werken zoals verwacht.

---

Snelle Diagnostiek

Loop eerst deze controles door:

1. Module ingeschakeld?

   • Controleer of Channable → General → Enable op Ja staat
   • Verifieer via CLI: bin/magento module:status Magmodules_Channable

2. Cache geleegd?

   bin/magento cache:flush
   

3. Zelftest geslaagd?

   • Voer de zelftest-knop uit in elke Channable configuratiesectie
   • Het controleert automatisch op veelvoorkomende configuratieproblemen

4. Controleer logs:

   • Extensie fouten: var/log/channable/error.log
   • Debug info: var/log/channable/debug.log (wanneer debug modus is ingeschakeld)
   • Algemene Magento fouten: var/log/exception.log

5. Cron draait?

   bin/magento cron:run --group=channable
   

---

Product Feed Problemen

Probleem: Feed URL geeft leeg resultaat of fout

Symptomen:

• Feed URL toont lege pagina of foutmelding
• Channable meldt "Unable to fetch feed"
• 404 of 500 fout bij openen van feed URL

Oplossing:

1. Verifieer dat de module is ingeschakeld:

   bin/magento module:status Magmodules_Channable
   

2. Controleer of de feed is ingeschakeld voor de juiste storeview in Channable → Product Feed

3. Leeg alle caches:

   bin/magento cache:flush
   

4. Test de feed URL direct in uw browser—controleer op PHP fouten

5. Verifieer dat URL rewrites werken (probeer index.php toe te voegen aan de URL indien nodig)

6. Controleer bestandspermissies op var/ en generated/ directories

Preventie:

• Test feed URLs altijd na configuratiewijzigingen
• Monitor server error logs tijdens feed setup

---

Probleem: Producten ontbreken in feed

Symptomen:

• Verwachte producten verschijnen niet in Channable
• Productaantal in feed is lager dan verwacht
• Specifieke producttypes worden niet getoond

Oplossing:

1. Controleer productzichtbaarheid:

   • Producten moeten "Catalogus" of "Catalogus, Zoeken" zijn
   • Simple producten in configureerbare producten kunnen "Niet Individueel Zichtbaar" zijn

2. Controleer filterinstellingen:

   • Review categoriefilters in Channable → Product Feed → Filteropties
   • Verifieer zichtbaarheidsfilter instellingen
   • Controleer "Niet Op Voorraad Uitsluiten" instelling als producten niet op voorraad zijn

3. Verifieer dat product is ingeschakeld:

   • Uitgeschakelde producten worden standaard uitgesloten

4. Voor configureerbare/gegroepeerde/bundel producten:

   • Controleer de "Producttypes" instellingen
   • Zorg dat de producttype configuratie overeenkomt met uw verwachtingen

5. Voer de zelftest uit:

   • Klik op de zelftest-knop in de configuratie

Preventie:

• Test feed na het toevoegen van nieuwe producten
• Documenteer uw filterregels ter referentie

---

Probleem: Verkeerde productdata in feed

Symptomen:

• Incorrecte prijzen tonen op marketplace
• Verkeerde afbeeldingen verschijnen
• Ontbrekende of incorrecte attributen

Oplossing:

1. Controleer attribuutkoppeling:

   • Verifieer dat het juiste attribuut is geselecteerd voor elk veld
   • Controleer of het attribuut waarden heeft voor de betreffende producten

2. Voor prijsproblemen:

   • Review BTW-instellingen in Channable → Product Feed → Geavanceerde Opties
   • Verifieer dat Magento BTW-configuratie correct is
   • Controleer of staffelprijzen of speciale prijzen de output beïnvloeden

3. Voor afbeeldingsproblemen:

   • Verifieer afbeeldingsbron instelling (Base Image vs Alle Afbeeldingen)
   • Controleer of afbeeldingen toegankelijk zijn via URL
   • Verifieer parent/child afbeelding fallback instellingen voor configureerbare producten

4. Voor configureerbare product data:

   • Review "Gebruik Parent Data voor Simples" instellingen
   • Zorg dat de juiste attributen van parent overerven

Preventie:

• Preview feed data voor verbinding met Channable
• Test eerst met een kleine productset

---

Probleem: Feed generatie is traag of krijgt timeout

Symptomen:

• Feed duurt te lang om te genereren
• Server timeout fouten
• Geheugenuitputting fouten

Oplossing:

1. Verlaag producten per pagina:

   • Ga naar Channable → Product Feed → Algemeen
   • Verlaag "Producten per pagina" naar 100 of 150

2. Controleer server resources:

   • Verhoog PHP memory limit indien nodig
   • Verhoog max execution time

3. Optimaliseer productaantal:

   • Gebruik filters om het aantal producten in de feed te verminderen
   • Neem alleen producten op die daadwerkelijk op marketplaces moeten staan

4. Controleer op problematische producten:

   • Schakel debug modus in en controleer logs op specifieke productfouten
   • Sommige producten met ongebruikelijke data kunnen verwerking vertragen

Preventie:

• Monitor feed generatietijd regelmatig
• Plan feed updates tijdens rustige periodes

---

Order Import Problemen

Probleem: Orders worden niet geïmporteerd

Symptomen:

• Channable toont orders maar ze verschijnen niet in Magento
• Webhook geeft fout
• Test orders falen

Oplossing:

1. Verifieer dat order import is ingeschakeld:

   • Channable → Orders → Inschakelen moet op Ja staan

2. Controleer webhook configuratie:

   • Kopieer de webhook URL van Channable → Orders → Webhooks
   • Zorg dat deze correct is ingevoerd in uw Channable account

3. Test de webhook:

   • Voeg /test/{productID} toe aan uw webhook URL
   • Vervang {productID} met een actueel product ID uit uw winkel
   • Voorbeeld: https://uwwinkel.nl/channable/order/hook/code/abc123/test/42

4. Controleer op voorraadproblemen:

   • Als producten niet op voorraad zijn, zullen orders falen
   • Schakel "Orders inschakelen voor niet op voorraad items" in om deze orders toe te staan

5. Verifieer verzendmethode:

   • Zorg dat de geconfigureerde verzendmethode bestaat en is ingeschakeld
   • Controleer of de fallback verzendmethode is ingesteld

6. Controleer logs:

   • Schakel order logging in via Channable → Orders → Logging
   • Review var/log/channable/ voor foutdetails

Preventie:

• Test webhook bij elke configuratiewijziging
• Houd een fallback verzendmethode geconfigureerd

---

Probleem: "Duplicate increment ID" fout

Symptomen:

• Order import faalt met increment ID fout
• Orders van bepaalde kanalen falen consistent

Oplossing:

1. Stel een order ID prefix in:

   • Ga naar Channable → Orders → Order ID Instellingen
   • Schakel "Gebruik Kanaal Order ID" in
   • Stel een prefix in zoals "M-" of "CH-"

2. Schakel alfanumeriek Order ID in:

   • Verwijdert speciale tekens die problemen kunnen veroorzaken

3. Als het order ID al bestaat:

   • De marketplace order was waarschijnlijk al geïmporteerd
   • Controleer bestaande orders op het kanaal order ID

Preventie:

• Stel altijd een Order ID prefix in voordat u live gaat
• Gebruik een unieke prefix per kanaal als u op meerdere marketplaces verkoopt

---

Probleem: Orders importeren met verkeerde verzendmethode

Symptomen:

• Alle orders gebruiken dezelfde verzendmethode ongeacht kanaal
• Verzendkosten komen niet overeen met marketplace

Oplossing:

1. Configureer verzendmethode mapping:

   • Gebruik Geavanceerde Verzendmethode Mapping in Channable → Orders
   • Koppel elke marketplace verzendmethode aan de juiste Magento methode

2. Controleer fallback methode:

   • Zorg dat de fallback verzendmethode geschikt is

3. Voor marketplace-specifieke verzendkosten:

   • Let op dat verzendkosten van de marketplace komen, niet van Magento configuratie

Preventie:

• Stel verzendmapping in voordat u orders importeert
• Test met orders van elke verbonden marketplace

---

Probleem: Klantadressen worden niet correct geïmporteerd

Symptomen:

• Huisnummers in verkeerd veld
• Bedrijfsnaam ontbreekt
• Adresvelden door elkaar

Oplossing:

1. Voor Nederlandse/Belgische adressen:

   • Schakel "Gescheiden Huisnummer" in via Channable → Orders → Adres & Factuur
   • Dit plaatst huisnummers in de tweede straatregel

2. Voor bedrijfsnamen:

   • Schakel "Importeer Bedrijfsnaam op Order" in

3. Controleer adresregel limieten:

   • Magento heeft karakterlimieten op adresvelden
   • Lange adressen kunnen worden afgekapt

Preventie:

• Test order import met diverse adresformaten
• Review geïmporteerde orders op adresaccuratesse

---

Product Updates Problemen

Probleem: Voorraad synchroniseert niet naar Channable

Symptomen:

• Voorraadwijzigingen in Magento verschijnen niet in Channable
• Marketplace toont verkeerde voorraadniveaus
• Producten worden niet als niet op voorraad gemarkeerd

Oplossing:

1. Verifieer dat productupdates zijn ingeschakeld:

   • Channable → Product Updates → Inschakelen moet op Ja staan

2. Controleer of cron is ingeschakeld en draait:

   • Schakel cron in via Channable → Product Updates → Instellingen
   • Verifieer dat Magento cron werkt:

     bin/magento cron:run --group=channable
     

3. Controleer invalidatiemodus:

   • Probeer te wisselen tussen Observer en Cron modus
   • Observer biedt real-time updates maar kan prestatie-impact hebben

4. Verifieer webhook configuratie:

   • Zorg dat webhook URL is geconfigureerd in Channable
   • Test de webhook verbinding

5. Controleer wachtrij:

   • Zoek naar geïnvalideerde producten die wachten op verwerking
   • Schakel logging in om te zien wat er wordt verstuurd

Preventie:

• Monitor productupdates logs regelmatig
• Test voorraadwijzigingen met een specifiek product

---

Probleem: Productupdates zijn te traag

Symptomen:

• Voorraadwijzigingen duren te lang om te reflecteren
• Updates stapelen zich op in plaats van direct te versturen

Oplossing:

1. Verhoog cron frequentie:

   • Ga naar Channable → Product Updates → Instellingen
   • Stel een frequenter schema in (elke 5 minuten)

2. Gebruik Observer modus:

   • Observer detecteert wijzigingen in real-time
   • Directer dan cron scanning

3. Pas producten per run aan:

   • Verlaag het limiet om updates sneller te verwerken
   • Standaard van 50 is redelijk voor de meeste winkels

Preventie:

• Kies een geschikte cron frequentie voor uw behoeften
• Monitor update timing tijdens drukke periodes

---

Debug Modus

Debug Modus Inschakelen

1. Ga naar Channable → General → Debug & Logging
2. Zet Debug Mode op Ja
3. Klik op Save Config

Log Locaties

• Debug log: var/log/channable/debug.log
• Error log: var/log/channable/error.log
• Order log: Apart in te schakelen via Channable → Orders → Logging

Waar Op Te Letten

• API call responses
• Product verwerkingsfouten
• Order import failures
• Webhook communicatieproblemen

Debug Modus Uitschakelen

Vergeet niet om debug modus uit te schakelen in productie:

• Logging voegt overhead toe
• Logbestanden kunnen groot worden
• Gevoelige data kan worden gelogd

---

Nog Steeds Problemen?

Als u de bovenstaande oplossingen heeft geprobeerd en nog steeds problemen heeft:

1. Verzamel informatie:

   • Magento versie
   • PHP versie
   • Extensie versie (getoond in General configuratie)
   • Foutmeldingen uit logs
   • Stappen om het probleem te reproduceren

2. Controleer op conflicten:

   • Schakel andere extensies tijdelijk uit
   • Test op een staging omgeving

3. Neem contact op met support:

   • Verstrek de verzamelde informatie
   • Voeg relevante log-uittreksels toe

---

Meer Hulp Nodig?

Documentatie:

• Alle Help Artikelen - Compleet documentatie overzicht

Support:

• Contact Opnemen - Hulp van ons team