# Gateway {% hint style="success" %} *Modul: ETRON Gateway* {% endhint %} ## *Gateways* > *E-Commerce* ➜ *Gateway* ➜ *Gateways* Über die Gateway können Produkte (inkl. der Daten wie Preise, Lagerstand, Bilder usw.) exportiert und Bestellungen importiert werden. {% hint style="info" %} *Für die Produkte befinden sich unter* [*Stammdaten -> Produkte -> Produkte im Reiter "Gateway"*](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte/produkte-produktstammblatt/gateway) *zusätzliche Felder, die über die Gateway exportiert werden.* {% endhint %}

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

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 {% tabs %} {% tab title="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 ](#exportierte-menge-lagerstand-export)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) #### 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](https://helpcenter.etron.info/einstellungen/allgemeine-einstellungen/verkauf/preiskalkulation#preislisten), 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](https://helpcenter.etron.info/stammdaten/produkte/produkte-produktstammblatt/gateway#beschreibung) als Klartext (string) exportiert, und nicht als HTML #### Intervalltyp {% hint style="info" %} *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*](#lagerstand-preisexport) *kann ein kürzerer Intervall gesetzt werden.* {% endhint %} 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) {% endtab %} {% tab title="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. {% hint style="info" %} *Damit die Gateway mit dem onRetail kommunizieren kann, ist es wichtig, den individuellen **Client Key** und **Client Secret** einzutragen! Sie werden nicht geändert.* {% endhint %} {% endtab %} {% tab title="Auftragseinstellungen" %}

Einstellungen zum Auftragsimport #### Vertriebskanal Der Vertriebskanal legt fest, welchem [Verkaufsteam](https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/kundenpflege/verkaufsteams) die Aufträge zugeordnet werden. #### Standard Produkt Das Produkt "Standard Produkt" wird beim Auftragsimport für Produkte verwendet, die einen Produktcode/SKU verwenden, der nicht in onRetail zugeordnet werden kann. #### E-Mails versenden Beim Auftragsimport wird von onRetail eine E-Mail mit der Auftragsbestätigung an den Kunden versendet. Wenn bereits eine Auftragsbestätigung vesendet wurde, ist diese Einstellung zu deaktivieren, damit der Kunde keine doppelte Auftragsbestätigung erhält. E-Mails zu Lieferungen und Rechnungen werden unabhängig von dieser Einstellung gesendet. #### Ausstehend Die Anzahl der zu importierenden Aufträge #### Intervalltyp Die Anzahl legt fest, wie oft mit dem gesetzten Interalltyp (Stunden / Tage / Wochen / Monate) der Auftragsimport durchgeführt wird. #### Intervallnummer Die Anzahl legt fest, wie oft mit dem gesetzten Interalltyp (Stunden / Tage / Wochen / Monate) der Auftragsimport durchgeführt wird. {% endtab %} {% tab title="Währungsregeln" %}

#### Preilistenwährung (Währung für Preisexport) Im Reiter "Währungsregeln" werden die vorhandenen Preislisten mit den dazugehörigen Währungen verknüpft. {% endtab %} {% endtabs %} ### Versand Bedingungen / Steuerzuordnung Regeln (OSS) / Zahlungsbedingungen / Partner {% tabs %} {% tab title="Versand Bedingungen" %} #### **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](https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/auftragswesen/versandmethoden) "Versandkostenfrei" zugeordnet. *Versandmethoden können unter* [*Konfiguration* ➜ *Auftragswesen* ➜ *Versandmethoden*](https://helpcenter.etron.info/verwaltungsoberflache/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](https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/auftragswesen/versandmethoden) zugeordnet. **Produktlieferung** Das Lieferprodukt ist bei der Versandmethode hinterlegt und wird durch das Auswählen der Versandmethode automatisch gesetzt. {% endtab %} {% tab title="Steuerzuordnung Regeln (OSS)" %} #### Steuerzuordnung Regeln (OSS)

Im Reiter Steuerzuordnung Regeln wird die [Steuerzuordnung](https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/fibu-daten/steuerzuordnung) für den Import/Export von Aufträgen hinterlegt. Dadurch findet ein Mapping der Steuern statt. #### Steuerbezeichnung Schlüssel, Steuerzuordnung And des Schlüssels, z.B. IT wird die Steuerzordnung (OSS) ausgewählt, z.B. OSS B2C Italia. In dieser Steuerzuordnung werden die Steuern zugeordnet, z.B. der Normal-Verkaufssteuersatz 19% von Deutschland auf den Normal-Verkaufssteuersatz 22% von Italien. #### Standard Steuerzuordnung hinzufügen Wurden noch keine Steuerzuordnungen eingetragen, ist der Button ![](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2Fcmk30dyt5O0b01j9WW88%2Fimage.png?alt=media\&token=e505459a-a323-4cb6-8861-56582bdbbd1d) sichtbar. Über diesen können die vorhandenen [Steuerzuordnungen](https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/fibu-daten/steuerzuordnung) automatisch hinzugefügt werden.

Wurden bereits Einträge hinterlegt, müssen diese entfernt ![](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FTc7ueBRknOjrSkhEKLgM%2Fimage.png?alt=media\&token=d8f1d84e-267a-4374-8e39-16450a9439bd) werden, damit der Button für das automatische Hinzufügen wieder angezeigt wird. {% endtab %} {% tab title="Zahlungsbedingungen" %} #### **Zahlungsbedingungen**

Im Reiter Zahlungsbedingungen können alle Zahlungsarten, die im Webshop zur Verfügung stehen konfiguriert werden. **Methode** Die Bezeichnung der Zahlungsmethode im Webshop. **CC Typ** Typ der Kreditkarte z.B. Zahlungsmethode "CC" und CC Typ "VISA" **Zahlungsbedingungen** Die Zahlungsbedingung der Zahlungsmethode, z.B. Sofort oder 14 Tage **Journal** Für die Zahlungsmethode wird der eingestellte [Journaltyp](https://helpcenter.etron.info/verwaltungsoberflache/fibu-daten/journale) verwendet, z.B. Kundenrechnung (Typ Verkauf) oder Paypal (Typ Bank) **Prozessart** Über die Prozessart wird festgelegt, welcher Prozess beim Import eines Auftrags mit dieser Zahlungsmethode angelegt wird * **Angebot**: Erstellt ein Angebot ohne Rechnung/Zahlung * **Bestellung**: Bestätigt das Angebot und erstellt einen Verkaufsauftrag * **Rechnung**: Erstellt nur eine Rechnung ohne Zahlung * **Zahlung**: Bestätigt das Angebot (Bestellung/Verkaufsauftrag wird erstellt) und erstellt eine bezahlte Rechnung #### Prozessbereitstellung Wenn diese Option aktiviert ist, wird die Lieferung einer Bestellung automatisch durchgeführt, sobald der Auftrag erstellt bzw. importiert wurde. Dies ist hilfreich, um Lagerbestände im Webshop sofort zu aktualisieren. Bitte beachten: Der Lieferstatus kann danach im System nicht mehr verfolgt werden, da die Bestellung als direkt geliefert gilt. {% endtab %} {% tab title="Lagerstand/Preisexport" %}

#### Lagerstand/Preisexport aktiv Ist diese Option aktiviert, werden Lagerstände und Preise exportiert. Die Lagerorte, welche Mengen und welche Preisliste exportiert wird, wird im [Reiter "Produkt Export"](#produkt-export) eingestellt. #### Intervalltyp *Beim Lagerstand- und Preisexport kann ein zeitnaher Intervall gesetzt werden, da nicht so viele Daten exportiert werden, wie beim* [*Produktexport*](#produkt-export)*.* Das Intervall, in dem ein Lagerstand-/Preisexport 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 Lagerstand-/Preisexport durchgeführt wird. {% endtab %} {% tab title="Partner" %}

#### Felder für Partner Abgleich (Dublettenabgleich für Kontakte beim Gatewayimport) Die Felder für den Partner Abgleich werden beim Bestellungsimport für den Abgleich der Kontaktdaten aus der Liefer-/Rechnungsadresse mit bestehenden [Kontakten aus den Stammdaten](https://helpcenter.etron.info/stammdaten/kontakte#alle-kontakte) verwendet. Wenn bei einer importierten Bestellung die angegeben Felder wie Name, E-Mail, Straße usw. bereits mit einem vorhandenen Kontakt übereinstimmen, wird dieser übernommen und kein neuer Kontakt in den Stammdaten angelegt. {% hint style="info" %} *Alle unter "Felder für Partner Abgleich" ausgewählten Felder müssen übereinstimmen und befüllt sein. Ist eines der Felder nicht befüllt, und kann daher nicht abgeglichen werden, wird ein neuer Kontakt erstellt.* *Das gilt auch für den Fall, dass unter "Felder für Partner Abgleich" keine Felder gesetzt sind, wodurch alle Felder miteinander abgeglichen werden.* {% endhint %} {% endtab %} {% endtabs %} ## 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 . ### 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* ![Aktions-Button "Bestellungen"](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FoMRSzUJ2OGUNetpD8xYz%2Fimage.png?alt=media\&token=c198310a-8538-4cc6-aa0a-91bd8496fba8) Der Button Bestellungen zeigt die Anzahl an importierten Bestellungen an. Über den Button können die Bestellungen aufgerufen werden. ### Produkte ![Aktions-Button "Produkte"](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2Fp8wr62xe6yWYkFdVudbs%2Fimage.png?alt=media\&token=c4ed42d5-7b58-4764-99b6-f7497dd82049) 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 ![Aktions-Button "Kunden"](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2Fi6H8N5CjiMVKrdTbfMsl%2Fimage.png?alt=media\&token=fd43641b-044f-46d0-8ef9-9f1503163b8a) 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 {% hint style="info" %} *Die Gateway-Protokollierung kann über den Button "Protokollierung" oder das Menü E-Commerce -> Gateway -> Protokollierung aufgerufen werden.* {% endhint %} ![Aktions-Button "Protokollierungen"](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FV6Qse0IU1D6mHoFm449d%2Fimage.png?alt=media\&token=33e6acbc-02ab-4f9d-8cb1-d11c2d46f75e) 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 ![Erneut versuchen](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FZxSGbeldvejCh5KP9Jl0%2Fimage.png?alt=media\&token=121bd790-7fde-4184-9f59-61c329be56a4) ausgewählt. Es werden nur jene Daten erneut übertragen, bei denen die Übertragung nicht erfolgreich war. ### Aktualisieren ![Aktions-Button "Aktualisieren"](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2Fnu2nsMViWG4dWIKFqkN6%2Fimage.png?alt=media\&token=a3f69766-e37f-4054-ba17-baee8a2c9a95) 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 ![Aktions-Button "Export"](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FHz1ra2KLdOKCekAOVxVd%2Fimage.png?alt=media\&token=8ad606b3-059c-4eed-8d30-b308ecf0ab2f) Ist dieser Button aktiviert werden die Produkte, die seit dem letzten Export aktualisiert oder neu angelegt bzw. [veröffentlicht ](https://helpcenter.etron.info/stammdaten/produkte/produkte-produktstammblatt#ist-veroffentlicht)wurden, an die Gateway exportiert. Durch Auswählen des Buttons wird die Einstellung aktiviert/deaktiviert. ### REST OAuth2 ![Aktions-Button "REST OAuth2"](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2Fk6aawGM7hWTa50zRtuS6%2Fimage.png?alt=media\&token=ed5221cb-1cb5-432f-b4de-c7b856a93891) [siehe REST OAuth2 ](#rest-oauth2) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://helpcenter.etron.info/verwaltungsoberflache/e-commerce/gateway.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.