Erläuterung GWS-Schnittstelle plus Zielsetzung - Vorteile
Funktionsübersicht:
Kundendatenanlage aus GWS via CSV Import.
Wird ein Kunde in GWS als Webshopkunde angelegt bzw. eingestuft, wird dieser in einem CRON Job (CSV Update via FTP-Server) eingespielt.
Kundenaustausch (User Replikation)
Hier stehen alle Felder des Kundendatenaustausches drin. Dieser besteht aus 2 Dateien (onventiscostumer und onventisuser). Shop-Benutzerausgabe aus gevis.docx
Wenn Benutzer angelegt werden, dann stellt die Firma aus "onventiscostumer" den B2B-Hauptbenutzer und der Besteller aus "onventisuser" den dazugehörigen Unteruser dar.
Die Datei wird als CSV Datei via FTP in den Shop importiert. Dazu kann unter Schnittstellen > GWS_KND_IMPORT > Einstellungen ein FTP-Server hinterlegt werden (s. FTP-Zugangsdaten).
Standardkundennummer
Diese wird in den Abfragen verwendet, wenn der Kunde keine Kundennummer hinterlegt hat bzw. als Gast im Shop ist. In der Regel wird hier als Kundennummer die des im GWS benannten "Barzahler" verwendet.
Referenznummer einstellen
Sie können in der Schnittstelle einstellen, mit welcher Artikelnummer die Abfragen an Ihr GWS System gesendet werden. Bedenken Sie, dass die Referenz sowohl im Shop als auch in GWS verfügbar sein muss, damit ein Preis, die Verfügbarkeit bzw. die Bestellübermittlung erfolgreich funktioniert. Zur Verfügung stehen EAN, Lieferantenartikelnummer und Artikelnummer adäquat der Artikelinformationen auf der Artikelkarte des Multishops.
Belegauskunft
Wenn sie bei GWS die Belegauskunft aktiviert haben, können wir Ihren Kunden den Zugriff auf folgende Belegarten in GWS geben:
- Angebot
- Auftrag
- Gutschrift
- Lieferschein
- Rechnung
- Reservierauftrag
- Sammelgutschrift
- Sammelrechnung
Zusätzlich:
- Offene Posten
Somit kann Ihr Kunde jeden oben genannten Beleg (Originalbeleg bzw. Kopie) als PDF herunterladen.
Darüber hinaus kann Ihr Kunde aus Angeboten die darin enthaltenen Artikel in den Shopwarenkorb übermitteln und dort bestellen. Die im Angebot befindlichen Artikel müssen nicht im Shop angelegt sein. Damit lässt sich die Angebotsannahme des Kunden auch bequem in den Shop verlagern, indem der Kunde das Angebot als Beleg sichten und auch direkt bestellen kann. Sie erhalten diese Shopbestellung wie gewohnt als Auftrag in Ihrem GWS-System angelegt.
Preis-, Verfügbarkeitsabfrage und Bestellübermittlung via GWS-UserID
Wenn Sie die Kundendaten aus GWS in den Shop übermitteln, können Sie auch statt der Kundennummer als Referenz für alle Abfragen auch die UserID aus GWS verwenden. Dadurch wird bei Auftragsübermittlung der Besteller den in GWS hinterlegten Ansprechpartner zugeordnet.
Timeout für die Preis-, Verfügbarkeitsabfrage und für die Bestellübermittlung
Der Shop sendet bei z.B. Klick auf die Artikelkarte (Artikeldetailseite im Shop) eine Anfrage an GWS. Der Shop wartet nun, bis die Anfrage von GWS beantwortet wird. Dies zeigt sich in dem drehenden Kreis im Preisfeld. Sie können mit der Timeoutdefinition zum einen für die Preis-, Verfügbarkeit eine Sekundenanzahl definieren, wann der Shop das Warten abbricht und "Preis auf Anfrage" anzeigt.
Unabhängig davon können Sie für die Bestelllübermittlung dies ebenso definieren. In der Regel braucht die Anlage eines Auftrages etwas länger, als die Rückmeldung eines Preises. Hier kann man den Timeout etwas großzügiger einstellen. Bedenken Sie aber, dass Sie hier die Wartezeit des Kunden definieren!
Fallback auf die Shopdatenbank
Sollte es zu dem Fall kommen, dass ein Preis aus GWS nicht rechtzeitig zurückgemeldet wurde und der Timeout eintrat oder aber auch die Schnittstelle ist aktuell nicht erreichbar (etc.) kann durch diese Funktion statt der "Preis auf Anfrage" Anzeige auch der im Shop hinterlegte Preis angezeigt werden. Dies kann der Listenpreis oder ein irgendwann eingestellter individueller Preis sein.
Mehrfachlagerabfrage
Sollten Sie mehrere Niederlassungen bzw. mehrere Läger besitzen, können wir diese ebenso für die Verfügbarkeitsabfrage heranziehen und für den Kunden visualisieren. Diese sind in der Regel alphanumerisch (z.B. KONSI123) oder numerisch (z.B. 3) codiert. Diese Information hinterlegen wir inklusive des dazugehörigen Klarnamen (ID 3 = Lager Wuppertal). Somit wir zum Beispiel dem Kunden bei der Rückmeldung der GetItemAvailability Abfrage mit der ID 3 und Bestand 500 am Artikeldetail ein grüner Haken beim "Lager Wuppertal" angezeigt. Wir können n Läger anbinden.
#Übergabe von passenden Auftragsparamatern in der Auftragsanlage (OrderCreationExtended) Beispiele:
#Erläuterung des Parameters (WICHTIG: es gehören immer beide dazu, Definition Versandart zu Auftragsparameter und Versandart zu Lagerort)
#Beispiel: Definition Versandart zu Auftragsparameter → hier 2 = Abholung $_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Abholung']['Auftragsparam'] = "2";
#Definition Versandart zu Lagerort→ hier 0 = LagerXY $_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Abholung']['Lagerort'] = "0";
#['Abholung'] = im Shop hinterlegte Versandart → muss 1:1 identisch geschrieben werden im Shop wie in der Config
#['Auftragsparam'] = siehe GWS-Schnittstellendoku gibt es nur 4 Zustände → 0 = Standard (keine Versandart), 1 = Zufuhr, 2 = Abholung, 3 = Zufuhr (Spedition)
#['Lagerort'] = ID des durch den Kunden in GWS definierten Lagerortes (kann Alphanumerisch sein z.B. 1 oder IRXLEBEN)
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Abholung']['Auftragsparam'] = "2";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Abholung']['Lagerort'] = "0";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Tourbelieferung']['Auftragsparam'] = "1";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Tourbelieferung']['Lagerort'] = "0";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Paketdienst']['Auftragsparam'] = "1";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Paketdienst']['Lagerort'] = "0";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Stadtexpress']['Auftragsparam'] = "2";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Stadtexpress']['Lagerort'] = "0";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Abholung LWL']['Auftragsparam'] = "2";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Abholung LWL']['Lagerort'] = "1";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Tourbelieferung LWL']['Auftragsparam'] = "1";
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Tourbelieferung LWL']['Lagerort'] = "1";
#Übergabe von Auftragstypen passend zu Versandarten (Hier am Beispiel Versandart "Blitz Abholung") in der Auftragsanlage (OrderCreationExtended)
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_VERSAND_FLAG']['Blitz Abholung']['Auftragstyp'] = 17;
#Übergabe von Versandart/Kosten bei Auftrag
$_CONFIG['MODULE']['SHOP']['INTEGRATION_VERSAND_NUMMER'] = "Artikelnummer der Versandkosten";
#Übertragung der Rechnungsadresse immer durchführen (Standard: Nur bei Rechnungsadressen- Änderung)
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['FRONTEND']=1;
#Belegauskunft deaktivieren
$_CONFIG['MODULE']['SHOP']['BELEGSUCHE'] = 0;
#Übertragung es Wunschliefertermins "Datum in Zukunft", wenn Kunde kein Wunschtermin einträgt
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_LIEF_DEFAULT'] = 4;
#"4" ist der Mulitplikationswert für wieviele Tage der Wunschliefertermin bei der Übertragung an die Warenwirtschaft hoch gezählt wird.
#Es wird hierbei nur die Übertragung angepasst, die Bestellung wie sie im Shop liegt bleibt dabei unverändert.
#Zur Priorisierungs Reihenfolge "1" Wunschliefertermin aus Auftrag; "2" Heute + 1 * Parammultiplikator wenn != 0; "3" false / empty
#Preiseinheiten aus GWS übernehmen
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_USE_UNIT_TYPE'] = true;
#Anfragen aus dem Shop an GWs übermitteln
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['ORDER_INQUIRY_TRANSFER'] = "true";
#Fehlermail versenden wenn Bestellnummern aus GWS an Shop nicht übermittelt wurden
$_CONFIG['MODULE']['SHOP']['INTEGRATION_MODULE_ERROR_MAILS'] ="XXX@beispielmail.de";
#Gültigkeitsbereich ab und bis in Jahren wo Angebote angezeigt werden
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_GUELTIG_AB_JAHRE'] = 2;
$_CONFIG['MODULE']['SHOP']['INTEGRATION_STACK']['CONFIGURATION']['GWS_GUELTIG_BIS_JAHRE'] = 2;