https://wiki.bergau.de/index.php?action=history&feed=atom&title=OBS%2FStammdaten%2FSchnittstellen%2FInternet-Shop%2FVShop_4.0%2FEinrichtungOBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Einrichtung - Versionsgeschichte2026-11-04T07:38:53ZVersionsgeschichte dieser Seite in OBS WikiMediaWiki 1.43.9https://wiki.bergau.de/index.php?title=OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop_4.0/Einrichtung&diff=67149&oldid=prevMINERVA-Nimz: Neue Einrichtungsanleitung für VShop 4.0 (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]2026-11-03T15:25:30Z<p>Neue Einrichtungsanleitung für VShop 4.0 (Neuaufbau Internet-Shop) [Styleguide-Abweichung: Linkziele folgen in derselben Welle]</p>
<p><b>Neue Seite</b></p><div>{{Vorlage:Kostenpflichtige Module}}<br />
{{Seitentyp|Anleitung}}<br />
= Einrichtung =<br />
<br />
Mit der Schnittstelle zu VShop 4.0 pflegen Sie Ihren Büroring-Shop direkt aus OBS: Personen, eigene Artikel, Preise und Bestellvorlagen überträgt OBS in den Shop, Bestellungen kommen als Aufträge zurück. Diese Seite zeigt, was Sie für die Einrichtung brauchen, welche Schritte der OBS-Support übernimmt und was Sie selbst erledigen.<br />
<br />
{{Auf einen Blick|1=<br />
* '''Ihre Aufgabe: Zugangsdaten.''' Die Zugangsdaten für Shop-Datenbank und FTP-Server erhalten Sie von Büroring und stellen sie dem OBS-Support bereit.<br />
* '''Ihre Aufgabe: Shop.''' Im Adminbereich des Shops hinterlegen Sie bei jeder Versandart die Artikelnummer ''VERSAND''.<br />
* '''OBS-Support: Schnittstelle.''' Der OBS-Support legt die Schnittstelle vom Typ ''VShop 4.0'' an, trägt die Zugangsdaten in die Konfiguration ein und legt den FTP-Job für die Bestellungen an.<br />
* '''Bestellungen.''' Ein FTP-Job holt die Bestelldateien ab, die Automatik <code>ShopGetBestellungen</code> liest sie als Aufträge ein.<br />
}}<br />
<br />
== Voraussetzungen ==<br />
* Sie betreiben einen VShop 4.0 von [https://www.bueroring.de/ BÜRORING eG]. Fragen zum Shop selbst und zu seinen Voraussetzungen beantwortet Büroring.<br />
* Von Büroring haben Sie die Zugangsdaten erhalten:<br />
** '''Shop-Datenbank:''' Adresse des Datenbankservers, Benutzername, Passwort und Name der Datenbank. OBS greift direkt auf die MySQL-Datenbank des Shops zu.<br />
** '''FTP-Server:''' Adresse, Benutzername und Passwort. Über den FTP-Server holt OBS die Bestellungen als openTRANS-Dateien ab.<br />
* Der OBS-Support legt die Schnittstelle an. Dafür braucht er Zugriff auf Ihre OBS-Installation, z.B. per Fernzugriff, und die Zugangsdaten von Büroring.<br />
* Jede Shop-Schnittstelle wird einzeln abgerechnet. Für eine neue Schnittstelle ist eine Vertragsänderung nötig. Sprechen Sie dazu Ihren OBS-Betreuer an.<br />
<br />
== Vorgehen ==<br />
Die Einstellungen im Shop, die Automatiken und die Meldung bei neuen Bestellungen erledigen Sie selbst. Die Schritte von [[#Schnittstelle in OBS anlegen|Schnittstelle in OBS anlegen]] bis [[#FTP-Job für Bestellungen anlegen|FTP-Job für Bestellungen anlegen]] übernimmt der OBS-Support. Sie sind hier beschrieben, damit Sie die Einrichtung nachvollziehen und später prüfen können.<br />
<br />
=== Einstellungen im Shop ===<br />
Diesen Schritt erledigen Sie selbst. Im Adminbereich des VShops öffnen Sie '''Zahlungsarten → Versandarten''':<br />
<br />
[[Datei:Versandarten.jpg|alt=Versandarten im Adminbereich des VShops]]<br />
<br />
{{Schritte|1=<br />
# Öffnen Sie nacheinander jede Versandart.<br />
# Tragen Sie als Artikelnummer ''VERSAND'' ein.<br />
# Speichern Sie die Versandart.<br />
}}<br />
<br />
=== Schnittstelle in OBS anlegen ===<br />
Diesen Schritt übernimmt der OBS-Support.<br />
<br />
{{Schritte|1=<br />
# Öffnen Sie '''Stammdaten → Schnittstellen → Internet-Shop''' und drücken Sie {{Einfg}}.<br />
# Übernehmen Sie in '''Nummer''' die vorgeschlagene dreistellige Nummer oder tragen Sie eine freie Nummer ein.<br />
# Wählen Sie in '''Schnittstelle''' ''VShop 4.0''.<br />
# Tragen Sie eine '''Bezeichnung''' ein, z.B. den Namen des Shops.<br />
# Speichern Sie mit {{F2}}.<br />
}}<br />
<br />
Beim Speichern legt OBS die Konfiguration mit den Standardwerten und das Verzeichnis <code>data\shop\<Nummer></code> der Schnittstelle an. Außerdem ordnet OBS der Schnittstelle alle Preislisten zu, deren Preislistentyp für Shops zulässig ist.<br />
<br />
{{Hinweis|1='''Nummer''' und '''Schnittstelle''' können Sie später nicht mehr ändern.}}<br />
<br />
=== Konfiguration eintragen ===<br />
Diesen Schritt übernimmt der OBS-Support mit den Zugangsdaten, die Sie bereitstellen.<br />
<br />
{{Schritte|1=<br />
# Markieren Sie die neue Schnittstelle, drücken Sie {{F10}} und wählen Sie '''X Konfiguration'''.<br />
# Tragen Sie die Zugangsdaten der Shop-Datenbank ein: <code>Datenbank.Host</code>, <code>Datenbank.Login.Benutzer</code>, <code>Datenbank.Login.Passwort</code> und <code>Datenbank.Datenbankname</code>. <code>Datenbank.Host.Port</code> brauchen Sie nur, wenn Büroring einen abweichenden Port nennt.<br />
# Wählen Sie in <code>Allgemein.Lagerlieferant.1</code> mit {{Return}} den Lieferanten aus, dessen Artikel Sie im Shop anbieten. Ohne diese Angabe kommt keine Verbindung zustande.<br />
# Tragen Sie die Zugangsdaten des FTP-Servers ein: <code>FTP.Host</code>, <code>FTP.Login.Benutzer</code> und <code>FTP.Login.Passwort</code>.<br />
# Tragen Sie die Verzeichnisse für die Abholung der Bestellungen ein:<br />
#* <code>FTP.Verzeichnis.IN</code>: <code>data\shop\<Nummer>\xml\</code>, z.B. <code>data\shop\001\xml\</code><br />
#* <code>FTP.Verzeichnis.OUT</code>: <code>/out/*xml</code><br />
# Prüfen Sie, dass <code>Allgemein.Aktiv</code> auf ''J'' steht.<br />
# Tragen Sie in <code>Allgemein.Schnittstelle.Sachbearbeiter</code> den Sachbearbeiter ein, der Nachrichten und Aufgaben aus der Schnittstelle erhalten soll.<br />
}}<br />
<br />
{{Achtung|1=Ersetzen Sie in <code>FTP.Verzeichnis.IN</code> den Teil <code><Nummer></code> durch die dreistellige Nummer der Schnittstelle.}}<br />
<br />
Alle weiteren Einstellungen beschreibt [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Konfiguration|Konfiguration]]. Für die Zugangsdaten brauchen Sie Level 5 für die Shop-Schnittstellen.<br />
<br />
=== Verbindung testen ===<br />
Diesen Schritt übernimmt der OBS-Support. Sie können ihn später jederzeit selbst wiederholen: Drücken Sie in der Konfiguration {{F9}} ('''F9 Test'''). OBS meldet „Verbindung erfolgreich.“ Erscheint „Verbindung konnte nicht aufgebaut werden.“, lesen Sie unter [[#Wenn es nicht klappt|Wenn es nicht klappt]] weiter.<br />
<br />
=== FTP-Job für Bestellungen anlegen ===<br />
Diesen Schritt übernimmt der OBS-Support, denn er erfordert Level 9 für die Shop-Schnittstellen. Die Bestellungen stellt Büroring als openTRANS-Dateien auf dem FTP-Server bereit. Ein Eintrag der [[OBS/Zusatzprogramme/FTP Jobliste|FTP Jobliste]] holt sie in das Verzeichnis der Schnittstelle.<br />
<br />
{{Schritte|1=<br />
# Drücken Sie in der Konfiguration {{F7}} ('''F7 FTP-Job'''). Die Taste steht nur Benutzern mit Level 9 für die Shop-Schnittstellen zur Verfügung.<br />
# OBS legt den FTP-Job ''Shop Bestellungen'' mit der Bezeichnung ''Internetshop <Nummer> Bestellabholung'' an. Er holt die Dateien aus <code>FTP.Verzeichnis.OUT</code> und legt sie in <code>FTP.Verzeichnis.IN</code> ab.<br />
}}<br />
<br />
Gibt es schon einen FTP-Job mit denselben Zugangsdaten und Verzeichnissen, ordnet OBS diesen der Schnittstelle zu, statt einen neuen anzulegen.<br />
<br />
=== Automatiken einrichten ===<br />
Die Automatiken richten Sie bei Bedarf selbst ein. Wie Sie Automatiken anlegen, steht unter [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]. Für VShop 4.0 stehen zur Verfügung:<br />
* <code>ShopGetBestellungen</code> – liest die abgeholten Bestelldateien als Aufträge ein.<br />
* <code>ShopSetPreise</code> – überträgt die Preise in den Shop.<br />
* <code>ExecShopJob</code> – arbeitet Übertragungen ab, die Sie im Hintergrund ausführen lassen.<br />
<br />
=== Meldung bei neuen Bestellungen ===<br />
Diese Einstellung nehmen Sie selbst vor. Benutzer, die über neue Shop-Bestellungen informiert werden sollen, aktivieren unter '''System → Benutzerpflege''', {{F9}} '''Layout''', Registerkarte '''Sonstiges''' den Punkt '''Meldung bei Internetbestellung''', siehe [[OBS/System/F9 Layout|F9 Layout]]:<br />
<br />
[[Datei:MitarbeiterShopLayout.jpg|alt=Einstellung Meldung bei Internetbestellung im Benutzerlayout]]<br />
<br />
== Ergebnis ==<br />
* {{F9}} in der Konfiguration meldet „Verbindung erfolgreich.“<br />
* Im Shop-Menü ({{F10}}) stehen alle Übertragungsfunktionen zur Verfügung, z.B. '''A Preise aktualisieren''' und '''U Bestellungen einlesen'''. Bei einer inaktiven Schnittstelle fehlen sie.<br />
* In der FTP Jobliste steht der Job ''Internetshop <Nummer> Bestellabholung''.<br />
* Neue Bestellungen aus dem Shop erscheinen nach dem nächsten Lauf von FTP-Job und <code>ShopGetBestellungen</code> als Aufträge in OBS.<br />
<br />
== Wenn es nicht klappt ==<br />
Hinweise zur Ursache stehen im Protokoll der Schnittstelle (Shop-Menü '''Z Protokoll'''). Einträge mit Level 9 sehen nur Benutzer mit Level 9 für die Shop-Schnittstellen.<br />
<br />
{| class="wikitable"<br />
! Meldung !! Ursache<br />
|-<br />
| „Verbindung konnte nicht aufgebaut werden.“ ({{F9}} in der Konfiguration) || Mögliche Ursachen:<br />
* <code>Allgemein.Aktiv</code> steht auf ''N''.<br />
* <code>Datenbank.Host</code>, <code>Datenbank.Login.Benutzer</code> oder <code>Datenbank.Login.Passwort</code> ist leer.<br />
* Eine der Ursachen aus den folgenden Zeilen. Die Meldung steht dann im Protokoll.<br />
|-<br />
| Protokoll: „Es ist kein Lieferant für den Shop ausgewählt!“ || <code>Allgemein.Lagerlieferant.1</code> ist leer. Wählen Sie den Lieferanten mit {{Return}} aus.<br />
|-<br />
| Protokoll: „Kein Shop-Datenbankname eingetragen!“ || <code>Datenbank.Datenbankname</code> ist leer.<br />
|-<br />
| Protokoll: „Keine Verbindung zur Shopdatenbank möglich!“ || OBS erreicht die Shop-Datenbank nicht, oder die Zugangsdaten stimmen nicht. Prüfen Sie <code>Datenbank.Host</code>, <code>Datenbank.Host.Port</code>, Benutzer, Passwort und Datenbanknamen. Zusätzlich legt OBS die Info „[Shop-DB] Fehler bei Verbindungsaufbau“ an. Stimmen die Angaben, wenden Sie sich an Büroring.<br />
|-<br />
| Protokoll: „Konfiguration für Shop … konnte nicht eingelesen werden!“ || OBS konnte die Konfiguration der Schnittstelle nicht lesen. Wenden Sie sich an den OBS-Support.<br />
|-<br />
| „Bitte FTP-Einstellungen vollständig hinterlegen!“ ({{F7}} in der Konfiguration) || Eine der Einstellungen <code>FTP.Host</code>, <code>FTP.Login.Benutzer</code>, <code>FTP.Login.Passwort</code>, <code>FTP.Verzeichnis.IN</code> oder <code>FTP.Verzeichnis.OUT</code> ist leer.<br />
|}<br />
<br />
== Siehe auch ==<br />
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0|VShop 4.0]]<br />
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Konfiguration|Konfiguration]]<br />
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Häufig gestellte Fragen|Häufig gestellte Fragen]]<br />
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Automatiken|Automatiken]]<br />
* [[OBS/Stammdaten/Schnittstellen/Internet-Shop|Internet-Shop]]</div>MINERVA-Nimz