KatanaPIM cron jobs voor Magento 2 synchronisatie

De Full Update cron haalt ALLE data op van de KatanaPIM API maar synchroniseert niet direct naar Magento.

Wat het doet:

1. Haalt alle attributen, categorieën, producten en assets op van de KatanaPIM API
2. Slaat de data op in tussentabellen (katanapim_product, katanapim_category, etc.)
3. Berekent hashes om wijzigingen te detecteren
4. Zet de needs_update flag op items waar PIM data verschilt van Magento
5. Markeert items die niet meer in PIM staan als verwijderd

Wat het NIET doet:

• Magento producten aanmaken of bijwerken
• Magento categorieën aanmaken of bijwerken
• Afbeeldingen importeren in Magento

De Incremental Update cron verwerkt items die gemarkeerd zijn voor update en synchroniseert ze naar Magento.

Wat het doet:

1. Haalt recent gewijzigde items op van de KatanaPIM API (met timestamp filter)
2. Verwerkt alle items met needs_update = 1
3. Maakt of updatet Magento producten, categorieën en attributen
4. Importeert afbeeldingen en video's in Magento
5. Wist de needs_update flag na succesvolle sync

De module gebruikt twee aparte hash vergelijkingen:

1. Tijdens API fetch (Full Sync):

2. Bij opslaan in tussentabel:

Dit betekent: als data niet is gewijzigd in KatanaPIM sinds de laatste Full Sync, wordt het item volledig overgeslagen en wordt needs_update niet aangepast.

Na een succesvolle Magento sync:

1. Het item wordt aangemaakt of bijgewerkt in Magento
2. mapped_magento_hash wordt gelijkgesteld aan mapped_katana_hash
3. needs_update wordt 0

Items worden alleen naar Magento gesynchroniseerd wanneer ALLE voorwaarden zijn voldaan:

• needs_update = 1
• skipped = 0
• is_deleted = 0
• has_error = 0

De cron limieten gelden voornamelijk voor de Incremental Sync, die items verwerkt van de tussentabellen naar Magento.

Als 500 producten needs_update = 1 hebben, maar de limiet is 100:

• Eerste cron run: verwerkt producten 1-100
• Tweede cron run: verwerkt producten 101-200
• Enzovoort...

Met een 5-minuten incremental schema zouden alle 500 producten binnen ~25 minuten gesynchroniseerd zijn.

Schema's kunnen worden geconfigureerd in Stores → Configuration → Katana PIM → Automation.

Controleer de flags:

SELECT sku, needs_update, skipped, is_deleted, has_error
FROM katanapim_product
WHERE needs_update = 1
LIMIT 10;

Items hebben needs_update = 1 EN skipped = 0 EN is_deleted = 0 EN has_error = 0 nodig om verwerkt te worden.

Verifieer dat cron actief is:

bin/magento cron:run --group=katanapim

Controleer cron schema:

SELECT * FROM cron_schedule
WHERE job_code LIKE 'katanapim%'
ORDER BY scheduled_at DESC
LIMIT 20;

Opties:

1. Verhoog cron limieten in de configuratie
2. Verlaag incremental schema frequentie
3. Draai full sync via CLI tijdens daluren in plaats van cron

Als items onterecht als verwijderd zijn gemarkeerd, betekent dit meestal:

• Het item is verwijderd uit KatanaPIM
• API verbinding faalde tijdens full sync (gedeeltelijke fetch)

Oplossing: Draai een handmatige full sync via CLI om alle data opnieuw op te halen:

bin/magento katana:import:full --products