Datenfeed: Warenbestand in Smartfit Software

Dieses Dokument beschreibt den Produktdatenfeed, über den Händler ihre Produkt-, Preis- und Bestandsdaten automatisiert an die Smartfit POS-Software übergeben. Der Feed ermöglicht es, Fahrräder und Größenvarianten in Smartfit mit aktuellen Preisen, Verfügbarkeiten und standortbezogenen Beständen anzuzeigen.

Der Datenfeed besteht aus einer strukturierten CSV- oder XML-Datei, in der jede Zeile bzw. jeder Knoten eine Kombination aus Produkt, Größe und Standort abbildet. Die Zuordnung zu den Smartfit Produktdaten erfolgt über globale Identifikatoren wie GTIN oder MPN. Pro Smartfit Software-Lizenz kann eine Feed-URL hinterlegt werden, die regelmäßig abgerufen und eingespielt wird.

Kernpunkte des Produkdatenfeeds: – Automatisierte Übertragung von Preisen, Sale-Preisen und Verfügbarkeiten – Standortbezogene Bestandsanzeige für Filialen und Lager – Unterstützung verschiedener Dateiformate (CSV/XML) – Voraussetzung: eindeutige Produktkennungen (GTIN/MPN) – Regelmäßiger Abruf und Synchronisation durch das Smartfit System

Der Feed stellt sicher, dass im Smartfit POS jederzeit aktuelle und vollständige Produktinformationen verfügbar sind und die Beratung auf realen Beständen basiert.

Was wird durch den Datenfeed technisch ermöglicht?

Über den Datenfeed werden folgende Funktionen in der Smartfit Software ermöglicht:

Preise: Sowohl UVP als auch Angebotspreise werden an die Smartfit Software übergeben. Die Preise werden direkt bei der Radauswahl angezeigt und können in derOberfläche gefiltert werden (z. B. nach Preisbereichen).
Verfügbarkeit: pro Größe (SKU)Für jede SKU bzw. jede Größenvariante kann die Verfügbarkeit (Bestand) direkt angezeigt werden. Die Verfügbarkeit ist ebenfalls filterbar, z. B. um nur tatsächlichverfügbare Größen anzuzeigen.
Unterschiedliche Filialen, Verkaufsflächen und Lager: Für unterschiedliche Filialen, Verkaufsflächen oder Lager können jeweils eigene Bestände hinterlegt werden. Diese Bestände sind in der Smartfit Softwaresichtbar und filterbar, sodass gezielt nach verfügbaren Rädern an einem bestimmten Standort gesucht werden kann

1 Überblick

1.1 Was ist ein Produktdatenfeed?

Ein Produktdatenfeed ist eine Datei, in der Ihre Produkte in Tabellenform beschrieben werden.

Jede Zeile steht für einen Artikel bzw. eine Größenvariante (z. B. ein bestimmtes Bike in Größe L).
Jede Spalte steht für ein Merkmal des Artikels (z. B. Titel, Marke, Größe, Preis, Bestand, Standort).

Ihr Kassen‑, Warenwirtschafts‑ oder Shopsystem erzeugt diese Datei automatisch und stellt sie unter einer festen URL bereit. Bei der Definition der einzelnen Felder orientieren wir uns am Google Merchant Center Standard (Product data specification). Dadurch können bestehende GoogleShopping Feeds in der Regel mit nur wenigen Anpassungen verwendet werden. Smartfit ruft diese URL regelmäßig ab und aktualisiert so die angezeigten Produkte,Bestände und Preise.

1.2 Unterstützte Dateiformate

Wir unterstützen Produktdatenfeeds in folgenden Formaten:

CSV (Comma Separated Values)
- Textdatei mit Spalten, die durch ein Trennzeichen getrennt sind.
- Unterstützte Trennzeichen: Tab, Leerzeichen, Doppelpunkt, senkrechter Strich (|), Komma, Semikolon.
- Empfohlene Zeichenkodierung: UTF‑8.
XML
- Strukturierte Textdatei mit klar gekennzeichneten Feldern in XML-Tags.
- Wird häufig von Shop‑Systemen und Marktplätzen bereitgestellt.

Wichtig ist, dass für jede Größenvariante ein eigener Eintrag (eine eigene Zeile bei CSV bzw. ein eigener Knoten bei XML) vorhanden ist.

1.3 Aktualisierung und Abrufintervall

Aktuell rufen wir den Datenfeed einmal pro Tag ab und aktualisieren damit die Daten in unserem System. Dieses Intervall werden wir in Zukunft voraussichtlich weitererhöhen, sodass Änderungen an Preisen und Verfügbarkeiten noch zeitnäher übernommen werden.

Die Smartfit Software selbst aktualisiert die Daten bei jedem Neustart: Beim Start des Programms werden die aktuellsten Informationen zu Preisen und Verfügbarkeiten vom Smartfit-System abgerufen und in die Smartfit Software übernommen.

1.4 Einschränkung:

nur Produkte mit globaler Kennung (GTIN/MPN)Die Synchronisation aus dem Produktdatenfeed in die Smartfit Systeme ist nur für Produkte möglich, die auch in unserer zentralen Fahrrad-Produktdatenbankvorhanden sind und sich eindeutig zuordnen lassen. Die Zuordnung erfolgt über einen globalen Identifikator wie GTIN (z. B. EAN) oder – falls keine GTIN vorhanden ist– über eine eindeutige MPN (Manufacturer Part Number) des Herstellers.Produkte, für die im Quellsystem ausschließlich interne Artikelnummern gepflegt sind und für die keine globalen IDs (GTIN/MPN) existieren, können über den Feed nichtmit der Smartfit Software synchronisiert werden. Solche Modelle stehen in der Smartfit Software weiterhin nur auf Basis der integrierten Smartfit Basis-Datenbank zurVerfügung und werden nicht mit Beständen und Preisen aus dem Feed angereichert.Dies betrifft insbesondere Marken ohne GTIN, die mit Baukastensystemen arbeiten (z. B. Riese & Müller, Simplon oder vergleichbare Hersteller).

2 Software-key Zuordnung

2.1 Beziehung zwischen Smartfit Software-Lizenz und Feed

Pro Smartfit Software-Lizenz (Software-Key) kann eine Feed-URL im System hinterlegt werden. Über diese URL werden alle Produkt‑, Preis‑ und Bestandsdaten für

diese Installation geladen.

Wenn in einem Geschäft mehrere Smartfit Software-Installationen bzw. Berater-Lizenzen eingesetzt werden (z. B. mehrere Beratungsplätze), können:

alle Installationen denselben Feed verwenden, wenn Sortiment, Preise und Bestände identisch sind, oder
unterschiedliche Feeds hinterlegt werden, wenn sich z. B. Sortiment oder Preise zwischen einzelnen Systemen unterscheiden sollen.

Dadurch bleibt die Konfiguration flexibel, während die Datenpflege zentral über den jeweiligen Produktdatenfeed erfolgt

3 Aufbau des Produktdatenfeeds

3.1 Zeilenlogik

Pro SKU × Standort gibt es eine Zeile im Feed.
Damit können Bestände und Preise für dasselbe Produkt je Standort unterschiedlich sein.

Beispiel:

SKU AMS-123-48 wird in Freiburg, Basel und im Lager geführt.
Es gibt drei Zeilen mit unterschiedlichem branch und ggf. unterschiedlichem stock und price.

3.2 Standort (Filiale/Lager)

Der Standort wird über eine eigene Spalte abgebildet, z. B. branch.

Typische Werte:
- Filialnamen: Freiburg, Basel
- Lager: Lager, Zentrallager

Die Bezeichnungen sollten konsistent verwendet werden (keine wechselnden Schreibweisen).

Sonderfall – nur eine Quelle: Wenn alle Bestände aus einer einzigen Quelle kommen (z. B. nur ein Lager, keine Filialen), kann die Spalte branch entfallen.In diesem Fall gibt es pro SKU nur eine Zeile.

3.3 Titel und Größe

Im Produktdatenfeed gelten folgende Regeln:

Der Produkttitel (title) enthält keine Größe.
Die Größe wird separat in einem eigenen Feld angegeben (size).

Beispiele:

❌ title = "CUBE AMS Zero99 48"

✅ title = "CUBE AMS Zero99" und size = "48"

Das erleichtert die Zuordnung von Größenvarianten im Smartfit System.

4 Felderübersicht

Hinweis: Es werden hier nur Felder aufgeführt, die für den Smartfit Software POS-Feed relevant sind und in den Unterlagen explizit genutzt werden.

4.1 Felderübersicht Produktdatenfeed

*Wenn alle Bestände aus einer Quelle kommen (z. B. nur eine Niederlassung), kann branch weggelassen werden.

5 Beispiele

5.1 Standortbezogener Bestand

Ein Produkt (SKU AMS-123-48) existiert in mehreren Filialen/Lagern mit unterschiedlichen Beständen:

id;title;size;branch;stock;price

AMS-123-48;CUBE AMS Zero99;48;Freiburg;2;3999.00

AMS-123-48;CUBE AMS Zero99;48;Basel;0;3999.00

AMS-123-48;CUBE AMS Zero99;48;Lager;5;3999.00

Interpretation:

In der Filiale Freiburg sind 2 Stück auf Lager.
In der Filiale Basel ist aktuell kein Bestand.
Im Lager sind 5 Stück verfügbar.
Der Preis liegt überall bei 3.999,00.

5.2 Einfacher Gesamtbestand (ohne branch)

Wenn es nur einen Standort gibt oder alle Bestände zusammengefasst werden, kann branch entfallen:

id;title;size;stock;price

AMS-123-48;CUBE AMS Zero99;48;7;3999.00