Wie kann ich ein Bestellplugin installieren?

Die CSB-Warenwirtschaft bietet zahlreiche direkt integrierte Bestellschnittstellen zu zahlreichen Lieferanten. Das sind jedoch bei weitem nicht alle Bestellschnittstellen die wir anbieten, viele davon werden als extra Plugin ausgeliefert und können bei bedarf manuell installiert werden.

Welche Bestellplugins es gibt und wie diese installiert werden, erfahren Sie in dieser Anleitung.

Inhalt:
1. Was für Bestell-Plugins gibt es
2. Wie wird ein Bestell-Plugin installiert
3. Einstellung des Bestell-Plugins im CSB

1. Was für Bestell-Plugins gibt es

Wir liefern mit jedem CSB Update immer die aktuellen Bestell-Plugins aus, zum aktuellen Zeitpunkt (07.05.2024) sind das folgende:

Neben den Plugins für die Erzeugung von Bestelldateien in einem bestimmten Format für die jeweiligen Lieferanten, bieten wir auch noch allgemeine Plugins für verschiedene Export Formate an.

2. Wie wird ein Bestell-Plugin installiert

Sämtliche Bestellplugins werden direkt mit jedem CSB-Update in ihrer aktuellen Version mit ausgeliefert. Um eines der gewünschten Bestellplugins in Ihrem CSB zu installieren gehen sie wie folgt vor.

Navigieren Sie zunächst mit dem Windows Datei-Explorer in ihr CSB PRG-Verzeichnis. Wo sich dieses befindet können Sie ganz leicht direkt in der Titelzeile ihrer CSB Warenwirtschaft ablesen.

In unserem Beispiel befindet sich das PRG-Verzeichnis unter:

D:\CSB\PRG\

Öffnen Sie nun mit dem Windows Datei-Explorer Ihr PRG-Verzeichnis.

In Ihrem PRG-Verzeichnis finden Sie die "plugins.zip" Zip-Datei, welche sämtliche CSB Bestell-Plugins beinhaltet. Öffnen Sie diese per Doppelklick.

In der plugins.zip befindet sich das Unterverzeichnis "plugins" sowie die "csbsystem.dll". Markieren Sie sowohl den Ordner "plugins" als auch die "csbsystem.dll" indem Sie mit gedrückter linker Maustaste einen Kasten um beide Objekte ziehen (alternativ halten Sie die [[Key: Shift]] Taste gedrückt und klicken jeweils die den "plugins" Ordner sowie die "csbsystem.dll" einmal an). Sind beide Objekte markiert, klicken Sie mit der rechten Maustaste auf eines der markierten Objekte und wählen im Kontextmenü den Eintrag "Kopieren" aus.

Als nächsten navigieren Sie zurück zu ihrem CSB PRG-Verzeichnis (in welchem sich die plugins.zip Datei befindet). Klicken Sie hier auf eine freie Fläche mit der rechten Maustaste und wählen aus dem Kontextmenü den Eintrag "Einfügen".

Sollte eine Abfrage kommen ob sie bestehende Dateien überschreiben wollen können Sie diese mit "Nein" verneinen, dann sind die entsprechenden Daten bereits installiert worden.

Es sollte sich nun der Ordner "plugins" im PRG-Verzeichnis befinden, sowie die "csbsystem.dll".

Öffnen Sie nun den Ordner "plugins" in Ihrem PRG-Verzeichnis mit einem Doppelklick.

In diesem befinden sich alle aktuell verfügbaren Bestellplugins.

Da Sie vermutlich nicht alle Bestell-Plugins benötigen ist es ratsam alle Plugins die nicht verwendet werden sollen zu entfernen. Markieren Sie somit alles was nicht benötigt wird und löschen Sie die Plugins mit der Taste [[Key: Entfernen]] oder Rechtsklick und dann "Löschen" im Kontextmenü.

Hinweis: Als Hilfestellung wurde in der obigen Liste zu allen Bestellplugins der DLL-Name mit eingetragen, anhand dieser können Sie ganz leicht ermitteln welche Plugins Sie benötigen und was gelöscht werden kann. Alternativ kann statt einfach alle Plugins aus der ZIP-Datei auszupacken ganz gezielt nur das ausgepackt werden was benötigt wird.

Nun sollten sich nur noch die gewünschten Plugins, welche auch verwendet werden sollen, im Ordner befinden.

In unserem Beispiel sind das nur noch die CSV-Datei Bestellplugins.

Um die Plugins nun zu laden muss CSB einmal beendet und neu gestartet werden, beim CSB Programmstart werden alle Plugins dann automatisch mit geladen. Starten Sie somit CSB einmal neu.

Beim CSB Start wird nun auch angezeigt das die Plugins geladen werden.

Damit ist die Installation der Plugins abgeschlossen und diese können nun verwendet werden.

3. Einstellung des Bestell-Plugins im CSB

Nachdem das Bestell-Plugin nun installiert wurde kann es im CSB verwendet werden. Hierzu müssen wir das Plugin noch dem gewünschten Lieferanten zuweisen.

Öffnen Sie hierzu zunächst den Lieferantenstamm (Programmpunkt 3-1).

Wählen Sie den gewünschten Lieferanten aus der Übersicht aus und verwenden Sie den Button [[Button: Prozedur Bestellung]].

Im oberen Bereich bei "Bestell-Plugin" können Sie nun das gewünschte Plugin aus dem DropDown-Menü auswählen.

Hinweis: Die Namen der Bestellplugins sind ebenfalls in der obigen Übersichtsliste unter "Bestell-Plugin-Name" angegeben, wählen Sie somit hier einfach das passende Plugin aus.

Haben Sie das gewünschte Plugin ausgewählt, bestätigen Sie mit [[Image: CSB-BildUnten-Button]].

Wichtig: Sollte das gewünschte Plugin nicht in der Auswahl erscheinen wurde es nicht korrekt installiert. Es ist nicht möglich den Plugin-Namen einfach manuell in das Feld zu tippen! Sollte das gewünschte Plugin in der Auswahl fehlen, prüfen Sie ob die DLL-Datei wirklich im prg/plugins Ordner liegt. Prüfen Sie zudem ob die "csbsystem.dll" im PRG-Verzeichnis vorhanden ist.

Damit ist die Einrichtung abgeschlossen und das Bestellplugin kann nun genutzt werden.

In der Regel werden die Bestelldateien automatisch erzeugt sobald die nächste Bestellung für den Lieferanten im Programmpunkt 4-4 - Bestellung auslösen / abschicken, durchgeführt wird.

Es ist auch möglich manuell eine alte Bestellung erneut über ein Bestellplugin erzeugen zu lassen, wählen Sie hierfür den Programmpunkt 4-5-N - Export über Plugins und dort den gewünschten Lieferanten.

Je nach Plugin kann der Ablauf etwas unterschiedlich sein, einige Übermitteln die Daten direkt an den Lieferanten, die meisten jedoch erstellen eine Exportdatei (idR. im C:\CSBxPort Verzeichnis), welche dann auf der Homepage des Lieferanten als Bestellung in den Warenkorb importiert werden kann. Bei anderen Lieferanten muss die Datei mit einem Programm des Herstellers übertragen werden.

Gelegentlich kann es notwendig sein das ihre Kundennummer des Lieferanten mit angegeben werden muss und somit für die Funktionsweise des Plugins benötigt wird. Sollte dem so sein können Sie ihre Kundennummer im Programmpunkt 3-1 - Lieferantenverwaltung bei dem jeweiligen Lieferanten hinterlegen. Bearbeiten Sie diesen hierzu mittels [[Button: Bearbeiten]] und geben im Feld "ihre KundenNr." ihre Kundennummer an.

Speichern Sie die Änderungen dann mittels [[Image: CSB-BildUnten-Button]].