DATEN-SCHNITTSTELLE

SOAP-Schnittstelle

Wir empfehlen bei allen Kommunikationen mit unserem Server, den Einsatz von SOAP. SOAP steht für "Simple Object Access Protocol" und definiert die komplette Datenkommunikation zwischen Ihren und unserem Server.

SOAP gibt explezit das Datenformat vor, in indem die Daten zwischen beiden Servern übermittelt werden. SOAP stellt nicht nur das Datenformat bereit, sondern exportiert ganze Funktionen, welche Ihnen zur Kommunikation mit unserem Server zur Verfügung stehen.

Sie können sich bei SOAP als Schnittstelle komplett sicher sein, dass keine zusätzlichen Fehlerbehandlungen in Ihrem Programm eingebaut werden müssen und Sie immer korrekte Daten erhalten, die in dem Format übertragen werden, wie sie vorgesehen wurden.

XML-Schnittstelle

Wenn Ihr Server / Ihre Application keinen Datenaustausch via SOAP unterstützen sollte, so bieten wir auch die Datenübertragung über reines XML an.

Über unseren eigenen Namespace-Raum propagieren wir unsere eigenen benutzerdefinierte Objekte um Listen und weitere Attribute, um diese verwalten zu können.

Unsere unten aufgeführte Datenschnittstelle beschreibt alle benutzerdefinierten Objekte, welche bei einer XML / SOAP Kommunikation verwendet werden.

Ihr angefertigtes XML-Dokument können Sie anschließend über einen XML-Validator mit Hilfe unserer Dokument-Type-Defination - kurz DTD genannt - validieren lassen, bevor Sie es an unseren Server übermitteln. Sollte es bei der Übermittlung zu Problemen kommen, so werden Sie auf unserem FTP-Server mit einer Datei import-status.txt über die vorhandenen Probleme aufgeklärt.

EXCEL-Schnittstelle

Unsere EXCEL-Schnittstelle dient alleine zur Aktualisierung der Produktdaten. Die Übermittlung von Auftragsstatus, Aufträgen und Reservierungen ist per EXCEL aus organisatorischen Gründen nicht möglich.

Die EXCEL-Schnittstelle dient unter Anderem für den Import von Produktlisten, die in Microsoft Excel erfasst wurden.

Sie erfassen zunächst die Stammdaten Ihrer Artikel in einer Excel-Liste (Download), spielen die Daten über das Menü
"Online-Shop Datenpflege" > "Produkte erfassen / pflegen" > "Produkte aktualisieren" ein.

Danach können Sie die Detailansicht mit unserer QickEdit-Funktion formatieren.

STAMMDATEN-AKTUALISIERUNG

Jeder Artikel muss nur einmal angelegt werden. Ob ein Artikel im Online-Shop dargestellt / gefunden wird und bestellt werden kann, hängt ausschließlich vom Status des Feldes "FREIGABE" ab.

Bezeichnung Datentyp Feldgröße Required Beschreibung
PROD_GR datalist_topicIDs   Yes

Liste von ThemenIDs aus unserem Shop-System.

Abwandlung für EXCEL anstatt SOAP / XML:

Die Produktgruppen-ID ist die Zuordnung des Artikels zu einer bestimmten Artikelgruppe. Einem Artikel können mehrere Artikelgruppen zugeordnet werden. Trennen Sie mehrere Produktgruppen-IDs mit einem Komma.

Die notwendigen Artikelgruppen-IDs finden Sie in jeder Franchise-Linie unter den Menüpunkten "Information für Anbieter", Abschnitt "DOWNLOAD" unter dem Link Artikelgruppen-Liste (Themenzuordnung).

Suchen Sie die passende Artikelgruppe (z.B. 3630 Balsamico). Als Produktgruppen-ID geben Sie die Nummer 3630 an.

Sollte Ihnen eine Artikelgruppe fehlen, so richten Sie Ihren Vorschlag an: kontakt@i-shop-in-shop.com.

Wichtige Information:
Bitte geben Sie hier nur Produktgruppen-IDs der untersten Ebene an.

ARTIKELNUMMER string 64 Yes

Ihre interne Artikelnummer

TITEL string   Yes

Artikelbezeichnung

KURZBESCHREIBUNG string 250 Yes

Die Kurzbeschreibung sollte 250 Zeichen nicht überschreiten und werblich getextet sein, damit sie den Käufer dazu verleiten auf die Detailseite zu klicken.

BESCHREIBUNG string   Yes

Detailierte Beschreibung des beworbenen Artikels.

Der Text sollte alle entscheidungsrelevanten Themen behandeln. Dem Kunden sollen hier alle Fragen über Wirkung, Vorteile, Hinweise und Contra-Indikationen beantwortet werden.

 

Die Artikelbeschreibung kann bis zu 1500 Zeichen umfassen.

FORMATIERUNG:
Der 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 richtig abgeschlossen ist, da es sonst zum Verlust von Formatierungen kommen kann.

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 hierzu haben, setzen Sie sich bitte mit Hr. Thomas Ballmann in Verbindung +43 (0)662 9396 - 12 oder t.ballmann@seminar-shop.com

PREIS double 16,2 Yes

Endkundenpreis

MWST_PROZ double 5,2 Yes

Anfallende MwSt. (Prozentsatz) des Artikels

F_MWST enumeration 0
1
Yes

Definiert, ob der Endkundenpreis als NETTO / BRUTTO angegeben wurde.

Werte:
0 = exkl. MwSt.
1 = inkl. MwSt

VERSANDGEWICHT double 16,3 Yes

Gewicht des Artikels in Kilogramm inkl. Verpackung und Überverpackung. Aus diesem Feld wird das Gesamtgewicht der Bestellung errechnet und damit die Höhe der Versandkosten.

FOTO string   Yes

Das Bild zum Artikel.

Tragen Sie hier den Pfad zum Bild auf Ihrem Server ein.

Wenn Sie Ihre Fotos auf einer CD gespeichert haben, so senden uns diese CD zu, oder stellen Sie uns diese zum Download bereit. In diesem Fall geben Sie nur den Namen des Bildes ein: z.B.: bild.jpg.

Wenn Sie Rückfragen haben, wenden Sie sich bitte an Herrn Ballmann:
Thomas Ballmann: 0043 (0)662 9396 - 12 oder t.ballmann@seminar-shop.com

F_FREIGABE enumeration 0
1
Yes

Freigabe

Verfügbare Werte:
0 = Artikel wird nicht angezeigt
1 = Artikel wird angezeigt

FOTO1 string   Yes

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 der Proportion des Fotos. Ein Foto sollte so komprimiert werden, dass es nicht größer als 300kb ist.

In die Spalte tragen Sie entweder den Link ein, unter dem Ihr Foto auf Ihrem Server gespeichert ist, oder Sie senden uns die Fotos auf einer CD bzw. stellen Sie uns zum Download zur Verfügung und geben in der Spalte nur den Namen des Bildes ein. z.B.: bild.jpg

FOTO2 string   No

Wie bei FOTO1

FOTO3 string   No

Wie bei FOTO1

EAN-CODE long64   No

EAN-Code des Artikels

SONDERPREIS double 16,2 No

Ist hier ein Preis angegeben, so wird der Normalpreis außer Kraft gesetzt und der Sonderpreis wie folgt dargestellt: Statt [PREIS] für [SONDERPREIS]

EINKAUFSPREIS double 16,2 No

Einkaufspreis exkl. MwSt.

Normalerweise wird der in der Lieferanten-Vereinbarung angegebene Prozentsatz zur Berechnung des Rabattes bezogen und auf den Netto-Verkaufspreis angewendet.

Wenn in diesem Feld ein Preis angegeben wird, wird dieser als Einkaufspreis herangezogen.

PRICE_TYPE enumeration unit_price
total_price
No

Der Preistyp legt fest, ob der angegebene Preis sich auf eine Einheit (unit_price) bezieht, oder für alle Artikel in einer Verpackungseinheit (total_price) gilt.

Werte:
unit_price = Endkundenpreis * Verpackungsinhalt
total_price = Endkundenpreis

MENGE long64   No

Nettoverpackungsinhalt der Ware (wie auf der Verpackung angegeben), damit der Kilo- / Literpreis wie vom Preisauszeichnungsgesetz vorgeschrieben, berechnet werden kann.

(Bitte geben Sie hier nur den Wert, ohne Einheit an)

Beispiel:
125g Nettoverpackungsinhalt = 125

MENGE_TYP enumeration

g
kg
ml
l

No

Einheit im Bezug auf den Nettoverpackungsinhalt (Spalte MENGE)

Beispiel:
125g Nettoverpackungsinhalt = g

Verfügbare Werte:
g
kg
ml
l

VERPAKUNG enumeration unit
cardboard
pallet
No

Verpackungseinheit

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

UNITS long64   No

Anzahl der Artikel in der Verpackungseinheit

UNIT_TYPE enumeration unit
bowl
bottle
No

Art der Verpackungseinheit

Werte:
unit = Stück
bowl = Behälter
bottle = Flasche

LAND string 3 No

Herkunftsland des Artikels

Verwenden Sie hier bitte die exakte Bezeichnung in Großschrift laut Internationalen KFZ Kennzeichen. Liste der Internationalen Kennzeichen.

Dieses Feld wird im Sucher verwendet und sollte nach Möglichkeit immer zur Verfügung stehen.

REGION string   No

Herkunftsregion des Artikels

Dieses Feld wird im Sucher verwendet und sollte nach Möglichkeit immer zur Verfügung stehen.

Beispiel:
Waldviertel, Champagne, Toskana, etc.

LINKS datalist_link   No

Fügen Sie URLs / LINKs zu PDF-Dokumenten, ZIP-Archiven usw. hinzu, um dem Kunden Prospekte, Flyer, Datenblätter usw. anbieten zu können.

Abwandlung für EXCEL anstatt SOAP / XML:

In jede Zeile schreiben Sie den Pfad zum Dokument als gültige URL gefolgt von einem Leerzeichen und einer Beschreibung, was den Kunden hinter dem Link erwartet.

Die URL kann relativ angegeben werden, wenn die Daten auf unserem FTP-Server liegen. Verwenden Sie absolute URLs, wenn die Daten von einem externen Server geliefert werden.

Beispiel:
pdfs/datasheed_a823uw2.pdf Datenblatt
pdfs/flyer_a823uw2.pdf Produktbeschreibung

RELATED_ARTIKELNR datalist_related   No

Verlinken Sie den angegebenen Artikel mit Zubehör-Artikel oder Artikel, die für den Endkunden interessant sein könnten.

Abwandlung für EXCEL anstatt SOAP / XML:

Schreiben Sie jeden Artikel in nur eine Zeile.

HERSTELLER string   No

Namen des Herstellers

MARKE string   No

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

EXPORT datalist_export   No

Wenn Sie selbst Zusender sind, können Sie hier angeben in welche Länder Sie den angegebenen Artikel liefern.

Abwandlung für EXCEL anstatt SOAP / XML:

Verwenden Sie hier bitte die exakte Bezeichnung laut Internationalen KFZ Kennzeichen in Großschrift. Liste der Internationalen Kennzeichen.

Format:
LAND[=Versandkosten:Abrechnungsart[|...]

Versandkosten:
Versandkosten als Gleitkommazahl

Abrechnungsart:
lump_sum (einmalige Versandkosten - egal wieviele Artikel bestellt werden)
per_unit (Versandkosten multipliziert mit der bestellten Menge des Artikels)

Beispiel (Einmalige Versandkostenpauschale Deutschland 4,50 EUR / Österrich 9,90 EUR)
D=4,50:lump_sum|A=9,90:lump_sum

VERSANDART datalist_shippingtype 2
3
No

Angabe der möglichen Versandarten.

Abwandlung für EXCEL anstatt SOAP / XML:

Mögliche Versandarten des Artikels.

Wird nichts angegeben, sind alle Auswahlen für den Endkunden verfügbar. Sind mehrere Auswahlen möglich, werden diese durch Kommas getrennt.

Folgende Werte sind möglich:
2 - Abholung
3 - Paket-Dienst

Beispiel (Artikel kann versendet / abgeholt werden)
2,3

TIPP: So können Sie die Verfügbarkeit Ihrer Artikel im Online-Shop darstellen:

Bezeichnung Datentyp Feldgröße Required Beschreibung
LAGER_STK long64   Yes

Beschränkte Mengen auf Lager

Das System bucht nach jeder Bestellung die bestellte Menge von dieser Menge ab.

-1 Bedeutet, dass sich unbeschränkte Mengen von diesem Artikel auf Lager befinden.

LIEFERZEIT enumeration

sofort
versand in
bestellt

Yes

In diesem Feld geben Sie an innerhalb 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

LIEFERTERMIN string   No

Wenn ein Artikel kurzfristig ausverkauft ist, können Sie einen Termin eingeben, ab wann der Artikel wieder lieferbar ist. Wenn ein Produkt exklusiv nach Bestelleingang angefordert wird, können Sie die Anzahl der Tage angeben, die benötigt werden, bis der Artikel vorraussichtlich verschickt wird.

Format 1: YYYY-MM-DD
Im Feld LIEFERZEIT muss als Wert bestellt eingegeben werden

Beispiel:
Ein Arikel ist voraussichtlich vor dem 29.11.2009 nicht
lieferbar: 2009-11-29

Format 2: expression (day|month|year)
Im Feld LIEFERZEIT muss als Wert versand in eingegeben werden

Beispiel:
Ein Artikel kann voraussichtlich erst in 7 Tagen nach Bestelleingang verschickt werden: 7 day

SHOW_STOCK_STYLE enumeration quantity
indicator
No

Legen Sie mit dieser Option fest, ob eine Anzeige der Verfügbarkeit des Artikels stattfinden soll.

quantity
Zeigt die auf Lager verfügbare Stückzahl an

indicator
Zeigt eine reine Textinformation an, ob es beim Bestellen des Artikels zu eventuellen Lieferverzögerungen kommen könnte.

Unser Online-Shop-System zeigt automatisch <= 10 Artikel auf Lager bereits eine Meldung an, dass nur noch wenige Exemplare verfügbar sind. Sobald die Lagerstückzahl <= 5 erreicht, wird der Kunde auf eine eventuell verzögerte Lieferung hingewiesen.

Beispiele:

Leeres Lager + Artikel direkt vom Außenlager lieferbar
LAGER_STK = 0, LIEFERZEIT = "sofort", LIEFERTERMIN = "", F_FREIGABE=1

 

Leeres Lager + Artikel direkt vom Außenlager lieferbar, Lieferzeit unbekannt
LAGER_STK = 0, LIEFERZEIT = "versand in", LIEFERTERMIN = "", F_FREIGABE=1

 

Leeres Lager + Artikel direkt vom Außenlager lieferbar, Lieferzeit bekannt ( 5 Tage )
LAGER_STK = 0, LIEFERZEIT = "versand in", LIEFERTERMIN = "5 day", F_FREIGABE=1

 

Leeres Lager + Artikel im Außenlager bestellt, Liefertermin unbekannt
LAGER_STK = 0, LIEFERZEIT = "bestellt", LIEFERTERMIN = "", F_FREIGABE=1

 

Leeres Lager + Artikel im Außenlager bestellt, Liefertermin bekannt (22.12.2009)
LAGER_STK = 0, LIEFERZEIT = "bestellt", LIEFERTERMIN = "2009-12-25", F_FREIGABE=1

RODUKTVARIANTEN-AKTUALISIERUNG

Je Artikel können mehrere Artikelabweichungen erfasst werden. Varianten sind zum Beispiel unterschiedliche Verpackungseinheiten, Farben, Größen oder Mengenrabatte bei Abnahme einer bestimmten Stückzahl. Felder die keine Daten enthalten übernehmen automatisch den Inhalt des Referenz-Artikels.

Bezeichnung Datentyp Feldgröße Required Beschreibung
REFERENZ_ARTIKEL string   Yes

Ihre interne Artikelnummer des Referenz-Artikels aus den Stammdaten

ARTIKELNUMMER string 64 Yes

Ihre interne Artikelnummer der Variante

PREIS double 16,2 Yes

Endkundenpreis inkl. MwSt.

LIEFERZEIT enumeration

sofort
versand in
bestellt

Yes

In diesem Feld geben Sie an innerhalb 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

LIEFERTERMIN string   No

Wenn ein Artikel kurzfristig ausverkauft ist, können Sie einen Termin eingeben, ab wann der Artikel wieder lieferbar ist. Wenn ein Produkt exklusiv nach Bestelleingang angefordert wird, können Sie die Anzahl der Tage angeben, die benötigt werden, bis der Artikel vorraussichtlich verschickt wird.

Format 1: YYYY-MM-DD
Im Feld LIEFERZEIT muss als Wert bestellt eingegeben werden

Beispiel:
Ein Arikel ist voraussichtlich vor dem 29.11.2009 nicht
lieferbar: 2009-11-29

Format 2: expression (day|month|year)
Im Feld LIEFERZEIT muss als Wert versand in eingegeben werden

Beispiel:
Ein Artikel kann voraussichtlich erst in 7 Tagen nach Bestelleingang verschickt werden: 7 day

VERSANDGEWICHT double 16,3 Yes

Gewicht des Artikels in Kilogramm inkl. Verpackung und Überverpackung. Aus diesem Feld wird das Gesamtgewicht der Bestellung errechnet und damit die Höhe der Versandkosten.

FOTO string   Yes

Das Bild zum Artikel.

Tragen Sie hier den Pfad zum Bild auf Ihrem Server ein.

Wenn Sie Ihre Fotos auf einer CD gespeichert haben, so senden uns diese CD zu, oder stellen Sie uns diese zum Download bereit. In diesem Fall geben Sie nur den Namen des Bildes ein: z.B.: bild.jpg.

Wenn Sie Rückfragen haben, wenden Sie sich bitte an Herrn Ballmann:
Thomas Ballmann: 0043 (0)662 9396 - 12 oder t.ballmann@seminar-shop.com

F_FREIGABE enumeration 0
1
Yes

Freigabe

Verfügbare Werte:
0 = Artikel wird nicht angezeigt
1 = Artikel wird angezeigt

STICHWORTE datalist_keywords   No

Liste von Stichwörtern.

Abwandlung für EXCEL anstatt SOAP / XML:

Schlagworte unter denen Ihr Artikel gefunden werden soll.

Diese Stichworte werden im Sucher ausgewertet und bestimmen auch das Ranking bei der Anzeige der Suchergebnisse.  Die von Ihnen gewählten Schlagworte werden des Weiteren in unserer Such-Maschinen-Optimierung verwendet und dienen als Schlüsselwörter. Jedes Stichwort muss mit "Komma" getrennt werden.

Es können beliebig viele Stichworte angegeben werden. Verwenden Sie auch Synonyme unter denen Ihr Artikel gefunden werden soll, um die Trefferquote zu erhöhen.

EAN-CODE long64   No

EAN-Code des Artikels

TITEL string   No

Artikelbezeichnung

KURZBESCHREIBUNG string 250 No

Die Kurzbeschreibung sollte 250 Zeichen nicht überschreiten und werblich getextet sein, damit sie den Käufer dazu verleiten auf die Detailseite zu klicken.

BESCHREIBUNG string   No

Detailierte Beschreibung des beworbenen Artikels.

Der Text sollte alle entscheidungsrelevanten Themen behandeln. Dem Kunden sollen hier alle Fragen über Wirkung, Vorteile, Hinweise und Contra-Indikationen beantwortet werden.

 

Die Artikelbeschreibung kann bis zu 1500 Zeichen umfassen.

FORMATIERUNG:
Der 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 richtig abgeschlossen ist, da es sonst zum Verlust von Formatierungen kommen kann.

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 hierzu haben, setzen Sie sich bitte mit Hr. Thomas Ballmann in Verbindung +43 662 9396-12 oder t.ballmann@seminar-shop.com

SONDERPREIS double 16,2 No

Ist hier ein Preis angegeben, so wird der Normalpreis außer Kraft gesetzt und der Sonderpreis wie folgt angezeigt: Statt [PREIS] für [SONDERPREIS]

EINKAUFSPREIS double 16,2 No

Einkaufspreis exkl. MwSt.

Normalerweise wird der in der Lieferanten-Vereinbarung angegebene Prozentsatz zur Berechnung des Rabattes bezogen und auf den Netto-Verkaufspreis angewendet.

Wenn in diesem Feld ein Preis angegeben wird, wird dieser als Einkaufspreis herangezogen.

LAGER_STK long64   No

Beschränkte Mengen auf Lager

Das System bucht nach jeder Bestellung die bestellte Menge von dieser Menge ab. Wenn die verfügbare Stückzahl 0 erreicht, wird der Artikel als "AUSVERKAUFT" dargestellt.

MENGE long64   No

Nettoverpackungsinhalt der Ware (wie auf der Verpackung angegeben), damit der Kilo- / Literpreis wie vom Preisauszeichnungsgesetz vorgeschrieben, berechnet werden kann.

(Bitte geben Sie hier nur den Wert, ohne Einheit an)

Beispiel:
125g Nettoverpackungsinhalt = 125

MENGE_TYP enumeration

g
kg
ml
l

No

Einheit im Bezug auf den Nettoverpackungsinhalt (Spalte MENGE)

Beispiel:
125g Nettoverpackungsinhalt = g

Verfügbare Werte:
g
kg
ml
l

FARBE string   No

Farbe des Artikels

GROESSE string   No

Größe des Artikels

AUTOMATISCHE RESERVIERUNG VON ARTIKELN

Sobald unser Kunde seinen Warenkorb abgeschlossen hat, übermitteln wir Ihnen in einem PUSH-Verfahren die zu reservierenden Artikel der aktuell eingegangenen Bestellung. Die Reservierung erfolgt grundsätzlich immer. Mit der Übermittlung des Auftrages bestätigen wir die Bestellung zur weiteren Bearbeitung durch Ihre Logistik.

Das benutzte Datenformat kann dabei zwischen folgenden Formaten gewält werden:
SOAP, XML

Wir empfehlen den Einsatz einer SOAP-Schnittstelle.

Bezeichnung Datentyp Feldlänge Beschreibung
REFERENCE_ID long64  

Unsere interne Bestellnummer, dient für Sie als Referenznummer für zukünftige Kommunikationen über die Datenschnittstelle

ARTICLE datalist_order_article  

Liste aller zu reservierenden Artikel

TTL datatype_interval  

Wie lange sollen die Artikel im System reserviert bleiben

AUTOMATISCHE ÜBERMITTLUNG EINES AUFTRAGS

Sobald unser Kunde seinen Warenkorb mit Sofortzahlung abgeschlossen hat, bzw. ein Vorauskasse-Auftrag bezahlt wurde, übermitteln wir Ihnen in einem PUSH-Verfahren die zu komission freigegebenen Artikel.

Das benutzte Datenformat kann dabei zwischen folgenden Formaten gewält werden:
SOAP, XML

Wir empfehlen den Einsatz einer SOAP-Schnittstelle.

Bezeichnung Datentyp Feldlänge Required Beschreibung
REFERENCE_ID long64   Yes

Unsere interne Bestellnummer, dient für Sie als Referenznummer für zukünftige Kommunikationen über die Datenschnittstelle

COMPANY_NAME string   No Lieferadresse - Firmenname
FIRSTNAME string   Yes Lieferadresse - Vorname
SURNAME string   Yes Lieferadresse - Name
EXTRA_NAME string   No Lieferadresse - Weiterer Name / Bezeichner
STREET string   Yes Lieferadresse - Straße
COUNTRY string   Yes Lieferadresse - Land
ZIP string   Yes Lieferadresse - Postleitzahl
CITY string   Yes Lieferadresse - Stadt
PHONE_NUMBER string   Yes Lieferadresse - Telefonnummer für Versandservice
SELLER_WEBSITE_ID long64   Yes

Website-ID auf der die Bestellung abgelaufen ist

SELLER_URL string   Yes URL zur Website auf der der Verkauf stattgefunden hat
PREFERRED_PARCEL_SERVICE string   Yes Zur Versendung gewählter Versandservice
SHIPPING_COSTS double 16,2 Yes Die von uns berechneten Versandkosten
MINIMUM_ACCOUNTING_COSTS double 16,2 No Die von uns berechneten Extrakosten, wenn der Mindestbestellwert unterschritten wurde
HANDLING_FEES double 16,2 No Versandkostenpauschale
TOTAL_COST double 16,2 Yes Rechnungsbetrag
WITHOUT_TAX enumeration

0
1

Yes Bestimmt, ob es sich bei der aktuellen Bestellung um eine innergemeinschaftliche Lieferung handelt. Wenn JA, dann sind alle Beträge in dieser Übermittlung Netto-Preise, andernfalls Brutto-Preise.
TAX double 16,2 Yes Im Gesamtpreis enthaltenene Mehrwertsteuer

AUTOMATISCHE ÜBERMITTLUNG EINES AUFTRAGS-STATUS - IN BEARBEITUNG

Sobald die Ware in Ihrem Lager bearbeitet wird, teilen Sie uns die Änderung in einem PUSH-Verfahren mit.

Das benutzte Datenformat kann dabei zwischen folgenden Formaten gewält werden:
SOAP, XML

Wir empfehlen den Einsatz einer SOAP-Schnittstelle.

Bezeichnung Datentyp Feldlänge Required Beschreibung
REFERENCE_ID long64   Yes

Unsere interne Bestellnummer, dient für Sie als Referenznummer für zukünftige Kommunikationen über die Datenschnittstelle

AUTOMATISCHE ÜBERMITTLUNG EINES AUFTRAGS-STATUS - VERSANDBEREIT

Sobald die Ware in Ihrem Lager versandbereit ist, teilen Sie uns die Änderung in einem PUSH-Verfahren mit.

Für jedes Paket das Versandbereit ist, benötigen wir die Informationen über den Inhalt eines jeden einzelnen Pakets.

Das benutzte Datenformat kann dabei zwischen folgenden Formaten gewält werden:
SOAP, XML

Wir empfehlen den Einsatz einer SOAP-Schnittstelle.

Bezeichnung Datentyp Feldlänge Required Beschreibung
REFERENCE_ID long64   Yes

Unsere interne Bestellnummer, dient für Sie als Referenznummer für zukünftige Kommunikationen über die Datenschnittstelle

DELIVERY_BILL_ID string 40 Yes Ihre interne Lieferschein-Nummer
ARTICLES datalist_shipping_article   Yes Versendete Artikel
PARCEL_SERVICE enumeration dhl_austra
dhl_austria_express
tnt_austria
tnt_austria_express
ups_austria
ups_austria_express
gls_austria
hermes_austria
dhl_germany
dhl_germany_express
tnt_germany
tnt_germany_express
ups_germany
ups_germany_express
gls_germany
hermes_germay
No

Paket-Dienst mit dem das Paket versendet wird.

Die Angabe des Paket-Dienstes ist notwendig, um den Nutzer direkt auf die Statusabfrage seiner Lieferung zu schicken.

TRACKING_ID string   No Sendungs-Kennung zur Verfolgung der Sendung über das Internet
WEIGHT double 16,4 No Gewicht des Pakets in Killogramm
DISPATCHER string   No Name der Person, die das Paket abgefertigt hat

AUTOMATISCHE ÜBERMITTLUNG EINES AUFTRAGS-STATUS - VERSENDET

Sobald die Ware Ihr Lager verlassen hat, teilen Sie uns die Änderung in einem PUSH-Verfahren mit.

Für jedes Paket das Versandbereit ist, benötigen wir die Informationen über den Paket-Aufkleber.

Das benutzte Datenformat kann dabei zwischen folgenden Formaten gewält werden:
SOAP, XML

Wir empfehlen den Einsatz einer SOAP-Schnittstelle.

Bezeichnung Datentyp Feldlänge Required Beschreibung
REFERENCE_ID long64   Yes

Unsere interne Bestellnummer, dient für Sie als Referenznummer für zukünftige Kommunikationen über die Datenschnittstelle

DELIVERY_BILL_ID string 40 Yes Ihre interne Lieferschein-Nummer
PARCEL_SERVICE enumeration dhl_austra
dhl_austria_express
tnt_austria
tnt_austria_express
ups_austria
ups_austria_express
gls_austria
hermes_austria
dhl_germany
dhl_germany_express
tnt_germany
tnt_germany_express
ups_germany
ups_germany_express
gls_germany
hermes_germay
Yes

Paket-Dienst mit dem das Paket versendet wird.

TRACKING_ID string   Yes Sendungs-Kennung zur Verfolgung der Sendung über das Internet
WEIGHT double 16,4 No Gewicht des Pakets in Killogramm

BENUTZERDEFINIERTE DATENTYPEN - datalist_topicIDs

Mit diesem Datentyp können Sie mehrere Themen-Zuordnungen zu einem Artikel treffen.

Bezeichnung Datentyp Feldlänge Required Beschreibung
TOPIC_ID long64   Yes

Die Produktgruppen-ID ist die Zuordnung des Artikels zu einer bestimmten Artikelgruppe. Einem Artikel können mehrere Artikelgruppen zugeordnet werden.

Die notwendigen Artikelgruppen-IDs finden Sie in jeder Franchise-Linie unter den Menüpunkten "Information für Anbieter", Abschnitt "DOWNLOAD" unter dem Link Artikelgruppen-Liste (Themenzuordnung).

Suchen Sie die passende Artikelgruppe (z.B. 3630 Balsamico). Als Produktgruppen-ID geben Sie die Nummer 3630 an.

Sollte Ihnen eine Artikelgruppe fehlen, so richten Sie Ihren Vorschlag an: kontakt@i-shop-in-shop.com.

Wichtige Information:
Bitte geben Sie hier nur Produktgruppen-IDs der untersten Ebene an.

BENUTZERDEFINIERTE DATENTYPEN - datalist_export

Mit diesem Datentyp können Sie angeben, in welche Länder Sie einen bestimmten Artikel verschicken. Wenn Sie keine Daten angeben, so ist das Produkt in alle Zielländer möglich, die Sie in unserem Versandkosten-Programm hinterlegt haben.

Bezeichnung Datentyp Feldlänge Required Beschreibung
COUNTRY string   Yes

Verwenden Sie hier bitte die exakte Bezeichnung laut Internationalen KFZ Kennzeichen in Großschrift. Liste der Internationalen Kennzeichen.

INDIVIDUAL_SHIPPING_COSTS datatype_shipping_costs   No Abweichende Versandkosten für diesen Artikel definieren

BENUTZERDEFINIERTE DATENTYPEN - datalist_shippingtype

Mit diesem Datentyp können Sie angeben, welche Versandmethoden für den ausgewählten Artikel zur Verfügung stehen.

Bezeichnung Datentyp Feldlänge Required Beschreibung
SHIPPING_TYPE enumeration 2
3
Yes

Folgende Werte sind möglich:
2 - Abholung direkt ab Lager
3 - Paket-Dienst

BENUTZERDEFINIERTE DATENTYPEN - datalist_keywords

Mit diesem Datentyp können Sie Stichworte / Synonyme für Ihre Produkte anlegen, unter denen das Produkt bei Suchergebnislisten angezeigt werden soll.

Bezeichnung Datentyp Feldlänge Required Beschreibung
KEYWORD string   Yes

Stichwort, unter der Ihr Produkt erscheinen soll

BENUTZERDEFINIERTE DATENTYPEN - datalist_order_article

Mit diesem Datentyp übermitteln wir Ihnen die Artikel, die mit dem eigentlichem Request in Verbindung stehen.

Bezeichnung Datentyp Feldlänge Required Beschreibung
ARTICLE_ID string   Yes

Ihre interene Artikelnummer

QUANTITY float64   Yes Bestellte Menge
UNIT_PRICE double 16,2 Yes Einzelstückspreis Netto
COST double 16,2 Yes Gesamtpreis

BENUTZERDEFINIERTE DATENTYPEN - datalist_shipping_article

Mit diesem Datentyp übermitteln Sie uns die Artikel, die mit dem eigentlichem Request in Verbindung stehen.

Bezeichnung Datentyp Feldlänge Required Beschreibung
ARTICLE_ID string   Yes

Ihre interene Artikelnummer

QUANTITY float64   Yes Verpackte Menge

Mit diesem Datentyp übermitteln Sie uns URLs.

Bezeichnung Datentyp Feldlänge Required Beschreibung
url string   Yes

Gültige Angabe einer URL. Die URL kann relativ sein, wenn die Daten sich auf unserem FTP-Server befinden, aber auch absolute, falls Sie die Daten auf Ihrem eigenem Server vorhalten.

Beispiel:
pdfs/datasheed_a823uw2.pdf

alias string   Yes

Beschreibung zur URL, damit der Kunde weis, was ihm hinter dieser URL erwarten wird.

Beispiel:
Datenblatt

Mit diesem Datentyp übermitteln Sie uns Referenz-Artikel als Artikelnummern.

Bezeichnung Datentyp Feldlänge Required Beschreibung
ARTICLE_ID string   Yes

Gültige Angabe einer Artikelnummer.

BENUTZERDEFINIERTE DATENTYPEN - datatype_shipping_costs

Mit diesem Datentyp können Sie abweichende Versandkosten für einen einzelnen Artikel definieren.

Bezeichnung Datentyp Feldlänge Required Beschreibung
SHIPPING_COSTS double 16,2 Yes Abweichende Versandkosten für diesen Artikel
PAYROLL_TYPE enumeration lump_sum
per_unit
Yes lump_sum: einmalige Versandkosten - egal wieviele Artikel bestellt werden
per_unit: Versandkosten multipliziert mit der bestellten Menge des Artikels

BENUTZERDEFINIERTE DATENTYPEN - datatype_interval

Mit diesem Datentyp übermitteln Sie uns einen Interval.

Bezeichnung Datentyp Feldlänge Required Beschreibung
expression long64   Yes

Zeitangabe z.B. 7

unit enumeration day
month
year
Yes Auf die Zeitangabe bezogene Einheit z.B. day, was in unserem Beispiel die Aussage für 7 Tage wäre

ALLGEMEINE FRAGEN

Bei Fragen zu unserem Datenformat erreichen Sie uns Montag bis Donnerstag von 08:30 Uhr bis 17:00 Uhr und Freitags bis 15:30 Uhr unter der Rufnummer +43 (0)662 9396 - 920 oder per eMail unter support@seminar-shop.com.