VendoSys

VendoSys ist ein Shop-System der VENDOSYS GmbH. Die Schnittstelle verbindet es in zwei Richtungen mit OBS: Bestellungen aus dem Shop liest OBS als Aufträge ein, und Ihre Preislisten stellt OBS als Preisdateien für den Shop bereit. So kommen Bestellungen ohne Abtippen in Ihre Auftragsbearbeitung, und Ihre Kunden sehen im Shop die Preise, die Sie in OBS für sie hinterlegt haben.

Steckbrief
Anbieter	VENDOSYS GmbH
Schnittstelle in OBS	VendoSys
Anbindung	Datei
Format Bestellungen	openTRANS 2.1 (XML)
Übertragungsweg Bestellungen	FTP-Job
Preise	XML-Dateien je Preisgruppe
Artikeltausch	✓
Rückmeldungen an den Shop	–
Übersicht	Internet-Shop

HINWEIS: Unterstützt wird das Bestellformat openTRANS 2.1 (Import.AU.Datei.Typ = 002).

Voraussetzungen

Sie haben einen Shop von VENDOSYS. Fragen zum Shop selbst beantwortet VENDOSYS.
Der Programmparameter 633 Internet-Shop vorhanden ist aktiviert, und der OBS-Support hat die Schnittstelle für Sie freigeschaltet. Anlegen dürfen eine Shop-Schnittstelle nur Benutzer mit Level 9.
Für die Abholung der Bestellungen brauchen Sie die FTP-Zugangsdaten von VENDOSYS.
Für die Preise arbeitet die Schnittstelle mit dem Modul Preislisten.

Einrichtung

Die Schnittstelle legt der OBS-Support an. Danach gehen Sie so vor:

Öffnen Sie im Shop-Menü X Konfiguration und tragen Sie die FTP-Zugangsdaten ein: FTP.Host, FTP.Login.Benutzer, FTP.Login.Passwort, FTP.Verzeichnis.OUT und FTP.Verzeichnis.IN.
Stellen Sie Import.AU.Datei.Typ auf 002 – OpenTRANS 2.1. Die Vorgabe 111 – VendoSys XML wird nicht unterstützt.
Legen Sie mit F7 F7 FTP-Job den FTP-Job für die Abholung der Bestellungen an. Dafür brauchen Sie Level 9 für die Shop-Schnittstellen. Der FTP-Job heißt Shop Bestellungen und legt die Dateien in dem Verzeichnis ab, das in FTP.Verzeichnis.IN steht. Das Einlesen erwartet sie in data\shop\<Nummer>\xml. Den FTP-Job finden und bearbeiten Sie in der FTP Jobliste.
Richten Sie die Automatik ShopGetBestellungen für das Einlesen der Bestellungen ein und bei Bedarf ShopSetPreise für die Preise, siehe Automatiken.
Geben Sie die Preislisten, die in den Shop sollen, für die Schnittstelle frei, siehe Preise übertragen.

<Nummer> ist die dreistellige Nummer der Schnittstelle aus der Liste Internet-Shops.

Konfiguration

Die Einstellungen öffnen Sie im Shop-Menü mit X Konfiguration. Wie die Liste der Einstellungen funktioniert, steht unter Internet-Shop: Konfiguration. In der Liste gibt es bei VendoSys außerdem:

Taste	Funktion
F7	F7 FTP-Job legt den FTP-Job für die Abholung der Bestellungen an. Dafür müssen `FTP.Host`, `FTP.Login.Benutzer`, `FTP.Login.Passwort`, `FTP.Verzeichnis.IN` und `FTP.Verzeichnis.OUT` gefüllt sein. Nur mit Level 9 für die Shop-Schnittstellen.
F8	F8 Zuord öffnet das OBS-Shop-Zuordnungsmenü mit T Artikeltausch.

Die Spalte Level nennt das Benutzerlevel für die Shop-Schnittstellen, das Sie mindestens brauchen, um die Einstellung zu ändern.

Allgemein

Einstellung	Standard	Level	Bedeutung
`Allgemein.Aktiv`	J	5	Schaltet die Schnittstelle aktiv (J) oder inaktiv (N). Bei N blendet das Shop-Menü B Preislisten verwalten und U Bestellungen einlesen aus.
`Allgemein.Debug`	N	9	Debugmodus. Erweitert das Protokoll um zusätzliche Einträge und sollte nur in Problemfällen aktiv sein.
`Allgemein.Debug.LogLevel`	0	9	Umfang der Protokolleinträge im Debugmodus, von 0 (keine) bis 5 (alles).
`Allgemein.Schnittstelle.Sachbearbeiter`	leer	5	Nummer des Shop-Sachbearbeiters. Er erhält Nachrichten und Aufgaben aus der Schnittstelle und wird Sachbearbeiter der eingelesenen Aufträge, siehe `Import.AU.Person.Sachbearb`.
`Allgemein.Lagerlieferant.1`	leer	5	Personennummer des ersten Shop-Lieferanten. Sie wählen ihn mit ↩ Enter aus. Beim Einlesen von openTRANS-Dateien sucht OBS die Artikel auch über die Bestellnummern der Shop-Lieferanten. Der FTP-Job, den Sie mit F7 anlegen, erhält diesen Lieferanten als Kunde.
`Allgemein.Lagerlieferant.2`	leer	5	Zweiter Shop-Lieferant, wie `Allgemein.Lagerlieferant.1`.
`Allgemein.Lagerlieferant.3`	leer	5	Dritter Shop-Lieferant, wie `Allgemein.Lagerlieferant.1`.
`Allgemein.Lagerlieferant.4`	leer	5	Vierter Shop-Lieferant, wie `Allgemein.Lagerlieferant.1`.
`Allgemein.Lagerlieferant.5`	leer	5	Fünfter Shop-Lieferant, wie `Allgemein.Lagerlieferant.1`.

FTP

Einstellung	Standard	Level	Bedeutung
`FTP.Host`	leer	5	Adresse des FTP-Servers.
`FTP.Login.Benutzer`	leer	5	Benutzername für den FTP-Server.
`FTP.Login.Passwort`	leer	5	Passwort für den FTP-Server.
`FTP.Mode.Passiv`	N	5	Passive Übertragung. OBS übernimmt die Einstellung beim Anlegen des FTP-Jobs mit F7 nicht. Stellen Sie den Modus im FTP-Job im Feld Passiv ein.
`FTP.Verzeichnis.IN`	leer	5	Verzeichnis in OBS, in das der FTP-Job die Bestelldateien ablegt: `data\shop\<Nummer>\xml\`.
`FTP.Verzeichnis.OUT`	leer	5	Verzeichnis und Dateimaske auf dem FTP-Server, aus dem der FTP-Job die Bestelldateien abholt, z.B. `/out/*.xml`.

Auftragsimport

Einstellung	Standard	Level	Bedeutung
`Import.AU.Datei.Typ`	111	3	Format der Bestelldateien. Sie wählen es mit ↩ Enter aus. Unterstützt wird 002 – OpenTRANS 2.1. Die Vorgabe 111 – VendoSys XML wird nicht unterstützt. Stellen Sie die Einstellung auf 002. OBS erkennt die openTRANS-Version an der Datei, so dass auch Dateien im Format openTRANS 1.0 eingelesen werden.
`Import.AU.Person.Sachbearb`	J	3	Übernimmt den Sachbearbeiter der Person als Sachbearbeiter des Auftrags. Hat die Person keinen Sachbearbeiter, oder steht die Einstellung auf N, gilt der Sachbearbeiter der Schnittstelle.
`Import.AU.Pos.Preis.Prioritaet`	J	3	Mit J übernimmt OBS die Preise aus der Bestellung in den Auftrag. Mit N ermittelt OBS die Preise für jede Position selbst.
`Import.AU.Pos.UstSatz`	J	3	Übernimmt die Steuersätze aus der Datei, sofern angegeben.
`Import.AU.Pos.NeueNummmern`	J	3	Nummeriert die Positionen beim Einlesen neu durch. Mit N behält OBS die Positionsnummern aus der Datei (LINE_ITEM_ID).
`Import.AU.Pos.PosNr`	J	3	Speichert zu jeder Auftragsposition die ursprüngliche Positionsnummer der Bestellung.
`Import.AU.FTPEingang.Anlegen`	N	3	Legt beim Einlesen einer Bestellung einen Eintrag im FTP-Eingang an.
`Import.Adresse.Auftraggeber.Prio`	J	3	J – behält die Auftraggeberadresse aus der Bestelldatei bei. N – überschreibt sie mit den OBS-Daten.
`Import.Adresse.Versand.Prio`	2	3	1 – überschreibt die Versandadresse aus der Datei mit den OBS-Daten. 2 – behält die Adresse aus der Datei bei.

Bedienung

Das Shop-Menü öffnen Sie in der Liste Internet-Shops (Stammdaten → Schnittstellen → Internet-Shop) mit F10 auf der markierten VendoSys-Schnittstelle.

Eintrag	Funktion	Seite
B Preislisten verwalten	Zeigt die Preislisten der Schnittstelle und startet den Preisexport.	B Preislisten verwalten
U Bestellungen einlesen	Liest die abgeholten Bestelldateien sofort als Aufträge ein.	Allgemeine Funktionen
X Konfiguration	Öffnet die Einstellungen der Schnittstelle.	Konfiguration
Z Protokoll	Zeigt Hinweise und Fehler der Übertragungen.	Allgemeine Funktionen

HINWEIS: Die Einträge B und U erscheinen nur, wenn die Schnittstelle aktiv ist (Allgemein.Aktiv = J). X und Z sind immer vorhanden.

B Preislisten verwalten

Die Liste Preislisten zeigt die Preislisten, die OBS bei bisherigen Exporten für diese Schnittstelle verarbeitet hat:

Spalte	Inhalt
Nummer	Nummer der Preisliste.
Name	Name der Preisliste.
Prio	Bei VendoSys ohne Bedeutung, die Spalte bleibt leer.
Gültig von, Gültig bis	Gültigkeitszeitraum der Preisliste.
Probleme	Nur im Analyse-Modus: Gründe, warum OBS die Preisliste nicht exportiert.
M	Markierung mit F5.

Eine neue Preisliste erscheint erst, wenn sie einmal exportiert wurde. Fett stehen die Preislisten, die der Schnittstelle zugeordnet sind. Rote Schrift heißt: Die Preisliste hat beim letzten Export den Status „Löschen“ erhalten. Im Analyse-Modus heißt rote Schrift: Die Preisliste hat mindestens ein Problem.

Taste	Funktion
F4	Wechselt die Sortierung: Nummer, Name oder Priorität.
F5	Markiert die aktuelle Preisliste.
F6	Export: A Alle oder B akt. Preisliste startet den Preisexport. OBS fragt vorher nach: „Achtung! Alle Preise werden aktualisiert!“ Mit 2 Start beginnt der Export. Bei VendoSys exportiert OBS mit beiden Einträgen alle Preislisten der Schnittstelle, siehe Preise übertragen.
F9	PLV: Öffnet die Preislistenverwaltung.
F10	Öffnet die weiteren Funktionen, siehe unten.

F10 bietet diese Einträge:

Eintrag	Funktion
A1 Analyse-Modus EIN (nur Shop-Preislisten)	Schaltet den Analyse-Modus für die Preislisten dieser Liste ein. Ist er an, heißt der Eintrag A1 Analyse-Modus AUS.
A2 Analyse-Modus EIN (alle OBS-Preislisten)	Schaltet den Analyse-Modus für alle Preislisten in OBS ein. So finden Sie auch Preislisten, die noch nie exportiert wurden. Ist er an, heißt der Eintrag A2 Analyse-Modus AUS.
R Preislisten zurücksetzen	Setzt alle Preislisten der Schnittstelle auf den Status „Löschen“ und erstellt die Dateien, mit denen der Shop die Preise löscht. OBS fragt vorher nach.

Analyse-Modus

Der Analyse-Modus zeigt in der Spalte Probleme, warum OBS eine Preisliste nicht exportiert:

Problem	Bedeutung
Nicht aktiv	Das Häkchen Preisliste aktiv ist nicht gesetzt.
Außerhalb Gültigkeitszeitraum	Das aktuelle Datum liegt nicht im Zeitraum Datum von bis Datum bis der Preisliste.
Typ enthält nicht Shop	Die Gültigkeit der Preisliste enthält nicht Shop.
Nicht der Schnittstelle zugeordnet	Die Preisliste ist nicht für die Schnittstelle freigegeben.
Keine Personenzuordnung	Keine Person, der die Preisliste zugeordnet ist, ist der Schnittstelle als Shop-Kunde zugeordnet.
Keine Preise hinterlegt	Die Preisliste enthält keine Preise.

Preise übertragen

Den Preisexport starten Sie in B Preislisten verwalten mit F6 oder automatisch mit der Automatik ShopSetPreise, siehe Automatiken. Damit eine Preisliste in den Shop kommt, muss gelten:

Die Preisliste ist aktiv, gültig und ihre Gültigkeit enthält Shop.
Die Preisliste ist für die Schnittstelle freigegeben: in der Preislistenverwaltung mit F10 S3 Preislisten für Shop(s) freigeben.
Die Preisliste gilt für mindestens einen Kunden, der der Schnittstelle als Shop-Kunde zugeordnet ist.
Die Preisliste enthält mindestens einen Artikel, der in den Shop-Einstellungen des Artikels für diese Schnittstelle zur Pflege freigegeben ist.

So bildet OBS die Preise:

Kunden mit denselben Preislisten fasst OBS zu einer Preisgruppe zusammen. Sie heißt Zusammenfassung mit den Nummern der Preislisten.
Je Artikel überträgt OBS den günstigsten Preis aus diesen Preislisten. Staffelpreise überträgt OBS nicht, nur den Preis zur kleinsten Staffelmenge.
Als Artikelnummer überträgt OBS die Alternative Art-Nr aus dem Artikelstamm. Ist keine hinterlegt, die OBS-Artikelnummer.
Die Kunden übergibt OBS mit ihrer Kundennummer und dem Gültigkeitszeitraum der Preisgruppe.

Je Preisgruppe schreibt OBS die Datei price_groups_<Preisgruppe>.xml in das Verzeichnis data\shop\<Nummer>\data_out. Hat eine Preisgruppe keine Kunden oder keine Artikel mehr, schreibt OBS eine Datei, mit der der Shop die Preisgruppe löscht.

HINWEIS: OBS legt die Preisdateien nur in data_out ab und überträgt sie nicht an VENDOSYS. Die Übertragung der Dateien zu VENDOSYS richten Sie selbst ein. Auch die Zuordnung der Kunden zur Schnittstelle nehmen Sie selbst vor. Das Shop-Menü von VendoSys bietet dafür keinen Eintrag.

Übertragener Inhalt

Angabe	Richtung	Übertragen	Hinweis
Bestellungen als Aufträge	Shop → OBS	✓	openTRANS 2.1, abgeholt per FTP-Job. Manuell mit U Bestellungen einlesen, automatisch mit `ShopGetBestellungen`.
Preise	OBS → Shop	✓	Als XML-Datei je Preisgruppe, siehe Preise übertragen.
Artikel	OBS → Shop	–
Personen	OBS → Shop	–
Lagerbestand	OBS → Shop	–
Bestellstatus, Sendungsverfolgung, Rechnung	OBS → Shop	–

Besonderheiten

Bestellungen im Format openTRANS

Mit Import.AU.Datei.Typ = 002 liest OBS die Bestellungen wie bei den anderen openTRANS-Schnittstellen ein, mit Prüfung bereits eingelesener Dateien und Archiv, siehe U Bestellungen einlesen.

Siehe auch