CCV Shop-PIM-Integration: Anleitung Schritt für Schritt

Einführung in PIM und seine Vorteile für CCV Shop

Product Information Management (PIM) zentralisiert, verwaltet und reichert alle Produktinformationen an, damit du sie über verschiedene Vertriebs- und Marketingkanäle ausspielen kannst. Es dient als zentrale Datenquelle (Single Source of Truth) für Produktdaten, darunter SKUs, Beschreibungen, technische Spezifikationen, Bilder, Videos, Marketingtexte und Übersetzungen. Ein PIM-System hält alle produktbezogenen Daten korrekt, konsistent und aktuell, egal wo sie veröffentlicht werden.

Ohne PIM-System tun sich Unternehmen mit der Verwaltung ihrer Produktdaten oft schwer. Produktinformationen verteilen sich über Tabellen, ERP-Systeme und Ordner verschiedener Abteilungen, was zu Inkonsistenzen und Fehlern führt. Manuelle Aktualisierungen kosten Zeit und sind fehleranfällig, wodurch sich die Einführung neuer Produkte und die Pflege bestehender verzögert. Diese Zersplitterung erschwert es, die Datenqualität zu halten, Produktkataloge auszubauen und an allen Touchpoints ein einheitliches Kundenerlebnis zu bieten.

Für CCV Shop-Nutzer bietet ein PIM-System mehrere Vorteile. Es hält deine Daten in deinem CCV Shop-Webshop, auf Marketplaces und in anderen Kanälen konsistent und vermeidet Abweichungen, die Kunden verwirren könnten. PIM steigert die betriebliche Effizienz, weil es die Verteilung der Daten automatisiert und den manuellen Aufwand für Produktaktualisierungen senkt. Diese Automatisierung verkürzt die Zeit, bis neue Produkte auf den Markt kommen. Ein PIM bereitet dich außerdem auf Omnichannel-Vertrieb vor, weil du Produktdaten leichter an die speziellen Anforderungen jedes Vertriebskanals anpassen und dort veröffentlichen kannst. Konsistente und detaillierte Produktinformationen helfen Kunden, fundierte Entscheidungen zu treffen, und können Retouren verringern.

Deine CCV Shop-Umgebung vorbereiten

Bevor du dein Product Information Management (PIM) System mit CCV Shop verbindest, solltest du deine CCV Shop-Umgebung vorbereiten. Diese Vorbereitung sorgt für eine reibungslose Datenübertragung und verhindert typische Integrationsprobleme. Im ersten Schritt prüfst du deinen API-Zugang und deine Zugangsdaten für CCV Shop. Dein PIM-System braucht diese Zugangsdaten, um mit CCV Shop zu kommunizieren, bestehende Produktdaten abzurufen und aktualisierte Informationen zu übertragen. Vergewissere dich, dass du einen aktiven API-Schlüssel mit den nötigen Berechtigungen zum Lesen und Schreiben von Produktdaten, Kategorien und gegebenenfalls weiteren Entitäten wie Varianten oder benutzerdefinierten Feldern hast. Wenn du keinen API-Schlüssel hast, erstelle einen im Backend von CCV Shop.

Prüfe als Nächstes deine bestehende Produktdatenstruktur in CCV Shop. Dazu gehört, dass du deine aktuellen Kategorien, Produkttypen und die zugeordneten Attribute verstehst. Finde Inkonsistenzen wie Produkte in falschen Kategorien, doppelte Produkteinträge oder Attribute mit unterschiedlichen Datentypen für dieselbe Information (z. B. 'Farbe' bei manchen Produkten als Text und bei anderen als Dropdown). Diese Prüfung hilft dir, deine PIM-Daten genau auf die Struktur von CCV Shop abzubilden. Ermittle gleichzeitig, welche benutzerdefinierten Felder oder Attribute in CCV Shop für deine PIM-Integration unverzichtbar sind. Wenn dein PIM zum Beispiel bestimmte Produktzertifizierungen oder detaillierte Materialzusammensetzungen speichert, stelle sicher, dass es in CCV Shop passende benutzerdefinierte Felder für diese Daten gibt.

Bereinige abschließend inkonsistente oder doppelte Daten gründlich, bevor du die Integration startest. Die Datenqualität bestimmt direkt, wie erfolgreich deine PIM-Einführung wird. Wenn du deine CCV Shop-Daten jetzt bereinigst, übernimmt das PIM keine Fehler, die zu falsch angezeigten Produkten, Problemen bei der Suche oder unzufriedenen Kunden führen könnten. Zur Bereinigung kann gehören, doppelte Produkte zusammenzuführen, Attributwerte zu vereinheitlichen oder veraltete Einträge zu entfernen. Ein sauberer Datensatz vereinfacht den ersten Datenimport in dein PIM und sorgt dafür, dass spätere Synchronisierungen auf einer verlässlichen Grundlage laufen.

API-Zugangsdaten von CCV Shop prüfen

Ein PIM-System muss sich mit deinem CCV Shop verbinden, um Produktinformationen zu synchronisieren. Stelle sicher, dass der API-Zugang korrekt eingerichtet ist.

1. Melde dich als Administrator im Backend von CCV Shop an.
2. Navigiere zu 'Startpunt > Mijn webshop > API-koppelingen'.
3. Prüfe, ob bereits ein API-Schlüssel existiert. Falls ja, kontrolliere, dass sein 'Status' aktiv ist, und sieh dir die zugehörigen Berechtigungen an. Er braucht mindestens die Berechtigungen 'Producten lezen', 'Producten schrijven', 'Productcategorieën lezen' und 'Productcategorieën schrijven'.
4. Wenn es keinen API-Schlüssel gibt oder dem vorhandenen Berechtigungen fehlen, klicke auf 'Nieuwe API-koppeling', um einen neuen Schlüssel zu erstellen. Gib ihm einen aussagekräftigen Namen (z. B. 'WISEPIM Integration') und erteile die nötigen Berechtigungen.
5. Notiere dir den erzeugten API-Schlüssel und die URL deines CCV Shops (z. B. yourshopname.ccvshop.nl). Diese Zugangsdaten brauchst du für die Konfiguration deines PIM-Systems.

Ergebnis: Dein CCV Shop-API-Schlüssel ist aktiv und hat die nötigen Berechtigungen, damit sich dein PIM-System verbinden und Produktdaten verwalten kann.

PIM-System für CCV Shop konfigurieren

Nachdem du deine CCV Shop-Umgebung vorbereitet hast, konfigurierst du dein PIM-System so, dass es mit deinem Shop kommuniziert. Das beginnt mit der Wahl einer PIM-Lösung, die zu deinen geschäftlichen Anforderungen passt. Für viele E-Commerce-Unternehmen bieten Systeme wie WISEPIM Funktionen zur Verwaltung umfangreicher Produktkataloge. Sobald du dein PIM ausgewählt und eingerichtet hast, legst du in der Regel ein neues Projekt oder eine eigene Umgebung für deine CCV Shop-Integration an. So sind alle Produktdaten, Attribute und Workflows für deinen CCV Shop im PIM geordnet und voneinander getrennt.

Kernstück der Integration ist die Konfiguration des CCV Shop-Connectors bzw. Integrationsmoduls in deinem PIM. Dieses Modul verbindet die beiden Systeme. Du trägst die API-Schlüssel und Endpoint-URLs von CCV Shop in die Konfigurationseinstellungen des PIM ein. Diese Zugangsdaten, zu denen eine Client ID und ein Client Secret gehören, berechtigen das PIM-System, sicher auf Produktdaten in deinem CCV Shop zuzugreifen und sie zu ändern. Die Endpoint-URLs leiten das PIM zu den richtigen API-Diensten für den Datenaustausch. Diese Angaben genau einzutragen ist entscheidend für eine stabile und sichere Verbindung.

Wenn die Verbindung steht, legst du deine Strategie für den ersten Import der Produktdaten aus CCV Shop ins PIM fest. Dieser erste Import füllt dein PIM mit deinem bestehenden Produktkatalog und schafft die Grundlage für alle künftigen Anreicherungen und Synchronisierungen. Überlege, welche Produkttypen, Kategorien, Attribute und Sprachen du zuerst importieren willst. Du könntest zum Beispiel mit allen aktiven Produkten samt Basisbeschreibungen, Preisen und Lagerbeständen beginnen. Ein durchdachter Import stellt sicher, dass dein PIM dein aktuelles Sortiment korrekt abbildet, bevor du die Produktinformationen im PIM selbst ausbaust. Dieser Schritt ist wichtig für einen reibungslosen Übergang und hilft, Datenabweichungen früh im Integrationsprozess zu vermeiden.

WISEPIM für den ersten Produktimport aus CCV Shop konfigurieren

Ein Händler, 'Outdoor Gear Pro', nutzt CCV Shop und möchte seine Produktdaten in WISEPIM zentralisieren. Dazu muss er den WISEPIM-Connector so konfigurieren, dass er bestehende Produktinformationen aus seinem CCV Shop abruft.

1. Melde dich bei deiner WISEPIM-Instanz an und navigiere zum Bereich 'Integrations' (Integrationen).
2. Wähle den 'CCV Shop Connector' und starte die Einrichtung.
3. Trage die 'Client ID', das 'Client Secret' und die 'API Endpoint URL' aus deinem CCV Shop-Backend in die entsprechenden Felder in WISEPIM ein.
4. Konfiguriere die Einstellungen für den ersten Import so, dass alle in CCV Shop als 'active' markierten Produkte abgerufen werden, einschließlich Namen, Beschreibungen, SKUs, Preisen und Hauptbildern.
5. Speichere die Konfiguration und führe einen Verbindungstest durch, um zu prüfen, ob WISEPIM und CCV Shop erfolgreich kommunizieren.

Ergebnis: Das WISEPIM-System verbindet sich erfolgreich mit dem CCV Shop von 'Outdoor Gear Pro' und importiert alle aktiven Produkte mit ihren Kernattributen, bereit für die Anreicherung.

Dieses JSON-Snippet zeigt eine typische Konfigurationsstruktur, in der die CCV Shop-API-Zugangsdaten und der API-Endpoint in den Connector-Einstellungen eines PIM-Systems gespeichert werden. Ersetze die Platzhalterwerte durch deine echte Client ID, dein Client Secret und die richtige API-Endpoint-URL für deine CCV Shop-Instanz.

{

"ccvShop": {

"clientId": "your_ccvshop_client_id",

"clientSecret": "your_ccvshop_client_secret",

"apiEndpoint": "https://api.ccvshop.nl/v1/"

}

}

Datenmapping und Synchronisierung einrichten

Ein wirksames Datenmapping ist die Grundlage für eine erfolgreiche PIM-Integration mit CCV Shop. Dabei verknüpfst du bestimmte Attribute aus deinem PIM-System mit den passenden Produktfeldern in deiner CCV Shop-Umgebung. So wird zum Beispiel das Attribut 'Product Name' deines PIM direkt dem Feld 'Title' in CCV Shop zugeordnet und 'Product Description' dem Feld 'Description'. Über die Basisfelder hinaus musst du auch Attribute für komplexe Datentypen mappen, etwa Produktvarianten (SKUs für Größe, Farbe oder Material), mehrsprachige Inhalte und Rich Media wie Bilder und Videos. Achte bei Varianten darauf, dass die Variantenstruktur deines PIM dazu passt, wie CCV Shop Produktoptionen abbildet; oft ist dafür eine Parent-Child-Beziehung oder ein bestimmtes Attributset nötig. Bei mehrsprachigen Inhalten ordnest du jede Sprachversion (z. B. 'Description_EN', 'Description_NL') dem jeweiligen Sprachfeld in CCV Shop zu und stellst sicher, dass dein PIM diese lokalisierten Attribute unterstützt.

Wenn das Mapping steht, legst du deine Synchronisierungsregeln fest. Sie bestimmen, wie und wann Produktinformationen von deinem PIM zu CCV Shop gelangen. Gängige Methoden sind geplante Aktualisierungen und Echtzeit-Aktualisierungen per Webhook. Geplante Aktualisierungen eignen sich für Massenübertragungen oder weniger zeitkritische Änderungen, etwa tägliche Bestandsupdates oder wöchentliche Katalogaktualisierungen. Du könntest dein PIM zum Beispiel so einstellen, dass es jede Nacht um 2 Uhr alle Produktdaten an CCV Shop überträgt. Für kritische, zeitkritische Daten wie Preisänderungen oder Lagerbestände ist die Echtzeit-Synchronisierung per Webhook wirksamer. Ändert sich ein Produktattribut im PIM, sendet ein Webhook sofort eine Benachrichtigung samt aktualisierten Daten an einen festgelegten Endpoint in CCV Shop, sodass dein Onlineshop immer die aktuellsten Informationen zeigt.

Klare Strategien zur Konfliktlösung sind entscheidend, um Abweichungen zwischen deinen PIM- und CCV Shop-Daten zu handhaben. Datenkonflikte können entstehen, wenn Produktinformationen nach der PIM-Integration manuell direkt in CCV Shop geändert werden oder wenn verschiedene Systeme Daten in beide Plattformen einspeisen. Eine gängige Strategie ist, das PIM für die meisten Produktdaten als 'Single Source of Truth' festzulegen, sodass PIM-Daten die CCV Shop-Daten bei der Synchronisierung immer überschreiben. Für bestimmte Felder wie 'Lagerbestand' oder 'Kundenbewertungen', die vor allem in CCV Shop oder einem ERP entstehen oder aktualisiert werden, kannst du die Synchronisierung jedoch so einstellen, dass die CCV Shop-Daten Vorrang haben oder Änderungen intelligent zusammengeführt werden. Dokumentiere diese Regeln klar, um Datenverlust und Inkonsistenzen zu vermeiden.

Benutzerdefinierte Attribute mappen und die Preissynchronisierung planen

Ein Möbelhändler verwaltet seine Produktdaten mit WISEPIM. Er möchte ein benutzerdefiniertes Attribut 'Material' (z. B. 'Oak', 'Pine', 'Metal') aus WISEPIM einer filterbaren Produkteigenschaft in CCV Shop zuordnen. Außerdem sollen tägliche Preisaktualisierungen aus seinem ERP, die in WISEPIM verwaltet werden, mit CCV Shop synchronisiert werden.

1. Stelle in WISEPIM sicher, dass das Attribut 'Material' definiert und für die relevanten Produkte befüllt ist.
2. Navigiere in CCV Shop zu 'Producten' > 'Producteigenschappen' und lege eine neue Eigenschaft namens 'Materiaal' an. Stelle sie als filterbar ein.
3. Ordne in den Einstellungen deiner PIM-Integration das WISEPIM-Attribut 'Material' der CCV Shop-Eigenschaft 'Materiaal' zu.
4. Richte in WISEPIM eine tägliche geplante Synchronisierung ein, die Produktdaten einschließlich des Attributs 'Material' und der Preisaktualisierungen an CCV Shop überträgt. Lass die Synchronisierung jede Nacht um 03:00 Uhr laufen.
5. Stelle bei Preisaktualisierungen sicher, dass die Synchronisierungsregel für das Feld 'Price' den WISEPIM-Daten Vorrang gibt, damit manuelle Änderungen in CCV Shop den maßgeblichen Preis aus dem PIM nicht überschreiben.

Ergebnis: Das Attribut 'Material' aus WISEPIM wird in CCV Shop korrekt als filterbare Produkteigenschaft angezeigt, und die täglichen Preisaktualisierungen aus WISEPIM werden genau übernommen.

Dieser JSON-Payload zeigt eine typische Webhook-Benachrichtigung, die ein PIM-System an CCV Shop sendet, wenn Preis, Bestand oder Material eines Produkts aktualisiert wird. Das Feld 'event' gibt die Art der Änderung an, 'product_id' kennzeichnet das betroffene Produkt, und das Objekt 'data' enthält die aktualisierten Attribute mit ihren neuen Werten. Der 'timestamp' zeigt, wann die Aktualisierung stattfand.

{

"event": "product_updated",

"product_id": "SKU-12345",

"data": {

"price": 129.99,

"stock_quantity": 50,

"material": "Oak"

},

"timestamp": "2023-10-27T10:30:00Z"

}

Testen, validieren und live gehen

Nachdem du dein PIM-System konfiguriert und das Datenmapping eingerichtet hast, sind gründliche Tests und Validierung vor dem vollständigen Rollout entscheidend. Beginne mit kleinen Tests an einer Teilmenge deiner Produkte. Wähle eine vielfältige Auswahl, darunter einfache Artikel, Produkte mit Varianten und Artikel aus verschiedenen Kategorien. So erkennst du mögliche Probleme früh, ohne deinen gesamten Produktkatalog zu beeinträchtigen. Teste zum Beispiel Produkte mit komplexen Attributsets oder besonderen Bildanforderungen, um sicherzustellen, dass das Mapping sie korrekt verarbeitet. Die Synchronisierungsprotokolle von WISEPIM liefern detaillierte Rückmeldungen zum Übertragungsstatus jedes Produkts, was bei der Fehlersuche hilft.

Sobald die erste Synchronisierung abgeschlossen ist, prüfe die Daten in deiner CCV Shop-Umgebung sorgfältig. Kontrolliere Produkttitel, Beschreibungen, Preise, Lagerbestände und SKU-Werte. Prüfe, ob alle Bildlinks funktionieren und die richtigen Bilder zeigen. Achte genau auf Attributwerte: Sie müssen korrekt übertragen und wie erwartet angezeigt werden, besonders bei benutzerdefinierten Attributen. Teste Produktvarianten, um sicherzugehen, dass sie richtig verknüpft und auswählbar sind. Findest du in dieser Phase Abweichungen, passe dein PIM-Mapping oder deine Konfiguration an und teste erneut.

Überwache die erste Synchronisierung auf Fehler und Performance. Sieh dir die Synchronisierungsberichte und Fehlerprotokolle des PIM-Systems an. Achte auf fehlgeschlagene Produktimporte, abgeschnittene Daten oder unerwartete Attributwerte. Bewerte, wie lange die Synchronisierung dauert; das gibt dir eine Schätzung für künftige vollständige Synchronisierungen. Behebe Performance-Engpässe oder wiederkehrende Fehler, bevor du weitermachst. Eine reibungslose erste Synchronisierung spricht für eine robuste Integration.

Nach erfolgreichen kleinen Tests und Validierungen planst du den vollständigen Rollout deiner PIM-Integration und setzt ihn um. Plane die vollständige Synchronisierung außerhalb der Stoßzeiten, um mögliche Auswirkungen auf deinen Live-Shop gering zu halten. Informiere die relevanten Beteiligten über den Rollout-Plan. Prüfe nach der vollständigen Synchronisierung stichprobenartig eine größere Auswahl an Produkten in CCV Shop, um die Datenintegrität im gesamten Katalog zu bestätigen. Danach ist deine PIM-Integration bereit für den Livebetrieb und sorgt für einen schlanken Workflow beim Produktdatenmanagement.

Die Synchronisierung einer neuen Produktkategorie validieren

Ein Modehändler möchte die Synchronisierung einer neuen Kategorie 'Summer Collection' mit 5 Produkten, die jeweils mehrere Farb- und Größenvarianten haben, von WISEPIM zu CCV Shop testen.

1. Filtere in WISEPIM die 5 Produkte der Kategorie 'Summer Collection' und wähle sie aus.
2. Starte eine gezielte Synchronisierung nur dieser ausgewählten Produkte an den CCV Shop-Kanal.
3. Melde dich im Adminbereich von CCV Shop an und navigiere zu 'Products > Overview'.
4. Suche die synchronisierten Produkte und öffne jede Produktseite einzeln.
5. Prüfe Produkttitel, Beschreibung, Preis und Lagerbestand. Kontrolliere, ob das Hauptbild und alle Galeriebilder vorhanden sind und korrekt laden.
6. Bestätige für jede Produktvariante, dass die Attribute 'Color' und 'Size' auf der Produktseite korrekt angezeigt werden und auswählbar sind.
7. Prüfe nach dem Vorgang das WISEPIM-Synchronisierungsprotokoll auf Fehlermeldungen.

Ergebnis: Alle 5 Produkte der Kategorie 'Summer Collection' werden in CCV Shop korrekt angezeigt, mit genauen Titeln, Beschreibungen, Preisen und funktionierenden Bildergalerien. Die Attribute 'Material' und 'Color' sind jeder Produktvariante korrekt zugeordnet.

Die PIM-Integration verwalten und optimieren

Damit deine PIM-Integration mit CCV Shop genau und effizient bleibt, braucht sie kontinuierliche Pflege. Führe regelmäßig Datenaudits durch, um zu prüfen, ob die Produktinformationen in CCV Shop mit dem PIM-System übereinstimmen. Auch Performance-Checks sind wichtig: Überwache Synchronisierungsprotokolle und Antwortzeiten, um Engpässe oder Verzögerungen zu erkennen. Wenn sich dein Produktkatalog weiterentwickelt, aktualisiere dein Datenmapping und deine Synchronisierungsregeln. Führst du zum Beispiel neue Produktlinien oder Attribute wie 'nachhaltige Materialien' oder 'Smart-Home-Kompatibilität' ein, stelle sicher, dass sie korrekt von deinem PIM den passenden Feldern in CCV Shop zugeordnet sind, um Inkonsistenzen zu vermeiden.

Nutze erweiterte Funktionen deines PIM-Systems, um die Integration weiter zu optimieren. Workflows können zum Beispiel die Prüfung und Freigabe neuer Produktdaten automatisieren, bevor sie mit CCV Shop synchronisiert werden, und so die Qualität sichern. Versionierungsfunktionen, wie es sie in WISEPIM gibt, erlauben dir, Änderungen an Produktinformationen über die Zeit nachzuverfolgen. Das liefert eine Änderungshistorie und ermöglicht bei Bedarf ein Zurücksetzen. So behältst du komplexe Produktlebenszyklen im Griff und reduzierst Fehler bei Aktualisierungen.

Bei der Fehlersuche in typischen Synchronisierungsproblemen prüfst du den Status der API-Verbindung, siehst dir die Fehlerprotokolle für bestimmte Produkt-SKUs an und kontrollierst die Datentypen der Attribute. Ein häufiges Problem sind abweichende Datenformate zwischen PIM und CCV Shop, die sich oft durch angepasste Mapping-Regeln oder Datentransformationen im PIM beheben lassen. Regelmäßiger Austausch mit dem Support deines PIM-Anbieters hilft auch bei komplexeren technischen Herausforderungen. Zur kontinuierlichen Pflege der Integration gehört, PIM und CCV Shop aktuell zu halten, Sicherheitsprotokolle zu überprüfen und den Datenfluss von Anfang bis Ende regelmäßig zu testen.