Probleemoplossing KatanaPIM Connect

Symptomen:

• "Test Credentials" knop toont fout
• Sync operaties falen direct

Oplossingen:

1. Verifieer credentials:

   • Controleer dat URL correct is (inclusief https://)
   • Verifieer dat API key geldig is en niet verlopen
   • Zorg dat er geen extra spaties in velden staan

2. Controleer netwerk:

   • Verifieer dat server KatanaPIM URL kan bereiken
   • Controleer firewall regels voor uitgaande verbindingen
   • Test met curl vanaf command line

3. SSL problemen:

   • Zorg voor geldig SSL certificaat op PIM
   • Controleer dat PHP bijgewerkte CA certificaten heeft

Symptomen:

• Producten grid blijft leeg na sync
• Sync voltooit maar geen producten verschijnen

Oplossingen:

1. Controleer product import ingeschakeld:

   • Product Data → General → Enable Product Import = Yes

2. Verifieer store filter:

   • General → Import Settings → Store Filter
   • Zorg dat correcte store is geselecteerd of "All"

3. Controleer dat PIM producten heeft:

   • Log in op KatanaPIM en verifieer dat producten bestaan
   • Zorg dat producten gepubliceerd/actief zijn in PIM

4. Review Sync Log:

   • Controleer op fouten in Katana PIM → Sync Log

Symptomen:

• Producten verschijnen in KatanaPIM grid
• Maar geen Magento producten worden aangemaakt

Oplossingen:

1. Handmatig aanmaken vereist:

   • Als auto-create is uitgeschakeld, gebruik massa-actie "Update/Create Magento Products"

2. Controleer automation instellingen:

   • Automation → Auto create new products = Yes

3. Verifieer attribuut mapping:

   • Vereiste attributen moeten gemapped zijn (minimaal Name)
   • Controleer Attributen grid voor mapping status

4. Controleer op fouten:

   • Kijk naar "Has Error" in Products grid
   • Review Sync Log voor gedetailleerde fouten

Symptomen:

• Product aangemaakt maar attributen zijn leeg
• Sommige attributen ontbreken

Oplossingen:

1. Controleer attribuut mapping:

   • Ga naar Katana PIM → Attributes
   • Verifieer dat attributen zijn gemapped (niet "-- Not Mapped --")
   • Zorg dat attributen niet gemarkeerd zijn als Skipped

2. Importeer eerst attributen:

   • Klik "Import Attributes" knop
   • Wacht tot import is voltooid
   • Map dan attributen

3. Verifieer PIM data:

   • Controleer dat product waarden heeft voor die attributen in PIM

Symptomen:

• Producten aangemaakt maar geen afbeeldingen
• Assets grid toont fouten

Oplossingen:

1. Controleer dat producten bestaan:

   • Assets vereisen dat gekoppelde producten eerst bestaan
   • Maak producten aan voordat je assets synchroniseert

2. Verifieer afbeelding URLs:

   • Controleer Assets grid voor geldige URLs
   • Zorg dat afbeeldingen publiek toegankelijk zijn

3. Controleer bestandsrechten:

   • Magento moet schrijftoegang hebben tot pub/media

4. Review fouten:

   • Controleer "Has Error" en "Error Message" kolommen

Symptomen:

• Simple producten maken wel aan maar configurables niet
• Parent producten ontbreken

Oplossingen:

1. Stel configurable attributen in:

   • Ga naar Attributen grid
   • Zet "Is Configurable" = Yes voor variant-attributen (Maat, Kleur)

2. Verifieer ouder/kind relaties:

   • Controleer dat PIM correcte product hiërarchie heeft
   • Parent producten moeten kinderen gekoppeld hebben

3. Sync volgorde:

   • Attributen moeten eerst gesynchroniseerd en geconfigureerd zijn
   • Synchroniseer dan producten

Symptomen:

• Sync wordt nooit voltooid
• Browser timeout
• Memory fouten in logs

Oplossingen:

1. Gebruik CLI in plaats daarvan:

   bin/magento katana:import:full
   

   CLI heeft geen browser timeout limieten.

2. Verklein batch sizes:

   • General → Import Settings → Batch Size Settings
   • Verlaag de page size waarden

3. Sync in delen:

   bin/magento katana:import:full --attributes
   bin/magento katana:import:full --categories
   bin/magento katana:import:full --products
   bin/magento katana:import:full --assets
   

4. Verhoog PHP limieten:

   • Verhoog max_execution_time
   • Verhoog memory_limit

Symptomen:

• Gewijzigde producten worden niet bijgewerkt
• "Needs Update" blijft No

Oplossingen:

1. Gebruik Full Sync:

   • Voer full sync uit om hash vergelijking te resetten

2. Force update:

   • Gebruik "Update/Create (force)" massa-actie

3. Controleer PIM timestamps:

   • Zorg dat PIM modificatiedatums bijwerkt

Symptomen:

• Sync draait niet automatisch
• Laatste sync datum wordt nooit bijgewerkt

Oplossingen:

1. Controleer automation ingeschakeld:

   • Automation → Enable Automation = Yes
   • Cron frequenties geconfigureerd

2. Verifieer Magento cron:

   bin/magento cron:run
   

3. Controleer cron schedule:

   SELECT * FROM cron_schedule
   WHERE job_code LIKE '%katana%'
   ORDER BY scheduled_at DESC LIMIT 10;
   

4. Controleer server cron:

   • Zorg dat systeem cron Magento cron regelmatig draait