Probleemoplossing

Veelvoorkomende problemen en oplossingen voor Digitec Galaxus Integratie. Begin met de snelle diagnostiek, vind daarna uw specifieke probleem hieronder.

---

Snelle Diagnostiek

1. Voer Self-Test uit:

   bin/magento digitec:selftest
   

2. Controleer module is ingeschakeld:

   • Digitec Galaxus → General Settings → Enable = Yes

3. Wis cache:

   bin/magento cache:flush
   

4. Controleer logs:

   • var/log/digitec-galaxus.log
   • var/log/system.log

---

FTP Verbindingsproblemen

"Connection failed" of timeout

Symptomen:

• FTP test knop toont fout
• Feeds uploaden niet

Oplossingen:

1. Verifieer credentials:

   • Controleer hostname, gebruikersnaam, wachtwoord
   • Geen extra spaties in velden
   • Correcte hostname (test vs productie)

2. Controleer firewall:

   • Zorg dat uitgaand FTP (poort 21) is toegestaan
   • SFTP kan poort 22 gebruiken

3. Test vanaf command line:

   ftp ftp.digitecgalaxus.ch
   

4. Neem contact op met Digitec Galaxus:

   • Verifieer dat uw credentials actief zijn
   • Check of IP whitelisting vereist is

"Permission denied" bij upload

Oorzaak: FTP gebruiker heeft geen schrijfrechten.

Oplossing: Neem contact op met Digitec Galaxus om map permissies voor uw account te verifiëren.

---

Feed Generatie Problemen

Geen producten in feed

Controleer:

1. Producten hebben geldige identifiers:

   • EAN/GTIN moet aanwezig en geldig zijn

2. Zichtbaarheidsfilter:

   • Check Advanced Settings → Filter on Visibility
   • Zorg dat producten correcte zichtbaarheid hebben

3. Categoriefilter:

   • Controleer of categoriefiltering uw producten uitsluit

4. Voorraadfilter:

   • "Exclude Out of Stock" kan ingeschakeld zijn

5. Data validatie:

   • Schakel "Enable Data Validation" in/uit om te testen

Debug:

bin/magento digitecgalaxus:run-generate-feed --type=data -vvv

"Invalid products" aantal te hoog

Oorzaak: Producten missen vereiste data.

Oplossingen:

1. Controleer vereiste attributen zijn gekoppeld:

   • Product Title
   • Minimaal één taal ingeschakeld

2. Verifieer productdata:

   • EAN moet geldig 13-cijferig nummer zijn
   • Prijzen moeten groter dan 0 zijn
   • Vereiste attributen moeten waarden hebben

3. Schakel validatie tijdelijk uit:

   • Zet "Enable Data Validation" uit
   • Controleer welke producten nu verschijnen
   • Fix hun data, schakel validatie weer in

Feed generatie timeout

Oorzaak: Grote catalogus overbelast server resources.

Oplossingen:

1. Schakel paging in:

   • Advanced Settings → Enable Paging = Yes
   • Zet Products per Batch op 5000

2. Verhoog PHP limieten:

   max_execution_time = 3600
   memory_limit = 2G
   

3. Draai tijdens rustige uren:

   • Plan feeds tijdens laag verkeer

---

Order Import Problemen

Orders importeren niet

Controleer:

1. Order import ingeschakeld:

   • Order Automation → Automate = Yes

2. FTP paden correct:

   • Path In komt overeen met Digitec Galaxus configuratie
   • Geen voorloop/naloop slashes

3. Order bestanden bestaan:

   • Controleer FTP voor bestanden in Path In map

4. Cron draait:

   bin/magento cron:run --group=digitec_galaxus
   

Debug:

bin/magento digitecgalaxus:run-order-import -vvv

"Product not found" fouten

Oorzaak: Product EAN/identifier in order matcht niet met Magento.

Oplossingen:

1. Verifieer product bestaat:

   • Zoek op EAN in Magento admin
   • Controleer product is ingeschakeld en op voorraad

2. Controleer identifier mapping:

   • Zorg dat EAN attribuut correct is gekoppeld

3. Schakel failed order emails in:

   • Krijg gedetailleerde foutinformatie

Orders aangemaakt zonder producten

Oorzaak: Sommige producten gevonden, andere niet.

Oplossingen:

1. Controleer order notities:

   • Bekijk order in Magento admin
   • Check opmerkingen voor ontbrekende product details

2. Voeg ontbrekende producten toe:

   • Maak producten aan met correcte EANs

Dubbele orders

Oorzaak: Order bestanden meerdere keren verwerkt.

Oplossingen:

1. Controleer verwerkte map:

   • Verifieer bestanden verplaatsen na verwerking

2. Gebruik Order ID Prefix:

   • Voeg unieke prefix toe zoals "DG-"
   • Voorkomt conflicten met reguliere orders

---

Verzending Sync Problemen

Tracking synchroniseert niet naar Digitec Galaxus

Controleer:

1. Shipping sync ingeschakeld:

   • Order Automation → Shipping Notes Synchronization

2. Vervoerder mapping geconfigureerd:

   • Track & Trace → Vervoerder mapping
   • Vervoerder namen moeten exact matchen

3. Tracking nummers toegevoegd:

   • Zending moet tracking nummer hebben

Debug:

bin/magento digitecgalaxus:run-sync-shipping -vvv

"Invalid carrier" fouten

Oorzaak: Vervoerder naam matcht niet met mapping.

Oplossing:

1. Controleer Magento vervoerder titels
2. Match exact in Track & Trace configuratie
3. Gebruik correcte Digitec Galaxus vervoerder codes

---

Prijs Problemen

Prijzen komen niet overeen met verwachte waarden

Controleer:

1. Prijsaanpassing instellingen:

   • Product Stock Pricing → Price Adjustment
   • Verifieer percentage is correct

2. Afrondingsinstellingen:

   • Check Round Price instelling

3. Valuta:

   • Verifieer store view valuta matcht met Digitec Galaxus

Prijzen tonen als 0

Oorzaak: Verkeerd prijsattribuut of ontbrekende prijs.

Oplossingen:

1. Verifieer producten hebben prijzen:

   • Controleer product in Magento admin

2. Controleer prijsattribuut:

   • Default is price of final_price
   • Custom attributen moeten bestaan

---

Prestatie Problemen

Trage feed generatie

Oplossingen:

1. Schakel paging in:

   • Splits grote catalogi in batches

2. Optimaliseer database:

   bin/magento indexer:reindex
   

3. Controleer server resources:

   • Verhoog PHP geheugen
   • Gebruik dedicated cron server

Cron jobs overlappen

Oorzaak: Vorige job draait nog wanneer volgende start.

Oplossingen:

1. Verlaag frequentie:

   • Verhoog tijd tussen runs

2. Controleer op vastgelopen jobs:

   SELECT * FROM cron_schedule WHERE status = 'running';
   

3. Wis vastgelopen jobs:

   bin/magento cron:clean
   

---

Debug Mode

Schakel gedetailleerde logging in:

1. Ga naar Digitec Galaxus → General Settings → Debug & Logging
2. Zet Debug Mode op Yes
3. Controleer var/log/digitec-galaxus.log
4. Schakel uit na troubleshooting (beïnvloedt prestaties)

---

Meer Hulp Nodig?

Documentatie:

• Alle Help Artikelen - Compleet documentatie overzicht

Support:

• Contact Opnemen - Hulp van ons team