WEBSALE V8s bietet eine hochentwickelte, sichere Online-Schnittstelle, mit der Kunden Informationen direkt aus dem Warenwirtschaftssystem (WWS) des Händlers abrufen können. Über diese Schnittstelle lassen sich insbesondere Kundenaufträge online einsehen und Lagerbestände zu Produkten abfragen.

Technische Daten und Einrichtung

Die technische Schnittstellenbeschreibung der WWS-Infodatenschnittstelle finden Sie unter https://doku.websale.de/schnittstellen. Folgende Verfahren werden verwendet:

▪die Daten werden per HTTP (Port 80) übertragen

▪die Daten werden mit 128 Bit Blowfish verschlüsselt

▪das Datenformat ist XML

▪die Kodierung der Daten ist UTF-8

Falls das WWS nicht direkt über das Internet erreichbar ist, kann WEBSALE Ihnen einen VPN-Tunnel zur Verfügung stellen. Dadurch kann das WWS eine sichere TCP/IP-Verbindung zum Shop über das Internet herstellen und die kundenspezifischen Daten können geschützt vom WWS abgerufen werden.

Damit der Shop eine Verbindung zu Ihrem WWS aufbauen kann, müssen Sie WEBSALE die folgenden Daten mitteilen:

▪IP-Adresse, über die Ihr WWS erreichbar ist. Als Port wird HTTP (Port 80) verwendet

▪URL, die der Shop aufrufen soll

Abstimmung mit der Warenwirtschaft

Die Anzeige der Aufträge im Shop muss mit der Warenwirtschaft abgestimmt werden. Prinzipiell kann der Shop nur die Daten anzeigen, die vom WWS geliefert werden. Bitte gehen Sie daher wie folgt vor:

1. Definition der Daten, die das WWS liefert.

2. Konfiguration dieser Daten im Shop-Modul.

3. Erstellen der Modul-Templates zum Anzeige dieser Daten.

Filtermöglichkeiten bei kundenspezifische Abfragen

Der Shop und das WWS bieten folgende Filtermöglichkeiten an:

▪Anzahl der maximalen Aufträge in der Übersichtsliste

▪Zeitraum von JJJJ-MM-TT bis JJJJ-MM-TT der Aufträge in der Übersichtsliste

▪alternativer Zeitraum (diese Woche, letzte Woche, dieser Monat, letzter Monat usw.) der Aufträge in der Übersichtsliste

▪Auftragstyp, wie z. B. abgeschlossene Aufträge, offene Aufträge, Stornos, Retouren usw. in der Übersichtsliste

▪beliebige Suche innerhalb der vom WWS zum Shop übergebenen Datenfelder

Voraussetzungen für kundenspezifische Abfragen

Damit die Schnittstelle verfügbar ist, müssen folgende Bedingungen erfüllt sein:

▪die Schnittstelle wurde von der WEBSALE AG freigeschaltet

▪der Käufer ist angemeldet

▪der Käufer verfügt über eine Kundennummer

▪die Kundennummer darf vom Käufer im Shop nicht editierbar sein

Voraussetzungen für die Abfrage des Lagerbestands eines Produkts

Damit die Schnittstelle verfügbar ist, muss folgende Bedingung erfüllt sein:

▪die Schnittstelle wurde von der WEBSALE AG freigeschaltet

Templates für kundenspezifische Abfragen

Sie benötigen fünf Templates:

▪Master-Template zum Anzeigen der Aufträge

▪Modul-Template zum Anzeigen der Übersichtsliste (wird per Extern Include im Master-Template angezeigt)

▪Modul-Template zum Anzeigen eines einzelnen Auftrages (wird per Extern Include im Master-Template angezeigt)

▪Modul-Template zum Anzeigen von noch nicht im WWS übernommen Aufträgen (wird per ExternInclude im Master-Template angezeigt)

▪Modul-Template zum Anzeigen von Fehlermeldungen (wird per ExternInclude im Master-Template angezeigt)

Das Master-Template wird über <a href="~WS-SSLLoadTpl(ws_online_erp.htm)~">....</a> im Benutzerkonto aufgerufen. Der Name des Templates ist frei definierbar.

Im Master-Template werden die Modul-Templates mittels WS-ExternInclude($WS-OnlineERPLink$) eingebunden.

Sie können das innere Tag auch mit {WS-OnlineERPLink}...{/WS-OnlineERPLink} klammern, um die Schnittstelle nur dann aufzurufen/anzuzeigen, wenn diese auch verfügbar ist.

{WS-OnlineERPLink}
   ~WS-ExternInclude($WS-OnlineERPLink$)~
{/WS-OnlineERPLink}

Referenz: WS-SSLLoadTpl()
Referenz: WS-OnlineERPLink
Wegweiser: Externe Includes verwenden
Referenz: WS-ExternInclude()

Templates für Lagerbestands-Abfragen

Sie benötigen 3 Templates:

▪Master-Template zum Anzeigen des Lagerbestands

▪Modul-Template zur Anzeige des Lagerbestands (wird per ExternInclude im Master-Template angezeigt)

▪Modul-Template zum Anzeigen von Fehlermeldungen (wird per ExternInclude im Master-Template angezeigt)

Das Master-Template wird über <a href="~WS-SSLLoadTpl(ws_online_erp_stock.htm)~&prod_index=~PR-ProdIndex~&depvar_index=~PR-VarIndex~">....</a> aufgerufen. Der Name des Templates ist frei definierbar.

Im Master-Template werden die Modul-Templates mittels ~WS-ExternInclude($WS-OnlineERPStockLevelLink$&erp_pn=$PR-NumberEnc$)~ eingebunden. Dabei ist der Parameter erp_pn die übergebene Produktnummer. Es kann ein beliebiges Produktdatenfeld übergeben werden.

Sie können das innere Tag auch mit {WS-OnlineERPStockLevelLink}...{/WS-OnlineERPStockLevelLink} klammern, um die Schnittstelle nur dann aufzurufen/anzuzeigen, wenn diese auch verfügbar ist. Zusätzlich sollten Sie den Bereich immer mit dem negativen Bereichs-Tag {!ST-Robot}...{/!ST-Robot} versehen, damit keine Anfragen von Suchmaschinen (Webcrawler) an das Warenwirtschaftssystem gesendet werden.

{!ST-Robot}
   {WS-OnlineERPStockLevelLink}
      ~WS-ExternInclude($WS-OnlineERPStockLevelLink$&erp_pn=$PR-NumberEnc$)~
   {/WS-OnlineERPStockLevelLink}
{/!ST-Robot}

Referenz: WS-OnlineERPStockLevelLink

Optional kann auch eine FilialID übergeben oder ausgewählt werden.
Für weitere Informationen nehmen Sie bitte Kontakt mit WEBSALE auf.

Konfiguration

Für jeden Subshop, in dem Sie die WWS-Infodatenschnittstelle verwenden möchten, müssen Sie eine Konfiguration mit dem Namen wws-online-interface.config im Konfigurationsverzeichnis des Shops hinterlegen (Pfad: ../konfiguration/<subshop>).

Referenz: Beschreibung der Konfiguration "wws-online-interface.config"

Styles

Referenz: Styles für die WWS-Infodatenschnittstelle

Tags

Referenz: Tags für die WWS-Infodatenschnittstelle