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
- 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.
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:
- De basisprijs (Default Config scope) wordt altijd ingesteld vanuit het standaard PIM prijsveld
- Website-specifieke prijzen worden ingesteld vanuit de gekoppelde PIM attributen
- Prijzen worden toegepast op alle store views binnen de gekoppelde website
- 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:
- Maak custom attributen aan in KatanaPIM voor elke website prijs (bijv.
Price_NL,Price_DE) - Deze moeten numerieke/decimale attributen zijn
- Vul de prijzen per product in KatanaPIM
- 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:
- Alle Help Artikelen - Compleet documentatie overzicht
Support:
- Contact Opnemen - Hulp van ons team
Voor een compleet overzicht van functies en configuratieopties, bekijk Magento 2 KatanaPIM koppeling.