KatanaPIM

Versie v3.5.0
Platform Magento 2
Uitgebracht 17 November 2025

Sync Proces voor KatanaPIM Connect

Begrijp hoe synchronisatie werkt in KatanaPIM Connect. Leer het verschil tussen Full en Incremental sync, en wanneer je welke moet gebruiken.

Overzicht

KatanaPIM Connect synchroniseert data in twee stadia:

  1. Import uit PIM - Haal data op uit KatanaPIM API naar tussentabellen
  2. Aanmaken in Magento - Verwerk tussendata om Magento entiteiten aan te maken/bij te werken

Deze twee-stadia aanpak laat je geïmporteerde data reviewen voordat je Magento producten aanmaakt.

Sync Types

Full Update

Een volledige synchronisatie van alle entiteiten uit KatanaPIM.

Wat het doet:

  • Haalt ALLE producten, categorieën, attributen en assets op uit PIM
  • Vergelijkt met bestaande data via hash-vergelijking
  • Markeert items als "Needs Update" wanneer wijzigingen worden gedetecteerd
  • Kan optioneel Magento reindex triggeren na voltooiing

Wanneer gebruiken:

  • Initiële setup en eerste import
  • Na grote wijzigingen in PIM
  • Wekelijks/dagelijks gepland onderhoud
  • Wanneer incremental sync gaten heeft

Uitvoeren via CLI:

# Volledige sync van alles
bin/magento katana:import:full

# Sync alleen specifieke entity types
bin/magento katana:import:full --attributes
bin/magento katana:import:full --categories
bin/magento katana:import:full --products
bin/magento katana:import:full --assets

Incremental Update

Een delta-synchronisatie die alleen gewijzigde items verwerkt.

Wat het doet:

  • Haalt alleen items op die zijn gewijzigd sinds laatste sync
  • Veel sneller dan full update
  • Lagere serverbelasting
  • Ideaal voor frequente updates

Wanneer gebruiken:

  • Regelmatige geplande updates (elke paar uur)
  • Na individuele productwijzigingen in PIM
  • Om Magento gesynchroniseerd te houden gedurende de dag

Uitvoeren via CLI:

bin/magento katana:import:incremental

Sync Volgorde

Entiteiten moeten in deze volgorde worden gesynchroniseerd:

  1. Attributen - Eerst vereist voor product data mapping
  2. Categorieën - Optioneel, nodig als je PIM categorieën gebruikt
  3. Producten - Hoofd productdata
  4. Assets - Product afbeeldingen en video's (vereist producten)

Het Full Update commando handelt deze volgorde automatisch af.

Wat Wordt Gesynchroniseerd

Producten

PIM Data Magento Veld
Productnaam name (gemapped attribuut)
Beschrijving description (gemapped attribuut)
SKU sku
GTIN gtin (gemapped attribuut)
Prijsdata price, special_price, cost
Categorie toewijzingen category_ids
Attribuutwaarden Custom attributen

Categorieën

PIM Data Magento Veld
Categorienaam name
URL key url_key
Ouder/kind hiërarchie path, level
Positie position

Attributen

PIM Data Magento Veld
Attribuutcode attribute_code (katanapim_ prefix)
Attribuutlabel frontend_label
Attribuuttype frontend_input
Opties attribute options

Assets

PIM Data Magento Veld
Afbeelding URL Product galerij
Afbeelding volgorde position
Video URL Product video
Alt tekst label

Hash Vergelijking

De module gebruikt hash-vergelijking om wijzigingen te detecteren:

  1. Wanneer data wordt geïmporteerd uit PIM, wordt een hash berekend
  2. Wanneer Magento entiteit wordt aangemaakt/bijgewerkt, wordt een andere hash berekend
  3. Als hashes verschillen, wordt het item gemarkeerd als "Needs Update"
  4. Overeenkomende hashes betekenen dat geen update nodig is

Dit voorkomt onnodige Magento saves en verbetert performance.

De "Needs Update" Vlag

In alle grids zie je een "Needs Update" kolom:

Waarde Betekenis
Yes PIM data verschilt van Magento - update aanbevolen
No Data is gesynchroniseerd - geen actie nodig

Items gemarkeerd als "Needs Update" worden verwerkt tijdens de volgende sync als automatisering is ingeschakeld.

De "Skipped" Vlag

Markeer items als "Skipped" om ze uit te sluiten van synchronisatie:

  • Geskipte items worden genegeerd tijdens auto-sync
  • Handig voor producten die je niet in Magento wilt
  • Kan worden in/uitgeschakeld via massa-actie

Automatisering Flow

Wanneer automatisering is ingeschakeld:

  1. Cron triggert op basis van geconfigureerde frequentie
  2. Incremental/Full Update haalt data op uit PIM
  3. Auto-create (indien ingeschakeld) maakt nieuwe Magento entiteiten aan
  4. Bestaande items met "Needs Update" worden bijgewerkt
  5. Sync Log registreert de resultaten

Handmatig vs Automatisch Aanmaken

Automatisch (via cron):

  • Schakel "Auto create new products" in bij Automation instellingen
  • Nieuwe producten worden automatisch aangemaakt tijdens sync
  • Minder controle, meer gemak

Handmatig (via grid):

  • Laat auto-create uitgeschakeld
  • Review eerst geïmporteerde producten in grid
  • Selecteer items en gebruik "Update/Create Magento Products" massa-actie
  • Meer controle over wat wordt aangemaakt

Performance Tips

  1. Gebruik Incremental voor frequente updates (elk uur)
  2. Gebruik Full voor periodiek onderhoud (dagelijks/wekelijks)
  3. Pas batch sizes aan als je timeouts ervaart
  4. Schakel reindex uit in productie - voer handmatig uit na sync
  5. Gebruik CLI voor grote imports - voorkomt browser timeouts

Meer Hulp Nodig?

Documentatie:

Support:

Aangemaakt:
Bijgewerkt:
star star star star star
star star star star star
Alexandru-Manuel Carabus
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
Google 11 Nov 2025
star star star star star
star star star star star
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
Google 09 Sep 2025
star star star star star
star star star star star
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord. Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn.... Bedankt!
Google 05 Sep 2025
star star star star star
star star star star star
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
Google 02 Sep 2025
star star star star star
star star star star star
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
Google 30 Jul 2025
star star star star star
star star star star star
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen. In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
Google 25 Jul 2025
star star star star star
star star star star star
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
Google 18 Jul 2025
star star star star star
star star star star star
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
Google 30 Jun 2025
star star star star star
star star star star star
R. U.
Erg goed team, reageren snel en duidelijk en hebben met toegang tot onze database erg goed geholpen (eigenlijk een gratis customization).
Google 18 Jun 2025
star star star star star
star star star star star
Hugo de Groot
Uitstekende support! Wij gebruiken o.a. de Rich Snippets Suite extensie voor onze Magento 2 webshop (Hyvä) en hadden een specifieke vraag over structured data op PLP-pagina’s. Binnen no-time kregen we een inhoudelijk en duidelijk antwoord. Zeer prettig contact en goed onderbouwde uitleg. Absoluut een betrouwbare partner voor Magento-extensies!
Google 13 Jun 2025