> For the complete documentation index, see [llms.txt](https://helpcenter.etron.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.etron.info/verwaltungsoberflache/e-commerce/gateway.md). # Gateways ETRON Gateway, Webshop-Anbindung, Produktexport, Bestellungsimport, Lagerstandexport, API {% hint style="success" %} *Modul: ETRON Gateway* {% endhint %} > *E-Commerce -> Gateway -> Gateways* Über das Gateway werden Produkte, Preise, Lagerstände, Bilder und weitere Stammdaten exportiert. Bestellungen werden aus dem Webshop in ETRON onRetail importiert. Die Kommunikation erfolgt über eine REST-API. {% hint style="info" %} *Am Produktstammblatt stehen im Reiter* [*Gateway*](/verwaltungsoberflache/stammdaten/produkte/produkte-produktstammblatt/gateway.md) *zusätzliche Exportfelder zur Verfügung.* {% endhint %}

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

In der Gateway-Ansicht werden Einstellungen und Übertragungen verwaltet. #### **Gateway Code** Der Gateway-Code dient als eindeutiger Token zur Identifizierung des Gateways. Er wird automatisch erstellt und kann geändert werden. #### **Verantwortliche Person** Es wird ein interner Benutzer hinterlegt. Bei aktivierten Fehler-E-Mails werden Übertragungsfehler an diese Person gesendet. #### **Gateway-URL** Es wird die API-Adresse des externen Gateways hinterlegt. #### **Verbindungs-ID / Zugriffs-Token** Verbindungs-ID und Zugriffs-Token kennzeichnen die Verbindung zwischen ETRON onRetail und dem Webshop eindeutig. {% hint style="info" %} *Verbindungs-ID und Zugriffs-Token sind nur für Systemadministratoren sichtbar.* {% endhint %} 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 Es werden die Sprachen festgelegt, in denen Produktdaten exportiert werden. Standardmäßig werden alle aktiven Systemsprachen verwendet. #### 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) {% hint style="info" %} *Beim Bestellungsimport werden Liefervorgänge/Lieferscheine prinzipiell für das Lager erstellt, das in der Gateway-Übersicht im Feld "Lager" sichtbar ist.*\ *Das Feld Lager wird in der Gateway-Übersicht eingeblendet:*\\

\ \_Bei einer Versandmethode mit dem Anbieter\_ \[\_Abholung\_]\(/pages/HnelS6bUvo6Rev7FCEV2#abholung-im-geschaft) \_wird das dort hinterlegte Lager für die Liefervorgänge verwendet.\_ {% endhint %} #### Exportierte Menge (Lagerstand Export) * **Freie** Es werden vorrätige Mengen ohne reservierte Einheiten exportiert. (exkl. der Mengen die z.B. bereits für eine Auslieferung reserviert sind ) * **Vorrätige** Es werden vorrätige Mengen einschließlich reservierter Einheiten exportiert. (inkl. der Mengen die z.B. bereits für eine Auslieferung reserviert sind ) * **Prognostizierte** Es wird die prognostizierte Menge unter Berücksichtigung erwarteter Lieferungen und Reservierungen exportiert. #### Preislisten exportieren Die [Produkt-Preisliste](/verwaltungsoberflache/einstellungen/allgemeine-einstellungen/verkauf/preiskalkulation.md#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](/verwaltungsoberflache/stammdaten/produkte/produkte-produktstammblatt/gateway.md#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 enthält den **Client Key** und das **Client Secret** der OAuth2-Verbindung. Darüber kann bei Bedarf ein ETRON-Supportzugriff eingerichtet werden. {% hint style="info" %} *Für die Kommunikation mit ETRON onRetail müssen Client Key und Client Secret hinterlegt sein. Nach der Einrichtung werden diese Werte nicht geändert.* {% endhint %} {% endtab %} {% tab title="Auftragseinstellungen" %}

Einstellungen zum Auftragsimport #### Vertriebskanal Der Vertriebskanal legt fest, welchem [Verkaufsteam](/verwaltungsoberflache/konfiguration/kundenpflege/verkaufsteams.md) 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 Es wird die Anzahl der noch zu importierenden Bestellungen angezeigt. #### Intervalltyp Es wird der Intervalltyp des automatischen Bestellungsimports festgelegt. #### Intervallnummer Es wird die Anzahl der Intervalleinheiten für den automatischen Bestellungsimport festgelegt. {% 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](/verwaltungsoberflache/konfiguration/auftragswesen/versandmethoden.md) "Versandkostenfrei" zugeordnet. *Versandmethoden werden unter* [*Konfiguration* -> *Auftragswesen* -> *Versandmethoden*](/verwaltungsoberflache/konfiguration/auftragswesen/versandmethoden.md) *angelegt.* #### **Versandart (Typ)** Die Bezeichnung der Versandart bzw. Versandmethode im Webshop **Versandmethode** Beim Auftragsimport wird die Versandart der in onRetail hinterlegten [Versandmethode](/verwaltungsoberflache/konfiguration/auftragswesen/versandmethoden.md) 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](/verwaltungsoberflache/konfiguration/fibu-daten/steuerzuordnung.md) 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](/verwaltungsoberflache/konfiguration/fibu-daten/steuerzuordnung.md) 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](/verwaltungsoberflache/fibu-daten/journale.md) 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](/verwaltungsoberflache/stammdaten/kontakte.md#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** startet den manuellen Export geänderter und noch nicht exportierter Daten. Produkte und Kategorien werden berücksichtigt. Ein Initialexport überträgt alle Produkte unabhängig von Änderungen. Dieser wird durch den ETRON-Support ausgelöst. ### BESTELLUNGEN AKTUALISIEREN ETRON onRetail ruft Webshop-Bestellungen im festgelegten Intervall ab. Über **Bestellungen aktualisieren** wird ein sofortiger manueller Import gestartet.

### Bestellungen > *E-Commerce* -> *Gateway* -> *Bestellungen*

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

Ü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. {% hint style="info" %} *Für Unterstützung bei der Fehlerbeseitigung steht der* [*ETRON Support*](/support-sonstiges/support-kontaktieren.md) *gerne zur Verfügung.* {% endhint %} Nachdem die Fehlerquelle beseitigt wurde, kann der erneute Bestellimport durchgeführt werden. Die Bestellung wird über *E-Commerce* -> *Gateway* -> *Bestellungen* in der Listenansicht aufgerufen.

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

Über den Button ![Erneut Importieren](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FtqHsdvmTBKFm2TepY277%2Fimage.png?alt=media\&token=4f4f74fa-967b-424f-9354-b70089338c9c)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 {% hint style="info" %} *Die Gateway-Protokollierung wird über **Protokollierung** oder über* *E-Commerce* -> *Gateway* -> *Protokollierung* *aufgerufen.* {% endhint %}

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

Bei aktivem Button werden seit dem letzten Import eingegangene Bestellungen automatisch abgerufen. Durch Auswählen des Buttons wird die Einstellung aktiviert/deaktiviert. ### Export

Bei aktivem Button werden geänderte oder neu [veröffentlichte](/verwaltungsoberflache/stammdaten/produkte/produkte-produktstammblatt.md#ist-veroffentlicht) Produkte automatisch exportiert. Durch Auswählen des Buttons wird die Einstellung aktiviert/deaktiviert. ### REST OAuth2

**Weitere Informationen**\ [REST OAuth2](#rest-oauth2) ### Fehler-E-Mails Bei aktivierter Option **Fehler-E-Mails senden** wird die verantwortliche Person automatisch benachrichtigt. Die Benachrichtigung wird bei fehlerhaften Gateway-Übertragungen versendet. ### FAQ Gateway

Der Lagerstand im Webshop weicht von ETRON onRetail ab

Es ist zu prüfen, ob der Lagerstand-/Preisexport aktiv ist. Zudem sind Intervall, Versand-Lagerorte und **Exportierte Menge** zu prüfen.

Eine Webshop-Bestellung wird nicht importiert

Es ist über **Bestellungen aktualisieren** ein manueller Import zu starten. Bei weiterhin bestehenden Fehlern ist die Protokollierung auf Fehlerstatus zu prüfen.

Eine Bestellung enthält einen Importfehler

Die Fehlerbeschreibung ist in der Chatter-Aktivität der Bestellung zu prüfen. Nach Behebung der Ursache ist **Erneut importieren** auszuwählen.

Für jede Bestellung wird ein neuer Kontakt angelegt

Die Felder unter **Partner** sind zu prüfen. Für den Abgleich müssen alle ausgewählten Felder befüllt sein und übereinstimmen.

**Weitere Informationen:**\ [Gateway-Felder am Produktstammblatt](/verwaltungsoberflache/stammdaten/produkte/produkte-produktstammblatt/gateway.md)\ [Versandmethoden](/verwaltungsoberflache/konfiguration/auftragswesen/versandmethoden.md)\ [Steuerzuordnungen](/verwaltungsoberflache/konfiguration/fibu-daten/steuerzuordnung.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://helpcenter.etron.info/verwaltungsoberflache/e-commerce/gateway.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.