Wie Sie einen Webshop mit onRetail ansteuern können und mehr zum Thema E-Commerce Anbindungen.

Zwischen ETRON onRetail und einem Webshop muss es einen Service geben, der die Datenübertragung zwischen den beiden Systemen regelt. Diesen Service nennt man Gateway, dies ist eine eigene Softwarelösung.

Einstellungen

Einstellungen > E-Commerce Gateway > Gateways

ETRON onRetail kann für die Übergabe an eine Gateway in verschiedenen Bereichen konfiguriert werden.

Wir unterscheiden zwischen

• der Schnittstelle Webshop S, die Verbindung zu einem Magento Webshop,

• oder einer allgemeinen Gateway/Schnittstelle (kein ETRON Produkt, für eine Webshop-Lösung ihrer Wahl)

Im ETRON onRetail kann es nur eine Gateway geben. Falls es zu Änderungen kommen sollte, kann statt einer Neuanlegung, die Bestehende bearbeitet werden.

Automatischer Export/Update

Durch eine Ausführung automatisierter Aufgaben wird es ermöglicht, Informationen des onRetail in einem bestimmten Intervall an die Gateway zu senden.

Export

Solange dieses Feld aktiv ist, werden die Produkte, die innerhalb des Intervalls verändert oder neu hinzugefügt worden sind, an die Gateway exportiert.

Update

Ist dieses Feld aktiviert, werden die Status aller Bestellungen, die sich innerhalb des Intervalls geändert haben, aktualisiert.

Die Glocke symbolisiert die Kommunikation zwischen onRetail und der Gateway. Ist diese auf "Aktiv" gesetzt, besteht die automatische Übertragung aller Informationen an die Gateway. Sollte diese deaktiviert werden, so wird die Kommunikation pausiert. Alle vorgenommenen Änderungen im onRetail werden wieder an die Gateway übertragen, wenn die Glocke reaktiviert oder manuell vorgegangen wird.

Die Felder Kontakte, Kassenbelege und Produkte zeigen die Anzahl an Änderungen der jeweiligen Kategorien, die nach dem letzten Intervall durchgenommen worden sind, an und werden im nächsten Intervall oder nach dem Pausieren der Kommunikation an die Gateway geschickt.

Ein Vorteil, die Kommunikation zu pausieren, ist z.B. die Möglichkeit, in Ruhe alle Stammdaten abzugleichen, bevor zwischendurch gemachte Veränderungen frühzeitig an die Gateway geschickt und im Webshop angezeigt werden.

Manueller Export/Update

Export

Der Aktion Button löst einen manuellen Export von allen veränderten, noch nicht exportierten Produkten zum Webshop aus.

Wenn Sie einen Initial-Export, sprich einen Gesamtexport aller Ihrer Daten zum Webshop (unwesentlich, ob diese verändert wurden, oder nicht) benötigen, dann wenden Sie sich bitte an unseren support@etron.at.

Update

ETRON onRetail ruft Ihre Onlineshop Bestellungen regelmäßig nach eingestelltem Intervall ab. Sollte aber eine manuelle Abfrage zwischendurch gewünscht sein, kann der Button "Bestellungen aktualisieren" genutzt werden.

Verantwortliche Person

Für die Verwaltung von Webshop Bestellungen und auch Informationen zu Übertragungsproblemen muss eine Person im Unternehmen definiert werden, welche von ETRON onRetail in den entsprechenden Fällen informiert werden kann.

Die ausgewählte Person kann je nach Benachrichtigungseinstellung in den Benutzereinstellungen, Informationen per Email oder direkt in ETRON onRetail erhalten. Ist eine Benachrichtigung per Email erwünscht, muss auch ein eigenes Mail-Server bereitgestellt und eingerichtet werden.

Connection ID/Zugriffs-Token

Eine Gateway, zwischen onRetail und Webshop ist immer einzigartig, weswegen sie durch eine Connection ID und einem Zugriffs-Token gekennzeichnet ist.

Diese werden für die Gateway selbst von ETRON an den onRetail Benutzer mitgeteilt und von der jeweiligen Person ins onRetail eingetragen.

Schnittstelle Webshop S

Wenn Sie die ETRON Gateway für Magento Webshops verwenden (Schnittstelle Webshop S), können Sie folgende Parameter für die Gateway konfigurieren.

REST OAuth2

Dieser Reiter ist weniger relevant für den onRetail Benutzer, als er hauptsächlich für ETRON ist. Mit dem Client Key und dem Client Secret kann ein ETRON Support Mitarbeiter über die Gateway auf das jeweilige onRetail zugreifen, falls Anfrage auf Hilfe besteht.

Genauigkeit

Die Felder unter diesem Reiter sind Informationen über die Anzahl der Kommastellen bei Währung, Preis, Einheit und Rabatt, sind standardmäßig vor eingestellt. Falls Bedarf auf eine Änderung besteht, kann dies durch das Bearbeiten von der Gateway umgeändert werden.

Produktexport

Unter diesem Reiter können Sie Einstellungen zum Export vornehmen.

• Lager: Definiert aus welchem Lager die Produkte exportiert werden sollen.

• Lagerplätze: Definiert aus welchen Lagerplätzen die Produkte exportiert werden sollen.

• Export Locations: Wenn angehakt, werden die Lagerbestände auch nach Lagerort (Filialen) exportiert. Eine Anzeige in Ihrem Webshop ist allerdings Abhängig von Ihrem Webshop-Produkt. Standardmäßig deaktiviert

• Export Vendors: Wenn angehakt, werden die Verkäufer/Lieferanten der Produkte mit exportiert. Eine Anzeige in Ihrem Webshop ist allerdings Abhängig von Ihrem Webshop-Produkt. Standardmäßig deaktiviert

• Zeige HTML Webshop Kurzbeschreibung: Wenn aktiviert, wird das Beschreibungsfeld auf Produkten als HTML Feld angezeigt. Damit dies im Webshop richtig präsentiert wird, muss diese Einstellung auch mit der Webshop Einstellung korrespondieren.

• Preis Dezimalstellen: Gibt die Anzahl der Dezimalstellen der Preise an.

• Intervalltyp: Arbeitet mit dem "Feld Intervall" zusammen und gibt den ersten Wert vor. Zum Beispiel Minuten. Unter Auftrags-Update änderbar

• Intervall: Arbeitet mit dem Feld "Intervalltyp" zusammen und gibt den zweiten Wert vor: Zum Beispiel: 10. (Ergebnis: Alle 10 Minuten wird in den Webshop übertragen) Unter Auftrags-Update änderbar

• Ausstehend: Anzahl der ausstehenden Übertragungen von geänderten Produkten.

Beim Export von Setprodukten

Setprodukte (Bundle) werden als einzelnes Produkt an den Webshop geschickt. Der Webshop (Gateway) hat keine Information darüber, dass es sich um einen Set-Artikel handelt.

In ETRON onRetail wird das Set direkt beim Import der Bestellung aufgelöst.

Auftragsimport

• Datumsformat: Jahr-Monat-Tag Stunde;Minute;Sekunde

• Kontakt-Änderungen: Mehrere Möglichkeiten um Dubletten auszuweichen.

• Kunden E-Mail senden: Kann aktiviert werden wenn das onRetail System E-Mails verschicken kann. Sollte mit den Webshop-Einstellungen korrespondieren, um Doppelsendungen zu vermeiden.

• Rabatt-Produkt, Dienstleistungsprodukt, Rounding Product, Standard Produkt: Sind vor eingestellt und werden in der Regel als Standard so genutzt.

Währungsregeln

Unter diesem Reiter werden die vorhandenen Preislisten mit den passenden Währungen eingestellt.

Versand-Regeln

• Versandmethode (Typ): Wie die Methode im Webshop genannt wird.

• Auslieferungsmethode: Wie die Methode im onRetail fungieren soll.

• Auslieferungsprodukt: Beschreibt das allgemeine Produkt oder Definition, was die Methode genau ist.

Steuer-Regeln

Dieser Reiter stellt alle voreingestellten, bekannten Steuersätze zu Verfügung. Sollte durch eine Überprüfung ein Steuersatz fehlen, kann Dieser angelegt werden. Eine Bearbeitung eines vorhandenen Steuersatzes ist ebenfalls möglich.

• Steuer: Ist die Art der Steuer, so wie sie aus dem Webshop kommt. Die Bezeichnung setzt sich durch den Ländercode und dem Steuersatz zusammen.

• Steuergegenstand: Ist die Beschreibung/Definition der Steuer.

Zahlungs-Regeln

Die Möglichkeit, alle Zahlungsarten, die auch im Webshop zur Verfügung stehen, anzulegen oder zu bearbeiten, findet man unter diesem Reiter. Die gängigsten Zahlungsmethoden sind vor eingestellt und können im onRetail System, solange der Webshop dieselbe Zahlungsart anbietet, problemlos erweitert werden.

• Methode: Zahlungsmethode

• CC Typ: Typ der Kreditkarte

• Zahlungsbedingung: Das Verhalten bei Auswahl der Zahlungsmethode.

• Journal: Die Bezeichnung und Währung der Zahlungsmethode, wie sie im Webshop angezeigt wird.

• Prozess-Typ: Wie die Zahlungsart durchgeführt wird.

• Lieferung abschließen: Es kann definiert werden, dass bei speziellen Zahlarten auch die erstellten Lieferscheine direkt abgeschlossen werden sollen.

Auftrags-Update

Solange der Cronjob aktiv ist, werden Produktexports und Bestellungsupdates zu einem bestimmten Intervall an die Gateway übersendet. Dieser Intervall kann unter diesem Reiter eingestellt werden.

Aufbauend auf bietet Ihnen E-Commerce Advanced zusätzlich die Verwaltung von .

Webshop Attribute

Stammdaten > Webshop Attribute

Mittels Webshop Attributen können einem Artikel beliebige Informationen zugewiesen werden.

Attribute werden global angelegt und sind dann bei jedem Artikel hinterlegt.

Der Wert des Attributes kann im Artikel geändert werden.

Attribute können einem der folgenden Typen zugeordnet werden.

• Boolean: Wahr/Falsch

• Auswahl: Mit dem Attribut werden die möglichen Werte erstellt. Im Produkt kann dann einer dieser Werte ausgewählt werden.

• Mehrfachauswahl: Wie Auswahl, nur können mehrere Werte ausgewählt werden.

• Datum: Datumseingabe

• Text: Freies Textfeld. Es kann also pro Produkt ein individueller Text hinterlegt werden.

• Übersetzung: Kann für Werte genutzt werden, welche in Ihrem Webshop für unterschiedliche Sprache eine unterschiedliche Bezeichnung haben. Es ist also möglich, den hinterlegten Wert zu übersetzen. Mehr Details siehe unten.

• Referenz

Dieser kann dann in den Varianten unter dem Reiter "Webshop-Attribute" mit dem gewünschten Text ausgefüllt werden.

Zusätzlich kann über die Checkbox „Ist Erforderlich“ definiert werden, ob ein Webshop Attribut ein Pflichtfeld sein soll. Durch diese Einstellung erzwingen Sie eine Eingabe/Wertzuweisung bei der Produktanlage.

Details zum Feld „Übersetzung“: Wenn Sie im Webshop Attribute den Wert „Übersetzung“ aktiveren, haben Sie die Möglichkeit, bei der Produktstammdatenpflege anschließend einen Wert auszuwählen, den Sie in weiterer Folge übersetzen können.

Zum Übersetzen klicken Sie nach der Auswahl des Wertes das Weltkugel-Symbol, um einen anderen Wert in die „Translation Value“ Spalte einzutragen.

Export/Import

Export

Durch das Auswählen von Exportieren wird ein neues Fenster geöffnet, wo sämtliche Daten angezeigt und diese in eine CSV oder Excel Datei exportiert werden können.

Standardmäßig ist Import-kompatibler Export ausgewählt. Um mehrere Informationen von verschiedenen Daten der zu exportierenden Produkte bzw. deren Attribute gewinnen zu können, muss Alle Daten exportieren markiert werden.

Import

Bei Auswahl einer CSV/Excel Datei können die Spalten, falls die Spaltenlabel genauso heißen, wie im onRetail, automatisch erkannt werden.

Spalten, die automatisch Nicht importieren bekommen haben, sind für den Import nicht nötig. Diese dienen meist nur zur Übersicht für den Benutzer, dadurch werden z.B. Anzeigenamen, Typen etc. nicht mit importiert.

Bevor ein Import gemacht wird, sollten alle zu importierenden Daten mit Import testen überprüft werden, um Fehler zu vermeiden. Erscheint die Meldung, dass alles o.k. scheint, sollte dann erst der Button Import ausgewählt werden.

Um ein Produkt aus Ihrem Kassensystem in einem Webshop anzubieten bzw. in den Webshop zu übertragen, ist die Aktivierung der Funktions-App ETRON onRetail E-Commerce Basic notwendig.

Um die Funktions-App zu aktivieren, wenden Sie sich bitte an den verkauf@etron.at oder verkauf@etron.de .

Kurzbeschreibung

• Stammdatenerweiterung für die Anbindung von Webshops

• Bereitstellung von Produktdaten für B2C, einfache, einsprachige Webshops

• Übernahme der Kunden- und Bestelldaten von Webshops

Generell

• 1 Sprache

• 1 Währung

• Max. 2.000 Produkte

• Einfache Produkte

• Variantenprodukte

• Stammdatenerweiterung

• Export der Stammdaten im JSON-Format in bestimmten Zeitintervallen (einstellbar)

• Import der Bestelldaten im JSON-Format über die REST-Schnittstelle

Produkt veröffentlichen

Stammdaten > Produkte Wählen Sie das im Webshop anzubietende Produkt aus.

Wählen Sie Bearbeiten und wechseln Sie auf den Reiter Webshop.

• Produktname: Eigener Produktname nur zur Anzeige im Webshop

• URL Schlüssel: Der Pfad in der URL kann für dieses Produkt gesetzt werden. Mehrere Produkte dürfen nicht den gleichen Schlüssel haben!

• Webshop Kategorien: Hierarchisches Menü zur Unterteilung/Kategorisierung der Produkte im Webshop

• Neu ab: Produkt wird als „Neu“ markiert

• Neu bis: Ist kein „Bis“-Datum gesetzt, bleibt das Produkt dauerhaft als „Neu“ markiert

• Alternative Produkte: Cross-selling-Produkte zu einem bestimmten Produkt im Warenkorb

• Empfohlene Produkte: Upselling-Produkte für die Produktdetailseite

• Zubehör: Zubehör-Produkte, die auf Produktdetailseite angezeigt werden

• Kurzbeschreibung: Kurztext, der neben dem Produkt angezeigt wird. Standard reiner Text, wenn eine HTML Formatierung gewünscht ist, kann diese hier eingestellt werden: HTML aktivieren.

• Beschreibung: Langbeschreibung des Produktes, kann auch frei, per HTML, formatiert werden.

• Featured: Produkt erhält im Webshop ein besonderes Label

• Versandbereit in: Spezielle Versandkonditionen

• Export ausständig: Kann für den nächsten Export über dem Gateway gesetzt werden um das Produkt nachtragend in den Webshop zu übertragen oder getätigte Einstellungen zu übernehmen.

• Aktiv im Webshop: Wenn es gesetzt ist, heißt es, dass das Produkt im Webshop aktiv ist.

Speichern Sie Ihre Änderung und wählen Sie am rechten Rand im Kästchen Veröffentlichen, um das Produkt in Ihrem Webshop zu aktivieren.

Preisaufschläge für Varianten

Für Produkte in verschiedenen Varianten (Größe, Farbe) können Preisaufschläge pro Attribut festgelegt werden.

Webshop Bilder

Um im Webshop alternative Produktbilder zu zeigen, wechseln Sie zu Webshop Bilder.

Mit Anlegen können Sie weitere Bilder zu Ihrem Produkt hinzufügen.

Das Bild kann auch mit einem alternativen Bildnamen versorgt werden.

Nach dem Speichern ist das neue Produktbild für den Webshop verfügbar.

Webshop Kategorien

Stammdaten > Webshop Kategorien

Hier können die Webshop Kategorien angelegt und hierarchisch sortiert werden.

Webshop Attribute

Stammdaten > Webshop Attribute

Diese Funktion steht Ihnen unter E-Commerce Advanced zur Verfügung.

Checkliste Gutscheinerstellung

Produkt Gutschein anlegen

• Gutschein als Produkt anlegen Stammdaten > Produkte > Produkte > Anlegen

• Produktart "Dienstleistung" auswählen und Steuern auf 0% setzen Die Felder sind im Reiter Allgemeine Informationen innerhalb der Produktübersicht zu finden.
• Den Wert des Gutscheines als Listenpreis eintragen Kann direkt in der Produktübersicht unter Preis Informationen gefunden werden.
• Als technischen Typen "Ist ein Gutschein (Verfügbar für Gutscheincodes)" auswählen Das Feld ist im Reiter Verkauf innerhalb der Produktübersicht zu finden.
• Webshop Attribut "ist_Gutschein" mit dem Typ "Boolean" anlegen Stammdaten > Webshop > Attribute > Anlegen Der Name ist frei wählbar. Kann auch "is_voucher" heißen. Der Typ MUSS ein Boolean sein!
• Webshop Attribute aktualisieren und den "ist_Gutschein" Attribut bearbeiten um das Häkchen zu setzen, damit der Wert "True" ist Der Reiter Webshop Attribute kann in der Produktübersicht gefunden werden.

Gutscheingruppe anlegen

• Gutscheingruppe anlegen Einstellungen > Gutscheine > Gutschein Gruppen > Anlegen

• Namen vergeben

• Code vergeben

• Erlaube Erstellung in der Kasse: Gutschein kann über der Kasse erstellt werden und im Webshop eingelöst werden

• Erlaube Codes in der Kasse: Gutschein kann abseits des Webshops auch in der Kasse eingelöst werden

• Technischer Typ: "Gutschein" auswählen

Produkt über den Gateway an den Webshop exportieren

• Veröffentlichen Der Button ist in der Produktübersicht zu finden.

Gutschein im Webshop kaufen

Das Gutscheinprodukt wird durch das Veröffentlichen über den Gateway an den Webshop übertragen und für Kunden die Möglichkeit gegeben, den Gutschein zu kaufen. Der Gutschein muss mit einem Online Zahlungsmittel bezahlt werden, da dies garantiert, dass der Gutschein mit einem Geldbetrag vom einkaufenden Kunden gedeckt ist.

Durch den Kauf im Webshop wird über den Gateway die Information an die ETRON onRetail Verwaltungsoberfläche geschickt, dass sie einen Gutscheincode generieren soll.

Im ersten Vorgang wird ein Angebot mit dem Gutschein im ETRON onRetail erstellt und eine Bestellbestätigung an den Kunden geschickt. In dieser E-Mail ist der Code noch nicht zu finden. Wenn der Code erfolgreich von ETRON onRetail generiert und an das Webshop geschickt wurde, wird eine weitere E-Mail über den Webshop mit dem Code gesendet. Die E-Mail Formatierung kann direkt in den Webshop Einstellungen angepasst werden.

Beim Erhalt kann diese E-Mail ausgedruckt und an der Kasse im Geschäft oder der Gutschein-Code im Webshop verwendet werden.

Der Code ist an keinen Kunden gebunden und kann von jedem eingelöst werden.

Ist der Wert des Gutscheines bei einem Kaufvorgang mehr als was zu zahlen ist, wird keine Zahlungsmethode zum Auswählen angezeigt und der Kauf kann gleich abgeschlossen werden. Auf dem Code bleibt der Restbetrag.

Reservierte Gutscheincodes

Unter Einstellungen > Gutscheine > Codes können reservierte Codes eingesehen werden. Reserviert bedeutet, dass der Kunde den Wert des Gutscheines noch nicht vollständig eingelöst hat. Der Wert wird z.B. reserviert, wenn der Kunde den Code im Webshop angegeben aber den Kauf noch nicht abgeschlossen hat. Der Wert des Gutscheines wird deshalb nur für diesen Kauf reserviert und kann für die nächsten 24 Stunden an keiner weiteren Stelle eingelöst werden. Dies ist besonders wichtig, da es zur Sicherheit dient, dass der Kunde denselben Code nicht gleichzeitig im Webshop sowie an der Kasse verwenden kann.

Sollte der Browser während des Kaufs abstürzen und die Verbindung zum Kaufabschluss geht verloren, ist dieser Code von der 24 Stunden-Sperre nicht ausgeschlossen.

Gutscheincode aufladen

Gutscheincodes können wieder aufgeladen werden oder einen höheren Wert bekommen. Dies ist allerdings über den Webshop nicht möglich und kann nur an der Kasse durchgeführt werden. Durch den Webshop können Gutscheincodes nur einmalig erworben werden.

Mit dem StarterShop Webshop können Sie schnell und einfach einen Onlineshop als neuen Vertriebskanal nutzen, um Ihre Ideen & Ihre Produkte erfolgreich im Internet zu verkaufen – denn online einzukaufen ist für immer mehr Menschen eine alltägliche Selbstverständlichkeit geworden. Basierend auf Magento – dem führenden Open Source Webshop-System mit über 100.000 Installationen – bieten wir Ihnen eine professionelle Lösung für den schnellen und einfachen Einstieg. Für weitere Informationen wechseln Sie bitte in unser

Übersicht aller Felder, die für ETRON onRetail Onlineshop, WooCommerce oder Magento zu befüllen sind:

a

Bestellungen ("orders"):

Aufbau:

"orders": array of `OrderObject`

OrderObject:

Beispiel:

{
  "orders": [
    {
      "id": "100000222",
      "created": "2019-05-22 07:30:50",
      "updated": "2019-05-22 07:31:25",
      "status": "processing",
      "shipping_method": {
        "type": "DHL",
        "description": "Versand über DHL"
      },
      "currency": "EUR",
      "comment": "Kommentar zur Bestellung vom Kunden",
      "taxmodel": "GROSS",
      "_payment": {
        "method": "CC",
        "cctype": "Visa"
      },
      "_lines": [
        {
          "type": "product",
          "is_line": true,
          "quantity": "1",
          "sku": "2113000016259",
          "name": "Product name",
          "unitprice": 19.99,
          "amount": 19.99,
          "discount_amount": 0,
          "tax_amount": 3.33,
          "taxclass": "REGULAR"
        },
        {
          "type": "shipping",
          "is_line": true,
          "amount": 4.9,
          "tax_amount": 0.82,
          "taxclass": "REGULAR"
        },
        {
          "type": "total",
          "is_line": false,
          "amount": 24.89,
          "tax_amount": 4.15
        }
      ],
      "_shipping": {
        "id": 2864,
        "salutation": "Herr",
        "firstname": "Stephan",
        "lastname": "Muster",
        "street": "Pottendorfer Straße 23",
        "zip": "1120",
        "city": "Wien",
        "country": "AT",
        "company": "ETRON",
        "email": "max.muster@muster.at",
        "phone": "+43 546 889797979",
        "vat_id": "ATU192853434"
      },
      "_billing": {
        "id": 2864,
        "salutation": "Herr",
        "firstname": "Stephan",
        "lastname": "Muster",
        "street": "Pottendorfer Straße 23",
        "zip": "1120",
        "city": "Wien",
        "country": "AT",
        "company": "ETRON",
        "email": "max.muster@muster.at",
        "phone": "+43 546 889797979",
        "vat_id": "ATU1928533434"
      }
    }
  ]
}

ShippingObject

OrderPaymentObject

OrderLineObject

OrderAddressObject

Mapping Tabelle, Anforderungen onRetail

OrderObject

OrderPaymentObject

OrderLineObject

OrderAddressObject

Bestellstatus "orderstatus"

Aufbau

"orderstatus": array of `OrderStatusObject`

OrderStatusObject

Mögliche Order Stati:

• processing: Bestellung in Bearbeitung

• complete: Bestellung wurde versendet

• cancelled: Bestellung wurde storniert

Beispiel:

{
  "orderstatus": [
    {
      "id": "10000111",
      "status": "complete"
    },
    {
      "id": "10000112",
      "status": "cancelled"
    }
  ]
}

Mapping Tabelle, Anforderungen onRetail

OrderStatusObject

Kategorien („categories“):

Kategorien werden in allen konfigurierten Sprachen übertragen. Kategoriebilder liegen auf einem externen Bilderspeicher (SFTP oder Amazon S3). Als Bildangaben sind immer alle zum Basisordner relativen Pfadangaben anzugeben.

Beispiel für Kategorien in nur 1 Sprache (scopeId = "default"):

{
  "categories": {
    "default": [
      {
        "id": "1",
        "name": "Hauptkategorie",
        "parent_id": "0",
        "position": 1,
        "visible": true,
        "image": "http://cdnmax938.maxcdn.com/saalhsf/1.jpg",
        "description": "Beschreibung Hauptkategorie"
      },
      {
        "id": "2",
        "name": "Unterkategorie",
        "parent_id": "1",
        "position": 1,
        "visible": true
      },
      {
        "id": "3",
        "name": "Unterkategorie 2",
        "parent_id": "1",
        "position": 2,
        "visible": true
      }
    ]
  }
}

Beispiel für Kategorien in zwei Sprachen "de" (Deutsch) und "en" (Englisch) mit den gleichnamigen scopeIds:

{
  "categories": {
    "en": [
      {
        "id": "1",
        "name": "Main category",
        "parent_id": "0",
        "position": 1,
        "visible": true
      },
      {
        "id": "2",
        "name": "Sub category",
        "parent_id": "1",
        "position": 1,
        "visible": true
      },
      {
        "id": "3",
        "name": "Sub category 2",
        "parent_id": "1",
        "position": 2,
        "visible": true
      }
    ],
    "de": [
      {
        "id": "1",
        "name": "Hauptkategorie",
        "parent_id": "0",
        "position": 1,
        "visible": true
      },
      {
        "id": "2",
        "name": "Unterkategorie",
        "parent_id": "1",
        "position": 1,
        "visible": true
      },
      {
        "id": "3",
        "name": "Unterkategorie 2",
        "parent_id": "1",
        "position": 2,
        "visible": true
      }
    ]
  }
}

Aufbau:

"categories": {
  "scopeId": **array of** `CategoryObject`,
  "scopeId": **array of** `CategoryObject`,...
}

CategoryObject:

onRetail Anforderungen

Mapping Tabelle, Anforderungen onRetail

CategoryObject:

Produkte ("products"):

Produkte und beim Produkt definierte Kategoriezuweisungen werden gemeinsam exportiert.

Vom Datenaustauschformat unterstützt werden einfache und konfigurierbare Produkte in einer und mehreren Sprachen, sowie optionale Unterstützung für Multistore (Price per Store)/Multi-Inventory (Inventory per Store).

Attribute wie weight, sku und status sind globale Attribute (d.h. sprach/store-unabhängig). Die Attribute _categories (Kategoriezuordnungen) und _images (Bildzuordnungen) sind optional und immer global (also sprach/store-unabhängig).

Ein Scope (Geltungsbereich) ist der Abschnitt, der sprach- bzw. storebezogene Produktdaten definiert (Preise, Produkttexte)

Produktbilder liegen auf einem externen Bilderspeicher (SFTP oder Amazon S3). Als Bildangaben sind immer alle zum Basisordner relativen Pfadangaben anzugeben.

Aufbau:

"products": array of `ProductObject`

ProductObject:

{
  "products": [
    {
      "sku": "SKU1",
      "weight": 0.1,
      "status": 1,
      "stock": 99,
      "manufacturer" : "Herstellername",
      "manufacturer_link": "www.hersteller.com/products/1"
      "_categories": [
        {
          "cat_id": 1
        },
        {
          "cat_id": 2
        },
        {
          "cat_id": 3
        }
      ],
      "_images": [
        {
          "url": "www.example.com/path/to/imagefile1.jpg" ,
          "position": 1
        },
        {
          "rel_path": "www.example.com/path/to/imagefile2.jpg",
          "position": 10
        }
      ],
      "_price": {
        "regular": 9.1583,
        "special": 8.325,
        "taxclass": "REGULAR",
        "_tiers": [
          {
            "pricelist_id": 1,
            "quantity": 10,
            "price": "8.99"
          },
          {
            "pricelist_id": 1,
            "quantity": 20,
            "price": "7.99"
          }
        ]
      },
      "_scopes": [
        {
          "scopeid": "de",
          "data": [
            {
              "field": "name",
              "data": "Produktname"
            },
            {
              "field": "short_description",
              "data": "Deutsche Kurzbeschreibung"
            },
            {
              "field": "description",
              "data": "Deutsche Langbeschreibung"
            }
          ]
        },
        {
          "socpeid": "en",
          "data": [
            {
              "field": "name",
              "data": "Product name"
            },
            {
              "field": "short_description",
              "data": "english short description"
            },
            {
              "field": "description",
              "data": "english description"
            }
          ]
        }
      ]
    }
  ]
}

ImageObject

PriceObject

PriceTierObject

ProductProperties

Liste aller übersetzten Felder eines Produktes

VariationObject

Beispiel: Konfigurierbares Produkt mit 2 Varianten (Farbe=Grün und Farbe=Blau). Farbvariante Blau kostet 13 € inkl. 20% MwSt, Farbvariante Grün kostet 12 € inkl. 20% MwSt..

{
  "products": [
    {
      "sku": "ConfigProduct1",
      "status": 1,
      "_categories": [
        {
          "cat_id": 1
        },
        {
          "cat_id": 2
        },
        {
          "cat_id": 3
        }
      ],
      "_variation_config": {
        "attributes": [
          "farbe"
        ],
        "children": [
          "child-sku-1",
          "child-sku-2"
        ]
      },
      "_images": [
        {
          "url": "www.example.com/path/to/imagefile1.jpg" ,
          "position": 1
        },
        {
          "rel_path": "www.example.com/path/to/imagefile2.jpg",
          "position": 10
        }
      ],
      "_scopes": [
        {
          "scopeid": "default",
          "data": [
            {
              "field": "name",
              "data": "Produktname"
            },
            {
              "field": "short_description",
              "data": "Kurzbeschreibung"
            },
            {
              "field": "description",
              "data": "Beschreibung"
            }
          ]
        }
      ]
    },
    {
      "sku": "child-sku-1",
      "weight": 1,
      "stock": 1,
      "status": 1,
      "_price": {
        "regular": 10.8333,
        "taxclass": "REGULAR"
      },
      "_scopes": [
        {
          "scopeid": "default",
          "data": [
            {
              "field": "name",
              "data": "Variante Blau"
            },
            {
              "field": "farbe",
              "data": "blau"
            }
          ]
        }
      ]
    },
    {
      "sku": "child-sku-2",
      "weight": 1,
      "stock": 1,
      "status": 1,
      "_price": {
        "regular": 10,
        "taxclass": "REGULAR"
      },
      "_scopes": [
        {
          "scopeid": "default",
          "data": [
            {
              "field": "name",
              "data": "Variante Grün"
            },
            {
              "field": "farbe",
              "data": "grün"
            }
          ]
        }
      ]
    }
  ]
}

ProductLinkObject

Beispiel: Produkt mit Links

{
  "products": [
    {
      "sku": "SKU1",
      "weight": 0,
      "_categories": [
        {
          "cat_id": 1
        },
        {
          "cat_id": 2
        },
        {
          "cat_id": 3
        }
      ],
      "_images": [
        {
          "url": "www.example.com/path/to/imagefile1.jpg" ,
          "position": 1
        },
        {
          "rel_path": "www.example.com/path/to/imagefile2.jpg",
          "position": 10
        }
      ],
      "name": "Produktname",
      "short_description": ".....",
      "description": ".....",
      "status": 1,
      "stock": 1,
      "_price": {
        "regular": 9.1583,
        "special": 8.325,
        "taxclass": "REGULAR"
      },
      "_linked_skus": [
        {
            "type": "upsell",
            "skus": [
                "linked-upsell-sku-1",
                "linked-upsell-sku-2"
            ]
        },
        {
            "type": "crosssell",
            "skus": [
                "linked-upsell-sku-1",
                "linked-upsell-sku-2"
            ]
        },
        {
            "type": "related",
            "skus": [
                "linked-upsell-sku-1",
                "linked-upsell-sku-2"
            ]
        }
      }
    }
  ]
}

Mapping Tabelle, Anforderungen onRetail

ProductObject

ImageObject

PriceObject

Für die Preisverwaltung wird eine Preisliste für den Webshop bei der Installation angelegt die nicht gelöscht werden kann. Preislisteneinträge die eine Mengenangabe haben, werden als PriceTierObject exportiert. Einträge ohne Mengenangabe werden als special Preis exportiert. Bei mehrfachen anzuwendenden Preisen, wird der niedrigste Preis exportiert. Prio: Artikel > Kategorie > Global

PriceTierObject

ProductProperties (Üersetzungen)

Übersetzungen befinden sich im Model ir.translation Im Feld source steht die englische Übersetzung, die der anderen installierten Sprachen im Feld value

VariationObject

ProductLinkObject