# 🔧 fashion XL: Connector

{% hint style="success" %}
*Modul: FashionXL*
{% endhint %}

> *Konfiguration* ➜ *Weitere Stammdaten* ➜ *fashion XL* ➜ *Connector*

Mit dem fashion XL-Connector können Produkt- und Preisdaten aus dem ERP-System fashion XL (in Zusammenarbeit mit ImPuls) automatisiert in ETRON onRetail übernommen werden. Voraussetzung ist ein entsprechendes Setup durch den ERP-Partner sowie die Einrichtung des FTP-Zugangs.

## Wie funktioniert der Import?

**1. Kommunikation über FTP**

Die Daten werden vom ERP täglich (ab 18:00 Uhr) auf einem FTP-Server bereitgestellt.\
ETRON onRetail holt sich diese XML-Dateien **alle 15 Minuten** automatisiert ab und verarbeitet sie schrittweise.\
Nach dem erfolgreichen Import werden die nicht mehr benötigten Dateien auf dem FTP-Server gelöscht.

**2. Importierte Datenarten**

Je nach aktivierten Optionen können folgende Informationen importiert werden:

* **Produkte**: Vorlagen, Varianten, Attribute, Kategorien
* **Preise**: UVP und spezifische Preislisten
* **Lagerstände**: pro Lagerort (Storage Areas)

{% hint style="info" %}
*Der **Belegexport** ist derzeit noch nicht verfügbar.* 
{% endhint %}

## Konfiguration

{% stepper %}
{% step %}

### Connector anlegen

Unter *Konfiguration ➜ Weitere Stammdaten ➜ Connector* einen neuen Eintrag erstellen

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F6mc2En8xPPGlefe9RZAw%2Fimage.png?alt=media&#x26;token=a6bea40c-8a94-49af-8a80-da9e2a120d03" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### FTP-Zugangsdaten hinterlegen

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F6cVlYyQ1tCzZzxF3X4gK%2Fimage.png?alt=media&#x26;token=6f102af0-1049-4f16-8a6a-255de31fe56e" alt=""><figcaption></figcaption></figure>

Beispiel für Host-URL:\
`123.host-my-website.com`\
Die Zugangsdaten und Port werden vom ERP-Anbieter bereitgestellt.
{% endstep %}

{% step %}

### Import-Typen aktivieren

<div align="left"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F6HB2IZSurNTmrYAZePik%2Fimage.png?alt=media&#x26;token=1b781f42-60ec-44c5-865b-54e0393d7880" alt=""><figcaption></figcaption></figure></div>

In der Detailansicht des Connectors kann ausgewählt werden, welche Datentypen importiert werden sollen:

* Produktdaten
* Lagerbestände
* Preislisten
  {% endstep %}

{% step %}

### Verzeichnisse und Verarbeitungsgröße definieren

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FCqivEpGeZGYePaRWwqHg%2Fimage.png?alt=media&#x26;token=54df8f2c-4034-4d7d-9d8a-fea21a351f0c" alt=""><figcaption></figcaption></figure>

Für jeden Import-Typ (Produkt, Preis, Lager, etc.) muss im entsprechenden Reiter folgende Konfiguration vorgenommen werden:

Im Feld **Importverzeichnis** muss das zu verwendende Verzeichnis (z. B. /Export/ oder /Import/), auf dem sich am FTP-Server die Daten befinden, hinterlegt werden.

Im Feld **Import Verarbeitungsgröße** kann eingestellt werden, wie viele Datensätze pro Import verarbeitet werden. Ist z.B. beim Produktimport "20" eingestellt, werden 20 Produktvorlagen mit ihren Varianten und Kategorien verarbeitet.
{% endstep %}

{% step %}

### Attribute für Produkte mappen

Im Reiter "Produkte"  kann das Mapping der Attribute (wie Größe, Farbe, Waschung,..) für die  Variantenerstellung erstellt werden.

Die Attribute müssen bereits mit dem [Varianten-Erstellungsmodus "Dynamisch"](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten-produkte/produkte/varianten-attribute#dynamisch) angelegt sein.

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FXE4qoGPBbuVipCSx53EB%2Fimage.png?alt=media&#x26;token=baede391-4b64-4282-9dd0-125d622c6629" alt=""><figcaption></figcaption></figure>

Der Attribut-Tag steht für die Bezeichnung des Attributs in der Import-Datei. Der Daten-Tag legt fest, welcher Tag die Attributwerte enthält.&#x20;

<**Imp\_Size**>\
&#x20;   <**code**>M\</code>\
&#x20;   \<position>3\</position>\
\</Imp\_Size>\
\<Imp\_Length xsi:nil="true"/>\
<**Imp\_Color**>\
&#x20;   \<code>159\</code>\
&#x20;   <**description**>Aubergine\</description>\
\</Imp\_Color>
{% endstep %}

{% step %}

### Gesamtlager festlegen

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FLfHcUC4dQfyYXsoEMrTC%2Fimage.png?alt=media&#x26;token=4c6556f7-f2e4-4c87-82d4-e01ae5f19485" alt=""><figcaption></figcaption></figure>

Beim Lagerimport muss in ETRON onRetail ein Gesamtlager (z. B. eine Filiale) zugewiesen werden.\
Der Lagercode aus dem ERP-System muss ebenfalls korrekt hinterlegt sein, damit die Verknüpfung funktioniert.\
Zusätzlich werden Storage Areas (z. B. Regalorte) automatisch übernommen und bei Bedarf neu angelegt.
{% endstep %}
{% endstepper %}

## Datenimport durchführen

* Über den Button **"Import"** wird der Import gestartet.<br>

  <div align="left"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FiJBCUGBoaYTVmPgXj5Sg%2Fimage.png?alt=media&#x26;token=dbfaa23e-9792-4825-a7db-f051595c0c3f" alt=""><figcaption></figcaption></figure></div>
* Der Import verarbeitet die zwischengespeicherte Datei schrittweise (z. B. 50 Produkte pro Intervall).<br>

  <div align="left"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FQ2o1D0Jxfi7DqXdGzBKD%2Fimage.png?alt=media&#x26;token=053a1ba0-4004-4756-a1a8-546638bfcb83" alt=""><figcaption></figcaption></figure></div>
* Bereits importierte Produkte werden erkannt und aktualisiert, nicht dupliziert.

### **Wichtige Hinweise**

* Wenn neue Daten im ERP vorliegen und sofort importiert werden müssen, **müssen die alten Anhänge ("\[Produkt, Preis, Lager]-import" und "Letzter \[Produkt, Preis, Lager]-import") gelöscht** werden. Nur dann wird die neueste Datei vom FTP erneut abgeholt.

  <figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FKd9JRp4ANpcoiv2kNENJ%2Fimage.png?alt=media&#x26;token=5102c759-bce7-46bc-9aec-b97a5e370290" alt=""><figcaption></figcaption></figure>
* Beim Initialimport empfiehlt es sich, **nur die Produktdaten zu aktivieren**. Lager und Preise können danach separat aktiviert werden.
* Sollte der Import hängen bleiben (z. B. bei vielen Produktvarianten), kann die **Verarbeitungsgröße reduziert** werden (z. B. von 50 auf 10).<br>

  <div align="left"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FvT0RbvwcX6VGkKZaoWfy%2Fimage.png?alt=media&#x26;token=b0d2ad00-f145-441e-9049-d4c347a6906e" alt=""><figcaption></figcaption></figure></div>

## Tipps und Besonderheiten

* **Preislisten** aus dem ERP müssen genau gemappt werden (z. B. `UVP_PRICES` → Preislistencode in onRetail).\
  **Standard Preislisten-Code**: Wird unter dem [Produktstammblatt ](https://helpcenter.etron.info/stammdaten/produkte/produkte-produktstammblatt/allgemeine-informationen#verkaufspreis)als Verkaufspreis gesetzt.

  <figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FFFV91gjEdvDuO2XQJoda%2Fimage.png?alt=media&#x26;token=0619f757-e499-42c5-b1af-ae655df22e93" alt=""><figcaption></figcaption></figure>
* **Lagerzuordnung** erfolgt anhand von Lagerorten, die aus dem ERP mitgeliefert werden. Wenn die Lagerorte im hinterlegten Gesamtlager nicht existieren, werden sie automatisch in ETRON onRetail neu angelegt.
* Die **Verarbeitung erfolgt lokal** – es wird immer nur die zwischengespeicherte Datei verarbeitet, nicht direkt der FTP.
* **Logs** vom Import und Export können unter[ Einstellungen -> System -> Logging](https://helpcenter.etron.info/verwaltungsoberflache/einstellungen/system/logging) aufgerufen werden.

<details>

<summary>FAQ</summary>

### **Was passiert, wenn ich auf „Import“ klicke, ohne etwas zu löschen?**

Dann wird **weiterhin die zwischengespeicherte Datei verarbeitet,** nicht die neueste vom FTP-Server. Erst durch das Löschen der bestehenden Anhänge kann eine neue Datei erneut abgeholt werden.

### **Können bereits importierte Produkte überschrieben werden?**

Ja. Produkte werden anhand ihrer [Artikelnummer](https://helpcenter.etron.info/stammdaten/produkte/produkte-produktstammblatt/allgemeine-informationen#interne-referenz) erkannt. Bereits importierte Produkte werden **aktualisiert**, nicht doppelt angelegt.

### **Welche Produktinformationen werden übernommen?**

Die Schnittstelle übernimmt:

* [Produktvorlagen](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte)
* [Varianten](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte/produkt-varianten)
* [Attribute ](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte/produkte-produktstammblatt/attribute-and-varianten)
* [Kategorien](https://helpcenter.etron.info/verwaltungsoberflache/konfiguration/stammdaten-produkte/kategorien)

### **Wie funktioniert die Preiszuordnung?**

Im ERP wird jeder Preis **einer Preisliste** zugeordnet (z. B. `UVP_PRICES`). Diese Codes müssen im Connector bekannt sein. Die Preise werden in der gewählten Preisliste als **Fixpreise** eingetragen.

### **Können mehrere Preislisten im Connector hinterlegt werden?**

Ja. Sie müssen mithilfe der Codes in ETRON onRetail und im Connector gemappt werden.

### **Warum sollte ich den Import auf 10 oder 20 Einträge begrenzen?**

Bei sehr vielen Produkten (z. B. 15.000 Varianten) kann es zu **Performanceproblemen** kommen. Eine niedrigere Verarbeitungsgröße sorgt für stabilere Importe, besonders beim Erstimport.

### **Was passiert bei Lagerimporten?**

Die Lagerstände werden pro Lagerort (Storage Area) übernommen. Lagerorte müssen vom Kunden korrekt zugewiesen werden.\
⚠️ Achtung: In der aktuellen Version kann es zu Problemen bei Inventuren kommen (z. B. doppelte Zählungen). Hier empfiehlt sich Rücksprache mit dem Support.

### **Welche Daten werden von ETRON onRetail an das ERP zurückgeschickt?**

Aktuell **nur Belegdaten (Verkäufe)** – allerdings ist der Belegexport derzeit **nicht funktionsfähig** und befindet sich noch in Entwicklung.

</details>


---

# 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/konfiguration/weitere-stammdaten/fashion-xl-connector.md?ask=<question>
```

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.