WWS-Infodatenschnittstelle verwenden
Dieses Kapitel wird überarbeitet. Bei Fragen zu diesem Thema wenden Sie sich bitte an Ihren WEBSALE-Ansprechpartner
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.
Hinweis: |
|
|
Die WWS-Infodatenschnittstelle ist speziell für das Warenwirtschaftssystem V4 der D&G entwickelt worden und nur mit diesem System einsetzbar. |
Voraussetzungen für kundenspezifische Abfragen und die Abfrage des Lagerbestands
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
Technische Daten und Einrichtung
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 Anzeigen 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
Integration
Schritt 1: Freischaltung/Aktivierung
Die Funktion muss freigeschaltet werden. Wenden Sie sich bitte an Ihren WEBSALE-Ansprechpartner.
Schritt 2: Konfiguration wws-online-interface.config anlegen
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>) oder über den Online-Servicebereich anlegen.
# Namen der Templates sind frei wählbar
<Templates>
ListEntries = incl_wws_list.htm
ShowEntry = incl_wws_detail.htm
PendingEntries = incl_wws_pending.htm
error = incl_wws_error.htm
StockAmount = incl_wws_stockamount.htm
CommonRequest = incl_wws_commonrequest.htm
</Templates>
# Auftragstypen, textuelle Ersetzung
<Types>
Standard = 1
onChange = submit();
0 = Offene Bestellungen
1 = Historische Einkäufe
</Types>
# Maximalanzahl an Einträgen - Werte für +Entry frei wählbar
<MaxEntries>
Standard = 5
onChange = submit();
+Entry = 5
+Entry = 10
+Entry = 20
+Entry = 50
+Entry = 100
</MaxEntries>
# Auswahl des Zeitraums
<PeriodSelection>
ShowYearsAgo = 10
MonthName1 = Januar
MonthName2 = Februar
MonthName3 = März
MonthName4 = April
MonthName5 = Mai
MonthName6 = Juni
MonthName7 = Juli
MonthName8 = August
MonthName9 = September
MonthName10 = Oktober
MonthName11 = November
MonthName12 = Dezember
AltThisWeek = Diese Woche
AltLastWeek = Letzte Woche
AltThisMonth = Dieser Monat
AltLastMonth = Letzter Monat
AltThisYear = Dieses Jahr
AltLastYear = Letztes Jahr
AltOnchange = submit();
</PeriodSelection>
# Definition der Kopfdaten - Parameter sind optional, aber die Werte fest (H1 ist immer Kundennummer)
<HeadData>
H1 = Kundennummer
H2 = Bestelldatum
H3 = Bestelluhrzeit
H4 = Bestellnummer
H6 = Belegnummer
H7 = Belegdatum
H8 = Betrag
H9 = Vorgang
H11 = Ausgeliefert am
H12 = Ausgeliefert mit
H13 = Paketnummer
H14 = Paketverfolgung
H16 = Shop-Nummer
H50 = Referenz Text
H300 = Offsetfeld 2
</HeadData>
# Definition der Positionsdaten - Parameter sind optional, aber die Werte fest (P1 ist immer Menge)
<PositionData>
P1 = Menge
P2 = Werbemittel
P3 = Artikelnummer
P4 = Varianten-Information 1
P5 = Varianten-Information 2
P6 = Preis
P21 = Bezeichnung
P22 = Lieferstatus
P429 = Feld 429
P388 = Feld 388
</PositionData>
Referenz: Beschreibung der Konfiguration "wws-online-interface.config"
Schritt 3: 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()
Schritt 4: 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.
Hinweis: |
|
|
Wenn ein Warenwirtschaftssystem eingesetzt wird, werden möglicherweise andere technische Felder benötigt. Bitte stimmen Sie sich hierfür mit dem Ansprechpartner Ihres Warenwirtschaftssystem ab und passen Sie den Code entsprechend an. Beispiel D&G: {!ST-Robot}
|
Styles
Referenz: Styles für die WWS-Infodatenschnittstelle
Tags
Referenz: Tags für die WWS-Infodatenschnittstelle