> ## 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.

# WSOM-from-Shop

> Bestellungen, Anfragen, Adressänderungen und Gutscheindaten mit dem lokal installierten WEBSALE Order Manager abholen, mit Konvertierungsmodulen und dem WEBSALE-Sektionsformat. Vorgängerversion für Bestandskunden.

Der WEBSALE Order Manager, kurz WSOM, ist ein Windows-Programm, das auf Ihrem System installiert wird und Daten vom Shop-Server abholt: Bestellungen, Adressdatenänderungen, Anfragen und Gutscheindaten.

Diese Abholweise ist die Vorgängerversion und nur noch für Bestandskunden relevant. Für neue Anbindungen wird [SOAP-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/soap-from-shop.md) empfohlen.

| Eigenschaft | Wert |
| - | - |
| Übertragungsrichtung | WEBSALE Shop → Warenwirtschaft (Data-from-Shop) |
| Übertragungsart | WSOM |
| Dateiformate | CSV, XML, PRD |
| Verschlüsselung | 128 Bit Triple DES |

Jeder Datensatz landet als eigene Datei in einem Verzeichnis Ihrer Wahl. Der Transfer läuft manuell oder vollautomatisch in regelmäßigen Intervallen.

## Zugangsdaten und manuelle Abholung

Prüfen Sie zuerst unter **Einstellungen → Zugangsdaten**, ob Shop-ID und Passwort richtig eingetragen sind. In diesem Dialog konfigurieren Sie bei Bedarf auch einen HTTP-Proxy.

Setzen Sie anschließend für jeden Datentyp, den Sie abholen möchten, den entsprechenden Haken und starten Sie die Übertragung mit **OK**.

## Automatisierte Abholung

Gehen Sie zunächst wie bei der manuellen Abholung vor und achten Sie zusätzlich darauf, dass **Passwort speichern** angehakt ist. Starten Sie die Übertragung einmal von Hand, um die Zugangsdaten zu prüfen, bevor Sie den Automatismus einschalten.

Rufen Sie dann **Einstellungen → Automatisch abholen…** auf und legen Sie Uhrzeiten und Intervalle fest.

Die erste Abholung erfolgt dabei nicht exakt zur eingestellten Startzeit. Bei einer Startzeit von 09:30 Uhr läuft sie beispielsweise irgendwann zwischen 09:30 und 09:35 Uhr an. Wenn Ihre Weiterverarbeitung auf eine genaue Uhrzeit angewiesen ist, planen Sie diesen Versatz ein.

## Die vier Datenarten

Für jede Datenart aktivieren Sie im Dialog **Einstellungen → Zugangsdaten** das zugehörige Kästchen. Das Zielverzeichnis lässt sich optional unter **Einstellungen → Verzeichnisse** ändern. Je abgeholtem Datensatz entsteht eine einzelne Datei.

| Datenart | Kästchen | Dateiendung | Format und Inhalt |
| - | - | - | - |
| Bestellungen | **Bestellungen** | `.ord` | [WS-Bestelldaten](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten.md) |
| Anfragen | **Anfragen** | `.inq` | [WS-Anfragedaten](https://dokumentation.websale.de/v8s/schnittstellen/service-und-app/ws-anfragedaten.md) |
| Adressänderungen | **Adressänderungen** | `.adr` | [WS-Adressdatenänderungen](https://dokumentation.websale.de/v8s/schnittstellen/kundendaten/ws-adressdatenaenderungen.md) |
| Gutscheindaten | **Gutscheine** | `.dat` | [WS-Gutscheindaten (from-Shop)](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale/ws-gutscheindaten-from-shop.md) |

Bei Gutscheinen gilt eine Einschränkung, die leicht zu Fehlschlüssen führt: Abgeholt werden nur Gutscheine, die über den Gutschein-Generator neu generiert wurden. Ob ein Gutschein im Shop eingelöst wurde, steht nicht in diesen Daten. Dafür müssen Sie die Bestelldaten auswerten.

## Das Format der Bestelldaten

Das Standardformat ähnelt XML, ist aber nicht XML. Die Daten sind in Sektionen gegliedert, die jeweils einen Namen tragen:

```
<ID>
 ...
</ID>
```

Innerhalb einer Sektion stehen die Werte als Zuweisungen:

```
OrderNumber = 0952872507055
```

Als Zeilentrenner dient CR/LF. Die Reihenfolge der Parameter innerhalb einer Sektion und die Reihenfolge der Sektionen untereinander sind beliebig. Vor dem Parameternamen sowie vor und hinter dem Gleichheitszeichen sind beliebig viele Leerzeichen oder Tabs zulässig. Ihr Parser darf sich also weder auf eine Reihenfolge noch auf eine feste Einrückung verlassen.

Ausschnitt eines Bestelldatensatzes:

```
<Header>
 FormatID = WEBSALE-8
 Generator = WEBSALE 8.0
 Copyright(c) = WEBSALE AG 2012, www.websale.de
</Header>

<ID>
 MallID = test
 ShopID = rwa-5
 SubShopID = Deutsch
 OrderNumber = 1118136132311
 Date = 24.10.09
 Time = 18:04:59
</ID>
```

Parameter und Werte kommen im Zeichensatz ISO-8859-1. Parameternamen sind maximal 64 Zeichen lang, Werte maximal 255 Zeichen, sofern nicht ausdrücklich anders gekennzeichnet.

## Konvertierungsmodule

Statt das Eingangsverzeichnis regelmäßig abzufragen, können Sie ein eigenes Programm je eingehendem Datensatz aufrufen lassen. Dieses Programm übernimmt dann die Weiterverarbeitung, beispielsweise die Konvertierung in ein eigenes Format oder das Einlesen in Ihre Warenwirtschaft. Das mitgelieferte XML-Modul nutzt genau diesen Mechanismus.

Gegenüber dem Pollen des Verzeichnisses hat das zwei Vorteile: Ihr Programm startet nur, wenn tatsächlich neue Daten eingegangen sind, und es kann nicht passieren, dass Ihr Programm und der WSOM gleichzeitig auf dieselbe Datei zugreifen.

Konfiguriert werden eigene Module unter **Einstellungen → Konvertierungsmodule**:

* **Aktiviert/Bestellungen konvertieren** legt fest, ob das Modul überhaupt aufgerufen wird.
* **Anfragen** bestimmt, ob zusätzlich zu Bestellungen auch abgeholte Anfragen konvertiert werden.
* **Adressendatenänderungen** und **Gutscheine** leiten auch diese Datenarten an Ihr Modul weiter.

## Verwandte Themen

* Wegweiser: [Übertragung: Trigger für Import und Export](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung.md)
* Wegweiser: [SOAP-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/soap-from-shop.md)
* Wegweiser: [WS-Bestelldaten](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten.md)


## Related topics

- [SOAP-from-Shop](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung/soap-from-shop.md)
- [WS-Adressdatenänderungen](https://dokumentation.websale.de/v8s/schnittstellen/kundendaten/ws-adressdatenaenderungen.md)
- [Übertragung: Trigger für Import und Export](https://dokumentation.websale.de/v8s/schnittstellen/uebertragung.md)
- [WS-Gutscheindaten (from-Shop)](https://dokumentation.websale.de/v8s/schnittstellen/marketing-seo-und-portale/ws-gutscheindaten-from-shop.md)
- [WS-Anfragedaten](https://dokumentation.websale.de/v8s/schnittstellen/service-und-app/ws-anfragedaten.md)


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