Einrichtung

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.

Auf einen Blick

Ihre Aufgabe: Zugangsdaten. Die Zugangsdaten für Shop-Datenbank und FTP-Server erhalten Sie von Büroring und stellen sie dem OBS-Support bereit.
Ihre Aufgabe: Shop. Im Adminbereich des Shops hinterlegen Sie bei jeder Versandart die Artikelnummer VERSAND.
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.
Bestellungen. Ein FTP-Job holt die Bestelldateien ab, die Automatik ShopGetBestellungen liest sie als Aufträge ein.

Voraussetzungen

Sie betreiben einen VShop 4.0 von BÜRORING eG. Fragen zum Shop selbst und zu seinen Voraussetzungen beantwortet Büroring.
Von Büroring haben Sie die Zugangsdaten erhalten:
- Shop-Datenbank: Adresse des Datenbankservers, Benutzername, Passwort und Name der Datenbank. OBS greift direkt auf die MySQL-Datenbank des Shops zu.
- FTP-Server: Adresse, Benutzername und Passwort. Über den FTP-Server holt OBS die Bestellungen als openTRANS-Dateien ab.
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.
Jede Shop-Schnittstelle wird einzeln abgerechnet. Für eine neue Schnittstelle ist eine Vertragsänderung nötig. Sprechen Sie dazu Ihren OBS-Betreuer an.

Vorgehen

Die Einstellungen im Shop, die Automatiken und die Meldung bei neuen Bestellungen erledigen Sie selbst. Die Schritte von Schnittstelle in OBS anlegen bis 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.

Einstellungen im Shop

Diesen Schritt erledigen Sie selbst. Im Adminbereich des VShops öffnen Sie Zahlungsarten → Versandarten:

Öffnen Sie nacheinander jede Versandart.
Tragen Sie als Artikelnummer VERSAND ein.
Speichern Sie die Versandart.

Schnittstelle in OBS anlegen

Diesen Schritt übernimmt der OBS-Support.

Öffnen Sie Stammdaten → Schnittstellen → Internet-Shop und drücken Sie Einfg.
Übernehmen Sie in Nummer die vorgeschlagene dreistellige Nummer oder tragen Sie eine freie Nummer ein.
Wählen Sie in Schnittstelle VShop 4.0.
Tragen Sie eine Bezeichnung ein, z.B. den Namen des Shops.
Speichern Sie mit F2.

Beim Speichern legt OBS die Konfiguration mit den Standardwerten und das Verzeichnis data\shop\<Nummer> der Schnittstelle an. Außerdem ordnet OBS der Schnittstelle alle Preislisten zu, deren Preislistentyp für Shops zulässig ist.

HINWEIS: Nummer und Schnittstelle können Sie später nicht mehr ändern.

Konfiguration eintragen

Diesen Schritt übernimmt der OBS-Support mit den Zugangsdaten, die Sie bereitstellen.

Markieren Sie die neue Schnittstelle, drücken Sie F10 und wählen Sie X Konfiguration.
Tragen Sie die Zugangsdaten der Shop-Datenbank ein: Datenbank.Host, Datenbank.Login.Benutzer, Datenbank.Login.Passwort und Datenbank.Datenbankname. Datenbank.Host.Port brauchen Sie nur, wenn Büroring einen abweichenden Port nennt.
Wählen Sie in Allgemein.Lagerlieferant.1 mit ↩ Enter den Lieferanten aus, dessen Artikel Sie im Shop anbieten. Ohne diese Angabe kommt keine Verbindung zustande.
Tragen Sie die Zugangsdaten des FTP-Servers ein: FTP.Host, FTP.Login.Benutzer und FTP.Login.Passwort.
Tragen Sie die Verzeichnisse für die Abholung der Bestellungen ein:
- FTP.Verzeichnis.IN: data\shop\<Nummer>\xml\, z.B. data\shop\001\xml\
- FTP.Verzeichnis.OUT: /out/*xml
Prüfen Sie, dass Allgemein.Aktiv auf J steht.
Tragen Sie in Allgemein.Schnittstelle.Sachbearbeiter den Sachbearbeiter ein, der Nachrichten und Aufgaben aus der Schnittstelle erhalten soll.

ACHTUNG: Ersetzen Sie in FTP.Verzeichnis.IN den Teil <Nummer> durch die dreistellige Nummer der Schnittstelle.

Alle weiteren Einstellungen beschreibt Konfiguration. Für die Zugangsdaten brauchen Sie Level 5 für die Shop-Schnittstellen.

Verbindung testen

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 weiter.

FTP-Job für Bestellungen anlegen

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 FTP Jobliste holt sie in das Verzeichnis der Schnittstelle.

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.
OBS legt den FTP-Job Shop Bestellungen mit der Bezeichnung Internetshop <Nummer> Bestellabholung an. Er holt die Dateien aus FTP.Verzeichnis.OUT und legt sie in FTP.Verzeichnis.IN ab.

Gibt es schon einen FTP-Job mit denselben Zugangsdaten und Verzeichnissen, ordnet OBS diesen der Schnittstelle zu, statt einen neuen anzulegen.

Automatiken einrichten

Die Automatiken richten Sie bei Bedarf selbst ein. Wie Sie Automatiken anlegen, steht unter Automatiken. Für VShop 4.0 stehen zur Verfügung:

ShopGetBestellungen – liest die abgeholten Bestelldateien als Aufträge ein.
ShopSetPreise – überträgt die Preise in den Shop.
ExecShopJob – arbeitet Übertragungen ab, die Sie im Hintergrund ausführen lassen.

Meldung bei neuen Bestellungen

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 F9 Layout:

Ergebnis

F9 in der Konfiguration meldet „Verbindung erfolgreich.“
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.
In der FTP Jobliste steht der Job Internetshop <Nummer> Bestellabholung.
Neue Bestellungen aus dem Shop erscheinen nach dem nächsten Lauf von FTP-Job und ShopGetBestellungen als Aufträge in OBS.

Wenn es nicht klappt

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.

Meldung	Ursache
„Verbindung konnte nicht aufgebaut werden.“ (F9 in der Konfiguration)	Mögliche Ursachen: `Allgemein.Aktiv` steht auf N. `Datenbank.Host`, `Datenbank.Login.Benutzer` oder `Datenbank.Login.Passwort` ist leer. Eine der Ursachen aus den folgenden Zeilen. Die Meldung steht dann im Protokoll.
Protokoll: „Es ist kein Lieferant für den Shop ausgewählt!“	`Allgemein.Lagerlieferant.1` ist leer. Wählen Sie den Lieferanten mit ↩ Enter aus.
Protokoll: „Kein Shop-Datenbankname eingetragen!“	`Datenbank.Datenbankname` ist leer.
Protokoll: „Keine Verbindung zur Shopdatenbank möglich!“	OBS erreicht die Shop-Datenbank nicht, oder die Zugangsdaten stimmen nicht. Prüfen Sie `Datenbank.Host`, `Datenbank.Host.Port`, 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.
Protokoll: „Konfiguration für Shop … konnte nicht eingelesen werden!“	OBS konnte die Konfiguration der Schnittstelle nicht lesen. Wenden Sie sich an den OBS-Support.
„Bitte FTP-Einstellungen vollständig hinterlegen!“ (F7 in der Konfiguration)	Eine der Einstellungen `FTP.Host`, `FTP.Login.Benutzer`, `FTP.Login.Passwort`, `FTP.Verzeichnis.IN` oder `FTP.Verzeichnis.OUT` ist leer.

Siehe auch