Gateway

ETRON Gateway, Produktexport, Bestellungsimport, Auftragsimport, Lagerstandexport, API, Visticle

Modul: ETRON Gateway

Gateways

E-Commerce ➜ Gateway ➜ Gateways

Über die Gateway können Produkte (inkl. der Daten wie Preise, Lagerstand, Bilder usw.) exportiert und Bestellungen importiert werden.

Für die Produkte befinden sich unter Stammdaten -> Produkte -> Produkte im Reiter "Gateway" zusätzliche Felder, die über die Gateway exportiert werden.

Üersicht über die Gateway(s): E-Commerce ➜ Gateway ➜ Gateways

Gateway-Ansicht mit allen Einstellungen

In der Gateway-Ansicht kann die Gateway eingestellt und diverse Aktionen durchgeführt werden:

Gateway Code

Der Gateway Code ist ein Token für die eindeutige Identifizierung und Adressierung des Gateways

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.

Gateway-URL

Die API-URL, unter der die Gateway erreichbar ist.

Verbindungs-ID / Zugriffs-Token

Ein Gateway, zwischen onRetail und Webshop ist immer einzigartig. Durch Verbindungs-ID und Zugriffs-Token kann es eindeutig identifiziert werden.

Verbindungs-ID und Zugriffs-Token werden von ETRON mitgeteilt und müssen anschließend in die entsprechenden Felder eingetragen werden.

Produkt Export / REST OAuth2 / Auftragseinstellungen / Währungsregeln

Produkt Export

Reiter "Produkt Export"

Exportierte Sprachen

Die Sprachen in denen Daten über das Gateway exportiert werden.

Versand-Lagerorte

Von den angegebenen Lagerorten wird die Summe der Produktbestände unter der Berücksichtigung der Einstellung Exportierte Menge exportiert.

Zusätzliche Lagerorte

Für den Export der Lagerorte und deren Bestände können zusätzliche Lagerorte gesetzt werden (z.B. für die Anzeige des Lagerstands pro Filiale, sofern dies der Webshop unterstützt)

Beim Bestellungsimport werden Liefervorgänge/Lieferscheine prinzipiell für das Lager erstellt, das in der Gateway-Übersicht im Feld "Lager" sichtbar ist. Einblenden des Felds Lager in der Gateway-Übersicht: Ist bei der Bestellung eine Versandmethode mit dem Anbieter "Abholung" gewählt worden, wird das bei der Versandmethode gesetzte Lager berücksichtigt und die Liefervorgänge für dieses erstellt.

Exportierte Menge (Lagerstand Export)

• Freie

Die vorrätigen Produktmengen werden exkl. der reservierten Mengen exportiert

(exkl. der Mengen die z.B. bereits für eine Auslieferung reserviert sind )

• Vorrätige

Die vorrätigen Produktmengen werden inkl. der reservierten Mengen exportiert

(inkl. der Mengen die z.B. bereits für eine Auslieferung reserviert sind )

• Prognostizierte

Die vorrätigen Produktmengen werden exkl. der reservierten Mengen exportiert

Preislisten exportieren

Die Produkt-Preisliste, die über das Gateway exportiert wird und daher die exportierten Produktpreise festlegt.

Exportsteuer inklusive

Wenn aktiviert werden die Produktpreise inklusive der Steuer (brutto) exportiert.

Ansonsten werden die Produktpreise exklusive der Steuer (netto) exportiert.

Exportiere Kurzbeschreibung als Klartext

Wenn aktiviert wird die Gateway-Kurzbeschreibung des Produkts als Klartext (string) exportiert, und nicht als HTML

Intervalltyp

Beim Produktexport sollte kein zu kurzer Intervall gesetzt werden, da ein ständig ablaufender Produktexport zu Verzögerungen bzw. einem langsameren System führen kann. Für den Lagerstand- und Preisexport kann ein kürzerer Intervall gesetzt werden.

Das Intervall, in dem ein Produktexport durchgeführt wird. Zusätzlich muss eine Intervallnummer für die Anzahl eingestellt werden:

Minuten / Stunden / Tage / Wochen / Monate

Intervallnummer

Die Anzahl legt fest, wie oft mit dem gesetzten Interalltyp (Stunden / Tage / Wochen / Monate) der Produktexport durchgeführt wird.

Ausstehend

Die Zahl gibt an, wie viele Produkte derzeit für einen Export ausstehend sind (neue Produkte, aktualisierte Produkte)

REST OAuth2

Auftragseinstellungen

Währungsregeln

Versand Bedingungen / Steuerzuordnung Regeln (OSS) / Zahlungsbedingungen / Partner

Versand Bedingungen

Versand Bedingungen

Reiter "Versand Bedingungen"

Im Reiter Versandbedingungen werden die Versandmethoden zugeordnet.

z.B. gibt es im Webshop die Versandart "FREE". Bei einem Auftragsimport in onRetail wird die Versandmethode "Versandkostenfrei" zugeordnet.

Versandmethoden können unter Konfiguration ➜ Auftragswesen ➜ Versandmethoden angelegt werden.

Versandart (Typ)

Die Bezeichnung der Versandart bzw. Versandmethode im Webshop

Versandmethode

Beim Auftragsimport wird die Versandart der in onRetail hinterlegten Versandmethode zugeordnet.

Produktlieferung

Das Lieferprodukt ist bei der Versandmethode hinterlegt und wird durch das Auswählen der Versandmethode automatisch gesetzt.

Steuerzuordnung Regeln (OSS)

Zahlungsbedingungen

Lagerstand/Preisexport

Partner

Aktionsleiste & Aktionsbuttons

Die Aktionsleiste und Aktionsbuttons befinden sich oben in der Gateway-Ansicht. Über diese können verschiedene Aktionen durchgeführt werden.

DATEN EXPORTIEREN

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

Wenn Sie einen Initial-Export, sprich einen Gesamtexport aller Ihrer Daten zum Webshop, egal ob geändert oder nicht, benötigen, dann wenden Sie sich bitte an unseren [e-mail].

BESTELLUNGEN AKTUALISIEREN

ETRON onRetail ruft die Onlineshop Bestellungen regelmäßig nach einem eingestelltem Intervall ab.

Eine sofortige manuelle Aktualisierung der Bestellung wird über den Button "Bestellungen aktualisieren" durchgeführt.

Bestellungen

E-Commerce ➜ Gateway ➜ Bestellungen

Der Button Bestellungen zeigt die Anzahl an importierten Bestellungen an. Über den Button wird die Listenansicht der Bestellungen aufgerufen.

Listen-Ansicht der Gateway-Bestellungen

Über die Listenansicht kann ein erneuter Import der Bestellung durchgeführt werden, wenn es beim Bestellimport zu einem Fehler kam. In der Detailansicht der Bestellung kann ein fehlerhafter Import im Feld "Import Fehler" erkannt werden.

Durch Auswählen einer Bestellung in der Listenansicht wird die Detailansicht der Bestellung aufgerufen.

Bestellungen, die über die Gateway importiert wurden, haben den zusätzlichen Reiter "Gateway"

Bestellnummer

Ist die Original-Bestellnummer (z.B. von dem Onlineshop auf dem die Bestellung getätigt wurde)

Die Bestellnummer wird auch auf den zugehörigen Rechnungen und Lieferscheinen im Reiter "Gateway" angezeigt und auf den Dokumenten angezeigt.

Import Fehler

Ist der Toggle aktiviert, kam es bei dieser Bestellung zu einem Import Fehler. Der Fehler wird im Chatter-Bereich angezeigt. Nach dem Beheben der Fehlerquelle muss der Bestellungsimport erneut durchgeführt werden.

Wie ist bei einem Import Fehler beim Bestellungsimport über die Gateway vorzugehen?

Wenn die Bestellung einen Import Fehler hat, sollte im Chatter der Bestellung zuerst die Fehlerbeschreibung in der automatisch erstellten Aktivität überprüft werden.

Aktivität mit Beschreibung des Gateway-Importfehlers

Diese kann bereits Aufschluss darüber geben, was die Ursache des fehlerhaften Imports ist. Diese Ursache muss behoben werden, bevor ein erneuter Bestellimport durchgeführt werden kann.

Für Unterstützung bei der Fehlerbeseitigung steht der ETRON Support gerne zur Verfügung.

Nachdem die Fehlerquelle beseitigt wurde, kann der erneute Bestellimport durchgeführt werden.

Dafür wird über das Menü E-Commerce -> Gateway -> Bestellungen die Bestellung in der Listenansicht aufgerufen.

Listen-Ansicht der Gateway-Bestellungen mit Button für erneuten Bestellungsimport

Über den Button wird für die Bestellung mit Import Fehler der Bestellungsimport erneut durchgeführt.

Update ausstehend

Wenn aktiv: es gab eine Änderung des Status/Rechnungsstatus

Produkte

Der Button Produkte zeigt die Anzahl an Produkten an Produkten an, die für das Gateway aktiv (veröffentlicht) sind. Über den Button können die Produkte aufgerufen werden.

Kunden

Der Button Kunden zeigt die Anzahl an Kunden zu den Bestellungen an. Über den Button können die Kunden-Kontakte aufgerufen werden.

Protokollierung, Gateway-Logs

Die Gateway-Protokollierung kann über den Button "Protokollierung" oder das Menü E-Commerce -> Gateway -> Protokollierung aufgerufen werden.

Der Button Protokollierung zeigt die Anzahl an Gatewayprotokollen (Logs) an. Diese werden beim Import und Export über die Gateway erstellt und geben Aufschluss darüber, ob ein Import/Export erfolgreich war, Fehler hatte, welche Daten übertragen wurden, usw.

Fehlgeschlagene Gateway-Übertragung: Übertragung erneut starten

Über die Protokollierung kann bei einer fehlerhaften Gateway-Übertragung die Übertragung erneut gestartet werden. Dafür wird der Button ausgewählt.

Es werden nur jene Daten erneut übertragen, bei denen die Übertragung nicht erfolgreich war.

Aktualisieren

Ist dieser Button aktiviert werden alle Bestellungen, seit dem letzten Auftragsimport, importiert und aktualisiert.

Durch Auswählen des Buttons wird die Einstellung aktiviert/deaktiviert.

Export

Ist dieser Button aktiviert werden die Produkte, die seit dem letzten Export aktualisiert oder neu angelegt bzw. veröffentlicht wurden, an die Gateway exportiert.

Durch Auswählen des Buttons wird die Einstellung aktiviert/deaktiviert.

REST OAuth2

Weitere Informationen REST OAuth2