Complete instellingen referentie voor de KatanaPIM Connect extensie. Deze gids legt elke instelling uit en wanneer je deze moet gebruiken.
Algemene Configuratie
Navigeer naar Stores → Configuration → Katana PIM → General of via het admin menu Katana PIM → Configuration.
General
Instelling
Beschrijving
Enabled
Hoofdschakelaar voor de KatanaPIM integratie
Wanneer uitschakelen: Alleen uitschakelen als je tijdelijk alle PIM synchronisatie wilt stoppen zonder de module te deïnstalleren. Handig tijdens grote catalogus herstructureringen of PIM migraties.
API
Verbind je Magento winkel met je KatanaPIM instance.
Instelling
Beschrijving
URL
Je KatanaPIM instance URL (bijv. https://jouwbedrijf.katanapim.com)
Key
API key van je KatanaPIM account (versleuteld opgeslagen)
Test Credentials
Valideert je API verbinding
Waar vind je je API key: In KatanaPIM, navigeer naar je account instellingen of neem contact op met je KatanaPIM beheerder.
Tip: Test altijd de credentials na het invoeren. Een mislukte verbinding voorkomt alle synchronisatie.
Import Settings
Fijn-afstemming van hoe de extensie data verwerkt tijdens synchronisatie.
Batch Size Settings
Bepaal hoeveel entiteiten per batch worden verwerkt. Kleinere batches gebruiken minder geheugen maar duren langer; grotere batches zijn sneller maar kunnen geheugenlimieten bereiken.
Instelling
Standaard
Beschrijving
Import PIM products page size
100
Producten opgehaald uit KatanaPIM per API call
Create Magento products page size
50
Producten aangemaakt/bijgewerkt in Magento per batch
Import attributes page size
100
Attributen geïmporteerd per batch
Import categories page size
100
Categorieën geïmporteerd per batch
Import Katana assets page size
100
Assets (afbeeldingen/bestanden) opgehaald uit PIM per batch
Import Magento assets page size
50
Assets verwerkt in Magento per batch
Wanneer aanpassen:
Lagere waarden als je geheugenfouten of timeouts ervaart tijdens sync
Hogere waarden als je een krachtige server hebt en snellere imports wilt
Asset page sizes zijn meestal het meest geheugenintensief - begin conservatief
Async Update Settings
Instelling
Beschrijving
Concurrency Limit
Maximum gelijktijdige async requests
Wanneer aanpassen: Verlaag dit als je Redis verbindingsfouten of "te veel verbindingen" fouten ziet. De standaard is meestal veilig, maar drukke winkels moeten mogelijk verlagen.
Reindex Data
Instelling
Beschrijving
Init Reindex after full sync
Automatisch Magento reindex triggeren na voltooiing van een volledige sync
Waarschuwing: Niet aanbevolen voor productie winkels met grote catalogi. Reindexen kan prestatieproblemen veroorzaken tijdens kantooruren. Plan in plaats daarvan reindex via cron tijdens daluren.
Wanneer inschakelen: Alleen op development/staging omgevingen, of kleine catalogi waar reindex snel voltooit.
Store Filter
Als je KatanaPIM account meerdere stores heeft, kun je filteren welke store's data te importeren.
Instelling
Beschrijving
Import Stores
Haalt beschikbare stores op uit KatanaPIM
Store Filter
Selecteer van welke KatanaPIM store te synchroniseren
Wanneer gebruiken: Multi-merk setups waar verschillende Magento instances verbinden met verschillende KatanaPIM stores. Laat leeg om van alle stores te importeren.
Import New Products in Websites
Instelling
Beschrijving
Websites
Magento websites waar nieuwe producten aan worden toegewezen
Belangrijk: Dit beïnvloedt alleen NIEUWE producten. Bestaande producten behouden hun huidige website toewijzingen. Selecteer alle websites waar PIM producten zichtbaar moeten zijn.
Store Languages
Map KatanaPIM talen naar je Magento store views voor meertalige productdata synchronisatie.
Instelling
Beschrijving
Store Language Mapping
Map KatanaPIM taalcodes naar Magento store views
KatanaPIM Taalcodes Vinden
In je KatanaPIM backend, navigeer naar Configuration > Languages om alle beschikbare talen en hun codes te zien.
Veelvoorkomende taalcode formaten:
nl-NL - Nederlands (Nederland)
en-US - Engels (Verenigde Staten)
fr-FR - Frans (Frankrijk)
de-DE - Duits (Duitsland)
it-IT - Italiaans (Italië)
es-ES - Spaans (Spanje)
De Standaardtaal Mappen
Om de standaardtaal van KatanaPIM te mappen (gemarkeerd met vinkje in de "Is default" kolom), gebruik de string default (kleine letters) als Katana Language Code.
Voorbeeld mapping:
Katana Language Code
Magento Store View
default
English (Default Store View)
nl-NL
Dutch
de-DE
German
Hoe Het Werkt
Wanneer producten synchroniseren, controleert de extensie welke talen zijn gemapt
Voor elke gemapte taal haalt het de vertaalde productdata op uit KatanaPIM
De data wordt opgeslagen in de corresponderende Magento store view
Niet-gemapte talen worden genegeerd tijdens sync
Tip: Map alleen talen die je daadwerkelijk gebruikt in Magento. Ongebruikte talen mappen verlengt de synctijd zonder voordeel.
Debug & Logging
Instelling
Beschrijving
Debug Mode
Schakel gedetailleerde logging in voor troubleshooting
View Logs
Download debug en error logs direct vanuit admin
Log locaties:
Debug log: var/log/katanapim/debug.log
Error log: var/log/katanapim/error.log
Wanneer inschakelen: Alleen bij het oplossen van problemen. Debug mode logt uitgebreide informatie en kan snel groot worden. Schakel uit na het oplossen van problemen.
Deze instellingen bepalen hoe productdata van KatanaPIM naar Magento stroomt.
General
Instelling
Beschrijving
Enable Product Import
Hoofdschakelaar voor product synchronisatie
If SKU exists update product
Koppel bestaande Magento producten aan KatanaPIM door SKU te matchen
SKU matching uitgelegd: Indien ingeschakeld, als een product in KatanaPIM dezelfde SKU heeft als een bestaand Magento product, worden ze gekoppeld. Toekomstige syncs zullen dat Magento product updaten in plaats van een duplicaat aan te maken.
Wanneer SKU matching inschakelen:
Migreren van een ander PIM systeem
KatanaPIM verbinden met een bestaande catalogus
Productdata bronnen samenvoegen
Wanneer uitschakelen: Nieuwe installaties waar alle producten uit KatanaPIM komen.
Attributes
Map KatanaPIM attributen naar core Magento productvelden. Selecteer welk KatanaPIM attribuut elk Magento veld moet vullen.
Instelling
Mapt naar Magento veld
Name
name
Short Description
short_description
Description
description
GTIN
Custom attribuut voor EAN/UPC codes
Manufacturer Part Number
Custom attribuut voor MPN
Attachments
Product bijlagen/downloads
Meta Keywords
meta_keyword
Meta Description
meta_description
Meta Title
meta_title
Tip: Deze dropdowns tonen alle beschikbare KatanaPIM attributen. Als je het benodigde attribuut niet ziet, voer eerst een attribuut import uit vanuit Katana PIM → Attributes.
Asset Data
Bepaal hoe afbeeldingen en video's van KatanaPIM worden behandeld.
Instelling
Beschrijving
Import Video to Gallery
Neem video's op in de product media galerij
Title Attribute
KatanaPIM attribuut om te gebruiken als videotitel
Gallery Position
Waar video's verschijnen in de galerij (lager = eerst)
Compare Image Hash
Importeer afbeeldingen alleen opnieuw als de inhoud is gewijzigd
Image hash vergelijking: Indien ingeschakeld, vergelijkt de extensie file hashes voor het importeren. Dit voorkomt het opnieuw downloaden van identieke afbeeldingen en versnelt incrementele syncs aanzienlijk.
Wanneer hash vergelijking uitschakelen: Als afbeeldingen in PIM worden bijgewerkt maar hashes niet veranderen (zeldzaam), of tijdens initiële import voor snelheid.
Product Import Defaults
Stel standaardwaarden in voor nieuw aangemaakte producten. Deze gelden alleen bij het aanmaken van producten - bestaande producten worden niet beïnvloed.
Instelling
Opties
Aanbeveling
Status
Enabled / Disabled
Disabled - Review producten voor ze live gaan
Visibility
Not Visible / Catalog / Search / Both
Not Visible - Enable na QA
Use config manage stock
Yes / No
Yes - Gebruik globale voorraad instellingen
Is in stock
Yes / No
Yes - Tenzij je voorraad apart beheert
Aanbevolen workflow: Importeer producten als Disabled/Not Visible, review ze in Magento, schakel dan in bulk in na QA.
Price Updates
Instelling
Beschrijving
Update product price changes
Synchroniseer price, special_price en cost vanuit PIM
Wanneer uitschakelen: Als prijzen worden beheerd in Magento (promoties, klantspecifieke prijzen) in plaats van PIM. Dit inschakelen overschrijft alle Magento-kant prijswijzigingen.
Match bestaande Magento categorieën op naam en diepte
Categorie matching uitgelegd: Indien ingeschakeld, als een KatanaPIM categorie dezelfde naam heeft als een Magento categorie op dezelfde boomdiepte, worden ze gekoppeld. Dit behoudt je bestaande categorie URLs en SEO.
Voorbeeld: KatanaPIM categorie "Kleding > Shirts" zal matchen met Magento categorie "Kleding > Shirts" als beide op diepte 2 zijn.
Wanneer inschakelen: KatanaPIM verbinden met een bestaande catalogus met gevestigde categorieën.
Wanneer uitschakelen: Nieuwe installaties, of als je volledig gescheiden categoriestructuren wilt.
Automation Configuratie
Navigeer naar Stores → Configuration → Katana PIM → Automation.
Automatiseer synchronisatie via Magento cron jobs.
Settings
Instelling
Beschrijving
Enable Automation
Hoofdschakelaar voor cron-gebaseerde sync
Auto create new products
Sta cron toe om nieuwe Magento producten aan te maken
Auto create new categories
Sta cron toe om nieuwe Magento categorieën aan te maken
Auto-create instellingen: Bepaal of de automatische sync nieuwe entiteiten kan aanmaken of alleen bestaande kan updaten.
Conservatieve aanpak: Schakel auto-create initieel uit. Nieuwe producten verschijnen in het Katana PIM grid maar worden niet aangemaakt in Magento totdat je ze handmatig goedkeurt.
Hands-off aanpak: Schakel beide in voor volledig geautomatiseerd catalogusbeheer. Nieuwe producten in PIM verschijnen automatisch in Magento.
Cron Settings
Instelling
Beschrijving
Full Update
Complete resync van alle data
Incremental Update
Sync alleen wijzigingen sinds laatste update
Aanbevolen schema:
Full Update: Wekelijks of dagelijks (daluren)
Incremental Update: Elke 1-4 uur
Full vs Incremental:
Full sync haalt alles op uit PIM, zorgt dat Magento exact matcht met PIM. Langzamer maar vangt gemiste wijzigingen.
Incremental sync haalt alleen items op die zijn gewijzigd sinds de laatste sync. Veel sneller voor dagelijkse updates.
Tip: Als producten niet synchroon lijken, voer een handmatige full sync uit vanuit het admin grid of CLI.
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.
11 Nov 2025
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
09 Sep 2025
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!
05 Sep 2025
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.
02 Sep 2025
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
30 Jul 2025
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.
25 Jul 2025
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
18 Jul 2025
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
30 Jun 2025
R. U.
Erg goed team, reageren snel en duidelijk en hebben met toegang tot onze database erg goed geholpen (eigenlijk een gratis customization).
18 Jun 2025
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!
