KatanaPIM

Versie v3.12.1
Platform Magento 2
Module uitgebracht 15 October 2026

Configureer Magento 2 KatanaPIM koppeling

Op zoek naar Magento 2 KatanaPIM koppeling? Bekijk de volledige Magento 2 KatanaPIM koppeling pagina voor functies, configuratieopties en prijzen.

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.

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
Limit to Katana Store 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.

Default Websites

Instelling Beschrijving
Default Websites Fallback websites voor nieuwe producten en categorieën wanneer er geen store mapping beschikbaar is

Belangrijk: Dit beïnvloedt alleen NIEUWE producten en categorieën. Bestaande entiteiten behouden hun huidige website toewijzingen. Wordt gebruikt door zowel product- als categorie-imports.

Limits

Beheert batch sizes, cron verwerkingslimieten, mass action drempels en async concurrency.

Batch Sizes

Bepaal hoeveel entiteiten per batch worden verwerkt.

Instelling Standaard Beschrijving
API Page Size 1000 Aantal items opgehaald uit Katana API per request (geldt voor alle entiteiten)
Magento Batch Size 20 Aantal items gesynchroniseerd naar Magento per batch (geldt voor alle entiteiten)

Wanneer aanpassen:

  • Lagere waarden als je geheugenfouten of timeouts ervaart tijdens sync
  • Hogere waarden als je een krachtige server hebt en snellere imports wilt

Cron Limits

Bepaal hoeveel entiteiten per cron run worden verwerkt. Stel in op 0 voor onbeperkt.

Instelling Standaard Beschrijving
Max Products per Cron 100 Maximum producten per cron run
Max Categories per Cron 100 Maximum categorieën per cron run
Max Attributes per Cron 100 Maximum attributen per cron run
Max Assets per Cron 100 Maximum assets per cron run

Wanneer aanpassen: Verhoog als je cron window lang genoeg is en de server het aankan. Verlaag als cron jobs overlappen of timeouts veroorzaken.

Mass Action

Instelling Standaard Beschrijving
Mass Action Limit 150 Maximum aantal records dat in één mass action kan worden verwerkt

Async Settings

Instelling Standaard Beschrijving
Concurrency Limit 1 Aantal pagina-requests dat de admin-sync gelijktijdig verstuurt

Wanneer aanpassen: Verhoog dit alleen als een import via de admin te langzaam is én je server PHP-FPM workers over heeft. Elk gelijktijdig request bezet een worker zolang zijn pagina duurt, dus een hoge waarde kan de admin voor iedereen onbruikbaar maken tijdens een import. Verlaag weer als je Redis- of databaseverbindingsfouten ziet.

Let op: de admin-sync wordt door de browser gestuurd, dus de pagina moet openblijven tot hij klaar is. Gebruik voor grote catalogi de cron (zie Automation).

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

  1. Wanneer producten synchroniseren, controleert de extensie welke talen zijn gemapt
  2. Voor elke gemapte taal haalt het de vertaalde productdata op uit KatanaPIM
  3. De data wordt opgeslagen in de corresponderende Magento store view
  4. 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.

Product Data Configuratie

Navigeer naar Stores → Configuration → Katana PIM → Product Data.

Deze instellingen bepalen hoe productdata van KatanaPIM naar Magento stroomt.

General

Instelling Beschrijving
Enable Product Import Hoofdschakelaar voor product synchronisatie
Only import published products Indien ingeschakeld worden alleen producten die als Published zijn gemarkeerd in KatanaPIM geimporteerd. Niet-gepubliceerde producten worden overgeslagen tijdens sync. (Nieuw in 3.10.0)
If SKU exists update product Koppel bestaande Magento producten aan KatanaPIM door SKU te matchen
SKU Fallback Wanneer een product geen SKU heeft in KatanaPIM (bijv. configureerbare producten), wordt deze waarde gebruikt als Magento SKU. Opties: External Key (gebruikt de external key code van het product) of KatanaPIM ID (gebruikt het numerieke KatanaPIM product ID). (Nieuw in 3.10.0)
Configurable Product Level Bepaalt welk hierarchieniveau het configureerbare product wordt. GrandParent: GrandParent = configurable, Parent = overgeslagen. Parent: Parent = configurable, GrandParent = overgeslagen. Both: Beide niveaus worden configureerbare producten.
Website Assignment Source Bepaalt hoe producten worden toegewezen aan Magento websites. Katana Stores (standaard): gebruikt de LimitedToStores van het product en het Store Mapping grid. Katana Attribute (legacy): gebruikt het katanapim_product_in_websites attribuut. Zie Product Website Matching. (Nieuw in 3.10.0)
Sync Related Products Indien ingeschakeld worden gerelateerde product-toewijzingen uit KatanaPIM gesynchroniseerd naar Magento. Schakel uit om gerelateerde producten handmatig te beheren in Magento. (Nieuw in 3.10.0)
Sync Cross-sell Products Indien ingeschakeld worden cross-sells uit KatanaPIM gesynchroniseerd naar Magento. Zolang dit aanstaat is KatanaPIM eigenaar van de lijst: cross-sells die in Magento handmatig zijn ingesteld worden bij de volgende sync vervangen. Standaard uit, zodat aanzetten een bewuste keuze is. (Nieuw in 3.12.0)

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 en cost vanuit PIM
Update special price Indien ingeschakeld wordt special_price gesynchroniseerd vanuit PIM. Indien uitgeschakeld wordt special_price in Magento niet overschreven tijdens sync. Handig wanneer aanbiedingsprijzen handmatig of via een andere bron worden beheerd. Alleen zichtbaar wanneer prijsupdates zijn ingeschakeld. (Nieuw in 3.10.0)

Wanneer prijsupdates uitschakelen: Als prijzen worden beheerd in Magento (promoties, klantspecifieke prijzen) in plaats van PIM. Dit inschakelen overschrijft alle Magento-kant prijswijzigingen.

Wanneer special price sync uitschakelen: Als je aanbiedingsprijzen beheert in Magento (bijv. via catalogus prijsregels of handmatige invoer) terwijl basisprijzen uit PIM komen.

Website Price Mapping (Nieuw in 3.8.0)

Koppel KatanaPIM prijs-attributen aan specifieke Magento websites. Hiermee kun je verschillende prijzen per website instellen vanuit PIM.

Instelling Beschrijving
Katana Attribute Het KatanaPIM prijs-attribuut (bijv. Price_DE, Price_FR, Price_NL)
Magento Website De Magento website waar deze prijs moet worden toegepast

Vereisten:

  • Catalog Price Scope moet ingesteld zijn op Website (Stores → Configuration → Catalog → Catalog → Price)
  • Update product price changes moet ingeschakeld zijn

Hoe het werkt:

  1. De basisprijs (Default Config scope) wordt altijd ingesteld vanuit het standaard PIM prijsveld
  2. Website-specifieke prijzen worden ingesteld vanuit de gekoppelde PIM attributen
  3. Prijzen worden toegepast op alle store views binnen de gekoppelde website
  4. Als een gekoppeld attribuut geen waarde heeft of leeg is, gebruikt het product de basisprijs voor die website

Voorbeeld configuratie:

Katana Attribuut Magento Website
Price_NL Nederlandse Website
Price_DE Duitse Website
Price_FR Franse Website

Prijs-attributen instellen in KatanaPIM:

  1. Maak custom attributen aan in KatanaPIM voor elke website prijs (bijv. Price_NL, Price_DE)
  2. Deze moeten numerieke/decimale attributen zijn
  3. Vul de prijzen per product in KatanaPIM
  4. Koppel ze in deze configuratie

Wanneer gebruiken:

  • Multi-website Magento setups met verschillende prijzen per regio/land
  • B2B setups met verschillende klantgroep websites
  • Multi-valuta setups waar prijzen per website worden beheerd

Wanneer NIET gebruiken:

  • Single-website Magento installaties
  • Wanneer Catalog Price Scope is ingesteld op "Global"
  • Wanneer prijzen identiek zijn voor alle websites

Category Data Configuratie

Navigeer naar Stores → Configuration → Katana PIM → Category Data.

General

Instelling Beschrijving
Enable Category Import Hoofdschakelaar voor categorie synchronisatie
If name exists link category Match bestaande Magento categorieën op naam en diepte
Default Store View for Category Tree Wordt gebruikt om de juiste root categorie boom te kiezen wanneer een Katana categorie geen Stores filter heeft, of wanneer het filter store views omvat die bij meerdere root categorieën horen. Laat leeg om de standaard store view te gebruiken.

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.

Meer Hulp Nodig?

Documentatie:

Support:

Voor een compleet overzicht van functies en configuratieopties, bekijk Magento 2 KatanaPIM koppeling.

Artikel bijgewerkt:
Download PDF
star star star star star
star star star star star
Gaaf - digital agency
We have tried the integration with SnelStart through several different providers, and this is the only solution that simply works. We needed support on two occasions, and it was provided quickly and professionally. We do recommend this company!
Google 12 May 2026
star star star star star
star star star star star
Andrew Velikiy
Great vendor with handy modules and quick support!
Google 13 Apr 2026
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