1 of 8

Webshop

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

E-Commerce Basic

Modul: ETRON onRetail E-Commerce Basic

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.

Manche Felder werden, je nachdem welcher Webshop (ETRON onRetail Onlineshop, WooCommerce, Magento) angebunden ist, nicht übertragen. Übersicht aller Webshop-Felder, die mit den Webshops kompatibel sind: Webshop-Felder

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.

Wichtig! Nur Produkte, die den Status „Aktiv“ haben, werden in den Webshop übertragen.

Achtung! Nachdem ein Produkt bereits für den Webshop veröffentlicht wurde, kann die Mengeneinheit nachträglich nicht mehr geändert werden. Das Produkt muss archiviert (deaktiviert) werden und ein neues Produkt mit den entsprechenden Attributen erstellt und veröffentlicht werden.

Preisaufschläge für Varianten

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

Wichtig!

Nur die Differenzen zum Originalpreis des Produktes hier eingeben!

d.h. wenn ein rotes T-Shirt um 1 Euro teurer ist, dann ist der Aufschlag + 1,00.

Webshop Bilder

Unter diesem Reiter haben Sie die Möglichkeit neben dem Hauptbild des Produktes weitere Bilder für den Webshop bereitzustellen.

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

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

Für die perfekte Bildereigenschaften empfehlen wir: Dateigröße: max. 200 KB Bildformat: JPG, JPEG, PNG Seitenlängen: 800x800 Pixel

Werden größere Bilder eingefügt, werden diese zwar auf die Standardgröße skaliert, aber es wird dieselbe Datenmenge für das Anzeigen der Bilder verwendet. Um die Webshop-Performance nicht zu beeinträchtigen, wird empfohlen, die angegebene Größe zu verwenden. Bilder mit transparentem Hintergrund werden unterstützt.

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.

E-Commerce Advanced

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

Modul: ETRON onRetail E-Commerce Advanced für oder

Für Kunden ist dieses Modul nicht verfügbar!

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

Dadurch, dass in Produktvarianten keine verschiedene Produktbeschreibungen angegeben werden können, kann ein Webshop-Attribut mit dem Typ Text erstellt werden:

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.

Werden mehrere Produkte ausgewählt, wird dazu geraten Produkt/Anzeigename zu inkludieren, um sicher zu gehen, welche Produkte in der CSV/Excel Datei überarbeitet werden, und Webshop Attribute/Webshop Attribut/Anzeigename für die Bezeichnung der Attribute, da sonst nur die externe ID ersichtlich ist.

Import

Wird dieselbe Excel Datei vom Export für den Import verwendet, ist es am effektivsten den Spaltenlabel Webshop Attribute / External ID in webshop_attribute_ids/id umzubenennen. Durch Verwendung des technischen Namen, wird gewährleistet, dass im Import Fenster die betroffene Spalte Webshop Attribute / Externe ID sofort gefunden wird und dadurch Zeit für die manuelle Suche in der Liste gespart wird.

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.

ACHTUNG! Falls der Spaltenname Webshop Attribute / External ID, in der zu importierenden Datei, nicht in den technischen Namen webshop_attribute_ids/id umgeändert wurde, wird bei dieser Spalte Nicht importieren automatisch ausgewählt. In diesem Fall muss dann Webshop Attribute / Externe ID aus der Dropdownliste ausgewählt werden. Diese ID ist sehr wichtig für den Import!

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.

Webshop-Felder

Übersicht aller Felder, die für , oder zu befüllen sind:

Bezeichnung

Feldname

ETRON onRetail Onlineshop

WooCommerce

Magento

Anmerkung

Gutscheine

Gateway

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.

ETRON bietet eine solche Gateway für Magento Webshops an, die „“. Diese ist für einen Magento Webshop optimiert, andere Webshop-Lösungen sind nicht kompatibel.

Für nähere Informationen wenden Sie sich an den ETRON Support unter oder .

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 , 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 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.

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.

Damit die Gateway mit dem onRetail kommunizieren kann, ist es wichtig, den individuellen Client Key und Client Secret einzutragen! Sie werden nicht geändert.

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.

Durch eine Änderung wird nicht nur die Gateway betroffen, sondern auch das onRetail System.

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.
Ausstehend: Anzahl der ausstehenden Übertragungen von geänderten Produkten.

Beim Export von Setprodukten

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.

Alle nachkommenden Reiter sind ebenfalls wichtig für die Einstellung des Auftragsimports.

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.

Ein neuer Eintrag kann angelegt werden, wenn im Webshop die Versandmethode vorhanden ist. Alle Versandmethoden des Webshops müssen in der Gateway eingetragen werden!.

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

Handbuch ETRON Webshop

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

JSON Schnittstelle

Bestellungen ("orders"):

Aufbau:

OrderObject:

Beispiel:

ShippingObject

OrderPaymentObject

OrderLineObject

OrderAddressObject

Mapping Tabelle, Anforderungen onRetail

OrderObject

OrderPaymentObject

OrderLineObject

OrderAddressObject

Bestellstatus "orderstatus"

Aufbau

OrderStatusObject

Mögliche Order Stati:

processing: Bestellung in Bearbeitung
complete: Bestellung wurde versendet
cancelled: Bestellung wurde storniert

Beispiel:

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"):

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

Aufbau:

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:

ProductObject:

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..

ProductLinkObject

Beispiel: Produkt mit Links

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

E-Commerce Basic

Modul: ETRON onRetail E-Commerce Basic

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.

Wichtig! Nur Produkte, die den Status „Aktiv“ haben, werden in den Webshop übertragen.

Preisaufschläge für Varianten

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

Wichtig!

Nur die Differenzen zum Originalpreis des Produktes hier eingeben!

d.h. wenn ein rotes T-Shirt um 1 Euro teurer ist, dann ist der Aufschlag + 1,00.

Webshop Bilder

Unter diesem Reiter haben Sie die Möglichkeit neben dem Hauptbild des Produktes weitere Bilder für den Webshop bereitzustellen.

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

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

Für die perfekte Bildereigenschaften empfehlen wir: Dateigröße: max. 200 KB Bildformat: JPG, JPEG, PNG Seitenlängen: 800x800 Pixel

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.

E-Commerce Advanced

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

Modul: ETRON onRetail E-Commerce Advanced für oder

Für Kunden ist dieses Modul nicht verfügbar!

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.

Die Möglichkeit, eine bestehende Excel Datei mit , ist geboten.

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

Dadurch, dass in Produktvarianten keine verschiedene Produktbeschreibungen angegeben werden können, kann ein Webshop-Attribut mit dem Typ Text erstellt werden:

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

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

Export/Import

Bevor eine Excel Datei für den ausgewählt wird, sollte zuerst ein durchgeführt werden, damit Spaltennamen gemäß der onRetail Spaltennamen übernommen und die externen IDs der Attribute der Produkte herausgefunden werden.

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.

Durch einen Export, werden die externen IDs für die Webshop Attribute ersichtlich, die wichtig für den sein werden. Diese IDs werden entweder mit der Auswahl noch genauer mit Webshop Attribute / External ID in der Export-Datei angezeigt.

Exportiert in der Excel Datei, werden die ausgewählten Daten in Spalten angezeigt. Eine weitere Empfehlung ist es, Webshop Attribut/Typ auch exportieren zu lassen, um Kompatibilitätsfehler der Datentypen bei der Überarbeitung der Attributwerte für den zu vermeiden.

Import

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

Spaltenlabel können ganz leicht durch einen herausgefunden werden.

JSON Schnittstelle

Bestellungen ("orders"):

Aufbau:

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“):

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.

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

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

Gateway

ETRON bietet eine solche Gateway für Magento Webshops an, die „“. Diese ist für einen Magento Webshop optimiert, andere Webshop-Lösungen sind nicht kompatibel.

Für nähere Informationen wenden Sie sich an den ETRON Support unter oder .

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 , 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 vorgegangen wird.

Manueller Export/Update

Export

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

Update

Verantwortliche Person

Die ausgewählte Person kann je nach , Informationen per Email oder direkt in ETRON onRetail erhalten. Ist eine Benachrichtigung per Email erwünscht, muss auch ein eigenes 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

Damit die Gateway mit dem onRetail kommunizieren kann, ist es wichtig, den individuellen Client Key und Client Secret einzutragen! Sie werden nicht geändert.

Genauigkeit

Durch eine Änderung wird nicht nur die Gateway betroffen, sondern auch das onRetail System.

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 ä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 änderbar
Ausstehend: Anzahl der ausstehenden Übertragungen von geänderten Produkten.

Beim Export von Setprodukten

(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

Vertriebskanal: Bei welchem Kanal der Import stattfinden soll.
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.

Alle nachkommenden Reiter sind ebenfalls wichtig für die Einstellung des Auftragsimports.

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.

Ein neuer Eintrag kann angelegt werden, wenn im Webshop die Versandmethode vorhanden ist. Alle Versandmethoden des Webshops müssen in der Gateway eingetragen werden!.

Steuer-Regeln

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

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 aktiv ist, werden Produktexports und Bestellungsupdates zu einem bestimmten Intervall an die Gateway übersendet. Dieser Intervall kann unter diesem Reiter eingestellt werden.