OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24/Konfiguration
Konfiguration
In der Konfiguration legen Sie fest, wie Ihre brShop24-Schnittstelle arbeitet: Zugangsdaten zum Shop, Verhalten beim Einlesen der Bestellungen, Übertragung von Preisen, Adressen und Bestellvorlagen. Über das Zuordnungsmenü verknüpfen Sie außerdem die Werte des Shops mit Ihren OBS-Stammdaten. 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 brShop24 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. Ä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.“ Bei brShop24 liest OBS dabei auch die Definitionen aus dem Shop ein, wenn die Schnittstelle aktiv ist. |
| Entf | Löscht die markierte Einstellung. Nur mit Level 9 für die Shop-Schnittstellen. |
| F8 | F8 Zuord öffnet das OBS-Shop-Zuordnungsmenü, siehe Zuordnungen. |
| F9 | F9 Test prüft die Verbindung zum Shop. OBS meldet „Verbindung erfolgreich.“ oder „Verbindung konnte nicht aufgebaut werden.“ Ursachen für Verbindungsfehler stehen unter Einrichtung. |
| F10 | Öffnet die Weitere Funktionen, siehe unten. |
F6 und F7 (F7 FTP-Job) stehen bei brShop24 nicht zur Verfügung. Den FTP-Job für die Abholung der Bestellungen legt der Einrichtungsassistent an.
F10 Weitere Funktionen
Y Schnittstelle zurücksetzen
Nur mit Level 9 für die Shop-Schnittstellen. Setzt die Daten der Schnittstelle in OBS vollständig zurück. Das brauchen Sie, wenn Büroring die Daten im Shop zurückgesetzt hat, z.B. nach einem Test vor dem Live-Betrieb. OBS fragt vorher nach.
Gelöscht werden die Zuordnungen und alle Daten, über die OBS die bisherigen Übertragungen wiedererkennt: Personen, Benutzer, Adressen, Kostenstellen, Kundengruppen, Artikel, Preislisten, Bestellvorlagen und Jobinformationen, die eingelesenen Definitionen wie Lager, Partner, Anreden, Einheiten, Hersteller, Marken und Steuersätze sowie die Shop-Einstellungen in Artikeln und Personen. Die Konfiguration und der Artikeltausch bleiben erhalten.
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, die Debug-Einstellungen und Allgemein.Protokolle.Monate. 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.
Konfiguration
Die Einstellungen, die für die Verbindung nötig sind, sind mit Pflicht für die Verbindung gekennzeichnet. Der Einrichtungsassistent trägt sie für Sie ein.
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 und die Vorgaben für neue Personen, Adressen und Aufträge erfordern Level 5, die Debug-Einstellungen Level 9.
| 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 die Automatiken arbeiten nicht. |
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.Kurzlink.Artikel |
leer | 3 | Link zum Artikel im Shop für Angebotsdrucke: eine URL mit dem Platzhalter $REFERENZ oder die Nummer eines Textbausteins mit dem Link. Siehe PDF-Druck Artikellink.
|
Allgemein.Protokolle.Monate |
60 | 3 | Wie viele Monate OBS Protokolleinträge und -dateien der Schnittstelle höchstens aufbewahrt. |
Allgemein.Schnittstelle.Sachbearbeiter |
leer | 3 | Shop-Sachbearbeiter, der Nachrichten und Aufgaben aus der Schnittstelle erhält, z.B. 01. |
Allgemein.Shop.URL |
leer | 5 | Pflicht für die Verbindung. URL des API-Endpunkts, z.B. https://<Ihre-Shop-Adresse>/apitest.
|
Allgemein.Standard.Personen.Preisgruppe |
1 | 5 | Preisgruppe für Personen, die OBS beim Einlesen der Bestellungen anlegt. |
Allgemein.Standard.Zahlungsbedingung |
leer | 5 | Standard-Zahlungsbedingung für Shop-Aufträge. |
Export.Artikel.ExportBeiSpeichern |
0 | 3 | Verhalten beim Speichern eines Artikels, der der Schnittstelle zugeordnet ist: 0 – überträgt den Artikel immer automatisch 1 – fragt, ob der Artikel übertragen werden soll 2 – überträgt beim Speichern nicht |
Export.GraphQL.Max.batchMode.PL.Loeschen |
100 | 3 | Höchstzahl Datensätze je Stapel beim Löschen von Preislisten im Shop. Werte unter 10 oder über 2000 setzt OBS auf 10 bzw. 2000. |
Export.GraphQL.Max.batchMode.PL.Zuordnen |
100 | 3 | Höchstzahl Datensätze je Stapel beim Zuordnen von Preislisten zu Kundengruppen und Benutzern. Werte unter 10 oder über 2000 setzt OBS auf 10 bzw. 2000. |
Export.GraphQL.Max.batchPriceList |
2000 | 3 | Höchstzahl Datensätze je Stapel bei der Übertragung von Preisen. Werte unter 100 oder über 5000 setzt OBS auf 100 bzw. 5000. |
Export.Liste.Bestellvorlage.AnzahlMax |
50 | 3 | Höchstzahl Artikel je erzeugter Bestellvorlage, höchstens 999. |
Export.Liste.Bestellvorlage.Basis |
2 | 3 | Datenbasis für Bestellvorlagen: 1 – Aufträge, 2 – Rechnungen. |
Export.Liste.Bestellvorlage.Pos.Alternativ |
J | 3 | Alternativ-Positionen in Bestellvorlagen einbeziehen. |
Export.Liste.Bestellvorlage.Pos.Eventual |
J | 3 | Eventual-Positionen in Bestellvorlagen einbeziehen. |
Export.Liste.Bestellvorlage.Pos.OhneBerechnung |
J | 3 | Positionen ohne Berechnung in Bestellvorlagen einbeziehen. |
Export.Liste.Bestellvorlage.Pos.Option |
J | 3 | Option-Positionen in Bestellvorlagen einbeziehen. |
Export.Liste.Bestellvorlage.Pos.Optional |
J | 3 | Optional-Positionen in Bestellvorlagen einbeziehen. |
Export.Liste.Bestellvorlage.Pos.Verbrauchsmat |
J | 3 | Verbrauchsmaterial-Positionen in Bestellvorlagen einbeziehen. |
Export.Liste.Bestellvorlage.VK0 |
N | 3 | Positionen mit einem Verkaufspreis von 0 oder weniger in Bestellvorlagen einbeziehen. |
Export.Liste.Bestellvorlage.Zeitraum.Monate |
36 | 3 | Aus wie vielen zurückliegenden Monaten OBS Vorgänge für die Positionen der Bestellvorlagen auswählt. Mindestens 3, höchstens 60 Monate (5 Jahre). |
Export.Person.Adr.OhneZeile3 |
J | 3 | Im Shop lassen sich nur zwei von drei Adresszeilen eintragen. Je nach Adressfeldern betrifft das Zusatz 2 bzw. Zusatz. J – überträgt die Adresse nur, wenn Zeile 3 leer ist N – überträgt die Adresse ohne Zeile 3 |
Export.Preise.Preis.VK.Check |
N | 3 | Prüft bei der Preisübertragung den Verkaufspreis. Mit J überträgt OBS nur Preise mit Ertrag (VK größer als EK). |
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 |
2 | 5 | Übernahme des Rechnungsempfängers. Kann die Erlaubnis zum Anlegen von Personen erfordern. 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. |
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 |
2 | 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.Datei.Typ |
001 | 3 | Format der Bestelldateien, mit dem OBS die Aufträge einliest. Sie wählen es mit ↩ Enter aus. Büroring stellt die Bestelldateien im Format OpenTRANS 1.0 bereit, die Einstellung steht deshalb auf 001. |
Import.AU.FTPEingang.Anlegen |
N | 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.
|
Import.AU.Kostenstellenuebernahme |
J | 3 | Übernimmt die Kostenstelle aus der Datei (COST_CATEGORY_ID). |
Import.AU.Materialanlage |
J | 3 | 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.Bemerk.VersandLagerVerwerfen |
N | 3 | Verwirft beim Einlesen die Positionsbemerkung „Versand von Lager“. |
Import.AU.Pos.NeueNummmern |
J | 3 | Nummeriert die Positionen beim Einlesen neu durch. |
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 hinterlegten Shop-Lagerlieferanten 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.Job.AufgabeBeiFehler |
N | 3 | Legt für den Shop-Sachbearbeiter eine Aufgabe an, wenn ein Preispflege-Job fehlschlägt. |
Import.Kostenstelle.BestimmtKunde |
N | 3 | Ist im Auftrag eine Kostenstelle angegeben, bestimmt sie den Kunden des Auftrags. Ohne Kostenstelle gilt die Personennummer des Käufers (Buyer-Party). |
Import.Personen.Anlage |
J | 5 | Erlaubt der Schnittstelle, beim Einlesen Personen anzulegen. Hat eine Person keine Kundennummer oder findet OBS die Nummer nicht im Personenstamm, legt OBS mit J eine Person an. Mit N verwendet OBS die Standard-Kundennummer. |
Import.Personen.Nummernkreis |
1 | 5 | Nummernkreis für Personen, die OBS beim Einlesen anlegt. Erlaubt sind 1 oder 9 als erste Ziffer. Je nach Länge sind weitere Vorgaben möglich, z.B. erzeugt 158 bei Standardlänge 6 die Personennummern 158000 bis 158999. |
Import.Projektnummer |
leer | 3 | Vorbelegung der Projektnummer bei Shop-Aufträgen. |
OAuth2.ClientId |
leer | 5 | Pflicht für die Verbindung. Client-ID für die Anmeldung an der API (OAuth2), z.B. 1. |
OAuth2.ClientSecret |
leer | 5 | Pflicht für die Verbindung. Client-Secret für die Anmeldung an der API (OAuth2). OBS speichert es verschlüsselt, höchstens 120 Zeichen. |
OAuth2.TokenEndpoint |
leer | 5 | Pflicht für die Verbindung. Token-Endpunkt für die Anmeldung an der API (OAuth2), z.B. https://<Ihre-Shop-Adresse>/oauth/token.
|
Positionserfassung.Starten |
N | 5 | Öffnet bei Shop-Aufträgen aus der Liste FTP-Eingang die Positionserfassung. |
Zuordnungen
Manche Werte legen Sie im Adminbereich des Shops an, z.B. Mengeneinheiten oder Steuersätze. OBS braucht sie, um Datensätze über die API anzulegen oder zu ändern. F8 öffnet in der Konfiguration das OBS-Shop-Zuordnungsmenü. Dort verknüpfen Sie diese Werte mit Ihren OBS-Stammdaten und legen Einstellungen für die Übertragung fest. Die Werte aus dem Shop liest OBS mit W Definitionen importieren ein, siehe Zuordnungen.
| Eintrag | Wofür |
|---|---|
| A Anreden | Ordnet die Anreden des Shops den OBS-Anreden zu. Nötig für die Übertragung von Benutzern und Adressen. |
| D Lieferstatus Einstellungen | Legt je Lieferstatus fest, ob OBS den Bestand überträgt und was bei Bestand 0 passiert. |
| E Einheiten | Ordnet die Mengeneinheiten des Shops den OBS-Mengeneinheiten zu. Nötig bei der Übertragung eigener Artikel für Basismengeneinheit und Grundpreisangabe. |
| L Lager und Lagerlieferanten | Legt die Lager fest und ordnet die Partner den OBS-Lieferanten zu. Nötig für die Übertragung von Preisen und eigenen Artikeln: Im brShop24 ist ein Artikel erst über Lager und Artikelnummer eindeutig, deshalb braucht OBS beide Angaben. |
| S Spediteure/Paketdienstleister | Ordnet die Paketdienstleister des Shops den OBS-Versandarten zu, damit OBS beim Einlesen den gewählten Dienstleister übernimmt. |
| T Artikeltausch | Tauscht beim Einlesen der Bestellungen eine Artikelangabe gegen einen OBS-Artikel oder eine Leistung, z.B. für Pauschalen mit Dummy-Artikelnummer. |
| U Umsatzsteuer | Ordnet die Steuersätze des Shops den OBS-Steuerschlüsseln zu. Nötig bei der Übertragung eigener Artikel. |
D Lieferstatus Einstellungen
Hier verknüpfen Sie keine OBS-Stammdaten, sondern legen für jeden Lieferstatus des Shops fest, wie OBS Artikel mit diesem Status überträgt: ob der Bestand mitgeht, ob ein Artikel ohne Bestand inaktiv wird und welchen Lieferstatus er dann erhält. Maßgeblich ist der Lieferstatus aus der Lager-Definition des Artikels, sonst der aus seinen Webshop-Einstellungen.
Die Liste Shop - Einstellungen Lieferstatus zeigt je Lieferstatus die Spalten OBS-ID, Bez, Exp. Bst. (Bestand exportieren), Deakt. 0 (deaktivieren bei Bestand 0) und Tausch 0 (anderer Lieferstatus bei Bestand 0).
| Taste | Funktion |
|---|---|
| Einfg | Liest die Lieferstatus aus dem Shop ein. |
| ↩ Enter | Öffnet die Eingabemaske Lieferstatus. Sichern Sie mit F2. |
Löschen können Sie Einträge nicht. Liest OBS einen Lieferstatus zum ersten Mal ein, belegt es die Einstellungen so vor:
- Lieferstatus Lagerartikel: Bestand exportieren, bei Bestand 0 Lieferstatus LagerartikelZZtOhneBestand.
- Lieferstatus Auslaufartikel: Bestand exportieren, bei Bestand 0 deaktivieren und Lieferstatus KeinLagerartikelGesperrt.
- Alle anderen: keine der drei Einstellungen.
Eingabemaske Lieferstatus
| Feld | Bedeutung |
|---|---|
| Lieferstatus Text | Bezeichnung des Lieferstatus im Shop. Nur zur Anzeige. |
| Artikelbestand exportieren | Überträgt den Bestand der Artikel mit diesem Lieferstatus, abhängig von den Einstellungen im Lager. Vom Bestand zieht OBS den auftragsgebundenen Bestand ab, der kleinste Wert ist 0. |
| Artikel deaktivieren, wenn Bestand 0 | Wirkt nur zusammen mit Artikelbestand exportieren. Ergibt die Bestandsermittlung 0, überträgt OBS den Artikel als inaktiv. |
| Lieferstatus bei Bestand 0 | Wirkt nur zusammen mit Artikelbestand exportieren. Ergibt die Bestandsermittlung 0, überträgt OBS den Artikel mit dem hier gewählten Lieferstatus. |
U Umsatzsteuer
Hier ordnen Sie die Steuersätze des Shops den OBS-Steuerschlüsseln zu. OBS braucht die Zuordnung bei der Übertragung eigener Artikel. Fehlt sie, wählt OBS den Steuersatz über den Prozentsatz, siehe Zuordnungen.
Die Liste Shop - Steuerraten zeigt die Spalten Name und Bez (Steuersatz im Shop) und OBS (zugeordneter Steuerschlüssel).
| Taste | Funktion |
|---|---|
| Einfg | Liest die Steuersätze aus dem Shop ein. |
| ↩ Enter | Öffnet die Eingabemaske Steuerrate. Sichern Sie mit F2. |
Löschen können Sie Einträge nicht.
Eingabemaske Steuerrate
| Feld | Bedeutung |
|---|---|
| Name | Name des Steuersatzes im Shop. Nur zur Anzeige. |
| OBS Mwst | Der OBS-Steuerschlüssel, der zu diesem Steuersatz gehört. Wählen Sie ihn aus der Liste. |