Zum Inhalt springen

OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop 4.0/Konfiguration

Aus OBS Wiki

Konfiguration

In der Konfiguration legen Sie fest, wie Ihre Schnittstelle zu VShop 4.0 arbeitet: Zugangsdaten zu Shop-Datenbank und FTP-Server, Übertragung von Personen, Artikeln und Preisen sowie Verhalten beim Einlesen der Bestellungen. Außerdem gleichen Sie von hier aus Artikel und Personen mit dem Shop ab. Sie erreichen die Konfiguration über Stammdaten → Schnittstellen → Internet-Shop. Markieren Sie die Schnittstelle, drücken Sie F10 und wählen Sie X Konfiguration.

Liste

Die Liste Shop Konfiguration zeigt alle Einstellungen der Schnittstelle mit den Spalten Schlüssel und Wert, sortiert nach dem Schlüssel. Unter der Liste steht die Beschreibung der markierten Einstellung. Passwörter zeigt die Liste als *****. Wie die Liste allgemein funktioniert, steht unter Internet-Shop: Konfiguration. Alle Einstellungen für VShop 4.0 stehen unten unter Konfiguration.

Tasten und Schaltflächen

Taste Funktion
 ↩ Enter Ändert den Wert der markierten Einstellung. Ja/Nein-Einstellungen wechseln direkt zwischen J und N. Passwörter dürfen höchstens 120 Zeichen lang sein. Ändern können Sie nur Einstellungen, deren Level Ihr Benutzerlevel für die Shop-Schnittstellen nicht übersteigt, siehe Spalte Level unter Konfiguration.
Einfg Einfg Upd. ergänzt fehlende Einstellungen mit ihrem Standardwert. OBS meldet „Fehlende Konfigurationsschlüssel wurden hinzugefügt.“ Vorhandene Werte bleiben unverändert.
Entf Löscht die markierte Einstellung. Nur mit Level 9 für die Shop-Schnittstellen.
F6 F6 Index legt die Feldlängen für die Datensatzschlüssel in der Shop-Datenbank fest. Nur mit Level 9 für die Shop-Schnittstellen.
F7 F7 FTP-Job legt den FTP-Job für die Abholung der Bestellungen an, siehe Einrichtung. 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ü. Bei VShop 4.0 enthält es T Artikeltausch: Dort tauschen Sie beim Einlesen der Bestellungen eine Artikelangabe gegen einen OBS-Artikel oder eine Leistung, siehe Artikeltausch.
F9 F9 Test prüft die Verbindung zur Shop-Datenbank. OBS meldet „Verbindung erfolgreich.“ oder „Verbindung konnte nicht aufgebaut werden.“ Ursachen stehen unter Einrichtung.
F10 Öffnet die Weitere Funktionen, siehe unten.
Wiki Öffnet die Beschreibung der Einstellungen im OBS-Wiki.

F10 Weitere Funktionen

D Datenabgleich

Öffnet das Menü Daten abgleichen mit A Abgleich Artikel und B Abgleich Personen, siehe D Datenabgleich.

Z1 Konfiguration exportieren

Schreibt die Einstellungen der Schnittstelle in die Datei <Schnittstellennummer>.oscf im Exportverzeichnis von OBS, z.B. 001.oscf. Nicht exportiert werden Allgemein.Aktiv und die Debug-Einstellungen. Vorher ergänzt OBS fehlende Einstellungen wie mit Einfg.

Z2 Konfiguration importieren

Liest die Datei <Schnittstellennummer>.oscf aus dem Importverzeichnis von OBS und übernimmt die Werte. Der Dateiname muss die Nummer der Schnittstelle tragen, in die Sie importieren. So übertragen Sie Einstellungen von einer Schnittstelle oder Installation auf eine andere.

D Datenabgleich

Mit dem Datenabgleich übernehmen Sie Daten, die bereits im Shop gepflegt sind, in OBS und verknüpfen sie mit Ihren OBS-Stammdaten. Wählen Sie im Menü Daten abgleichen einen der beiden Einträge.

A Abgleich Artikel

Ordnet die Artikel des Shops den OBS-Artikeln zu:

  1. Steht Import.Abgleich.Artikel.Depot auf J, fragt OBS „Aktuelle Lager ebenfalls importieren?“. Mit Ja liest OBS die Lager aus dem Shop ein, und Sie wählen ein Lager aus. Der Abgleich beschränkt sich dann auf dieses Lager.
  2. OBS liest die Warengruppen des Shops ein.
  3. OBS liest die Artikel aller Kataloge des Shops und sucht zu jedem Artikel den OBS-Artikel über Artikelnummer und EAN. Findet OBS keinen, steht im Protokoll „<Artikelnummer> konnte keinem OBS-Artikel zugeordnet werden“.
  4. Den gefundenen OBS-Artikel ordnet OBS der Warengruppe des Shops zu.
  5. Hat der Artikel keinen der Shop-Lieferanten (Allgemein.Lagerlieferant.1 bis Allgemein.Lagerlieferant.5), behandelt OBS ihn als eigenen Artikel: OBS legt die Shop-Einstellungen des Artikels an und übernimmt Shop-Bezeichnung und Suchbegriffe. Die Shop-Pflege steht auf Ja, wenn der Artikel im Shop aktiv ist, sonst auf Nein. Je nach Einstellung übernimmt OBS außerdem Kurz- und Langtext (Import.Abgleich.Artikel.Texte) und das Bild als Shop-Hauptbild (Import.Abgleich.Artikel.Bilder).

Mit Import.Abgleich.Artikel.Log auf J hält OBS das Ergebnis je Artikel fest und schreibt es zusätzlich in eine Log-Datei ImpArtikel_….log im Verzeichnis debug der Schnittstelle.

B Abgleich Personen

Verknüpft die Konten des Shops mit den Ansprechpartnern in OBS:

  1. OBS liest die Kundengruppen des Shops ein, siehe F Kundengruppen.
  2. Zu jedem Konto mit Kundennummer sucht OBS bei der Person mit dieser Nummer einen sichtbaren Ansprechpartner über Benutzername, E-Mail-Adresse und Name. OBS übernimmt nur eindeutige Treffer.
  3. Das erste Konto einer Person wird Shop-Ansprechpartner (Eigenschaft 9000), wenn die Person noch keinen hat. Weitere Konten erhalten die Eigenschaft 9013 (Zusatzkonto).
  4. OBS ordnet den Ansprechpartner der Schnittstelle zu und speichert die Kundengruppe des Kontos in den Shop-Einstellungen der Person. Hat der Ansprechpartner noch keinen Benutzernamen, übernimmt OBS den Login aus dem Shop.

Konfiguration

Die Einstellungen, ohne die keine Verbindung zustande kommt, sind mit Pflicht für die Verbindung gekennzeichnet. Wie Sie sie eintragen, steht unter Einrichtung.

Die Spalte Level nennt das Benutzerlevel für die Shop-Schnittstellen, das Sie mindestens brauchen, um die Einstellung zu ändern. Die meisten Einstellungen ändern Sie ab Level 3. Zugangsdaten, Allgemein.Aktiv, die Shop-Lieferanten und die meisten Vorgaben für neue Personen und Aufträge erfordern Level 5, die Debug-Einstellungen Level 9.

Allgemein

Einstellung Standard Level Bedeutung
Allgemein.Aktiv J 5 Pflicht für die Verbindung. Schaltet die Schnittstelle aktiv (J) oder inaktiv (N). Bei N blendet das Shop-Menü die Übertragungsfunktionen aus, und auch die Automatiken übertragen keine Daten.
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.Debug.SqlLog N 9 Schreibt alle SQL-Befehle, die OBS auf der Shop-Datenbank ausführt, in eine Protokolldatei im Verzeichnis debug der Schnittstelle.
Allgemein.Lagerlieferant.1 leer 5 Pflicht für die Verbindung. Personennummer des ersten Shop-Lieferanten. Sie wählen ihn mit  ↩ Enter aus. Artikel der Shop-Lieferanten gelten als Shop-Artikel, Artikel ohne Shop-Lieferanten als eigene Artikel.
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.
Allgemein.Schnittstelle.Sachbearbeiter leer 5 Nummer des Shop-Sachbearbeiters. Er erhält Nachrichten und Aufgaben aus der Schnittstelle.
Allgemein.Standard.Personen.Preisgruppe 1 5 Preisgruppe für Personen, die OBS beim Einlesen der Bestellungen neu anlegt. Ist der Wert ungültig, gilt Programmparameter 593.
Allgemein.Standard.Zahlungsbedingung leer 5 Standard-Zahlungsbedingung für Shop-Aufträge.

Datenbank

OBS greift direkt auf die MySQL-Datenbank des Shops zu. Die Zugangsdaten erhalten Sie von Büroring.

Einstellung Standard Level Bedeutung
Datenbank.Datenbankname leer 5 Pflicht für die Verbindung. Name der Shop-Datenbank.
Datenbank.Host leer 5 Pflicht für die Verbindung. Adresse des Datenbankservers.
Datenbank.Host.Port leer 5 Port des Datenbankservers. Bleibt das Feld leer, verwendet OBS den Standardport.
Datenbank.Login.Benutzer leer 5 Pflicht für die Verbindung. Benutzername für die Shop-Datenbank.
Datenbank.Login.Passwort leer 5 Pflicht für die Verbindung. Passwort für die Shop-Datenbank. OBS speichert es verschlüsselt, höchstens 120 Zeichen.

Export

Einstellung Standard Level Bedeutung
Export.Artikel.Prioritaet N 5 Mit J hat OBS die Artikelpriorität: Beim Aktualisieren eigener Artikel überträgt OBS nicht nur den Preis, sondern auch Name, Kurzbeschreibung, Beschreibung, Suchbegriffe, EAN, Mengeneinheit, Packungseinheit, Warengruppe und Hersteller.
Export.Artikel.V03alsEigene N 3 Mit J behandelt OBS Artikel, deren Bestellnummer bei Büroring mit V03 beginnt, als eigene Artikel.
Export.Liste.Bestellvorlage.AnzahlMax 80 3 Höchstzahl Artikel je erzeugter Bestellvorlage. Bei einem Wert unter 1 gilt 80.
Export.Liste.Bestellvorlage.Basis 1 3 Datenbasis für Bestellvorlagen: 1 – Aufträge, 2 – Rechnungen. Ist das Feld leer, gilt 2.
Export.Liste.Bestellvorlage.DatumAb 01.01.2013 3 Ab welchem Datum OBS Vorgänge für die Auswahl der Artikel einbezieht. Ist das Feld leer, gilt der 1. Januar vor fünf Jahren.
Export.Person.Budget.Aktion 1 3 Standard-Aktion, wenn eine Bestellung das Budget der Kostenstelle überschreitet:
0 – keine Aktion
1 – Warnung, die Bestellung kann trotzdem ausgeführt werden
2 – Freigabe, eine berechtigte Person muss die Bestellung freigeben
3 – Sperre, die Bestellung kann nicht ausgelöst werden
Bei einem ungültigen Wert gilt 0.
Export.Person.E-Mail-Login J 5 Mit J ist die E-Mail-Adresse der Login im Shop, mit N die Personennummer.
Export.Person.KS.Bezeichnung N 3 Mit J überträgt OBS die Bezeichnung der Kostenstelle als Kennung in den Shop. Ist sie leer, nimmt OBS Personennummer und Kostenstellennummer. Mit N überträgt OBS Nummer und Bezeichnung der Kostenstelle.
Export.Person.KS.EineProPsNr J 3 Mit J überträgt OBS nur die erste Kostenstelle einer Person, mit N alle Kostenstellen.
Export.Person.LoginAusAnsprech N 3 Mit J verwendet OBS für das Hauptkonto im Shop die Logindaten des Shop-Ansprechpartners (Eigenschaft 9000), sofern einer festgelegt ist.
Export.Person.Pflicht.Ansprech.9000 N 3 Mit J überträgt OBS eine Person nur, wenn sie einen Shop-Ansprechpartner (Eigenschaft 9000) hat.
Export.Preise.Multiplikation.Alka N 4 Multipliziert bei Artikeln des Lieferanten Alka den Preis mit dem Bestellfaktor aus den EK-Lieferanteninformationen. Die Lieferantennummer steht im Programmparameter 696.
Export.Preise.perFTP N 5 Mit J überträgt OBS bei einer Übertragung aller Preise die Preislisten als Textdateien in einer ZIP-Datei per FTP an Büroring, statt sie direkt in die Shop-Datenbank zu schreiben. Dafür legt OBS einen FTP-Job an, der die Datei in das Verzeichnis /in/ des FTP-Servers hochlädt. Überträgt OBS nur eine Preisliste oder die Preise einer Person, schreibt es weiter direkt in die Datenbank.

FTP

Die FTP-Zugangsdaten braucht OBS für die Abholung der Bestellungen und für Export.Preise.perFTP.

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. OBS speichert es verschlüsselt, höchstens 120 Zeichen.
FTP.Mode.Passiv N 5 Überträgt im passiven Modus. Standard ist der aktive Modus (N).
FTP.Verzeichnis.IN leer 5 Verzeichnis in OBS, in das der FTP-Job die Bestelldateien ablegt: data\shop\<Nummer>\xml\, z.B. data\shop\001\xml\.
FTP.Verzeichnis.OUT leer 5 Verzeichnis und Dateimaske auf dem FTP-Server, aus dem der FTP-Job die Bestelldateien abholt: /out/*xml.

Import

Einstellung Standard Level Bedeutung
Import.Abgleich.Artikel.Bilder J 3 A Abgleich Artikel übernimmt für eigene Artikel das Bild aus dem Shop als Shop-Hauptbild (Verweis auf die Bildadresse).
Import.Abgleich.Artikel.Depot J 3 A Abgleich Artikel bietet an, die Lager aus dem Shop einzulesen. So beschränken Sie den Abgleich auf ein Lager.
Import.Abgleich.Artikel.Log J 3 A Abgleich Artikel hält das Ergebnis je Artikel fest und schreibt eine Log-Datei.
Import.Abgleich.Artikel.Texte J 3 A Abgleich Artikel übernimmt für eigene Artikel Kurz- und Langtext aus dem Shop.
Import.Adresse.Auftraggeber.Prio J 3 J – behält die Auftraggeberadresse aus der Bestelldatei bei. N – überschreibt sie mit den OBS-Daten.
Import.Adresse.KontaktInAdresse J 3 Übernimmt den Kontakt in die Adresse (Name, Zusatz1 oder Zusatz2), sofern dort Platz ist.
Import.Adresse.Rechnung J 5 Übernahme des Rechnungsempfängers. Kann die Erlaubnis zum Anlegen von Personen erfordern. J übernimmt den Rechnungsempfänger, N nicht. Feiner steuern Sie mit Zahlen:
1 – kein Rechnungsempfänger
2 – Rechnungsempfänger aus der Datei
3 – Rechnungsempfänger aus dem Personenstamm
4 – Rechnungsempfänger aus der Datei, wenn im Personenstamm keiner angegeben ist
Import.Adresse.Versand J 5 Übernimmt die Versandanschrift, wenn sie abweicht.
Import.Adresse.Versand.Check 1 3 Womit OBS die Versandadresse der Bestellung vergleicht, um zu entscheiden, ob sie abweicht:
1 – mit der Adresse des Auftraggebers im Auftrag
2 – mit der Adresse des Käufers (BUYER_PARTY) aus der Bestelldatei
Andere Werte behandelt OBS wie 1.
Import.Adresse.Versand.Prio 1 3 1 – überschreibt die Versandadresse aus der Datei mit den OBS-Daten. 2 – behält die Adresse aus der Datei bei.
Import.AU.Adressuebernahme J 5 Übernimmt die Adresse in den Auftrag.
Import.AU.FTPEingang.Anlegen J 3 Legt beim Einlesen einer Bestellung einen Eintrag im FTP-Eingang an.
Import.AU.KdBemerk.Drucken J 3 Vorbelegung für die Druckoption des Auftragstexts, den OBS aus der Bemerkung des Kunden erzeugt. Mit N setzt OBS beim Einlesen das Häkchen kein Druck.
Import.AU.Kopf.Bemerk 1 3 Übernahme der Bemerkungen aus den Kopfdaten der Bestellung:
0 – keine
1 – nur die erste Bemerkung
2 – alle Bemerkungen
Import.AU.Kostenstellen.Info leer 3 Nummer des Textbausteins, mit dem OBS die Kostenstelle als Auftragstext (Position) einfügt. Dafür muss Import.AU.Kostenstellenuebernahme auf J stehen. Platzhalter siehe Wie funktionieren Platzhalter.
Import.AU.Kostenstellenuebernahme J 3 Übernimmt die Kostenstelle aus der Datei (COST_CATEGORY_ID).
Import.AU.Materialanlage J 5 J – legt das Auftragsmaterial beim Einlesen an. N – legt kein Material an. Das Material entsteht dann erst, wenn Sie die Positionserfassung einmal öffnen.
Import.AU.Person.Sachbearb N 3 Übernimmt den Sachbearbeiter der Person als Sachbearbeiter des Auftrags. Gibt es die Person noch nicht oder hat sie keinen Sachbearbeiter, gilt der Sachbearbeiter der Schnittstelle.
Import.AU.PersonNrAusEMail N 3 Sucht die Personennummer über die E-Mail-Adresse, wenn die Bestellung keine Kundennummer enthält. OBS verwendet die E-Mail-Adresse des Auftraggebers, aus dem Kontakt vor der Adresse. Die Zuordnung muss eindeutig sein.
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.Preis.Prioritaet J 5 Mit J übernimmt OBS die Preise aus der Bestellung in den Auftrag. Mit N ermittelt OBS die Preise für jede Position selbst, mit den Preislisten der Schnittstelle.
Import.AU.Pos.UstSatz N 3 Übernimmt die Steuersätze aus der OpenTRANS-Datei, sofern angegeben.
Import.AU.PrioShopLieferant N 3 Mit J setzt OBS beim Einlesen bevorzugt die Shop-Lieferanten (Allgemein.Lagerlieferant.1 bis Allgemein.Lagerlieferant.5) als Lieferant für Position und Material ein. Sonst immer den ersten Lieferanten des Artikels.
Import.AU.Standard.Filiale leer 3 Filiale für den Auftrag, wenn OBS auf anderem Weg keine Filiale findet. Erfordert die Filiallösung.
Import.AU.StempelArtikelnummer leer 3 Standard-Artikelnummer für Stempelartikel aus dem Shop.
Import.Info.EMail N 3 Versendet eine E-Mail, wenn ein Auftrag eingelesen wurde. Die E-Mail erhalten nur Benutzer, bei denen Meldung bei Internetbestellungen (Shop) aktiviert ist.
Import.Kostenstelle.Suche.BezeichnungVoll N 3 Mit J vergleicht OBS die vollständige Bezeichnung der Kostenstelle mit der Referenz aus der Bestelldatei, um die Kostenstelle zu finden.
Import.Personen.Anlage J 5 Erlaubt der Schnittstelle, beim Einlesen Personen anzulegen, wenn OBS die Person der Bestellung nicht im Personenstamm findet.
Import.Personen.Nummernkreis 1 5 Nummernkreis für Personen, die OBS beim Einlesen anlegt.
Import.Projektnummer leer 5 Vorbelegung der Projektnummer bei Shop-Aufträgen.

Weitere

Einstellung Standard Level Bedeutung
Positionserfassung.Starten N 5 Öffnet bei Shop-Aufträgen aus der Liste FTP-Eingang die Positionserfassung.

Siehe auch

Abgerufen von „https://wiki.bergau.de/index.php?title=OBS/Stammdaten/Schnittstellen/Internet-Shop/VShop_4.0/Konfiguration&oldid=67098“