MINERVA-Nimz: Neue Einstiegsseite der Shop-Schnittstelle VendoSys: Überblick, Einrichtung, Bedienung, Konfiguration (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

2026-11-03T15:26:01Z

Neue Einstiegsseite der Shop-Schnittstelle VendoSys: Überblick, Einrichtung, Bedienung, Konfiguration (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]

Neue Seite

{{Vorlage:Kostenpflichtige Module}}
{{Seitentyp|Schnittstelle}}
= 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|[https://www.vendosys.de/ 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|[[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]
}}

{{Hinweis|1=Unterstützt wird das Bestellformat openTRANS 2.1 (<code>Import.AU.Datei.Typ</code> = ''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 [[OBS/Kostenpflichtige Module/Preislisten|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: <code>FTP.Host</code>, <code>FTP.Login.Benutzer</code>, <code>FTP.Login.Passwort</code>, <code>FTP.Verzeichnis.OUT</code> und <code>FTP.Verzeichnis.IN</code>.
# Stellen Sie <code>Import.AU.Datei.Typ</code> 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 <code>FTP.Verzeichnis.IN</code> steht. Das Einlesen erwartet sie in <code>data\shop\<Nummer>\xml</code>. Den FTP-Job finden und bearbeiten Sie in der [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]].
# Richten Sie die Automatik <code>ShopGetBestellungen</code> für das Einlesen der Bestellungen ein und bei Bedarf <code>ShopSetPreise</code> für die Preise, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]].
# Geben Sie die Preislisten, die in den Shop sollen, für die Schnittstelle frei, siehe [[#Preise übertragen|Preise übertragen]].

<code><Nummer></code> 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 [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Internet-Shop: Konfiguration]]. In der Liste gibt es bei VendoSys außerdem:

{| class="wikitable"
! Taste !! Funktion
|-
| {{F7}} || '''F7 FTP-Job''' legt den FTP-Job für die Abholung der Bestellungen an. Dafür müssen <code>FTP.Host</code>, <code>FTP.Login.Benutzer</code>, <code>FTP.Login.Passwort</code>, <code>FTP.Verzeichnis.IN</code> und <code>FTP.Verzeichnis.OUT</code> gefüllt sein. Nur mit Level 9 für die Shop-Schnittstellen.
|-
| {{F8}} || '''F8 Zuord''' öffnet das '''OBS-Shop-Zuordnungsmenü''' mit [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Artikeltausch|T Artikeltausch]].
|}

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

=== Allgemein ===
{| class="wikitable"
! Einstellung !! Standard !! Level !! Bedeutung
|-
| {{Anker|Allgemein.Aktiv}}<code>Allgemein.Aktiv</code> || J || 5 || Schaltet die Schnittstelle aktiv (''J'') oder inaktiv (''N''). Bei ''N'' blendet das Shop-Menü '''B Preislisten verwalten''' und '''U Bestellungen einlesen''' aus.
|-
| {{Anker|Allgemein.Debug}}<code>Allgemein.Debug</code> || N || 9 || Debugmodus. Erweitert das Protokoll um zusätzliche Einträge und sollte nur in Problemfällen aktiv sein.
|-
| {{Anker|Allgemein.Debug.LogLevel}}<code>Allgemein.Debug.LogLevel</code> || 0 || 9 || Umfang der Protokolleinträge im Debugmodus, von ''0'' (keine) bis ''5'' (alles).
|-
| {{Anker|Allgemein.Schnittstelle.Sachbearbeiter}}<code>Allgemein.Schnittstelle.Sachbearbeiter</code> || leer || 5 || Nummer des Shop-Sachbearbeiters. Er erhält Nachrichten und Aufgaben aus der Schnittstelle und wird Sachbearbeiter der eingelesenen Aufträge, siehe <code>Import.AU.Person.Sachbearb</code>.
|-
| {{Anker|Allgemein.Lagerlieferant.1}}<code>Allgemein.Lagerlieferant.1</code> || leer || 5 || Personennummer des ersten Shop-Lieferanten. Sie wählen ihn mit {{Return}} 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.
|-
| {{Anker|Allgemein.Lagerlieferant.2}}<code>Allgemein.Lagerlieferant.2</code> || leer || 5 || Zweiter Shop-Lieferant, wie <code>Allgemein.Lagerlieferant.1</code>.
|-
| {{Anker|Allgemein.Lagerlieferant.3}}<code>Allgemein.Lagerlieferant.3</code> || leer || 5 || Dritter Shop-Lieferant, wie <code>Allgemein.Lagerlieferant.1</code>.
|-
| {{Anker|Allgemein.Lagerlieferant.4}}<code>Allgemein.Lagerlieferant.4</code> || leer || 5 || Vierter Shop-Lieferant, wie <code>Allgemein.Lagerlieferant.1</code>.
|-
| {{Anker|Allgemein.Lagerlieferant.5}}<code>Allgemein.Lagerlieferant.5</code> || leer || 5 || Fünfter Shop-Lieferant, wie <code>Allgemein.Lagerlieferant.1</code>.
|}

=== FTP ===
{| class="wikitable"
! Einstellung !! Standard !! Level !! Bedeutung
|-
| {{Anker|FTP.Host}}<code>FTP.Host</code> || leer || 5 || Adresse des FTP-Servers.
|-
| {{Anker|FTP.Login.Benutzer}}<code>FTP.Login.Benutzer</code> || leer || 5 || Benutzername für den FTP-Server.
|-
| {{Anker|FTP.Login.Passwort}}<code>FTP.Login.Passwort</code> || leer || 5 || Passwort für den FTP-Server.
|-
| {{Anker|FTP.Mode.Passiv}}<code>FTP.Mode.Passiv</code> || 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.
|-
| {{Anker|FTP.Verzeichnis.IN}}<code>FTP.Verzeichnis.IN</code> || leer || 5 || Verzeichnis in OBS, in das der FTP-Job die Bestelldateien ablegt: <code>data\shop\<Nummer>\xml\</code>.
|-
| {{Anker|FTP.Verzeichnis.OUT}}<code>FTP.Verzeichnis.OUT</code> || leer || 5 || Verzeichnis und Dateimaske auf dem FTP-Server, aus dem der FTP-Job die Bestelldateien abholt, z.B. <code>/out/*.xml</code>.
|}

=== Auftragsimport ===
{| class="wikitable"
! Einstellung !! Standard !! Level !! Bedeutung
|-
| {{Anker|Import.AU.Datei.Typ}}<code>Import.AU.Datei.Typ</code> || 111 || 3 || Format der Bestelldateien. Sie wählen es mit {{Return}} 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.
|-
| {{Anker|Import.AU.Person.Sachbearb}}<code>Import.AU.Person.Sachbearb</code> || 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.
|-
| {{Anker|Import.AU.Pos.Preis.Prioritaet}}<code>Import.AU.Pos.Preis.Prioritaet</code> || 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.
|-
| {{Anker|Import.AU.Pos.UstSatz}}<code>Import.AU.Pos.UstSatz</code> || J || 3 ||Übernimmt die Steuersätze aus der Datei, sofern angegeben.
|-
| {{Anker|Import.AU.Pos.NeueNummmern}}<code>Import.AU.Pos.NeueNummmern</code> || J || 3 ||Nummeriert die Positionen beim Einlesen neu durch. Mit ''N'' behält OBS die Positionsnummern aus der Datei (LINE_ITEM_ID).
|-
| {{Anker|Import.AU.Pos.PosNr}}<code>Import.AU.Pos.PosNr</code> || J || 3 ||Speichert zu jeder Auftragsposition die ursprüngliche Positionsnummer der Bestellung.
|-
| {{Anker|Import.AU.FTPEingang.Anlegen}}<code>Import.AU.FTPEingang.Anlegen</code> || N || 3 ||Legt beim Einlesen einer Bestellung einen Eintrag im FTP-Eingang an.
|-
| {{Anker|Import.Adresse.Auftraggeber.Prio}}<code>Import.Adresse.Auftraggeber.Prio</code> || J || 3 ||''J'' – behält die Auftraggeberadresse aus der Bestelldatei bei. ''N'' – überschreibt sie mit den OBS-Daten.
|-
| {{Anker|Import.Adresse.Versand.Prio}}<code>Import.Adresse.Versand.Prio</code> || 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.

{| class="wikitable"
! Eintrag !! Funktion !! Seite
|-
| '''B Preislisten verwalten''' || Zeigt die Preislisten der Schnittstelle und startet den Preisexport. || [[#B Preislisten verwalten|B Preislisten verwalten]]
|-
| '''U Bestellungen einlesen''' || Liest die abgeholten Bestelldateien sofort als Aufträge ein. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#U Bestellungen einlesen|Allgemeine Funktionen]]
|-
| '''X Konfiguration''' || Öffnet die Einstellungen der Schnittstelle. || [[#Konfiguration|Konfiguration]]
|-
| '''Z Protokoll''' || Zeigt Hinweise und Fehler der Übertragungen. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#Z Protokoll|Allgemeine Funktionen]]
|}

{{Hinweis|1=Die Einträge '''B''' und '''U''' erscheinen nur, wenn die Schnittstelle aktiv ist (<code>Allgemein.Aktiv</code> = ''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:

{| class="wikitable"
! 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|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.

{| class="wikitable"
! 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|Preise übertragen]].
|-
| {{F9}} || '''PLV''': Öffnet die [[OBS/Kostenpflichtige Module/Preislisten|Preislistenverwaltung]].
|-
| {{F10}} || Öffnet die weiteren Funktionen, siehe unten.
|}

{{F10}} bietet diese Einträge:
{| class="wikitable"
! Eintrag !! Funktion
|-
| '''A1 Analyse-Modus EIN (nur Shop-Preislisten)''' || Schaltet den [[#Analyse-Modus|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:

{| class="wikitable"
! 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 <code>ShopSetPreise</code>, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken#ShopSetPreise|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 [[OBS/Kostenpflichtige Module/Preislisten|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 <code>price_groups_<Preisgruppe>.xml</code> in das Verzeichnis <code>data\shop\<Nummer>\data_out</code>. Hat eine Preisgruppe keine Kunden oder keine Artikel mehr, schreibt OBS eine Datei, mit der der Shop die Preisgruppe löscht.

{{Hinweis|1=OBS legt die Preisdateien nur in <code>data_out</code> 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 ==
{| class="wikitable"
! Angabe !! Richtung !! Übertragen !! Hinweis
|-
| Bestellungen als Aufträge || Shop → OBS || ✓ || openTRANS 2.1, abgeholt per FTP-Job. Manuell mit '''U Bestellungen einlesen''', automatisch mit <code>ShopGetBestellungen</code>.
|-
| Preise || OBS → Shop || ✓ || Als XML-Datei je Preisgruppe, siehe [[#Preise übertragen|Preise übertragen]].
|-
| Artikel || OBS → Shop || – ||
|-
| Personen || OBS → Shop || – ||
|-
| Lagerbestand || OBS → Shop || – ||
|-
| Bestellstatus, Sendungsverfolgung, Rechnung || OBS → Shop || – ||
|}

== Besonderheiten ==
=== Bestellungen im Format openTRANS ===
Mit <code>Import.AU.Datei.Typ</code> = ''002'' liest OBS die Bestellungen wie bei den anderen openTRANS-Schnittstellen ein, mit Prüfung bereits eingelesener Dateien und Archiv, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#U Bestellungen einlesen|U Bestellungen einlesen]].

== Siehe auch ==
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen|Allgemeine Funktionen]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Artikeltausch|Artikeltausch]]
* [[OBS/Kostenpflichtige Module/Preislisten|Preislisten]]
* [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]]

OBS/Stammdaten/Schnittstellen/Internet-Shop/VendoSys - Versionsgeschichte

MINERVA-Nimz: Neue Einstiegsseite der Shop-Schnittstelle VendoSys: Überblick, Einrichtung, Bedienung, Konfiguration (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]