Dieses Tutorial erklärt, wie du ein Product Information Management (PIM) System mit Lightspeed integrierst. Es behandelt die Vorbereitung deiner Umgebungen, die Konfiguration von Attributen, das Mapping der Daten und die Einrichtung einer laufenden Synchronisation für dein Produktdatenmanagement.
Einführung in die Integration von PIM und Lightspeed
Ein Product Information Management (PIM) System zentralisiert alle produktbezogenen Daten und schafft eine einzige, verlässliche Quelle für deinen E-Commerce-Betrieb. Für Lightspeed-Nutzer sorgt ein PIM-System dafür, dass Produktdaten über alle Vertriebskanäle konsistent, genau und verfügbar sind. Die Zentralisierung verbessert die Datenqualität, reduziert manuelle Fehler und verkürzt die Zeit bis zur Einführung neuer Produkte. Wenn du Produktbeschreibungen, Spezifikationen, Bilder und andere Attribute in einem PIM anreicherst, kann dein Lightspeed-Webshop Kunden ein detaillierteres und ansprechenderes Einkaufserlebnis bieten.
Viele Lightspeed-Webshops tun sich schwer mit der Verwaltung ihrer Produktdaten. Die Daten liegen oft in getrennten Systemen wie Tabellen, ERPs oder Lieferantenportalen, was zu Inkonsistenzen und veralteten Informationen führt. Manuelle Dateneingabe ist fehleranfällig und wird mit wachsendem Katalog immer zeitaufwendiger. Produktinformationen für mehrere Sprachen, Währungen oder Vertriebskanäle zu pflegen, macht die Abläufe noch komplizierter und kann Produktlaunches und Updates verlangsamen. Diese Probleme im Datenmanagement können Geschäftsprozesse und Kundenzufriedenheit beeinträchtigen.
Eine Integration deines PIM-Systems mit Lightspeed vereinfacht diese Prozesse. Dieses Tutorial beschreibt die Schritte, um dein PIM mit deinem Lightspeed-Webshop zu verbinden. Dazu gehören die Vorbereitung deiner Datenumgebung, die Konfiguration der Produktattribute im PIM, das genaue Mapping dieser Attribute auf die Datenstruktur von Lightspeed, ein erster Import deines Produktkatalogs und die Einrichtung einer laufenden Synchronisation, die alle Daten automatisch aktuell hält. Mit diesen Schritten schaffst du einen robusten und effizienten Fluss deiner Produktinformationen.
Lightspeed- und PIM-Umgebung vorbereiten
Bevor du Lightspeed mit einem PIM-System integrierst, bereite beide Umgebungen vor. Erstelle oder besorge zuerst die nötigen API-Schlüssel in deinem Lightspeed-eCom-Backend. Gehe zu "Settings" > "Tools" > "API" (Einstellungen > Tools > API), um einen neuen API-Schlüssel anzulegen. Weise dem Schlüssel beim Erstellen gezielte Berechtigungen zu, mit denen das PIM-System Produktdaten lesen und schreiben darf, darunter Produktdetails, Varianten, Bilder und Kategorien. Wenn du nur die nötigen Berechtigungen vergibst, minimierst du Sicherheitsrisiken. Bewahre diese Schlüssel sicher auf, denn sie gewähren programmatischen Zugriff auf deinen Lightspeed-Shop.
Führe als Nächstes ein erstes Datenaudit in deiner Lightspeed-Umgebung durch. Es hilft dir, bestehende Produktdatenstrukturen, Attributsätze und Kategoriehierarchien zu verstehen. Prüfe, wie Produkttitel, Beschreibungen, SKUs, Preise und Bestände aktuell gepflegt werden. Ermittle, welche benutzerdefinierten Felder oder Attribute bereits im Einsatz sind. Dieser Schritt ist entscheidend für ein genaues Mapping und dafür, welche Daten im PIM angereichert oder standardisiert werden müssen. Wenn du deine aktuelle Datenlandschaft kennst, vermeidest du Mapping-Fehler und sorgst für einen reibungslosen Übergang.
Richte gleichzeitig dein PIM-Konto ein und lege die Grundstruktur deines Produktkatalogs fest. Dazu erstellst du Produktfamilien, Attributgruppen und erste Attribute, die zu deinen Geschäftsanforderungen und den im Lightspeed-Audit ermittelten Daten passen. Nutzt Lightspeed zum Beispiel "Color" und "Size" als Variantenoptionen, stelle sicher, dass diese Attribute auch in deinem PIM definiert sind. WISEPIM ermöglicht eine flexible Anlage und Kategorisierung von Attributen, was hilft, die Daten von Anfang an logisch zu strukturieren. Lege eine klare Produkthierarchie fest, die deine Lightspeed-Kategorien abbildet oder verbessert.
Stelle schließlich sicher, dass alle nötigen Benutzerrollen und Berechtigungen in Lightspeed und in deinem PIM-System konfiguriert sind. Prüfe in Lightspeed, ob der mit dem API-Schlüssel verknüpfte Benutzer die richtigen Zugriffsrechte hat. Lege im PIM Benutzerkonten für die Teammitglieder an, die Produktdaten pflegen, und weise Rollen mit passenden Lese-, Schreib- oder Freigaberechten zu. Eine saubere Rechteverwaltung verhindert unbefugte Datenänderungen und wahrt die Datenintegrität auf beiden Plattformen.
PIM-Kanäle und Attribute für Lightspeed konfigurieren
Bevor du dein PIM mit Lightspeed integrierst, lege in deiner PIM-Lösung einen eigenen Lightspeed-Vertriebskanal an. Dieser Kanal dient als spezifische Ausgabekonfiguration, mit der du Produktdaten genau auf die Anforderungen von Lightspeed zuschneidest. Wenn du die Lightspeed-Daten in einem eigenen Kanal isolierst, wahrst du die Datenintegrität über alle Vertriebsplattformen und stellst sicher, dass Lightspeed nur relevante und korrekt formatierte Informationen erhält. Dieses Setup verhindert Datenkonflikte und strafft die Synchronisation, weil das PIM genau weiß, welche Attribute und Werte es für Lightspeed aufbereiten muss.
Definiere und strukturiere als Nächstes deine Produktattribute im PIM passend zum erwarteten Datenmodell von Lightspeed. Zu den wesentlichen Attributen gehören in der Regel Product Title, Description, Price, Stock Quantity und Images. Darüber hinaus kommen Attribute wie SKU, EAN, Brand, Color, Material und Weight infrage. Entscheidend ist, die verschiedenen Attributtypen in deinem PIM zu verstehen: Text für Kurzbeschreibungen oder Namen, Rich Text für ausführliche, formatierte Produktbeschreibungen, Number für Preise und Bestände, Boolean für Ja/Nein-Werte (z. B. 'Is new product') und Media für Produktbilder und Videos. Jeder Attributtyp im PIM muss logisch einem passenden Feld in Lightspeed entsprechen, damit die Daten korrekt übertragen werden.
Nutze die Möglichkeiten deines PIM, um kanalspezifische Attributvarianten zu verwalten. Eine Produktbeschreibung für einen Printkatalog ist zum Beispiel womöglich zu lang für eine Lightspeed-Produktseite. Dein PIM sollte es dir erlauben, ein kürzeres, kanalspezifisches Attribut Lightspeed Description zu definieren. Ebenso hast du für Lightspeed vielleicht andere Preisstrategien oder Bildanforderungen als für andere Kanäle. PIM-Lösungen wie WISEPIM bieten robuste Funktionen, um solche kanalspezifischen Überschreibungen anzulegen und zu verwalten. So erhält jeder Vertriebskanal optimierte Produktinhalte, ohne doppelte Daten oder manuelle Anpassungen. Dieser Ansatz senkt den Aufwand deutlich, um konsistente und hochwertige Produktinformationen über alle deine E-Commerce-Plattformen hinweg zu pflegen.
Produktdaten für Lightspeed vorbereiten
Ein Unternehmen muss die Daten für ein neues Produkt, 'Luxury Leather Wallet', für seinen Lightspeed-Webshop vorbereiten. Das PIM enthält umfangreiche Produktinformationen, aber Lightspeed verlangt bestimmte Attribute und Formate.
- Lege im PIM-System einen eigenen Kanal 'Lightspeed Webshop' an.
- Definiere im PIM die Kernattribute für die 'Luxury Leather Wallet', darunter: Productnaam (Text), Korte Beschrijving (Rich Text), Prijs (Number), Voorraad (Number), Hoofdafbeelding (Media), Kleur (Text) und Materiaal (Text).
- Fülle die Produktdaten der 'Luxury Leather Wallet' mit Werten wie: 'Luxury Leather Wallet', 'Handcrafted from premium Italian leather...', '€89.99', '150', 'luxury_wallet_main.jpg', 'Black', 'Italian Leather'.
- Mappe das PIM-Attribut Korte Beschrijving auf das Hauptfeld für die Produktbeschreibung in Lightspeed und Hoofdafbeelding auf das Feld für das Hauptbild. Stelle sicher, dass auch andere Attribute wie Prijs und Voorraad auf die jeweiligen Lightspeed-Felder gemappt sind.
Ergebnis: Die Produktdaten der 'Luxury Leather Wallet' sind korrekt strukturiert und bereit für den Export nach Lightspeed. Alle Pflichtfelder sind vorhanden und für den Webshop richtig formatiert.
Die Lightspeed-API mit deinem PIM verbinden
Um die Kommunikation zwischen deinem PIM und Lightspeed herzustellen, trage zuerst die nötigen API-Zugangsdaten in die Integrationseinstellungen deines PIM ein. Dazu gehst du meist in den Bereich 'Connectors' oder 'Integrations' deines PIM-Systems. Dort gibst du den Lightspeed-API-Schlüssel und das API-Secret ein oder, bei OAuth 2.0, die Client ID und das Client Secret aus deinem Lightspeed-Backend. Achte darauf, dass der richtige Lightspeed-API-Endpunkt konfiguriert ist, in der Regel https://api.lightspeed.com/api/. Welche Authentifizierungsmethode du wählst, API-Schlüssel oder OAuth 2.0, hängt von den Sicherheitsanforderungen und den Möglichkeiten deines PIM- und Lightspeed-Setups ab. OAuth 2.0 bietet durch tokenbasierte Authentifizierung mehr Sicherheit und erfordert oft eine in Lightspeed konfigurierte Redirect-URL für den ersten Autorisierungsablauf.
Nachdem du Zugangsdaten und Endpunkt konfiguriert hast, führe in deinem PIM einen Verbindungstest durch. Er prüft, ob dein PIM die Lightspeed-API erreicht und sich mit den angegebenen Daten authentifizieren kann. Ein erfolgreicher Test bestätigt, dass die grundlegende Kommunikationsverbindung steht und der Datenaustausch beginnen kann. Schlägt der Verbindungstest fehl, sind typische Ursachen falsche API-Schlüssel oder Secrets, eine falsch formatierte Endpunkt-URL oder unzureichende API-Berechtigungen in deinem Lightspeed-Konto. Auch Firewall-Beschränkungen auf dem Server deines PIM können ausgehende Verbindungen zu Lightspeed blockieren. Prüfe die Fehlermeldungen deines PIM und schlage die konkreten Fehlercodes in der Lightspeed-API-Dokumentation nach, um Verbindungsprobleme zu diagnostizieren und zu beheben. WISEPIM bietet zum Beispiel detaillierte Logs für API-Verbindungsversuche, die helfen, die genaue Fehlerursache zu finden.
Dieses JSON-Snippet zeigt eine typische Konfigurationsstruktur, um ein PIM per OAuth 2.0 mit der Lightspeed-API zu verbinden. Es enthält den API-Endpunkt, die Authentifizierungsmethode, die Client-Zugangsdaten, eine Redirect-URI für den Autorisierungsablauf und die angeforderten API-Scopes (Berechtigungen).
{
"integrationName": "Lightspeed PIM Connector",
"apiEndpoint": "https://api.lightspeed.com/api/",
"authenticationMethod": "OAuth2.0",
"clientId": "YOUR_LIGHTSPEED_CLIENT_ID",
"clientSecret": "YOUR_LIGHTSPEED_CLIENT_SECRET",
"redirectUri": "https://yourpim.com/integrations/lightspeed/callback",
"scope": "products.read,products.write,categories.read"
}
Produktdaten mappen und transformieren
Nachdem du dein PIM mit Lightspeed verbunden hast, legst du im nächsten Schritt fest, wie Produktdaten zwischen den beiden Systemen fließen. Dieser Prozess heißt Daten-Mapping und verknüpft bestimmte Attribute in deinem PIM mit den entsprechenden Feldern in Lightspeed. Das PIM-Attribut 'short_description' könnte zum Beispiel direkt auf das Lightspeed-Feld 'summary' gemappt werden, während 'long_description' auf 'description' in Lightspeed gemappt wird. Ein durchdachtes Mapping sorgt dafür, dass alle relevanten Produktinformationen, von Basisdaten bis zu reichhaltigen Inhalten, korrekt in deinem Lightspeed-Webshop erscheinen. Dazu gehört auch die Verwaltung von Produktvarianten bzw. SKUs. Jede Variante (z. B. ein T-Shirt in verschiedenen Größen und Farben) braucht eigene Attribut-Mappings, damit Lightspeed alle verfügbaren Optionen und ihre spezifischen Details korrekt anzeigt, etwa variantenspezifische Bilder oder Preise.
Datentransformationsregeln sind entscheidend, um PIM-Daten an die spezifischen Anforderungen von Lightspeed anzupassen. Diese Regeln decken verschiedene Szenarien ab, etwa das Formatieren von Zahlen, das Umrechnen von Einheiten oder bedingte Logik. Ein PIM speichert das Produktgewicht zum Beispiel in Kilogramm, Lightspeed verlangt es aber in Gramm: Eine Transformationsregel rechnet den Wert bei der Synchronisation um. Ebenso kannst du mit bedingter Logik die Sichtbarkeit eines Produkts in Lightspeed anhand seines Bestandsstatus im PIM steuern. Fortgeschrittene PIM-Systeme wie WISEPIM bieten robuste Transformations-Engines, mit denen du mehrere PIM-Attribute zu einem Lightspeed-Feld zusammenfügen kannst, etwa 'brand' und 'model_number' zu einem vollständigen Produkttitel. Das sichert konsistente und genaue Daten über alle Plattformen.
Für eine ansprechende Produktpräsentation ist schließlich das korrekte Mapping und die Optimierung von Medien-Assets unverzichtbar. Bilder und Videos aus deinem PIM müssen auf die Medienfelder von Lightspeed gemappt werden. Dabei stellst du sicher, dass Bild-URLs korrekt verknüpft sind und die Assets die technischen Vorgaben von Lightspeed zu Größe, Auflösung und Format erfüllen. Dein PIM sollte verschiedene Bildvarianten verwalten (z. B. Thumbnails, Hauptbilder, Galeriebilder) und Lightspeed die passenden URLs liefern. Die Optimierung dieser Assets für die Web-Performance, etwa durch Komprimierung ohne Qualitätsverlust, wirkt sich direkt auf die Ladezeiten und das gesamte Nutzererlebnis in deinem Lightspeed-Webshop aus.
Ein Produkt mit Preistransformation und Medien mappen
Ein neues Produkt 'Luxury Watch' soll aus dem PIM in Lightspeed veröffentlicht werden. Das PIM enthält den Produktnamen, eine Kurzbeschreibung, den Preis als Dezimalzahl (z. B. 1299.99) und eine URL für das Hauptbild.
- Mappe das PIM-Attribut 'product_name' auf das Lightspeed-Feld 'title'.
- Mappe das PIM-Attribut 'short_description' auf das Lightspeed-Feld 'summary'.
- Mappe das PIM-Attribut 'retail_price_usd' auf das Lightspeed-Feld 'price'. Wende eine Transformationsregel an, die die Zahl mit zwei Nachkommastellen und einem Komma als Dezimaltrennzeichen formatiert (z. B. wird 1299.99 zu '1.299,99' bei niederländischem Gebietsschema oder zu '1,299.99' bei englischem).
- Mappe das PIM-Attribut 'main_image_url' auf das Lightspeed-Feld 'images[0].src', damit das Hauptbild angezeigt wird.
Ergebnis: Das Produkt 'Luxury Watch' wird in Lightspeed mit dem richtigen Titel, einem formatierten Preis von '1,299.99' und seinem Hauptbild angelegt.
Dieses JSON-Snippet zeigt eine vereinfachte Mapping-Konfiguration. Es enthält direkte Mappings für Produktname und Kurzbeschreibung. Das Attribut 'retail_price_usd' hat eine Transformationsregel, die die Zahl mit zwei Nachkommastellen formatiert, mit einem Punkt als Dezimaltrennzeichen und einem Komma als Tausendertrennzeichen, wie es in vielen internationalen Gebietsschemas üblich ist. 'main_image_url' wird auf den ersten Bildplatz in Lightspeed gemappt.
{
"product_mappings": [
{
"pim_attribute": "product_name",
"lightspeed_field": "title"
},
{
"pim_attribute": "short_description",
"lightspeed_field": "summary"
},
{
"pim_attribute": "retail_price_usd",
"lightspeed_field": "price",
"transformation": {
"type": "format_number",
"parameters": {
"decimals": 2,
"decimal_separator": ".",
"thousands_separator": ","
}
}
}
],
"media_mappings": [
{
"pim_attribute": "main_image_url",
"lightspeed_field": "images[0].src"
}
]
}
Die erste Datensynchronisation durchführen
Nachdem du deinen PIM-Kanal konfiguriert, die Attribute gemappt und die API-Verbindung hergestellt hast, führst du als Nächstes die erste vollständige Datensynchronisation durch. Dabei werden alle ausgewählten Produktdaten aus deinem PIM-System in deine Lightspeed-Umgebung übertragen. Starte die Synchronisation im Integrations-Dashboard deines PIM oder in den Einstellungen des Lightspeed-Kanals. Je nach Größe deines Produktkatalogs kann dieser erste Sync zwischen wenigen Minuten und mehreren Stunden dauern. In dieser Zeit verarbeitet dein PIM-System jedes Produkt, wendet die festgelegten Mapping-Regeln an und sendet die Daten über die Lightspeed-API.
Die Überwachung der Synchronisation ist entscheidend. Die meisten PIM-Systeme, darunter WISEPIM, bieten detaillierte Logs oder ein Echtzeit-Dashboard, in dem du den Status des Syncs verfolgen kannst. Achte genau auf Fehler, Warnungen oder übersprungene Einträge. Typische Probleme sind ungültige Attributwerte, fehlende Pflichtfelder in Lightspeed oder erreichte API-Rate-Limits. Behebe diese Probleme zügig, indem du die Datenqualität im PIM prüfst, dein Mapping anpasst oder die konkreten Fehlercodes in der Lightspeed-API-Dokumentation nachschlägst. Wenn du die Ursache jedes Fehlers verstehst, vermeidest du ähnliche Probleme bei künftigen Synchronisationen.
Prüfe nach Abschluss der Synchronisation die importierten Produktdaten direkt in deinem Lightspeed-Backoffice. Gehe zum Bereich 'Products' (Produkte) und sieh dir eine repräsentative Auswahl von Produkten an. Prüfe Kerndaten wie Produktnamen, Beschreibungen, Preise, Bestände und Kategoriezuordnungen. Kontrolliere außerdem, ob die Produktbilder korrekt verknüpft und angezeigt werden und ob Varianten (z. B. Größen, Farben) richtig strukturiert sind. Prüfe nach dem Backoffice auch den Live-Webshop in Lightspeed, um sicherzustellen, dass die Produkte für Kunden wie erwartet erscheinen. Achte auf Formatierung, Bildqualität und die gesamte Darstellung.
Abweichungen oder fehlende Daten, die du bei der Prüfung findest, erfordern sofortiges Handeln. Bei weitreichenden Problemen pausiere weitere Synchronisationen und überprüfe die Konfiguration deines PIM-Kanals und das Daten-Mapping. Bei einzelnen Problemen kannst du die Daten oft direkt im PIM korrigieren und einen Teil-Sync für bestimmte Produkte auslösen. Wenn du diese ersten Herausforderungen dokumentierst, kannst du dein Integrations-Setup verfeinern und die laufende Datenpflege reibungsloser gestalten. Eine erfolgreiche erste Synchronisation legt das Fundament für genaue und konsistente Produktinformationen über alle deine Vertriebskanäle.
Laufende Synchronisation und Wartung
Nach der ersten Datensynchronisation brauchst du laufende, automatisierte Prozesse, damit die Produktinformationen in Lightspeed aktuell und genau bleiben. Konfiguriere dein PIM-System für inkrementelle Updates, die nur die seit der letzten Synchronisation geänderten Produktdaten übertragen. Dieser Ansatz minimiert API-Aufrufe und optimiert die Performance, sodass dein Lightspeed-Katalog die neuesten Produktdetails aus dem PIM zeigt, ohne dass alle Daten neu geladen werden. Setze Webhooks für einen Datenfluss in Echtzeit oder nahezu Echtzeit ein, bei dem das PIM Updates direkt nach einer Änderung an Lightspeed sendet. Für weniger zeitkritische Daten kannst du alternativ Aufgaben planen, die in regelmäßigen Abständen laufen, etwa täglich oder stündlich, und Batch-Updates verarbeiten.
Proaktives Monitoring ist entscheidend für eine stabile Integration. Prüfe regelmäßig die Synchronisationslogs und Fehlerberichte deines PIM-Systems. Diese Logs liefern detaillierte Einblicke in erfolgreiche Updates, übersprungene Einträge und Fehler, einschließlich konkreter Fehlermeldungen der Lightspeed-API. Behebe gemeldete Fehler zügig, um Datenabweichungen oder unvollständige Produkt-Listings zu vermeiden. Typische Probleme sind ungültige Attributwerte, fehlende Pflichtfelder oder API-Rate-Limits. Eine feste Routine zum Prüfen dieser Berichte hilft, Probleme zu erkennen und zu lösen, bevor sie deinen E-Commerce-Betrieb beeinträchtigen.
Führe regelmäßig Datenaudits direkt in Lightspeed durch, um Datenintegrität und Konsistenz zu prüfen. Vergleiche eine Stichprobe von Produktdaten in Lightspeed mit den Quelldaten in deinem PIM, um sicherzustellen, dass alle Attribute, Bilder und Beschreibungen korrekt dargestellt sind. Dieser Schritt fängt subtile Abweichungen ab, die keinen Synchronisationsfehler auslösen, aber das Kundenerlebnis oder die Auffindbarkeit beeinträchtigen könnten. PIM-Lösungen wie WISEPIM bieten Funktionen wie Datenqualitäts-Dashboards und Versionskontrolle, die das Finden und Korrigieren von Inkonsistenzen erleichtern und diese Audits effizienter machen. Regelmäßige Wartung deiner PIM-Lightspeed-Integration sorgt dafür, dass deine Produktdaten ein verlässlicher Wert für deinen Onlineshop bleiben.
Typische Integrationsprobleme beheben
Bei der Integration eines PIM-Systems mit Lightspeed können verschiedene Probleme auftreten, die den Datenfluss stören. Wenn du typische Probleme und ihre Lösungen kennst, bleibt dein Produktdaten-Workflow effizient. Eine häufige Herausforderung sind die API-Rate-Limits von Lightspeed. Lightspeed begrenzt die Anzahl der API-Anfragen, die eine Anwendung in einem bestimmten Zeitraum stellen darf, um die Systemstabilität zu sichern. Wird das Limit überschritten, kommt der HTTP-Statuscode "429 Too Many Requests" zurück. Um das zu lösen, setze in der Integrationslogik deines PIM eine Exponential-Backoff-Strategie um, die fehlgeschlagene Anfragen nach immer längeren Intervallen wiederholt. Wenn du Produktupdates und Neuanlagen in weniger, größeren Anfragen bündelst, sinkt außerdem die Gesamtzahl der API-Aufrufe. Schlage die konkreten Rate-Limits in der API-Dokumentation von Lightspeed nach, um deine Anfragemuster zu optimieren.
Fehler bei der Datenvalidierung sind eine weitere häufige Integrationshürde. Solche Fehler treten auf, wenn die vom PIM gesendeten Daten nicht den spezifischen Anforderungen von Lightspeed an ein Feld entsprechen. Beispiele sind ein Text-String in einem Feld, das einen Zahlenwert erwartet, ein Wert, der eine Zeichenbegrenzung überschreitet, oder ein fehlendes Pflichtfeld. Die Integrationslogs deines PIM enthalten meist detaillierte Fehlermeldungen von Lightspeed, die das betroffene Attribut und den Fehlergrund nennen. Vergleiche zur Fehlersuche Datentyp und Inhalt des PIM-Attributs mit den Feldvorgaben von Lightspeed. Passe die Datentransformationsregeln in deinem PIM an, damit die Daten den Erwartungen von Lightspeed entsprechen. Verlangt Lightspeed zum Beispiel eine Dezimalzahl für 'price', stelle sicher, dass das PIM Werte mit Komma in Dezimalzahlen mit Punkt umwandelt.
Probleme bei der Bildsynchronisation zeigen sich als defekte Bildlinks, falsche Bildformate oder Bilder, die nicht auf den Produktseiten erscheinen. Lightspeed stellt oft bestimmte Anforderungen an Bild-URLs (z. B. öffentlich zugänglich, bestimmte Dateitypen wie JPG oder PNG). Prüfe, ob die in deinem PIM gespeicherten Bild-URLs korrekt sind und auf erreichbare Ressourcen zeigen. Stelle sicher, dass dein PIM Bilder in Lightspeed-kompatiblen Formaten verarbeitet und exportiert. Werden Bilder extern gehostet, prüfe, ob der Hosting-Server Zugriffe von den Lightspeed-Servern zulässt. WISEPIM lässt sich zum Beispiel so konfigurieren, dass Bilder automatisch skaliert und konvertiert werden, um kanalspezifische Anforderungen zu erfüllen. Das verhindert viele dieser Probleme.
Verbindungsprobleme können schließlich die gesamte Integration unterbrechen. Ursachen können falsche API-Zugangsdaten, Firewall-Beschränkungen im Netzwerk oder vorübergehende Ausfälle sein. Prüfe zuerst, ob API-Schlüssel und Secret, die in deinem PIM für die Lightspeed-Verbindung hinterlegt sind, korrekt sind und die nötigen Berechtigungen haben. Prüfe deine Netzwerkinfrastruktur auf Firewalls oder Proxy-Server, die ausgehende Verbindungen von deinem PIM-Server zu den API-Endpunkten von Lightspeed blockieren könnten. Wenn alle Zugangsdaten und Netzwerkeinstellungen korrekt erscheinen, kann ein vorübergehender Ausfall auf Seiten des PIM oder von Lightspeed die Ursache sein. Behalte dann die Statusseiten der Dienste im Blick.
Einen Validierungsfehler beim Produktgewicht beheben
Du synchronisierst Produktupdates aus deinem PIM nach Lightspeed. Ein Produkt, "Organic Cotton T-shirt", wird nicht aktualisiert, und die PIM-Logs zeigen einen Fehler beim Attribut 'weight'.
- PIM-Integrationslogs prüfen: Öffne die Integrationslogs deines PIM für den Lightspeed-Kanal. Du findest eine Fehlermeldung ähnlich wie "Validation error: 'weight' expects a numeric value, received '0.25 kg'."
- Attributanforderungen von Lightspeed prüfen: Sieh in der API-Dokumentation von Lightspeed oder in deinen Lightspeed-Produkteinstellungen nach. Du stellst fest, dass das Feld 'weight' in Lightspeed eine Dezimalzahl (z. B. 0.25) ohne Einheit erwartet.
- Datentransformation im PIM anpassen: Öffne in deinem PIM den Bereich für Daten-Mapping oder Transformation des Attributs 'weight'. Ändere die Regel so, dass das Suffix " kg" entfernt und der Wert in eine Gleitkommazahl umgewandelt wird. Eine Transformation könnte zum Beispiel "0.25 kg" in "0.25" umwandeln.
- Produkt erneut synchronisieren: Löse für das "Organic Cotton T-shirt" eine erneute Synchronisation von deinem PIM nach Lightspeed aus.
Ergebnis: Das Produkt "Organic Cotton T-shirt" wird in Lightspeed erfolgreich aktualisiert, und das Attribut 'weight' ist korrekt auf 0.25 gesetzt.
