Grundlagen der Synchronisation

Im Shop steht ein anderer Preis als in der Warenwirtschaft, ein gelöschtes Produkt ist wieder da, oder eine von Hand geänderte Beschreibung ist am nächsten Tag wieder die alte. Diese Seite erklärt, wie es dazu kommt, und zwar so, dass Sie die Ursache selbst einordnen können, auch ohne technischen Hintergrund.

Schnittstellen sind komplex, weil sie Systeme mit jeweils eigener Logik und eigenem Datenbestand verbinden. In der Praxis erleben wir deshalb immer wieder, dass bei einer Abweichung vorschnell die Schnittstelle als Ursache vermutet wird, sei es durch interne Beteiligte oder durch externe IT-Dienstleister. Liegt die tatsächliche Ursache dann in der Warenwirtschaft oder im Shop, kostet das zusätzlichen Analyseaufwand, Sie ebenso wie unseren Support. Damit wir TRADElube zu fairen Konditionen und nachhaltig betreiben können, ist es hilfreich, wenn wir mit solchen Situationen gemeinsam zielgerichtet umgehen. Dazu soll diese Seite beitragen, durch Transparenz, technisches Basiswissen und nachvollziehbare Beispiele.

Was bedeutet „Synchronisation“?

Synchronisation bedeutet in TRADElube, dass Daten aus einer Quelle, etwa der Warenwirtschaft oder einer Importdatei, verarbeitet und mit einem Zielsystem abgeglichen werden, etwa einem Shop wie Shopware, WooCommerce oder Shopify. Dabei sorgt TRADElube dafür, dass der Datenbestand im Zielsystem dem entspricht, was aktuell als „gültig“ in TRADElube vorliegt.

Was dabei geschieht, stellen Sie je Aufgabe ein:

• Welche Felder synchronisiert werden und welche nicht,
• ob ein Feld immer überschrieben wird, nur bei der Neuanlage eines Produkts, oder gar nicht,
• ob eigene Skripte die Daten unterwegs verändern,
• welche Datensätze betroffen sind, also Produkte, Kategorien, Hersteller oder Medien.

Hinweis: Im Folgenden ist meist von „Produkten“ die Rede, weil das der häufigste Fall ist. Die beschriebenen Prinzipien gelten sinngemäß auch für Kategorien, Hersteller, Medien und die übrigen Objekttypen, die TRADElube synchronisiert.

Warum stimmen Daten im Shop manchmal nicht mit den Erwartungen überein?

Es gibt verschiedene Gründe, warum sich der Datenbestand im Shop „falsch“ anfühlen kann. Die häufigsten Ursachen sind:

1. Manuelle Änderungen im Shop

Wenn Sie im Shop manuelle Änderungen an einem Produkt vornehmen, etwa an der Beschreibung, dem Lagerbestand oder dem Preis, und diese Felder nicht ausdrücklich von der Synchronisation ausgeschlossen wurden, können diese Änderungen später durch TRADElube wieder überschrieben werden. Das geschieht nicht sofort, sondern erst dann, wenn TRADElube eine Änderung an diesem Produkt registriert, zum Beispiel durch einen Import aus der Warenwirtschaft oder eine Bearbeitung innerhalb von TRADElube. Dann wird das betroffene Produkt erneut vollständig mit dem Shop abgeglichen, und Ihre manuelle Änderung ist gegebenenfalls wieder weg.

Wichtig zu verstehen ist: TRADElube überwacht das Shopsystem nicht permanent und kann nicht erkennen, wenn dort von Hand etwas geändert wird. Die Synchronisation erfolgt immer auf Grundlage der in TRADElube bekannten Daten und nicht durch einen Abgleich mit dem aktuellen Zustand im Shop. Technisch wäre eine permanente Überwachung des Shopsystems auch kaum praktikabel, da dies bedeuten würde, regelmäßig über die Schnittstelle (API) sämtliche Produkte im Shop durchzugehen, was zu erheblichem Aufwand und unnötiger Systemlast führen würde.

Je nach Konfiguration greift außerdem die Erneuerungszeit der Aufgabe: Dabei wird ein Produkt nach einer festgelegten Zeitspanne, etwa einer Woche, auch ohne erkennbare Änderung erneut synchronisiert, um die Daten im Shop aufzufrischen. Näheres unter Aufgaben. Auch dabei kann eine manuelle Änderung überschrieben werden.

Lösung: Besprechen Sie mit uns, welche Felder von Hand gepflegt werden sollen. Diese lassen sich in der Konfiguration ausdrücklich ausschließen, und für die meisten Zwischenfälle findet sich eine Regel, die den Wert aus dem Shop stehen lässt.

2. Wiederherstellung alter Datenbestände (z. B. durch ein Backup)

Eine häufige, aber schwer nachvollziehbare Fehlerquelle ist die unbemerkte Rücksicherung eines veralteten Shop-Backups. Dadurch können Produkte, Kategorien oder Medien wieder erscheinen, die aus Sicht von TRADElube schon längst gelöscht oder geändert wurden.

TRADElube erkennt diese Daten nicht mehr als gültig, weil sie bereits als gelöscht registriert sind. Sie werden deshalb nicht erneut gelöscht und führen zu Abweichungen.

Wichtig: Das bedeutet nicht, dass jemand „schuld“ ist. Manchmal wird ein Backup von einem dritten IT-Dienstleister aus gutem Grund eingespielt, ohne dass der Zusammenhang mit TRADElube bedacht wird. Die Abweichung entsteht trotzdem und muss technisch korrigiert werden.

Lösung: Sprechen Sie uns an, dann stoßen wir einen vollständigen Neuabgleich an. Produkte, die in TRADElube gelöscht sind und durch das Backup wieder im Shop stehen, müssen dabei von Hand entfernt werden, denn TRADElube kennt sie nicht mehr.

3. Fehlerhafte Daten aus der Quelle (z. B. Warenwirtschaft)

Ein weiterer häufiger Grund für unerwartete Daten im Shop liegt nicht in der Schnittstelle, sondern in den Quelldaten, also etwa in der Warenwirtschaft. Wenn dort der Preis, der Lagerbestand oder eine Kategorie falsch gepflegt ist, übernimmt TRADElube diese Daten korrekt, auch wenn das Ergebnis im Shop dann falsch aussieht.

Der Fehler ist dabei nicht immer in der Warenwirtschaft selbst sichtbar. Häufig verursacht ihn erst die herstellerspezifische Schnittstellensoftware, die zwischen der Warenwirtschaft und TRADElube steht. Für TriData ist dieser Zusammenhang unter TriData anbinden beschrieben.

TRADElube kann also nur die Daten synchronisieren, die es erhält, und wenn diese fehlerhaft sind, wird der Fehler in den Shop übernommen.

Beispiel: In der Warenwirtschaft ist ein Artikel mit 0 Stück lagernd geführt, obwohl tatsächlich noch Ware verfügbar wäre. TRADElube übernimmt diesen Bestand und trägt ihn korrekt in den Shop ein. Der Fehler liegt daher nicht an der Schnittstelle, sondern an der Ausgangsdatenquelle.

Lösung: TRADElube zeichnet je Datensatz und Feld auf, welcher Wert wann wohin übertragen wurde. Damit sehen Sie selbst nach, ob der Wert schon falsch geliefert wurde oder erst unterwegs falsch geworden ist. Wie das geht, steht unter Nachverfolgung.

4. Drittanbieter-Systeme oder Plugins

Auch Plugins oder automatische Prozesse innerhalb des Shopsystems, etwa Preisregeln, Caching oder Hintergrund-Jobs, können Shopdaten verändern oder überschreiben. Diese Änderungen finden außerhalb von TRADElube statt und sind für die Schnittstelle aus demselben Grund nicht sichtbar wie eine Änderung von Hand: TRADElube synchronisiert, was ihm bekannt ist, und liest den Shop nicht dauernd aus.

Die Rolle der Konfiguration

Was, wann, wie und in welche Richtung synchronisiert wird, ist nicht zufällig, sondern je Aufgabe eingestellt. Genau darin liegt die Stärke, und genau darin liegt auch der Preis: Was nicht eingestellt ist, geschieht nicht, und was eingestellt ist, geschieht auch dann, wenn Sie es im Einzelfall anders gewollt hätten.

Nur durch eine saubere Abstimmung und Dokumentation der Konfiguration lässt sich sicherstellen, dass

• Felder korrekt aktualisiert werden,
• manuelle Änderungen im Shop nicht ungewollt überschrieben werden,
• Daten nicht doppelt oder versehentlich gelöscht werden,
• individuelle Geschäftsregeln, etwa Preis- oder Textlogiken, berücksichtigt sind.

Wichtig: Wenn TRADElube „etwas anderes tut als erwartet“, liegt das in den meisten Fällen daran, dass die Erwartung noch nicht in der Konfiguration abgebildet ist.

Empfehlungen für den Alltag

• 🔄 Vermeiden Sie manuelle Änderungen im Shop, wenn diese nicht ausdrücklich durch die Konfiguration ausgenommen wurden.
• 💾 Klären Sie Wiederherstellungen von Backups vorher ab, bevor TRADElube wieder aktiv synchronisiert.
• 🧾 Nutzen Sie die Nachverfolgung, um eine Abweichung bis zu ihrem Ursprung zurückzuverfolgen.
• 🛠️ Melden Sie Unstimmigkeiten sachlich, ohne Vorverurteilung der Schnittstelle. Wir unterstützen Sie bei der Ursachenanalyse.
• 📘 Dokumentieren Sie Ihre Geschäftslogik und individuellen Konfigurationen, um Fehlverhalten früh zu erkennen oder zu vermeiden.

Im Zweifelsfall wenden Sie sich an uns. Wir helfen gerne bei der Optimierung Ihrer Konfiguration und der Analyse unerwarteter Effekte.