Wie richte ich die Boxenstopp Schnittstelle im CSB ein?

Mit der CSB Warenwirtschaft können Sie ihre individuelle Preisliste von Boxenstopp über Ihre Boxenstopp-Zugangsdaten als Preisliste einspielen, Verfügbarkeiten von Artikeln abfragen und Bestellungen direkt an Boxenstopp übermitteln. 

Wie die Schittstelle eingerichtet wird erfahren Sie in dieser Anleitung.

Vorbereitung:

Die Boxenstopp Schnittstelle funktioniert nur auf Arbeitstationen mit Windows 10 / Windows 11, ältere Windows Versionen werden von der Schnittstelle nicht unterstützt! Führen Sie die folgenden Schritte somit nur durch wenn sie mindestens Windows 10 als Betriebsystem einsetzten.

Darüber hinaus wird mindestens eine CSB Version vom 27.01.2022 [11037] oder neuer benötigt, sonst funktioniert die Schnittstelle nicht. Sie können ihren aktuellen CSB Versionsstand im Programmpunkt 9-B - Systeminfo / Neuheiten einsehen.

1. Hinterlegen Ihrer Zugangsdaten im Lieferantenstamm

Zunächst müssen ihre Zugangsdaten im Lieferantenstamm bei ihrem Boxenstopp Lieferant hinterlegt werden. Öffnen Sie hierfür den Programmpunkt 3-1 - Lieferantenverwaltung und wählen Ihren Boxenstopp Lieferant aus und öffnen Sie die Bearbeitung über den Button [[Button: Bearbeiten]].

Es öffnet sich der Dialog der Lieferantenbearbeitung, tragen Sie hier zunächst auf der ersten Reiterkarte ihre Boxenstopp-Kundennummer ein.

Wechseln Sie dann auf die zweite Reiterkarte [[Tab: 2 - Online/Bankv.]], im oberen Bereich finden Sie die Felder für den Online Zugang.

Geben Sie hier zunächst im Feld "http Verfügbarkeit" das Schlüsselwort EDIWheel_Inquiry ein und bestätigen Sie mit [[Key: Enter]]. CSB erkennt nun das die EDIWheel Schnittstelle genutzt werden soll und blendet weitere, dafür benötigte Felder ein.

Hier können Sie nun die für die Schnittstelle benötigten Daten eingeben:

Zugangsname: Tragen Sie hier den Benutzernamen, welchen Sie von Boxenstopp erhalten haben ein.

Passwort: Geben Sie hier das von Boxenstopp erhaltene Passwort ein.

Hinweis: Falls Ihnen Ihre Boxenstopp Zugangsdaten nicht bekannt sind, wenden Sie sich bitte direkt an die Firma Boxenstopp.

Url: Hier wird die URL für die Schnittelle eingetragen, diese können Sie hier kopieren und in das Feld einfügen.

https://onlineservices.prod.rz2.prm-ag.de/-sEg1d4W8fjTMnqX0Zmutg/Adhoc?guidOnlineService=be251aa4-2dac-7cac-7514-64a700038353

Aktivieren Sie zu guter letzt noch den Haken bei [[Checkbox-Checked: Authorisierung erforderlich]].

Wenn alle Daten eingetragen wurde, speichern Sie ihre Änderungen mit [[Image: CSB-BildUnten-Button]].

Da Boxenstopp in der Preisliste einen EK mitliefert, bietet es sich an für die ermittlung ihres VK-Preises eine entsprechende EK-Kalkulation für den Lieferanten zu hinterlegen. Dies können Sie über den Button [[Button: EK Kalkulation]] im Lieferantenstamm tun.

Es öffnet sich die EK-Kalkulations Übersicht für den Lieferanten Boxenstopp, hier können Sie die bestehende Grundkalkulation per Doppelklick oder dem Button [[Button: Bearbeiten]] bearbeiten.

Legen Sie hier falls gewünscht ihre persönliche EK Kalkulation an (die Kalkulation im Screenshot ist nur ein Beispiel zur Darstellung und soll natürlich nicht übernommen werden!) und speichern Sie diese mit [[Image: CSB-BildUnten-Button]] ab.

Damit ist die Schnittstelle eingerichtet und wir können zunächst damit beginnen Ihre individuelle Preisliste im CSB einzuspielen.

 

2. Individuelle Preisliste einlesen: Erster Lauf (Alte Artikelnummern auf neue Umschlüsseln)
Die Boxenstopp Daten müssen beim ersten einlesen, zwei mal eingelesen werden, zunächst mit diesem Format und später mit dem eigentlichen Aufbau. Dies dient dazu ggf. vorhandene Artikel, welche noch mit den alten Artikelnummern angelegt wurden auf die neuen Artikelnummern umzuschlüsseln.

Achtung: Haben Sie bisher nicht mit Boxenstopp Artikeln die noch die alten Nummern verwenden gearbeitet und arbeiten generell nur mit den neuen Boxenstopp Artikelnummern, dann können Sie diesen Teil der Anleitung überspringen und direkt mit Schritt 3 fortfahren!

Um die alten Boxenstopp Artikelnummern auf die neuen Umzuschlüsseln gehen Sie wie folgt vor. Öffnen Sie zunächst den Programmteil 1-6 - Herstellerdaten einlesen und legen entweder über den Button [[Button: Neu]] eine neue Schnittstelle für Boxenstopp an oder falls bereits vorhanden, bearbeiten Sie die vorhandene Schnittstelle mit dem Button [[Button: Bearbeiten]].

In unserem Fall legen wir die Schnittstelle für Boxenstopp komplett neu an.

Geben Sie im oberen Bereich zunächst den Namen des Lieferanten an und wählen Sie danach im DropDown-Menü bei Lieferantennummer Ihre Lieferantennummer für Ihren Boxenstopp Lieferanten in Ihrem CSB aus.

Bei "Empfangsdatei" geben Sie folgendes ein:

_BOXENSTOPP

Deaktivieren Sie dann den Haken bei [[Checkbox: Automatische Schnittstelle verwenden]], dadurch werden die unteren Felder editierbar.

Übernehmen Sie nun alle Daten aus den gelb hinterlegten Felder des obigen Screenshots. Es ist wichtig das sie hier gründlich arbeiten, da sonst Fehler beim Einlesen der Preisdatei auftreten können!

Haben Sie alle Daten wie oben beschrieben übernommen, speichern Sie ihre Änderungen mit [[Image: CSB-BildUnten-Button]] ab. Wir können nun die Preisliste das erste mal einlesen, verwenden Sie hierfür den Button [[Button: Daten einlesen]].

CSB lädt nun ihre aktuelle individuelle Preisliste von Boxenstopp herunter und spielt diese ins System ein, dabei werden die alten Boxenstopp Artikelnummern als Umschlüsselung für die neuen Nummern hinterlegt. So können Sie später sowohl die alte, als auch die neue Artikelnummer eingeben und den korrekten Artikel finden.

Nach dem Einlesen der Datei fragt das Programm ob ihre VK-Preise nun neu Kalkuliert werden sollen, dies können Sie zunächst mit "Nein" abbrechen.

Im nächsten Schritt stellen wir die Schnittstelle nun auf die aktuellen Werte um, um nun mit den neuen aktuellen Boxenstopp Artikelnummern zu arbeiten.

 

3. Individuelle Preisliste einlesen: Zweiter Lauf (mit den neuen Boxenstopp Artikelnummern)
Öffnen Sie den Programmpunkt 1-6 - Herstellerdaten einlesen und wählen Sie hier entweder die vorhandene Boxenstopp Schnittstelle aus und bearbeiten diese über den Button [[Button: Bearbeiten]] oder legen über den Button [[Button: Neu]] eine neue Schnittstelle für den Lieferanten Boxenstopp an. 

In unserem Beispiel ist bereits eine Schnittstelle vorhanden deswegen Bearbeiten wir diese, Sie können aber einfach über den Button [[Button: Neu]] eine neue Schnittstelle für Boxenstopp anlegen.

Es öffnet sich die Schnittstellen konfiguration, hier geben Sie im oberen Bereich zunächst einen Namen für den Lieferanten ein und wählen im DropDown Menü Ihre Lieferantennummer für Ihren Boxenstopp Lieferanten in Ihrem CSB aus. Im Feld Empfangsdatei geben Sie folgendes ein:

_BOXENSTOPP

Deaktivieren Sie dann noch den Haken bei [[Checkbox: Automatische Schnittstelle verwenden]] dadurch werden die unteren Felder aktiv und können nun Bearbeitet werden.

Übernehmen Sie sämtlichen gelb markierten Werte aus der Abbildung in ihre Boxenstopp Schnittstelle. Mit dieser Konfiguration werden die neuen (aktuellen) Boxenstopp Artikelnummern verwendet. Sie finden diese im Katalog auf der Boxenstopp Webseite unter den jeweiligen Artikeln.

Wenn alle Werte korrekt eingetragen wurden Speichern Sie die Änderungen mit [[Image: CSB-BildUnten-Button]] ab. Nun kann die Preisliste eingelesen werden, verwenden Sie hierfür den Button [[Button: Daten lesen]] in der Schnittstellenübersicht.

CSB lädt nun ihre individuelle Preisliste bei Boxenstopp herunter, verabeitet diese und spielt sie als Hintergrundliste im System ein. Nach der erfolgreichen verarbeitung fragt das Programm ob die Verkaufspreise nun neu Kalkuliert werden sollen, haben Sie zu Beginn der Anleitung ihre EK-Kalkulation für Boxenstopp hinterlegt können Sie nun anhand dieser die Preise kalkulieren lassen

 

Verfügbarkeitsabfrage
Neben der Preisliste bietet die Boxenstopp Schnittstelle auch die Möglichkeit die Verfügbarkeit für Artikel abzufragen. Dies können Sie bspw. direkt im Artikelstamm über den Button [[Button: Verfgbkt]] für einen Artikel abfragen.

CSB fragt dann über die Schnittstelle bei Boxenstopp die aktuelle Verfügbarkeit für den Artikel ab und zeigt die Rückmeldung in einem gesonderten Fenster.

Hier ein Beispiel für einen Verfügbaren Artikel

Hier ein Beispiel für einen Artikel der nicht mehr Verfügbar ist.

Die Funktion der Verfügbarkeitskontrolle finden Sie an zahlreichen Stellen im Programm und können sie über den Button [[Button: Vf. Abfrage]] bzw. [[Button: Verfgbkt]] nutzen.

 

Bestellungen an Boxenstopp übertragen
Es ist ebenfalls Möglich im CSB ausgelöste Bestellungen direkt an Boxenstopp zu übertragen. Hierfür werden die Bestellungen wie gewohnt im CSB erfasst und dann über den Programmpunkt 4-4 - Bestellungen auslösen / abschicken ausgelöst. Danach kann diese Bestellung über den Programmpunkt 4-5 - G - Standad direkt an Boxenstopp übertragen werden.

Es öffnet sich der Dialog für die Bestellübertragung, wählen Sie hier ihren Boxenstopp Lieferanten aus dem DropDown-Menü aus und danach die gewünschte Referenznummer, der zuvor über Programmpunkt 4-4 ausgelösten Bestellung, welche an Boxenstopp übertragen werden soll. (idR. wird die letzte Referenznummer gewählt, da diese immer der zuletzt ausgelösten Bestellung entspricht).

Um die Bestellübertragung zu starten bestätigen Sie mit [[Image: CSB-BildUnten-Button]]. Die Bestellung wird nun direkt an Boxenstopp übermittelt. Nach erfolgreicher Übertragung erhalten Sie eine entsprechende Rückmeldung. Sollten Artikel der Bestellung nicht mehr Lieferbar sein, wird auch dies in der Rückmeldung mit aufgeführt.

Hinweis: Die letzte Originalantwort des Systems ist in XML-Format jeweils unter der Datei EdiWheelResponse.xml im CSB-Programmverzeichnis gespeichert.

Achtung: Die Bestellübertragung ist nur mit den neuen Boxenstopp Artikelnummern möglich, sie können keine alten Artikelnummern übertragen, diese Werden von Boxenstopp nicht erkannt!

 

Bestellübertragung automatisch nach Bestellauslösung öffnen
Es ist optional möglich die Bestellübertragung der Bestellung an Boxenstopp auch direkt nach dem Auslösen der Bestellung in Programmpunkt 4-4 von CSB öffnen zu lassen, dadurch sparen Sie sich den manuellen Schritt über den Programmpunkt 4-5-G -Standard.

Um die Bestellübertragung direkt automatisch nach dem Auslösen der Bestellung zu öffnen gehen Sie in den Programmpunkt 3-1 - Lieferantenverwaltung. Wählen Sie in der Übersicht den Eintrag für ihren Boxenstopp Lieferanten aus und verwenden den Button [[Button: Prozedur Bestellung]].

Im folgenden Dialog geben Sie unter "Proc 1 Ausösen" folgendes ein:

dn45G()

Speichern Sie die Änderungen mit [[Image: CSB-BildUnten-Button]]. Beim nächsten Auslösen einer Bestellung für Boxenstopp wird dann automatisch auch die Bestellübertragung geöffnet.