https://wiki.bergau.de/index.php?action=history&feed=atom&title=OBS%2FStammdaten%2FSchnittstellen%2FInternet-Shop%2FVShop_4.0OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0 - Versionsgeschichte2026-11-04T06:46:21ZVersionsgeschichte dieser Seite in OBS WikiMediaWiki 1.43.9https://wiki.bergau.de/index.php?title=OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop_4.0&diff=67096&oldid=prevMINERVA-Nimz: Neue Einstiegsseite der Shop-Schnittstelle VShop 4.0: Überblick, Einrichtung, Bedienung, Konfiguration (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]2026-11-03T15:26:06Z<p>Neue Einstiegsseite der Shop-Schnittstelle VShop 4.0: Überblick, Einrichtung, Bedienung, Konfiguration (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]</p>
<p><b>Neue Seite</b></p><div>{{Vorlage:Kostenpflichtige Module}}<br />
{{Seitentyp|Schnittstelle}}<br />
= VShop 4.0 =<br />
<br />
Der VShop 4.0 ist ein Shop-System der Büroring eG. OBS schreibt direkt in die Datenbank des Shops: Kunden mit Kostenstellen, Preise, Ihre eigenen Artikel, Kataloge und Bestellvorlagen überträgt OBS in den Shop. Die Bestellungen aus dem Shop holt ein FTP-Job als Dateien ab, OBS liest sie als Aufträge ein. So pflegen Sie Kunden und Preise an einer Stelle, und Ihre Kunden sehen im Shop ihre eigenen Preise und Listen.<br />
<br />
{{Hinweis|1=Nachfolger von VShop 4.0 ist [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24|brShop24]]. Zur Umstellung siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/M Migration|brShop24: M Migration]].}}<br />
<br />
{{Steckbrief<br />
|Anbieter|[https://www.bueroring.de/ BÜRORING eG]<br />
|Schnittstelle in OBS|''VShop 4.0''<br />
|Anbindung|direkte Datenbankverbindung zur Shop-Datenbank (MySQL)<br />
|Format Bestellungen|openTRANS 1.0 (XML)<br />
|Übertragungsweg Bestellungen|FTP-Job<br />
|Preise|direkt in die Shop-Datenbank, optional als Dateien per FTP<br />
|Bilder|als Bildadresse (URL)<br />
|Rückmeldungen an den Shop|–<br />
|Übersicht|[[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]<br />
}}<br />
<br />
== Voraussetzungen ==<br />
* Sie haben einen VShop 4.0 von Büroring. Fragen zum Shop selbst beantwortet Büroring.<br />
* 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.<br />
* Von Büroring brauchen Sie die Zugangsdaten zur Shop-Datenbank (Server, Port, Benutzer, Passwort, Name der Datenbank) und die FTP-Zugangsdaten für die Abholung der Bestellungen.<br />
* In der Konfiguration ist mindestens der Lieferant <code>Allgemein.Lagerlieferant.1</code> eingetragen. Ohne ihn baut OBS keine Verbindung zum Shop auf.<br />
* Für die Preise ist das Modul Preislisten bei VShop 4.0 optional:<br />
** Mit dem Modul [[OBS/Kostenpflichtige Module/Preislisten|Preislisten]] überträgt OBS die Preislisten, die für die Schnittstelle freigegeben sind.<br />
** Ohne das Modul überträgt OBS die Standard-Verkaufspreise je Preisgruppe der Person und die personenbezogenen Artikelpreise.<br />
<br />
== Einrichtung ==<br />
Die Schnittstelle legt der OBS-Support an. Er trägt die Zugangsdaten für Datenbank und FTP in die Konfiguration ein und legt den FTP-Job für die Abholung der Bestellungen an. Sie stellen dafür die Zugangsdaten von Büroring bereit und hinterlegen im Adminbereich des Shops bei jeder Versandart die Artikelnummer ''VERSAND''. Das Einlesen der Bestellungen übernimmt die Automatik <code>ShopGetBestellungen</code>, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]].<br />
<br />
Wie Sie dabei im Einzelnen vorgehen, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Einrichtung|Einrichtung]].<br />
<br />
== Konfiguration ==<br />
Die Einstellungen der Schnittstelle öffnen Sie im Shop-Menü mit '''X Konfiguration'''. Alle Einstellungen für VShop 4.0 beschreibt die Seite [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Konfiguration|Konfiguration]], wie die Liste der Einstellungen funktioniert, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|Internet-Shop: Konfiguration]].<br />
<br />
In der Liste der Einstellungen gibt es außerdem:<br />
{| class="wikitable"<br />
! Taste !! Eintrag !! Wofür<br />
|-<br />
| {{F8}} || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Artikeltausch|T Artikeltausch]] || Tauscht beim Auftragsimport eine Artikelangabe gegen einen festen OBS-Artikel, z.B. für Pauschalen.<br />
|-<br />
| {{F10}} || '''D Datenabgleich''' || Gleicht mit '''A Abgleich Artikel''' die Artikel und mit '''B Abgleich Personen''' die Kunden des Shops mit OBS ab, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Konfiguration|Konfiguration]].<br />
|}<br />
<br />
== Bedienung ==<br />
Das Shop-Menü öffnen Sie in der Liste '''Internet-Shops''' ('''Stammdaten → Schnittstellen → Internet-Shop''') mit {{F10}} auf der markierten VShop-4.0-Schnittstelle.<br />
<br />
{| class="wikitable"<br />
! Eintrag !! Funktion !! Seite<br />
|-<br />
| '''A Preise aktualisieren''' || Überträgt die Preise in den Shop, auf Wunsch im Hintergrund. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/A Preise aktualisieren|A Preise aktualisieren]]<br />
|-<br />
| '''C Personen übertragen''' || Überträgt die Kunden einer Personenauswertung mit Zugängen und Kostenstellen in den Shop. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/C Personen übertragen|C Personen übertragen]]<br />
|-<br />
| '''D eigene Artikel übertragen''' || Überträgt die eigenen Artikel einer Artikelauswertung in den Shop. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/D eigene Artikel übertragen|D eigene Artikel übertragen]]<br />
|-<br />
| '''E Warengruppen verwalten''' || Liest die Warengruppen des Shops ein und ordnet ihnen eigene Artikel zu. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/E Warengruppen verwalten|E Warengruppen verwalten]]<br />
|-<br />
| '''F Kundengruppen''' || Liest die Kundengruppen des Shops ein und ordnet sie zu. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/F Kundengruppen|F Kundengruppen]]<br />
|-<br />
| '''H Kataloge für Personen einer Auswertung übertragen''' || Überträgt für die Kunden einer Personenauswertung ihre personenbezogenen Artikel als Artikelvorlage. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/H Kataloge für Personen einer Auswertung übertragen|H Kataloge für Personen einer Auswertung übertragen]]<br />
|-<br />
| '''I Bestellvorlagen übertragen''' || Überträgt Bestellvorlagen für einen Kunden oder eine Personenauswertung. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/I Bestellvorlagen übertragen|I Bestellvorlagen übertragen]]<br />
|-<br />
| '''U Bestellungen einlesen''' || Liest die abgeholten Bestelldateien sofort als Aufträge ein. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#U Bestellungen einlesen|Allgemeine Funktionen]]<br />
|-<br />
| '''V leere Passworte füllen''' || Erzeugt Internet-Passwörter für Kunden, die noch keins haben. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#V leere Passworte füllen|Allgemeine Funktionen]]<br />
|-<br />
| '''X Konfiguration''' || Öffnet die Einstellungen der Schnittstelle. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Konfiguration|Konfiguration]]<br />
|-<br />
| '''Y FTP-Protokoll''' || Zeigt das Protokoll des FTP-Jobs, der die Bestelldateien abholt. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#Y FTP-Protokoll|Allgemeine Funktionen]]<br />
|-<br />
| '''Z Protokoll''' || Zeigt Hinweise und Fehler der Übertragungen. || [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen#Z Protokoll|Allgemeine Funktionen]]<br />
|}<br />
<br />
{{Hinweis|1=Die Einträge '''A''' bis '''V''' erscheinen nur, wenn die Schnittstelle aktiv ist (in der Konfiguration <code>Allgemein.Aktiv</code> = ''J''). '''X''', '''Y''' und '''Z''' sind immer vorhanden.}}<br />
<br />
Einzelne Kunden bearbeiten Sie auch in den [[OBS/Stammdaten/Personen/Weitere Funktionen/Q - Webshop-Einstellungen|Webshop-Einstellungen]] der Person. Regelmäßige Übertragungen richten Sie als [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]] ein: <code>ShopGetBestellungen</code> für die Bestellungen, <code>ShopSetPreise</code> für die Preise und <code>ExecShopJob</code> für Übertragungen, die Sie im Hintergrund starten (siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Shop-Jobs|Shop-Jobs]]).<br />
<br />
== Übertragener Inhalt ==<br />
{| class="wikitable"<br />
! Angabe !! Richtung !! Übertragen !! Hinweis<br />
|-<br />
| Bestellungen als Aufträge || Shop → OBS || ✓ || openTRANS-Dateien, abgeholt per FTP-Job. Manuell mit '''U Bestellungen einlesen''', automatisch mit <code>ShopGetBestellungen</code>.<br />
|-<br />
| Eigene Artikel || OBS → Shop || ✓ || Mit '''D eigene Artikel übertragen''': Bezeichnung, Kurz- und Langtext, Suchbegriffe, EAN, Einheit, Hersteller, Preis und Bildadressen. Artikel der Shop-Lagerlieferanten pflegt Büroring.<br />
|-<br />
| Zuordnung eigener Artikel zu Warengruppen || OBS → Shop || ✓ || Mit '''E Warengruppen verwalten''' oder über die OBS-Warengruppe des Artikels.<br />
|-<br />
| Warengruppen (Kategorien) || Shop → OBS || ✓ || Mit '''E Warengruppen verwalten'''. Neue Warengruppen legt OBS im Shop nicht an.<br />
|-<br />
| Preise || OBS → Shop || ✓ || Mit '''A Preise aktualisieren''' oder <code>ShopSetPreise</code>. Preislisten oder Standardpreise, siehe [[#Voraussetzungen|Voraussetzungen]].<br />
|-<br />
| Personen (Kundenkonten) || OBS → Shop || ✓ || Mit '''C Personen übertragen''' oder aus den Webshop-Einstellungen der Person. Auf Wunsch mit weiteren Zugängen aus den Ansprechpartnern.<br />
|-<br />
| Kostenstellen mit Budget || OBS → Shop || ✓ || Monatliches, vierteljährliches oder jährliches Budget. Ein halbjährliches Budget überträgt OBS nicht.<br />
|-<br />
| Kundengruppen || Shop → OBS || ✓ || Mit '''F Kundengruppen'''.<br />
|-<br />
| Kataloge (Artikelvorlagen) || OBS → Shop || ✓ || Aus den personenbezogenen Artikeln, mit '''H Kataloge für Personen einer Auswertung übertragen''' oder in den Webshop-Einstellungen der Person.<br />
|-<br />
| Bestellvorlagen || OBS → Shop || ✓ || Mit '''I Bestellvorlagen übertragen'''.<br />
|-<br />
| Artikel und Kunden aus dem Shop || Shop → OBS || ✓ || Abgleich mit {{F10}} '''D Datenabgleich''' in der Konfiguration.<br />
|-<br />
| Lagerbestand || OBS → Shop || – ||<br />
|-<br />
| Bestellstatus, Sendungsverfolgung, Rechnung || OBS → Shop || – ||<br />
|}<br />
<br />
== Besonderheiten ==<br />
=== Shop-Lagerlieferanten ===<br />
In der Konfiguration tragen Sie unter <code>Allgemein.Lagerlieferant.1</code> bis <code>Allgemein.Lagerlieferant.5</code> die Lieferanten ein, deren Artikel Büroring im Shop pflegt. Für diese Artikel gilt:<br />
* OBS überträgt sie nicht als eigene Artikel. Eigene Artikel sind alle Artikel, die keinen dieser Lieferanten in den Einkaufsinformationen haben.<br />
* OBS erkennt sie im Shop an der Bestellnummer des Lieferanten. Haben Artikel verschiedener dieser Lieferanten dieselbe Bestellnummer, überträgt OBS die Preise des Artikels, dessen Lieferant die kleinere Nummer hat: Lagerlieferant 1 hat Vorrang vor 2 usw.<br />
* Auch beim Auftragsimport sucht OBS über diese Lieferanten, siehe [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Häufig gestellte Fragen#faq_shop_artikelnichtgefunden|Warum kann ein Artikel nicht gefunden werden?]]<br />
<br />
=== Artikeldaten oder nur Preis ===<br />
Ob OBS bei einem Artikel, der schon im Shop ist, alle Artikeldaten überschreibt, legt <code>Export.Artikel.Prioritaet</code> fest. Steht die Einstellung auf ''N'', aktualisiert OBS nur Preis und Status (aktiv oder inaktiv).<br />
<br />
=== Bilder ===<br />
Bilddateien überträgt OBS nicht. Stattdessen überträgt OBS die Bildadresse (URL), unter der der Shop das Bild lädt. Die Adresse hinterlegen Sie in der [[OBS/Stammdaten/Artikel: H2 - Bildverwaltung|Bildverwaltung]] des Artikels. Eine Bildadresse überträgt OBS nur, wenn sie sich in OBS geändert hat. So bleiben Bilder erhalten, die im Adminbereich des Shops gepflegt wurden.<br />
<br />
=== Nachfolger brShop24 ===<br />
Nachfolger von VShop 4.0 ist der [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24|brShop24]] von Büroring. Die beiden Schnittstellen sind nicht kompatibel. Was bei einer Umstellung für OBS zu beachten ist, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24#Umstellung von VShop 4.0|brShop24: Umstellung von VShop 4.0]]. Die Übernahme der Daten in OBS beschreibt [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/M Migration|brShop24: M Migration]].<br />
<br />
== Siehe auch ==<br />
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]<br />
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Häufig gestellte Fragen|VShop 4.0: Häufig gestellte Fragen]]<br />
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]<br />
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Allgemeine Funktionen|Allgemeine Funktionen]]<br />
* [[OBS/Kostenpflichtige Module/Preislisten|Preislisten]]<br />
* [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]]</div>MINERVA-Nimz