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.
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.
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.
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: |
|
| 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: Überschrift: <h2>Text</h2> 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: |
| 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: |
|
| F_FREIGABE | enumeration | 0 1 |
Yes | Freigabe Verfügbare Werte: |
| 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. |
| 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: |
|
| MENGE_TYP | enumeration | g |
No | Einheit im Bezug auf den Nettoverpackungsinhalt (Spalte MENGE) Beispiel: |
| VERPAKUNG | enumeration | unit cardboard pallet |
No | Verpackungseinheit |
| UNITS | long64 | No | Anzahl der Artikel in der Verpackungseinheit |
|
| UNIT_TYPE | enumeration | unit bowl bottle |
No | Art der Verpackungseinheit |
| 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: |
|
| 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: |
|
| 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: Versandkosten: Abrechnungsart: Beispiel (Einmalige Versandkostenpauschale Deutschland 4,50 EUR / Österrich 9,90 EUR) |
|
| 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: |
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 |
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: |
| 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 Beispiel: Format 2: expression (day|month|year) Beispiel: |
|
| SHOW_STOCK_STYLE | enumeration | quantity indicator |
No | Legen Sie mit dieser Option fest, ob eine Anzeige der Verfügbarkeit des Artikels stattfinden soll. quantity indicator |
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 |
Leeres Lager + Artikel direkt vom Außenlager lieferbar, Lieferzeit unbekannt |
|
Leeres Lager + Artikel direkt vom Außenlager lieferbar, Lieferzeit bekannt ( 5 Tage ) |
|
Leeres Lager + Artikel im Außenlager bestellt, Liefertermin unbekannt |
|
Leeres Lager + Artikel im Außenlager bestellt, Liefertermin bekannt (22.12.2009) |
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 |
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: |
| 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 Beispiel: Format 2: expression (day|month|year) Beispiel: |
|
| 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: |
|
| F_FREIGABE | enumeration | 0 1 |
Yes | Freigabe Verfügbare Werte: |
| 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: Überschrift: <h2>Text</h2> 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: |
|
| MENGE_TYP | enumeration | g |
No | Einheit im Bezug auf den Nettoverpackungsinhalt (Spalte MENGE) Beispiel: |
| FARBE | string | No | Farbe des Artikels |
|
| GROESSE | string | No | Größe des Artikels |
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 |
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 |
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 |
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 |
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 |
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 |
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: |
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 |
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: |
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 |
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 |
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: |
|
| alias | string | Yes | Beschreibung zur URL, damit der Kunde weis, was ihm hinter dieser URL erwarten wird. Beispiel: |
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. |
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 |
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 |
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.