> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# WS-DataFlowManager

> Produkt-, Kategorie- und Lagerbestandsdaten über Export-Templates in beliebige Formate exportieren und an externe Such- und Marketing-Dienste übergeben.

Mit dem DataFlowManager erzeugen Sie aus Ihren Shopdaten Feeds in nahezu beliebigem Format und übergeben sie an externe Dienste, beispielsweise an FACT-Finder, FINDOLOGIC, econda, Google Shopping oder Facebook.

| Eigenschaft | Wert |
| - | - |
| Übertragungsrichtung | WEBSALE Shop → externe Systeme (Data-from-Shop) |
| Dateiformate | CSV, XML, JSON und weitere |

Der Aufbau der Ausgabedatei steckt vollständig in einem Template. Das heißt: Was ein Dienst an Feldern und Struktur erwartet, bilden Sie im Template nach, ohne dass der Shop das Format kennen muss.

Die Liste der verfügbaren Tags steht unter [WS-DataFlowManager: Tag-Referenz](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale/ws-dataflowmanager/tag-referenz.md).

## Produktdatenexport aktivieren

Der Export über ein Template wird aktiv, sobald die Template-Datei im Ausgabeverzeichnis der Exportdatei liegt. Der Dateiname ist fest vorgegeben:

```
export-template.txt
```

Sobald Sie Umlaute als Spaltenüberschriften oder in festen Ausgabefeldern verwenden, muss das Template in Unicode oder ANSI kodiert sein.

Im selben Verzeichnis legt der Shop eine Datei `lastexport.ini` an. Sie enthält Zeitstempel und laufende Nummer des letzten Exports. Beide Angaben werden für eine etwaige Bildübertragung gebraucht und für die Versionsnummer der Datei, die manche Formate verlangen.

## Kategoriedatenexport aktivieren

Für Kategoriedaten gilt dasselbe Prinzip mit einem eigenen Dateinamen:

```
category-template.txt
```

Anders als bei Produktdaten lassen sich Kategoriedaten ausschließlich über ein Template exportieren.

## Felder vor der Ausgabe umrechnen

Manche Felder müssen vor der Ausgabe in andere Werte übersetzt werden, beispielsweise eine interne Mehrwertsteuerkennung in den tatsächlichen Steuersatz. Dafür dienen die `PRCONV-`-Tags und zwei Dateien im Ausgabeverzeichnis.

In `convert-fields.csv` tragen Sie ein, welche Felder konvertiert werden:

| Spalte | Inhalt |
| - | - |
| `Org-Name` | Name des Produktdatenfeldes, beispielsweise `VATIndex` |
| `Conv-Name` | Name im Template, ohne den Präfix `PRCONV-`, beispielsweise `Tax` |
| `Table` | Dateiname der Konvertierungstabelle. Sie muss ebenfalls im Ausgabeverzeichnis liegen, Pfadangaben sind nicht zulässig. |

Die Konvertierungstabelle selbst hat zwei Spalten:

| Spalte | Inhalt |
| - | - |
| `Org-Value` | Wert des Produktdatenfeldes, beispielsweise `1`. Ein `*` steht für den Standardwert, der greift, wenn kein passender Eintrag gefunden wird. |
| `Conv-Value` | Konvertierter Wert, beispielsweise `0.19` |

Der Stern als Standardwert lohnt sich immer: Ohne ihn bleibt das Feld leer, sobald ein unerwarteter Wert auftaucht, und der Fehler fällt erst beim Empfänger auf.

## Spezialfeatures

Was sich mit Template und Tags allein nicht abbilden lässt, konfigurieren Sie in der Datei `special.ini` im Ausgabeverzeichnis. Pflichtparameter ist `Feature`, die weiteren Parameter hängen von dessen Wert ab.

| Feature | Beschreibung |
| - | - |
| `Sport-Tec-Prices` | Exportiert zusätzlich die Preise eines anderen Subshops. Welcher das ist, legt der Parameter `SrcSubshop` fest. Die zusätzlichen Preise fügen Sie über `~STP-Price~`, `~STP-BulkAmount~`, `~STP-BulkPrice~` und `{@STP-BulkPrices}` ein. |

## Import beim Empfänger anstoßen

Viele Dienste müssen nach dem Export erfahren, dass neue Daten bereitliegen. Dafür hinterlegen Sie im Bereich **Zeitsteuerung** unter **URL die nach dem Ende des Exports aufgerufen wird** eine Trigger-URL.

Braucht der Empfänger eine Authentifizierung, geben Sie sie in der URL mit:

```
https://Username:Passwort@domain.de/...
```

Zusätzlich wählen Sie als HTTP-Methode `GET` oder `POST`. Welche davon richtig ist, muss Ihnen der externe Dienstleister zusammen mit der URL nennen.

## Verwandte Themen

* Wegweiser: [WS-DataFlowManager: Tag-Referenz](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale/ws-dataflowmanager/tag-referenz.md)
* Wegweiser: [Marketing, SEO und externe Portale](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale.md)
* Wegweiser: [Datenfeed-Einrichtung](https://dokumentation.websale.de/ws-search/datenfeed-einrichtung.md)


## Related topics

- [WS-DataFlowManager: Tag-Referenz](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale/ws-dataflowmanager/tag-referenz.md)
- [Marketing, SEO und externe Portale](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale.md)
- [Spezielle Online-Dienste](https://dokumentation.websale.de/v8s/online-servicebereich/spezielle-online-dienste.md)
- [Konfiguration wsautoexpdelcost.cfg](https://dokumentation.websale.de/v8s/referenz/konfigurationen/konfiguration-wsautoexpdelcost-cfg.md)
- [Arbeiten mit dem Online-Servicebereich](https://dokumentation.websale.de/v8s/arbeiten-mit-dem-online-servicebereich.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.