Daten - Schnittstelle für
die Artikelpflege

vom 20.11.2006 (V2.0)

I-Shop in Shop powered by Seminar-Shop GmbH
A- 5020 Salzburg,
Ziegeleistrasse 31

Daten - Schnittstelle für die Artikelpflege

vom 20.11.2006 (V2.0)

Gültig für alle Artikel-Einspielungen der i-Shop-in-Shop Plattformen (Delikatessenladen, Pro-Gesundheit, Tagungs-Shop etc.)

1 Anforderungen

1.1. Für jeden Artikel der über das i-Shop-in-Shop System verkauft werden soll müssen zunächst die Artikel-Stammdaten und -Varianten in unserer Datenbank vorhanden sein. Diese können uns in den Formaten *.csv, *.xls oder *.xml übergeben werden. Auf Rückfrage stellen wir auch eine SOAP Schnittstelle zur Verfügung.

Diese Daten können uns per e-Mail oder zum Download von einem Server übergeben werden.

1.2. Ausserdem benötigen wir Aktualisierungsinformationen, immer dann wenn sich an Preisen, Lieferzeit oder Verfügbarkeit etwas geändert hat.

1.3. Die Auftragsdaten werden Ihnen per e-Mail, *.csv, *.xml 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 auf Online-Masken abgewickelt.

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.

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 URL bereitgestellt werden. Täglich oder wöchentlich werden diese Daten von Seminar-Shop an der URL abgeholt und die Daten in der Datenbank automatisch aktualisiert.

- Alternativ können die Daten als Excel-File oder CSV-File per e-Mail an Seminar-Shop gesandt werden. t.ballmann@seminar-shop.com

 

2 Voraussetzungen

Voraussetzungen für eine automatische Artikelpflege sind:

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, entfallen diese Angaben.

 

3 Vorgehensweise

LÖSCHEN: Im Zuge des Vergleichs werden Datensätze, die in der neuen Liste nicht vorhanden sind gelöscht.

AKTUALISIEREN: Datensätze die sich verändert haben werden aktualisiert. Sollten einzelne Artikel nur kurzfristig nicht angezeigt werden, ist unbedingt nur das Flag FREIGABE auf 0 zu setzen. Der Artikel darf nicht aus der Liste genommen werden. Wenn der Artikel einmal gelöscht wurde, erhält er bei Wiederaufnahme eine neue interne ID, d.h. alle alten Statistikdaten stehen für dieses Artikel nicht mehr zur Verfügung.

ANLEGEN: Neue Datensätze werden hinzugefügt.

FEHLER: Datensätze, die Fehlerhaft sind, werden nicht berücksichtigt.

- Nach diesem internen Vergleich werden die Daten in der Seminar-Shop Datenbank automatisch aktualisiert. Es erfolgt seitens Seminar-Shop keine weitere Überprüfung. Der Anbieter erhält nach erfolgreicher Einspielung automatisch ein e-Mail mit der Summe der aktualisierten Datensätze.

- Nachträgliche Änderungen müssen vom Anbieter selbst mit Hilfe der Online-Masken durchgeführt werden. (Stammdaten nach dem LogIn)

 

3. Daten-Austausch Formate

Es sind 3 Files mit Artikeldaten bereitzustellen (siehe unten). Der File-Name sollte die Kunden-Nummer bei Seminar-Shop beinhalten. Bsp.: 32345_stamm.csv, 32345_variant.csv, 32345_aktuell.csv. Die Kundennummer wird Ihnen bei Bedarf von Seminar-Shop mitgeteilt.

CSV _ Datenformat:

Bei der Erstellung der CSV Datei sind unbedingt die Spezifikationen, wie Sie in der Information unter dem folgenden Link definiert sind, exakt einzuhalten.

Infos unter http://de.wikipedia.org/wiki/CSV-Datei

Sollten beim automatischen Import Fehler festgestellt werden, und Sie per e-Mail ein Fehler-Protokoll erhalten, ist zuerst von Ihnen zu prüfen ob alle Spezifikationen eingehalten wurden. Wir unsererseits können nur fehlerfrei Dateien automatisch importieren.

Zusätztlich sind folgende Spezifikationen einzuhalten:

<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

keine URL Adressen!

Die erste Zeile der Tabelle enthält die Feldbezeichnungen, diese müssen unbedingt mit den vorgegebenen Feldbezeichnungen übereinstimmen.

 

Beispieldatei zum Download

 

DATENFILES

Für die Anzeige und laufende Aktualisierung der Daten im Online-Shop stehen 3 Datenstrukturen zur Verfügung

STAMMDATEN - sind die Grunddaten zu jedem Artikel

VARIANTEN - sind Varianten zu einem Artikel. Z.B.: Farben, Verpackungseinheiten, Größen, die einen eigenen Preis haben.

AKTUALISIERUNG - sind jene Daten, die sich laufend verändern können, und daher regelmässig aktualisiert werden müssen, damit es zu keinen Fehlbestellungen im Online-Shop kommt.

1. STAMMDATEN

Die Stammdaten müssen je Artikel nur einmal angelegt werden. Ob der Artikel im Online-Shop angezeigt wird oder nicht wird über das Feld "FREIGABE" gesteuert.

 

Bezeichnung

Pflicht

Beschreibung

PROD_GR

ja

Die Artikelgruppen-ID ist die Zuordnung des Artikels zu einer Artikelgruppe in der Suche nach Artikelgruppen. Einem Artikel kann nur eine Artikelgruppe zugeordnet werden. Artikelgruppen ID finden Sie in jeder Franchise-Linie unter Information für Anbieter /DOWNLOAD unter dem Link ArtikelGRUPPEN-LISTE (Themenzuordnung).Die passende Artikelgruppe suchen und die Nummer eingeben. Z.B:"3630 Balsamico" dann geben Sie hier 3630 ein. Sollte Ihnen eine Artikelgruppe fehlen, bitte den Vorschlag an: marketing@delikatessenladen.org wenn möglich auch einen Vorschlag machen in welche Obergruppe der Vorschlag einzuordnen ist.

Bitte geben sie hier keine Obergruppen ein.

ARTIKELNUMMER

ja

Ihre interne Artikelnummer

EAN-CODE

nein

wenn vorhanden hier die Nummer eingeben

TITEL 

ja

Artikelbezeichnung

KURZBESCHREIBUNG

ja

Die Kurzbeschreibung sollte nicht mehr als 250 Zeichen lang, werblich getextet sein und den User veranlassen auf die Detailseite zu klicken, wo er die detaillierten Informationen vorfindet

BESCHREIBUNG

ja

Hier wird das Artikel detailliert beschrieben.  Der Text sollte alle entscheidungs-relevanten Themen behandeln. Der Kunde muss hier alle Fragen über Wirkung, Vorteile, Hinweise und Contra-Indikationen beantwortet bekommen. Je besser dieser Text umso leichter die Kaufentscheidung. 

Dieser Text kann bis zu 1.500 Zeichen lang sein.

FORMATIERUNG: Dieser Text kann HTML Formatierungen enthalten. Folgende Formatierungen sind zugelassen: 

Überschrift: <h2>Text</h2>

Fettdruck: <b>Text</b>

Kursiv:  <i> Text</i>

Unterstrichen:  <u>Text</u>

Zeilkenumbruch:<br />

Absatz: <p>Text</p>

Bitte beachten Sie, dass jede Formatierung immer richtig abgeschlossen ist. Bei der Datenübernahme müssen wir alle weiteren Formatierungen löschen!

Bei Übernahme von Texten aus einer Webseite(HTML) oder einem Word-Dokument werden beim Kopieren automatisch auch nicht sichtbare Formatierungen nach Excel übernommen, die dann zu Fehlern führen. Deshalb sollten Sie Texte immer vor Übernahme in einem Texteditor von allen Formatierungen befreien. (Format *.txt)  Wenn Sie Fragen dazu haben, setzen Sie sich bitte mit Hr. Thomas Ballmann in Verbindung +43 662 9396-12 oder t.ballmann@seminar-shop.com

STICHWORTE

nein

Geben Sie hier alle Stichworte an unter denen Ihr Artikel gefunden werden soll. Diese Stichworte werden im Sucher ausgewertet und bestimmen auch das Ranking bei der Anzeige der Suchergebnisse.  Die Stichworte werden auch in unserer Such-Maschinen-Optimierung verwendet und dienen den Suchmaschinen als Key-Words. Jedes Stichwort muss mit, oder | getrennt sein.  Es können beliebig viele Stichworte angegeben werden, aber keine Wiederholungen

PREIS

ja

Alle Preise inkl. MWSt. eingeben

SONDERPREIS

nein

Ist hier ein Preis angegeben, so wird der Normalpreis ausser Kraft gesetzt und der SonderPreis wie folgt angezeigt: Jetzt statt .... nur ....

EINKAUFSPREIS

nein

Normalerweise wird der in der Lieferanten-Vereinbarung angegebene %-Satz zur Berechnung des Rabattes bezogen auf den Netto-Verkaufspreis angewendet. Wenn in diesem Feld ein Einkaufspreis angegeben wird, gilt dieser als Grundlage für den Einkaufspreis. Der Einkaufspreis ist grundsätzlich ohne MWSt. auszuweisen. 

PRICE_TYPE

nein

Legt fest ob der Preis für eine Einheit (unit_price) ist oder für alle (total_price).

Werte: unit_price | total_price

MWST_PROZ

ja

den MWSt. Prozentsatz eingeben. Wir benötigen diesen %-Satz um den netto Verkaufspreis für die Provisionsabrechnung zu ermitteln

F_MWST

ja

Preis inkl. (Wert:1) oder exkl. (Wert: 0)[MWST_PROZ].

MENGE

nein

Rohgewicht der Ware wie auf der Verpackung angegeben. Zur Berechnung des Kilo bzw. Liter Preises laut Preisauszeichnungsgesetz. Nur den Wert eingeben. bsp.: 125g = WERT: 125

MENGE_TYP

nein

EINHEITTYP: ist die Einheit im bezug auf das Rohgewicht (Spalte MENGE) bsp.: 125g = WERT: g

Werte:
g, kg, ml, l

VERPAKUNG

nein

Verpackungs-Einheit

Werte:
unit = Einzelstück
cardboard = Karton
pallet = Palette

UNITS

nein

Anzahl der Artikel in der Verpackungseinheit

UNIT_TYPE

nein

Art der Verpackungseinheit

Werte:
unit, bowl, bottle

LAND

ja

Hier das Herkunftsland des Artikels eingeben. Dabei die exakte Bezeichnung in Großschrift laut Internationalen KFZ Kennzeichen verwenden. Liste der Internationalen Kennzeichen. Dieses Feld wird im Sucher verwendet und sollte nach Möglichkeit immer zur Verfügung stehen.

REGION

ja

Hier die Herkunftsregion des Artikels eingeben. Dieses Feld wird im Sucher verwendet und sollte nach möglichkeit immer zur Verfügung stehen. Bsp.: Waldviertel, Champagne, Toskana, etc.

HERSTELLER

nein

Sie können hier den Namen des Herstellers eingeben. Wird hier ein Name eigegeben, so wird in der Detailansicht nur der Name erwähnt.

Wird hier eine Herstellernummer angegeben, so wird aus der Herstellertabelle, der Text der Beschreibung des Herstellers eingefügt. Auf Wunsch legen wir für jeden Hersteller eine kurze Beschreibung an, die dann in der Detailansicht des Artikeles als Herstellerinformation erscheint.

MARKE

nein

Hier können Marken(Handelsmarken)-Bezeichnungen eingetragen werden, die auch vom Sucher berücksichtigt werden..

VERSANDGEWICHT

ja

Gewicht des Artikels in KG inkl. Verpackung und Überverpackung. Aus diesem Feld wird das Gesamtgewicht der Bestellung errechnet und die hohe der Versandkosten.

EXPORT

nein

Wenn Sie selbst Versender sind, können Sie hier angeben in welche Länder Sie liefern. Das Format (ISO-3166-1) sind die internationalen Landeskenzeichen durch Komma getrennt.

VERSANDART

nein

Geben Sie hier die Versandart an. Wird nichts angegeben wird als Default "Paket-Dienst" gesetzt. Mehrfach Auswahl wird durch Komma getrennt. Folgende Werte sind möglich:
3 - Paket-Dienst
2 - Abholung
8 - Spedition

Beispiel: 2, 3
Artikel kann versand oder abgeholt werden.

LIEFERTERMIN

nein

Wenn ein Artikel kurzfristig ausverkauft ist, können Sie hier einen Termin eingeben ab wann der Artikel wieder lieferbar ist. Dieser Termin wird in der Detailansicht dem Kunden angezeigt. Datum ab wann der Artikel wieder Lieferbar ist: Format: YYYY-MM-DD. Im Feld LIEFERZEIT muss dann als Wert "bestellt" eingegeben werden.
Ist ein Artikel erst nach einigen Tagen lieferbar muss hier die Anzahl der Tage eingegeben werden und im Feld LIEFERZEIT "versand in".

LIEFERZEIT

ja

In diesem Feld geben Sie an in welcher Zeit ab Auftragseingang der Artikel kommissioniert und bereit gestellt werden kann. Bei Artikel die immer auf Lager sind, kann sofort eingegeben werden, wenn der Artikel erst von einem Vorlieferanten bestellt werden muss, dessen Lieferzeit. Folgende Werte werden akzeptiert.

sofort
versand in
bestellt

LAGER_STK

nein

nur eingeben wenn beschränkte Mengen verfügbar sind. Das System bucht dann jeden Auftrag von dieser Menge ab. Wenn die Menge 0 ist wird bei dem Artikel "AUSVERKAUFT" angezeigt

FOTO

ja

Das Bild zum Artikel. Es ist jenes Bild, das in der Such-Ergebnisliste angezeigt wird.  Hier tragen Sie entweder den Link ein, unter dem Ihr Foto auf Ihrem Server verspeichert ist. Z.B.: http://www.xxx.de/fotos/bild.jpg  Oder Sie senden uns die Fotos auf einer CD oder zum Download und geben hier nur den Namen des Bildes ein. z.B.: bild.jpg. Wenn Sie Rückfragen haben:
+43 662 9396-12 Thomas Ballmann

FOTO1

ja

Es können maximal 3 Fotos zu einem Artikel angezeigt werden. Die Fotos sollten in einer Breite von 300 px abgespeichert sein, die Höhe ergibt sich dann aus dem Foto. Ein Foto sollte so komprimiert werden, daß es nicht größer als 150 kb groß ist.

In die Spalte tragen Sie entweder den Link ein, unter dem Ihr Foto auf Ihrem Server verspeichert ist. Z.B.: www.xxx.de/fotos/bild.jpg? Oder Sie senden uns die Fotos auf einer CD oder zum Download und geben hier nur den Namen des Bildes ein. z.B.: bild.jpg

FOTO2

nein

 

FOTO3

nein

 

F_FREIGABE

ja

Freigabe Flag: Wert 0=Artikel wird nicht angezeigt, Wert 1=Artikel wird angezeigt. Default wenn keine Eingabe = 1 Artikel wird angezeigt.

 

2. VARIANTEN

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. Z.B. wird das Artikel als EinzelArtikel, im 6er Karton, im 12er Karton und im Überkarton mit 24 12er Karton angeboten. Je Einheit können unterschiedliche Preise angeboten werden, wobei der Stückpreis degressiv sein sollte.

Bezeichnung

Pflicht

Beschreibung

REFERENZ_ARTIKEL

ja

Das ist die Artikelnummer jenes Artikels dem die Variante zugeordnet ist.

ARTIKELNUMMER

ja

Ihre interne Artikelnummer der Variante

EAN-CODE

nein

wenn vorhanden hier die Nummer eingeben

TITEL 

nein

Artikelbezeichnung, bzw. Bezeichnung der Variante

KURZBESCHREIBUNG

nein

Hier wird die Variante kurz beschrieben.

Dieser Text kann bis zu 250 Zeichen lang sein.

BESCHREIBUNG

nein

PREIS 

ja

Alle Preise inkl. MWSt. eingeben

SONDERPREIS

nein

Ist hier ein Preis angegeben, so wird der Narmalpreis ausser Kraft gesetzt und der SonderPreis wie folgt angezeigt: Jetzt statt .... nur ....

EINKAUFSPREIS

nein

 siehe oben

LIEFERTERMIN

nein

Siehe oben

LIEFERZEIT

ja

Siehe oben

LAGER_STK

nein

nur eingeben wenn beschränkte Mengen verfügbar sind. Das System bucht dann jeden Auftrag von dieser Menge ab. Wenn die Menge 0 ist wird bei dem Artikel "AUSVERKAUFT" angezeigt

MENGE

nein

Rohgewicht der Ware wie auf der Verpackung angegeben. Zur Berechnung des Kilo bzw. Liter Preises laut Preisauszeichnungsgesetz. Nur den Wert eingeben. bsp.: 125g = WERT: 125

MENGE_TYP

nein

EINHEITTYP: ist die Einheit im bezug auf das Rohgewicht (Spalte MENGE) bsp.: 125g = WERT: g

VERSANDGEWICHT

ja

Gewicht des Artikels

FOTO

ja

Das Bild zum Artikel. Es ist jenes Bild, das in der Such-Ergebnisliste angezeigt wird.  Hier tragen Sie entweder den Link ein, unter dem Ihr Foto auf Ihrem Server verspeichert ist. Z.B.: http://www.xxx.de/fotos/bild.jpg  Oder Sie senden uns die Fotos auf einer CD oder zum Download und geben hier nur den Namen des Bildes ein. z.B.: bild.jpg. Wenn Sie Rückfragen haben:
+43 662 9396-12 Thomas Ballmann

STICHWORTE

nein

Geben Sie hier alle Stichworte an unter denen Ihr Artikel gefunden werden soll. Diese Stichworte werden im Sucher ausgewertet und bestimmen auch das Ranking bei der Anzeige der Suchergebnisse.  Die Stichworte werden auch in unserer Such-Maschinen-Optimierung verwendet und dienen den Suchmaschinen als Key-Words. Jedes Stichwort muss mit, oder | getrennt sein.  Es können beliebig viele Stichworte angegeben werden, aber keine Wiederholungen

FARBE

nein

Wenn bei der Bestellung eine Farbe angegeben werden muss, so ist hier die Farbe zu erfassen. Je Farbe muss eine eigene Variante erfasst werden.

GROESSE

nein

Wenn bei der Bestellung eine Größe angegeben werden muss, so ist hier die Größe zu erfassen. Je Größe muss eine eigene Variante erfasst werden.

F_FREIGABE

ja

Freigabe Flag: Wert 0=Artikel wird nicht angezeigt, Wert 1=Artikel wird angezeigt. Default wenn keine Eingabe = 1 Artikel wird angezeigt.

3. AKTUALISIERUNG

Bei Änderungen in den unten angeführten Feldern ist so kurzfristig als möglich eine Aktualisierungs-Information auf Ihrem Server bereitzustellen.

Dieses File wird von unserem Server Täglich abgefragt. Dazu ist es notwendig uns auf Ihrem Server einen Zugang einzurichten über den wir dieses File abholen können. Folgende Angaben werden benötigt:

URL Server: http://www.ihrname.com

Zugangsdaten: Benutzer, Passwort

Filename: Produkte_AKTUELL.csv

Auf Wunsch können Sie uns das File auch als Excel-File per e-Mail senden und wir spielen es innerhalb 24 Stunden an Werktagen in die Datenbank ein.

Wir weisen ausdrücklich darauf hin, daß alle Kosten, die uns entstehen, weil Artikeldaten nicht aktuell waren, in vollem Umfang dem Lieferanten in Rechnung gestellt werden. (Provisionen, Rückzahlungskosten, verrechnete Inkasso-Gebühren, Telefonate mit dem Kunden, etc.).

Bezeichnung

Pflicht

Beschreibung

ARTIKELNUMMER

ja

Ihre interne Artikelnummer der Variante

PREIS 

ja

Alle Preise inkl. MWSt. eingeben

SONDERPREIS

nein

Ist hier ein Preis angegeben, so wird der Narmalpreis ausser Kraft gesetzt und der SonderPreis wie folgt angezeigt: Jetzt statt .... nur ....

EINKAUFSPREIS

nein

 siehe oben

LIEFERTERMIN

nein

Siehe oben

LIEFERZEIT

ja

Siehe oben

LAGER_STK

nein

nur eingeben wenn beschränkte Mengen verfügbar sind. Das System bucht dann jeden Auftrag von dieser Menge ab. Wenn die Menge 0 ist wird bei dem Artikel "AUSVERKAUFT" angezeigt

F_FREIGABE

ja

Freigabe Flag: Wert 0=Artikel wird nicht angezeigt, Wert 1=Artikel wird angezeigt. Default wenn keine Eingabe = 1 Artikel wird angezeigt.

4. Auftragsdaten

Die Auftragsdaten werden per e-Mail versandt.

Einen Muster-Auftrag können Sie sich hier ansehen.

5. COPYRIGHT

Alle Rechte Vorbehalten. Diese Schnittstellenbeschreibung sowie deren Datenstruktur ist nur für Kunden der Seminar-Shop GmbH gedacht. Eine Nutzung für andere Zwecke ist ausdrücklich untersagt. Alle Immateriellen Güterrechte sind für 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.wohnenaktuell.at
http://www.rent-a-shop.org
http://www.iro.cc