» I-SHOP-IN-SHOP » DOWNLOADS » SCHNITTSTELLEN
Daten - Schnittstelle für die Artikelpflege - vom 16.09.2008 (V3.0)
DOWNLOADS: DATENSTRUKTUR | EINBINDUNG in ein CMS | LIEFERANTENVERTRAG |
Für jeden Artikel, der über das i-Shop-in-Shop-System verkauft werden
soll, müssen zunächst die Stamm- und Varianten-Daten
in unsere Datenbank eingespielt werden. Diese Daten
können Sie uns in den Formaten CSV oder XML bzw. mit
Hilfe eines PlugIn breitstellen. Auf Rückfrage stellen
wir auch eine auf Ihr System angepasste SOAP-Schnittstelle
bereit, bzw. betreiben einen Web-Services auf Basis
einer SOAP-Schnittstelle.
Die Datenstruktur entnehmen Sie bite unserer Beschreibung "DATENSTRUKTUR"
PlugIn - Wenn Sie
als Online-Shop Software osCommerce oder xtCommerce bzw.
eine Ableitung davon bei identer Datenbank einsetzen,
können Sie auf
Ihrem Server ein PlugIn einrichten. Dieses Plugin
ist ein Programm mit dem wir einmal täglich Ihre
aktualisierten Artikeldaten einlesen. Sie ersparen
sichmit diesem PlugIn die tägliche Aktualisierung sowie die Einrichtung
einer Schnittstelle. Fordern Sie bitte die Dateien
per e-Mail an.
PlugIn osCommerce | PlugIn xtCommerce
Sie brauchen die Datei nur in das root-Verzeichnis von xtCommerce kopieren
und schon ist die Schnittstelle fertig (Nach dem Downlod
unzip in das root Verzeichnis). Bitte teilen Sie uns zur Sicherheit
das Verzeichnis mit. (z.B.: www.ihrname.de/xtcommerce/ -
wir rufen dann regelmässig die Daten unter www.ihrname.de/xtcommerce/plugin.php ab
und aktualisieren damit automatisch unsere Datenbank.
Unsere Datenschutz-Verpflichtungen beim Umgang mit Ihren Artikeldaten sind in unserem Lieferanten-Vertrag in Absatz 2 ff. und 3 ff. umfassend geregelt.
Sie exportieren täglich die entsprechenden Artikeldaten im CSV- bzw. XML-Format auf ein von uns für Sie eigerichtetes FTP-Verzeichnis auf unserem Server. Alternativ können Sie uns ein FTP- bzw. HTTP-Verzeichnis zur Verfügung stellen, von wo wir täglich die aktualisierten Produktdaten automatisch beziehen und damit unsere Datenbank aktualisieren.
Wenn Sie uns die Daten als XLS-Datei zukommen lassen, so senden Sie uns diese Datei per eMail, damit wir entsprechende Konvertierungs-Maßnahmen ergreifen können. Wenn wir Daten manuell (z.B. Excel-Dateien im Format *.xls oder *.xlsx oder andere Formate wie *.pdf oder *.doc) in unsere Datenbank einspielen sollen, verrechnen wir diese Arbeiten nach effektivem Aufwand mit € 1,50 /je Minute.
Die einmalige Einrichtung einer Datenschnittstelle kostet € 200.-. Bis 15.11.2008 kostenlos.
DIE SCHNITTSTELLE BRINGT FOLGENDE VORTEILE: Die Daten aus einer fremden Datenbank können jederzeit in die i-Shop-in-Shop-Datenbank eingespielt werden Für automatische Aktualisierungen müssen die aktuellen Daten nur unter einer Adresse bereitgestellt werden. Täglich oder wöchentlich werden diese Daten von unserem Robot an der zuvor bestimmten Adresse abgeholt und die Daten in die Datenbank automatisch übernommen
Unsere Datenschutz-Verpflichtungen beim Umgang mit Ihren Artikeldaten sind in unserem Lieferanten-Vertrag in Absatz 2 ff. und 3 ff. umfassend geregelt.
Für jeden Lieferanten wird bei uns eine Datenschnittstelle eingerichtet. In dieser werden die Header (Kopfzeile) unserer Datenstruktur angepasst und eine Produktgruppen Konvertierung eingerichtet. Dazu benötigen wir eine *.csv Datei mit den Produktgruppen, die Sie Ihren Produkten zugeordnet haben. Diese Zuordnung muss auch in den Produkt-Stammdaten enthalten sein. Zur möglichst schnellen und automatischen Abwicklung dieser Datentransfers stellen wir Ihnen eine transparente Datenschnittstelle zur Verfügung. Zweck der Schnittstelle ist die Übernahme von Artikeldaten in die Datenbanken der jeweiligen Plattform.
DATENSTRUKTUR der Datenschnittstelle zum Download
CSV-Datei - Muster zum Download
Um die zu übertragende Datenmenge zu reduzieren, bieten wir die Möglichkeit, dass Sie uns Dateien bereitstellen, welche nur die Änderungen bereits bekannter Artikel beinhalten. Dieses sogenannte inkrementelle Update muss in einer eigens dafür vorgesehenen Daten-Datei gepflegt werden, so dass es zu keinen Überschneidungen der Produkt-Daten kommen kann.
Die Auftragsdaten werden Ihnen per e-Mail, oder auf Anfrage per Datenschnittstelle zur Verfügung gestellt.
Alle anderen Kommunikationen im Zusammenhang mit der Auftragsabwicklung, Reklamationen, Rückware, etc. werden über unsere Lieferanten-Plattform im Online-Shop-System abgewickelt.
Bitte alle Fragen zu DATENSCHNITTSTELLE per e-Mail an Herrn Ballmann übermitteln.
Unternehmensbeschreibung, Zahlungs- und Lieferbedingungen, Bankdaten, Allgemeine Geschäftsbedingungen sind in unserer Datenbank eingetragen und mit Lieferanten-Rechtenfreigegeben. Änderungen sind über die Online-Masken möglich.
Diese Angaben sind nur nötig wenn im eigenen Namen für eigene Rechnung verkauft wird. Wenn i-Shop-in-Shop der Auftragnehmer des Kunden ist, können Teile dieser Angaben entfallen.
Eine Liste aller Artikelgruppen des Lieferanten liegt bei uns als XLS-Datei oder CSV-Datei vor. Wir erstellen daraus eine Übersetzungs-Tabelle in der die Verknüpfung zu unserer Datenbank gepflegt wird.
Es können nur Artikel übernommen werden, bei denen für jede Artikelgruppe eine Entsprechung vorhanden ist.
Die Daten werden im angegebenen Format als CSV-Datei aus der Datenbank des Anbieters exportiert und geprüft. Bei der Erstellung der CSV-Datei achten Sie bitte darauf, dass alle Spezifikationen in der CSV-Datei eingehalten werden.
Die Daten-Datei wird i-Shop-in-Shop in einer zuvor definierten Art und Weise für den Import bereitgestellt.
Nachdem die Datei auf den Server der Seminar-Shop GmbH übertragen wurde, werden die Artikel-Daten mit den bereits vorhandenen Daten in unserer Datenbank verglichen. Wesentlich für diesen Vergleich ist die Artikelnummer eines jeden Artikels. Während dem Import wird nach folgenden Kriterien entschieden:
Im Zuge des Vergleichs werden Datensätze, welche in der neuen Daten-Datei nicht vorhanden sind aus unserer Datenbank als "Ausverkauft" / "Nicht mehr lieferbar" gekennzeichnet und im Online-Shop nicht mehr angezeigt.
Datensätze, welche sich verändert haben, werden aktualisiert. Sollten einzelne Artikel nur kurzfristig nicht angezeigt werden, ist nur die Lagerstückzahl auf 0 zu setzen. Wenn Sie wissen, bis wann der Artikel wieder lieferbar ist, so können Sie uns auch einen Liefertermin bekannt geben, bzw. sagen, wie lange die Besorgung des Artikels ab Bestelleingang benötigen würde.
Neue Datensätze werden der Datenbank hinzugefügt.
Datensätze, die Fehlerhaft sind, werden nicht in die Datenbank eingefügt. In einem Report nach jedem Import können Sie die Fehlermeldungen einsehen und diese in Ihrer Daten-Datei beheben.
Nach dem internen Vergleich werden die Daten in der Seminar-Shop Datenbank automatisch aktualisiert. Es erfolgt seitens i-Shop-in-Shop keine weitere Überprüfung der Daten. Dem Lieferanten wird im Falle eines FTP-Uploads nach Import eine Datei namens "import-status.txt" im FTP-Verzeichnis bereitgestellt, wo die vorgenommenen Änderungen, Löschungen und Fehler detailiert dargestellt werden.
Bei der Erstellung einer CSV-Datei sind unbedingt die Spezifikationen nach den Definitionen einer CSV-Datei exakt einzuhalten. Gleiches gilt auch für den Datenaustausch als XML-Datei.
Sollten beim automatischen Import Fehler festgestellt werden, ist zuerst von Ihnen zu prüfen ob alle Spezifikationen eingehalten wurden. Unsererseits können nur fehlerfreie Daten-Dateien automatisch importieren.
Zeichen-Satz ASCII für Windows Deutsch (kein UniCode)
Eliminierung aller HTML-Tags außer
<b> = Fett schreiben
</b> = Fett schreiben beenden
<i> = Kursiv schreiben
</i> = Kursiv schreiben beenden
<u> = Unterstrichen schreiben
</u> = Unterstrichen schreiben beenden
<br /> = Zeilenschaltung
<p> = Absatzanfang
</p> = Absatzende
Links, bzw. URL-Adressen sind in allen Feldern zu unterlassen.
Die erste Zeile der Tabelle enthält die Feldbezeichnungen, diese müssen unbedingt mit den vorgegebenen Feldbezeichnungen übereinstimmen.
Die Stammdaten müssen je Artikel nur einmal angelegt werden. Ob ein Artikel im Online-Shop angezeigt wird oder nicht, wird über das Feld "FREIGABE" gesteuert, welches Sie in Ihrer Datendatei hinzufügen können und den Inhalt 0 bzw. 1 führen darf.
0 beendet die Freigabe / 1 listet das Produkt im Online-Shop.
Teilen Sie uns alle möglichen Informationen zu einem Produkt aus Ihrer Datenbank mit.
Im Minimum benötigen wir folgende Felder, um Ihre Daten übernehmen zu können:
eindeutige Artikelnummer
Artikel-Bezeichnung
Artikel-Beschreibung (Kurzbeschreibung - werblicher Text, Langbeschreibung alle verkaufsnotwendigen Informationen)
Einkaufs- wie auch Verkaufspreis (Einkaufspreis ohne MwSt., Verkaufspreis inkl. MwSt.)
Mehrwertsteuersatz
Bild zur Veranschaulichung des Artikels (max. 3 Bilder je Artikel)
Wenn Sie den Beschreibungstext in mehreren Feldern gespeichert haben, senden Sie uns alle Felder, wir definieren dann in der Schnittstelle die Zusammenhänge um auch diese Daten im Online-Shop darzustellen.
Wichtig wären zudem Informationen zu folgenden Daten:
Verfügbarkeit in Form von Ampelinformationen (rot= nicht verfügbar, gelb= in Kürze wieder verfügbar, bestellt, grün= auf Lager) oder den aktuellen Lagerbestand. Wir berücksichtigen diese Informationen bei der Bestellung durch einen Kunden.
Lieferzeit ab Auftragseingang. Wenn Artikel nicht mehr auf Lager aber bereits bestellt sind, Angabe eines voraussichtlichen Liefertermins, bis wann kann der Artikel geliefert werden.
Worauf bezieht sich der Preis. Auf ein Stück oder eine Verpackungseinheit mit xx Stück. In welchen Verpackungseinheiten wird geliefert (Bsp.:Karton mit 12 Stk.)
Interessant sind auch: Angaben zu Hersteller, Marke, Herkunftsland, in welche Länder wird geliefert (sollte es Eischränkungen geben, Stichworte je Artikel für die Optimierung im Suchmaschinenmarketing.
Je Artikel können mehrere Varianten erfasst werden. Varianten sind zum Beispiel unterschiedliche Verpackungseinheiten, Farben, Größen oder Mengenrabatte bei Abnahme einer bestimmten Stückzahl. Wird ein Artikel als Einzelstück, im 6er Karton, im 12er Karton und im Überkarton mit 24x 12er Karton angeboten, so kann für jede Abweichung des Grundartikels ein eigener Preis angegeben werden, wobei der Preis pro Stück dabei degressiv sein sollte.
Die Aktualisierung Ihrer Produkt-Daten und den Lagerbeständen kann von unserem Server in einem zuvor definierten Intervall erfolgen. Die Daten werden uns laut der vereinbarten Schnittstelle geliefert und in unsere Datenbank übernommen.
Wir weisen ausdrücklich darauf hin, dass alle Kosten, die uns durch falsche bzw. nicht aktuell gehaltene Artikeldaten entstehen, in vollem Umfang dem Lieferanten in Rechnung gestellt werden.
Für die Übermittlung von Änderungen an Teilen von Daten-Feldern, wie z.B. Einkaufs- oder Verkaufspreis eines Artikels, reicht es aus, eine Daten-Datei mit nur dem einem Datensatz pro Artikel zur Verfügung zu stellen, wo nur die Felder enthalten sind, welche sich geändert haben. Wichtig ist, dass der Datensatz die Artikelnummer des zu ändernden Datensatzes in unserer Datenbank enthält.
Diese Schnittstellen-Beschreibung, sowie deren Daten-Strukturen sind nur für Kunden der Seminar-Shop GmbH frei zugänglich. Eine Nutzung für andere Zwecke ist, soweit nicht anders vereinbart ausdrücklich untersagt. Alle immateriellen Güterrechte sind durch die Seminar-Shop GmbH geschützt.
Für Fragen wenden Sie sich bitte an:
Seminar-Shop GmbH
Ziegeleistrasse 31, A-5020 Salzburg
Tel. +43 (0)662 9396-10 / Fax. +43 (0)662 9396-70
E-Mail: v.iro@seminar-shop.com
www.i-shop-in-shop.com
Weitere Plattformen und Services:
http://www.i-shop-in-shop.com
http://www.delikatessenladen.org
http://www.pro-gesundheit.org
http://www.seminar-shop.com
http://www.tagungs-shop.com
http://www.anzeigen-shop.com
http://www.iro.cc
