Kostenpflichtige Module/Internet-Shop/brShop24/Konfiguration: Unterschied zwischen den Versionen

Aus OBS Wiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „{{Vorlage:Kostenpflichtige Module}} Diese Seite listet die Konfigurationsschlüssel für den Schnittstellentyp VShop 4.0 auf. Informationen zur Liste und Einst…“)
 
(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Vorlage:Kostenpflichtige Module}}
{{Vorlage:Kostenpflichtige Module}}
Diese Seite listet die Konfigurationsschlüssel für den Schnittstellentyp VShop 4.0 auf. Informationen zur Liste und Einstellungen anderer Shop-Schnittstellen finden Sie [[FRMSHOPEINSTELLUNGEN|hier]].
Diese Seite listet die Konfigurationsschlüssel für den Schnittstellentyp brShop24 auf. Informationen zur Liste und Einstellungen anderer Shop-Schnittstellen finden Sie [[FRMSHOPEINSTELLUNGEN|hier]].
=wichtige Einstellungen VShop 4.0=
=Einstellungen über Schlüssel=
Diese Einstellung sind wichtig, damit die Schnittstelle überhaupt funktionieren kann.
==wichtige Einstellungen für brShop24==
Diese Einstellung sind wichtig, damit die Schnittstelle überhaupt funktionieren kann. Siehe dazu auch [[Kostenpflichtige_Module/Internet-Shop/brShop24#Installation.2FEinrichtung|brShop24 Installation/Einrichtung]]
{| class="wikitable"
{| class="wikitable"
|-
|-
! Schlüssel!! Erklärung!! Beispiel
! Schlüssel!! Erklärung!! Beispiel
|-
|-
| Shop.Aktiv|| aktiviert oder deaktiviert die Schnittstelle|| J
| Allgemein.Aktiv|| aktiviert oder deaktiviert die Schnittstelle|| J
|-
|-
| Datenbank.Host|| Adresse des Datenbankservers|| mein.dbserver.de
| Allgemein.Shop.URL|| Endpunkt-URL für die API|| <nowiki>https://meinshop.brshop24.de/apitest</nowiki>
|-
|-
| Datenbank.Login.Benutzer|| Benutzername für Datenbankzugang|| OBS100000
| OAuth2.ClientId|| Client-Id für OAuth2-Authentifizierung (API-Zugriff)|| 1
|-
|-
| Datenbank.Login.Passwort|| Passwort für Datenbankzugang|| pA5sw0rT
| OAuth2.ClientSecret|| Client-Secret für OAuth2-Authentifizierung (API-Zugriff)|| 0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
|-
|-
| Datenbank.Datenbankname|| Name der Shop-Datenbank|| v40_100000
| OAuth2.TokenEndpoint|| Token-Endpoint für OAuth2-Authentifizierung (API-Zugriff)|| <nowiki>https://meinshop.brshop24.de/oauth/token</nowiki>
|}
 
==Übersicht aller Einstellungen für brShop24==
{| class="wikitable"
|-
|-
| Shop.Lagerlieferant.1|| erster Shop-Lagerlieferant|| 700001
! Schlüssel!! Erklärung!! Beispiel
|-valign="top"
| Allgemein.Aktiv|| aktiviert (J) oder deaktiviert (N) die Schnittstelle|| J
|-valign="top"
| Allgemein.Debug|| Debugmodus für Shop aktivieren. Erweitert das Protokoll um zusätzliche Einträge und sollte nur in Problemfällen aktiviert werden.<br />'''Für Administratoren (Level 9)'''|| N
|-valign="top"
| Allgemein.Debug.LogLevel|| Level für Logeinträge während des Debuggens (0 bis 5). 0=Keine 5=Alles<br />'''Für Administratoren (Level 9)'''|| 0
|-valign="top"
| Allgemein.Schnittstelle.Sachbearbeiter|| Shopsachbearbeiternummer als Empfänger für Nachrichten und Aufgaben aus der Shopschnittstelle|| 01
|-valign="top"
| Allgemein.Shop.URL|| Endpunkt-URL für die API|| <nowiki>https://meinshop.brshop24.de/apitest</nowiki>
|-valign="top"
| Allgemein.Standard.Personen.Preisgruppe|| Personenanlage in Preisgruppe||
|-valign="top"
| Allgemein.Standard.Zahlungsbedingung|| Standardzahlungsbedingung für Shopaufträge||
|-valign="top"
| Export.Artikel.ExportBeiSpeichern|| Eisntellung für das Verhalten von OBS beim Speichern eines Artikels mit Zuordnung zur Schnittstelle.<br />0 = Export wird beim Speichern ausgeführt (Standard)<br />1 = Ja/Nein Abfrage, ob Exportiert werden soll<br />2 = Kein Export beim Speichern|| 0
|-valign="top"
| Export.GraphQL.Max.batchPriceList|| Maximale Anzahl an Datensätzen pro Stapel. Der minimal verwendete Wert ist 100 und der maximale Wert 5000. Größere oder kleinere Werte werden automatisch auf den maximalen bzw. minimalen Wert gesetzt.<br />Standardwert ist 2000.|| 2000
|-valign="top"
| Export.Liste.Bestellvorlage.AnzahlMax|| maximale Anzahl an Artikeln pro generierter Bestellvorlage|| 100
|-valign="top"
| Export.Liste.Bestellvorlage.Basis|| Bestellvorlage Standard-Datenbasis.<br />1 = Auftrag<br />2 = Rechnung|| 2
|-valign="top"
| Export.Liste.Bestellvorlage.Pos.Alternativ|| In Bestellvorlage Alternativ-Positionen mit einbeziehen.|| J
|-valign="top"
| Export.Liste.Bestellvorlage.Pos.Eventual|| In Bestellvorlage Eventual-Positionen mit einbeziehen.|| J
|-valign="top"
| Export.Liste.Bestellvorlage.Pos.OhneBerechnung|| In Bestellvorlage Positionen ohne Berechnung mit einbeziehen.|| J
|-valign="top"
| Export.Liste.Bestellvorlage.Pos.Option|| In Bestellvorlage Option-Positionen mit einbeziehen.|| J
|-valign="top"
| Export.Liste.Bestellvorlage.Pos.Optional|| In Bestellvorlage Optional-Positionen mit einbeziehen.|| J
|-valign="top"
| Export.Liste.Bestellvorlage.Pos.Verbrauchsmat|| In Bestellvorlage Verbrauchsmaterial-Positionen mit einbeziehen.|| J
|-valign="top"
| Export.Liste.Bestellvorlage.VK0|| In Bestellvorlage Positionen mit VK<=0 einbeziehen.|| N
|-valign="top"
| Export.Liste.Bestellvorlage.Zeitraum.Monate|| Anzahl der vergangenen Monate ausgehend vom aktuellen Datum aus denen Vorgänge bei der Selektion der Positionen mit einbezogen werden. Es werden minimal 3 Monate und maximal 60 Monate (5 Jahre) selektiert.|| 36
|-valign="top"
| Export.Person.Adr.OhneZeile3|| Prüfung der Adressezeile 3 beim Export von Adressen, da im Shop nur zwei von drei Zeilen eingetragen werden können. Abhängig der vorhandenen Adressefelder bezieht sich dies auf "Zusatz 2" bzw. "Zusatz".<br />J = Export nur wenn Adresszeile 3 leer<br />N = Inhalt wird ignoriert und Adresse ohne Zeile 3 im Shop angelegt|| J
|-valign="top"
| Export.Preise.Preis.VK.Check|| Aktiviert beim Preisexport die Prüfung des Verkaufspreises. Wenn aktiviert (J), werden nur Preise mit Ertrag (VK > EK) exportiert.|| J
|-valign="top"
| Import.Adresse.Auftraggeber.Prio|| Legt fest, ob die Adresse aus der Datei mit den OBS-Daten überschrieben wird (N) oder die Adresse aus der Datei beibehalten werden soll (J).|| J
|-valign="top"
| Import.Adresse.KontaktInAdresse|| Kontakt wird in Adresse übernommen (Name, Zusatz1 oder Zusatz2), sofern dort Platz ist.|| J
|-valign="top"
| Import.Adresse.Rechnung|| Rechnungsempfänger übernehmen. Dies benötigt eventuell die Erlaubnis Personen anlegen zu dürfen.|| J
|-valign="top"
| Import.Adresse.Versand|| Versandanschrift übernehmen|| J
|-valign="top"
| Import.Adresse.Versand.Check|| Legt fest, mit welcher Adresse die Versandadresse der Shop-Bestellung verglichen wird.<br />0 = BUYER_PARTY aus Datei<br />1 = Auftraggeber|| 1
|-valign="top"
| Import.Adresse.Versand.Prio|| Legt fest, ob die Adresse aus der Datei mit den OBS-Daten überschrieben wird (1) oder die Adresse aus der Datei beibehalten werden soll (2).|| 2
|-valign="top"
| Import.AU.Adressuebernahme|| Adresse in Auftrag übernehmen|| J
|-valign="top"
| Import.AU.Datei.Typ|| Import-Typ Auftragsdateien. Bestimmt mit welchem Import die Auftragsdaten importiert werden.{{Hinweis|Gegenwärtig stellt Büroring nur Auftragsdateien im Format OpenTRANS 1.0 zur Verfügung. Diese Einstellung sollte daher immer auf 001 stehen.}}|| 001
|-valign="top"
| Import.AU.FTPEingang.Anlegen|| Aktiviert die Anlage einer Info in FTP-Eingang bei Import der Bestellung.|| N
|-valign="top"
| Import.AU.KdBemerk.Drucken|| Vorbelegung für die Druck-Option des Auftragstext, welcher aus der Auftragsbemerkung des Kunden genriert wird. Mit "N" wird das Häkchen in "kein Druck" automatisch beim Import gesetzt.|| J
|-valign="top"
| Import.AU.Kostenstellen.Info|| Textbausteinnummer für Kostenstelleninfo als Auftragstext (Position). Für die Anlage der Info muss die Kostenstellenübernahme aktiv sein.||
|-valign="top"
| Import.AU.Kostenstellenuebernahme|| Aktiviert die Übernahme von Kostenstellen aus der Datei (COST_CATEGORY_ID).|| J
|-valign="top"
| Import.AU.Materialanlage|| Automatische Anlage des Auftragsmaterials beim Import.<br />J = Legt das Material beim Import an<br />N = Es wird kein Material beim Import angelegt. Für Materialanlage muss die Positionserfassung einmal geöffnet werden|| J
|-valign="top"
| Import.AU.Person.Sachbearb|| Übernahme des Sachbearbeiters aus der Person als Sachbearbeiter des Auftrags. Ist noch keine Person vorhanden oder der Sachbearbeiter leer, so wird der Standard-Sachbearbeiter der Shop-Schnittstelle verwendet.|| N
|-valign="top"
| Import.AU.Pos.Bemerk.VersandLagerVerwerfen|| Positionsbemerkung "Versand von Lager" beim Import verwerfen.|| N
|-valign="top"
| Import.AU.Pos.NeueNummmern|| Wenn aktiv ("J"), dann werden die Positionen beim Auftragsimport neu durchnummeriert.|| J
|-valign="top"
| Import.AU.Pos.UstSatz|| Übernahme der Steuersätze, sofern angegeben, aus der OpenTRANS-Datei.|| N
|-valign="top"
| Import.AU.PrioShopLieferant|| Beim Importieren der Bestellungen werden vorzugsweise die hinterlegten Shop-Lagerlieferanten als Lieferant für Position und Material gezogen. Andernfalls wird immer der erste Lieferant des Artikels gezogen.|| N
|-valign="top"
| Import.AU.Standard.Filiale|| Standard Filiale bei Auftragsanlage. Sollte auf anderen Wegen keine Filiale gefunden werden können, wird im Auftrag diese Filiale gesetzt. Benötigt Filiallösung!||
|-valign="top"
| Import.AU.StempelArtikelnummer|| Standard Artikelnummer für Stempel-Artikel, die aus dem Shop übernommen werden||
|-valign="top"
| Import.Info.EMail|| Versendet eine E-Mail als Information, dass ein Auftrag importiert wurde. Die E-Mail wird nur an Benutzer versendet, die "Meldung bei Internetbestellungen (Shop)" aktiviert haben.|| N
|-valign="top"
| Import.Job.AufgabeBeiFehler|| Aufgabe bei Fehler in Preispflege-Job für Shop-Sachbearbeiter anlegen.|| N
|-valign="top"
| Import.Kostenstelle.BestimmtKunde|| Ist eine Kostenstelle im Auftrag angegeben, so wird der Kunde des Auftrags durch die kostenstelle bestimmt. Ohne Kostenstelle wird die Personennummer der Buyer-Party verwendet.|| N
|-valign="top"
| Import.Personen.Anlage|| Shop darf Personen bei Auftragsimport anlegen (J = Anlage erlaubt). Ist eine Person ohne Kundennummer oder die Nummer kann im Personenstamm nicht gefunden werden, wird aufgrund dieser Einstellung entweder ein Datensatz im Personenstamm angelegt oder die Standardkundennummer verwendet.|| J
|-valign="top"
| Import.Personen.Nummernkreis|| Anlage der Personen (Import.Personen.Anlage) in angegebenen Nummernkreis. Erlaubt ist 1 oder 9 als erste Ziffern. Je nach Länge können aber auch weitere Vorgaben gemacht werden (z. N. 158 bei Standardlänge 6 generiert Personennummern von 158000 bis 158999 für die Anlage).||
|-valign="top"
| Import.Projektnummer|| Vorbelegung der Projektnummer bei Shopaufträgen||
|-valign="top"
| OAuth2.ClientId|| Client-Id für OAuth2-Authentifizierung (API-Zugriff)|| 1
|-valign="top"
| OAuth2.ClientSecret|| Client-Secret für OAuth2-Authentifizierung (API-Zugriff)|| 0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
|-valign="top"
| OAuth2.TokenEndpoint|| Token-Endpoint für OAuth2-Authentifizierung (API-Zugriff)|| <nowiki>https://meinshop.brshop24.de/oauth/token</nowiki>
|-valign="top"
| Positionserfassung.Starten|| Aufrufen der Positionserfassung bei Shop-Aufträgen aus der Liste FTP-Eingang|| N
|}
|}


=Übersicht Einstellungen VShop 4.0=
=Zuordnungen=
==Shop.Aktiv==
Manche Definitionen sind im Adminbereich des Shops zu machen, werden jedoch für die Kommunikation mit der API für die Anlage oder Änderung von Datensätzen benötigt. In der Einstellungsliste finden Sie daher die Schaltfläche {{Key|F8 Zuord}}. Über diese gelangen Sie zu den relevanten Zuordnungen und Einstellungen für bestimmte Werte im Datenexport (z. B. Verknüpfung OBS-Mengeneinheiten zu Shop-Mengeneinheiten).
aktiviert oder deaktiviert die Schnittstelle
==A Anreden==
 
[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|Liste Zuordnung]] für Personenanreden. Relevant bei Export von Benutzern und Adressen.
==Shop.Sachbearbeiter==
==D Lieferstatus Einstellungen==
Name der Shop-Datenbank
Hier erfolgen zwar keine Verknüpfungen mit Stammdaten von OBS, jedoch ermöglicht dieser Menüpunkt Einstellungen für den Artikelexport vorzunehmen, die Auswirkungen auf den hinterlegten Lieferstatus, Export des Bestands und die Anzeige eines Artikels (aktiv/inaktiv) haben.<br />
 
Einstellungsmöglichkeiten in Eingabemaske:
==Shop.Lagerlieferant.1==
{| class="wikitable"
erster Shop-Lagerlieferant ('''Pflichtfeld''')
|-
 
! Feld!! width="640px"|Erklärung
==Shop.Lagerlieferant.2==
|- valign="top"
zweiter Shop-Lagerlieferant
| Artikelbestand exportieren|| Häkchen aktiviert den Export von Bestand abhängig der [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Maske|Einstellungen im Lager]].
 
|-valign="top"
==Shop.Lagerlieferant.3==
| Artikel deaktivieren, wenn Bestand 0|| Bei gesetztem Häkchen ist die Auswirkung abhängig davon, ob in ''Artikelbestand exportieren'' ebenfalls das Häkchen gesetzt ist. Ist dies der Fall und die Bestandsermittlung kommt auf einen Bestand von 0, so wird ein Artikel automatisch als ''inaktiv'' exportiert.{{Achtung|Die Einstellungen im OBS-Artikelstamm werden hierbei nicht geändert. Sollte der Artikel später wieder einen Bestand haben, so wird der Artikel auch wieder im Shop aktiviert.}}
dritter Shop-Lagerlieferant
|-valign="top"
 
| Lieferstatus bei Bestand 0|| Ändert den Lieferstatus bei aktivem Bestandsexport und einem ermittelten Bestand von 0 autamatisch auf den hier zugeorndeten Status, wenn der Artikel exportiert wird.
==Shop.Lagerlieferant.4==
|}
vierter Shop-Lagerlieferant
 
==Shop.Lagerlieferant.5==
fünfter Shop-Lagerlieferant
 
==Datenbank.Host==
Datenbankserver Adresse
 
==Datenbank.Login.Benutzer==
Datenbankserver Benutzer
 
==Datenbank.Login.Passwort==
Passwort für Datenbankzugang
 
==Datenbank.Datenbankname==
Name der Shop-Datenbank
 
==FTP.Host==
FTP-Server Adresse
 
==FTP.Login.Benutzer==
FTP-Server Benutzer
 
==FTP.Login.Passwort==
FTP-Server Passwort
==FTP.Mode.Passiv==
Modus der Übertragung. Standardmäßig ist der Modus "aktiv" (N).
 
==FTP.Verzeichnis.IN==
FTP-Server Verzeichnis für Übertragung
 
==FTP.Verzeichnis.OUT==
FTP-Server Verzeichnis für Abholung
 
==Bild.FTP.Host==
FTP-Server Bilder Adresse
 
==Bild.FTP.Login.Benutzer==
FTP-Server Bilder Benutzer
 
==Bild.FTP.Login.Passwort==
FTP-Server Bilder Passwort
==Bild.FTP.Mode.Passiv==
Modus der Übertragung. Standardmäßig ist der Modus "aktiv" (N).
 
==Bild.FTP.Verzeichnis.IN==
FTP-Server Bilder Verzeichnis für Übertragung
 
==Bild.FTP.Verzeichnis.OUT==
FTP-Server Bilder Verzeichnis für Abholung
 
==Import.Personen.Anlage==
Shop darf Personen anlegen
 
==Import.Personen.Nummernkreis==
Personennummer beginnend mit
 
==Import.Projektnummer==
Vorbelegung der Projektnummer bei Shopaufträgen
 
==Import.Adresse.Versand==
Versandanschrift übernehmen, wenn abweichend. Für den Adress-Vergleich ist [[#Import.Adresse.Versand.Check|Import.Adresse.Versand.Check]] bei Bedarf anzupassen.
==Import.Adresse.Versand.Check==
Legt fest, mit welcher Adresse die Versandadresse der Shop-Bestellung verglichen wird.<br />
0=BUYER_PARTY aus Datei<br />
1=Auftraggeber
 
==Import.AU.Materialanlage==
Für Shopaufträge Material automatisch anlegen?
==Import.AU.Person.Sachbearb==
Übernahme des Sachbearbeiters aus der Person als Sachbearbeiter des Auftrags. Ist noch keine Person vorhanden oder der Sachbearbeiter leer, so wird der Standard-Sachbearbeiter der Shop-Schnittstelle verwendet.
==Import.AU.Pos.NeueNummmern==
Der Import übernimmt den Wert des Elements ''LINE_ITEM_ID'' als Positionsnummer. Ist diese Einstellung aktiv (''J''), dann werden die Positionen beim Auftragsimport neu durchnummeriert. Andernfalls bleiben die Positionsnummern der Datei erhalten.
 
==Import.AU.PrioShopLieferant==
Im Standard ist diese Option deaktiviert (N). Es wird dann bei Erstellung der Auftragspositionen und des Materials immer der erste Lieferant eines Artikels gezogen. Wird dies auf J gestellt, werden beim importieren der Bestellungen die Lieferanten aus [[#Shop.Lagerlieferant.1|Shop.Lagerlieferant.1]] bis [[#Shop.Lagerlieferant.5|Shop.Lagerlieferant.5]] beim anlegen der Position und des Materials priorisiert behandelt. Wurde ein Artikel nicht über den Lieferanten gefunden, so wird wieder der erste Lieferant des Artikels gezogen.
 
==Import.Info.EMail==
Erstellt eine E-Mail als Information, dass ein Auftrag importiert wurde. Die E-Mail wird nur auf das Standardkonto von Benutzern erstellt, die "Meldung bei Internetbestellungen (Shop)" in Ihren [[OBS/System/F9_Layout|Einstellungen]] aktiviert haben.
 
==Import.Kostenstelle.Suche.BezeichnungVoll==
Wenn aktiv ("J"), dann wird die volle Bezeichnung der Kostenstelle mit der Referenz der Datei verglichen, um die richtige Kostenstelle zu identifizieren. Die Standardsuche bezieht nur die ersten 6 Zeichen der Referenz mit ein, da diese auch mit der OBS-Kostenstellennummer gefüllt sein kann.
 
==Standard.Personen.Preisgruppe==
Personenanlage in Preisgruppe
 
==Standard.Zahlungsbedingung==
Standardzahlungsbedingung für Shopaufträge
 
==Bestellvorlage.Basis==
Bestellvorlage Standard-Datenbasis. 1=Auftrag 2=Rechnung
 
==Bestellvorlage.Anzahl==
maximale Anzahl an Artikeln pro generierter Bestellvorlage
 
==Bestellvorlage.DatumAb==
Datum, ab welchem Vorgänge für Selektion von Artikeln einbezogen werden
 
==Bestellvorlage.Sortierung==
Sortierung für Bestellvorlage. 1=Pickhäufigkeit 2=Artikelnummer
 
==Export.Person.E-Mail-Login==
E-Mail-Adresse als Login verwenden
 
==Export.Artikel.Preis.Auswert==
Artikelauswertung für VK1 Aktualisierung. Bei der Aktualisierung von Preisen wird der VK1 auch direkt im Shopartikel gesetzt.
 
==Export.Person.Gruppenpreise==
Gruppenpreise
==Export.Preise.perFTP==
Die Übertragung der Gesamtdaten erfolgt bei Verwendung des Preislisten-Moduls per FTP. OBS überträgt dabei insgesamt 4 Dateien in einer ZIP-Datei an Büroring. Die Übernahme der Daten erfolgt morgens bis 7:50.
 
==Positionserfassung.Starten==
Aufrufen der Positionserfassung bei Shop-Aufträgen aus der Liste FTP-Eingang
 
==Prioritaet.Artikel==
OBS hat Artikelpriorität. Das heißt, dass bei der Aktualisierung nicht nur der Preis geändert wird. Folgende Daten werden dann gesetzt:
*Name
*Kurzbeschreibung
*Beschreibung
*Suchbegriffe
*EAN
*Mengeneinheit
*Packungseinheit
*Artikelgruppe (Shop-Warengruppe)
*Hersteller


==Prioritaet.Preis==
==E Einheiten==
Mögliche Werte sind "J" und "N" für Ja und Nein. Bei Ja hat der Shop die Preispriorität. Das heißt es werden die Preise aus der Bestellung in den Auftrag übernommen. Steht diese Einstellung auf Nein so führt OBS für jede Position die [[OBS/Preislisten/FAQ_Preislisten#Wie_funktioniert_die_Preisfindung.3F|Bestpreisfindung]] mit Shop-Preislisten durch.
[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Einheiten|Liste Zuordnung]] für Mengeneinheiten. Relevant beim Export eigener Artikel für die Basis-Mengeneinheit und Grundpreisangabe.
==L Lager und Lagerlieferanten==
Die [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|Einstellung der Lager und Zuordnung]] der Partner zu OBS-Lieferanten ist relevant für den Export von Preisen und eigenen Artikeln. Da im brShop24 eine eindeutige Identifikation eines Artikels über die Kombination Lager und Artikelnummer erfolgt, benötigt OBS beide Angaben im Export.
==S Spediteure/Paketdienstleister==
Zuordnung der Paket- bzw. Versanddienstleister aus Ihrem Shop zu [[OBS/Kostenfreie_Module/Zusatzkosten#Versand|OBS-Versandarten]]. Dies ist relevant für die Übernahme des gewählten Dienstleisters zur entsprechenden Versandart. Der Dienstleister wird seit August 2023 von Büroring in der OpenTRANS-Datei mitgeliefert.
==T Artikeltausch==
Der [[Kostenpflichtige_Module/Internet-Shop/Zusatz/Artikeltausch|Artikelaustausch]] bitete Ihnen die Möglichkeit in den Auftragsimport einzugreifen. Bestimmte Pauschalen können mit Dummy-Artikelnummer in der Auftragsdatei stehen. Damit die Artikel korrekt identifiziert werden können, können Sie hier die OBS-Artikel zuordnen.
==U Umsatzsteuer==
Verwaltung für die Zuordnung von OBS-Steuersätzen. Diese sind relevant für den Export eigener Artikel.

Aktuelle Version vom 5. September 2023, 09:57 Uhr

Kostenpflichtige Module

Internet-Shop
Der modified ECommerce Shop
Shop-Menü
Automatische Vorgänge
modified eCommerce 2.0
Der Büroring-ShopV4
Einrichtung
Eigene Artikel
brShop24
Einstellungen und Automatiken
Funktionen
Preislisten
Preislistenverwaltung
F10 Weitere Funktionen
Automatiken Kommandos
ZUGFeRD
Factoring
UPS
DHL
IMS Professional
TAPI
SMS
Fleet Management
Mehrlager-Verwaltung
Mehrsprachen Modul
Multilanguage Modul
Einfache Produktionsnachverfolgung
DMS - Dokumenten Management System
DMS Dokumente
Tasten und Schaltflächen
F10 Weit.
E DMS Definitionen
QR Zeiterfassung
EVA Marketing Tool
Technikersteuerung
Termin-Projekte
Edifact-Schnittstelle
Backup Überwachung Email
Anlagenbuchhaltung
OBS Geo Daten
DeliSprint / DPD
Filialen
Auto-Waagen
Cashback
Moebelschnittstelle
Tourenplanung
Tourenplanung
Dokumenten Manager
DocuWare-Schnittstelle
OFML-Kalkulation
Pascom
Versicherungsschaden
Gutschriftsanzeigen
OCPP Ladestationen
Kameraverwaltung
DataInOut
REST-Schnittstelle
Beispiele
Sammelverträge


Diese Seite listet die Konfigurationsschlüssel für den Schnittstellentyp brShop24 auf. Informationen zur Liste und Einstellungen anderer Shop-Schnittstellen finden Sie hier.

Einstellungen über Schlüssel

wichtige Einstellungen für brShop24

Diese Einstellung sind wichtig, damit die Schnittstelle überhaupt funktionieren kann. Siehe dazu auch brShop24 Installation/Einrichtung

Schlüssel Erklärung Beispiel
Allgemein.Aktiv aktiviert oder deaktiviert die Schnittstelle J
Allgemein.Shop.URL Endpunkt-URL für die API https://meinshop.brshop24.de/apitest
OAuth2.ClientId Client-Id für OAuth2-Authentifizierung (API-Zugriff) 1
OAuth2.ClientSecret Client-Secret für OAuth2-Authentifizierung (API-Zugriff) 0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
OAuth2.TokenEndpoint Token-Endpoint für OAuth2-Authentifizierung (API-Zugriff) https://meinshop.brshop24.de/oauth/token

Übersicht aller Einstellungen für brShop24

Schlüssel Erklärung Beispiel
Allgemein.Aktiv aktiviert (J) oder deaktiviert (N) die Schnittstelle J
Allgemein.Debug Debugmodus für Shop aktivieren. Erweitert das Protokoll um zusätzliche Einträge und sollte nur in Problemfällen aktiviert werden.
Für Administratoren (Level 9)		 N
Allgemein.Debug.LogLevel Level für Logeinträge während des Debuggens (0 bis 5). 0=Keine 5=Alles
Für Administratoren (Level 9)		 0
Allgemein.Schnittstelle.Sachbearbeiter Shopsachbearbeiternummer als Empfänger für Nachrichten und Aufgaben aus der Shopschnittstelle 01
Allgemein.Shop.URL Endpunkt-URL für die API https://meinshop.brshop24.de/apitest
Allgemein.Standard.Personen.Preisgruppe Personenanlage in Preisgruppe
Allgemein.Standard.Zahlungsbedingung Standardzahlungsbedingung für Shopaufträge
Export.Artikel.ExportBeiSpeichern Eisntellung für das Verhalten von OBS beim Speichern eines Artikels mit Zuordnung zur Schnittstelle.
0 = Export wird beim Speichern ausgeführt (Standard)
1 = Ja/Nein Abfrage, ob Exportiert werden soll
2 = Kein Export beim Speichern		 0
Export.GraphQL.Max.batchPriceList Maximale Anzahl an Datensätzen pro Stapel. Der minimal verwendete Wert ist 100 und der maximale Wert 5000. Größere oder kleinere Werte werden automatisch auf den maximalen bzw. minimalen Wert gesetzt.
Standardwert ist 2000.		 2000
Export.Liste.Bestellvorlage.AnzahlMax maximale Anzahl an Artikeln pro generierter Bestellvorlage 100
Export.Liste.Bestellvorlage.Basis Bestellvorlage Standard-Datenbasis.
1 = Auftrag
2 = Rechnung		 2
Export.Liste.Bestellvorlage.Pos.Alternativ In Bestellvorlage Alternativ-Positionen mit einbeziehen. J
Export.Liste.Bestellvorlage.Pos.Eventual In Bestellvorlage Eventual-Positionen mit einbeziehen. J
Export.Liste.Bestellvorlage.Pos.OhneBerechnung In Bestellvorlage Positionen ohne Berechnung mit einbeziehen. J
Export.Liste.Bestellvorlage.Pos.Option In Bestellvorlage Option-Positionen mit einbeziehen. J
Export.Liste.Bestellvorlage.Pos.Optional In Bestellvorlage Optional-Positionen mit einbeziehen. J
Export.Liste.Bestellvorlage.Pos.Verbrauchsmat In Bestellvorlage Verbrauchsmaterial-Positionen mit einbeziehen. J
Export.Liste.Bestellvorlage.VK0 In Bestellvorlage Positionen mit VK<=0 einbeziehen. N
Export.Liste.Bestellvorlage.Zeitraum.Monate Anzahl der vergangenen Monate ausgehend vom aktuellen Datum aus denen Vorgänge bei der Selektion der Positionen mit einbezogen werden. Es werden minimal 3 Monate und maximal 60 Monate (5 Jahre) selektiert. 36
Export.Person.Adr.OhneZeile3 Prüfung der Adressezeile 3 beim Export von Adressen, da im Shop nur zwei von drei Zeilen eingetragen werden können. Abhängig der vorhandenen Adressefelder bezieht sich dies auf "Zusatz 2" bzw. "Zusatz".
J = Export nur wenn Adresszeile 3 leer
N = Inhalt wird ignoriert und Adresse ohne Zeile 3 im Shop angelegt		 J
Export.Preise.Preis.VK.Check Aktiviert beim Preisexport die Prüfung des Verkaufspreises. Wenn aktiviert (J), werden nur Preise mit Ertrag (VK > EK) exportiert. J
Import.Adresse.Auftraggeber.Prio Legt fest, ob die Adresse aus der Datei mit den OBS-Daten überschrieben wird (N) oder die Adresse aus der Datei beibehalten werden soll (J). J
Import.Adresse.KontaktInAdresse Kontakt wird in Adresse übernommen (Name, Zusatz1 oder Zusatz2), sofern dort Platz ist. J
Import.Adresse.Rechnung Rechnungsempfänger übernehmen. Dies benötigt eventuell die Erlaubnis Personen anlegen zu dürfen. J
Import.Adresse.Versand Versandanschrift übernehmen J
Import.Adresse.Versand.Check Legt fest, mit welcher Adresse die Versandadresse der Shop-Bestellung verglichen wird.
0 = BUYER_PARTY aus Datei
1 = Auftraggeber		 1
Import.Adresse.Versand.Prio Legt fest, ob die Adresse aus der Datei mit den OBS-Daten überschrieben wird (1) oder die Adresse aus der Datei beibehalten werden soll (2). 2
Import.AU.Adressuebernahme Adresse in Auftrag übernehmen J
Import.AU.Datei.Typ Import-Typ Auftragsdateien. Bestimmt mit welchem Import die Auftragsdaten importiert werden.
HINWEIS: Gegenwärtig stellt Büroring nur Auftragsdateien im Format OpenTRANS 1.0 zur Verfügung. Diese Einstellung sollte daher immer auf 001 stehen.
 001
Import.AU.FTPEingang.Anlegen Aktiviert die Anlage einer Info in FTP-Eingang bei Import der Bestellung. N
Import.AU.KdBemerk.Drucken Vorbelegung für die Druck-Option des Auftragstext, welcher aus der Auftragsbemerkung des Kunden genriert wird. Mit "N" wird das Häkchen in "kein Druck" automatisch beim Import gesetzt. J
Import.AU.Kostenstellen.Info Textbausteinnummer für Kostenstelleninfo als Auftragstext (Position). Für die Anlage der Info muss die Kostenstellenübernahme aktiv sein.
Import.AU.Kostenstellenuebernahme Aktiviert die Übernahme von Kostenstellen aus der Datei (COST_CATEGORY_ID). J
Import.AU.Materialanlage Automatische Anlage des Auftragsmaterials beim Import.
J = Legt das Material beim Import an
N = Es wird kein Material beim Import angelegt. Für Materialanlage muss die Positionserfassung einmal geöffnet werden		 J
Import.AU.Person.Sachbearb Übernahme des Sachbearbeiters aus der Person als Sachbearbeiter des Auftrags. Ist noch keine Person vorhanden oder der Sachbearbeiter leer, so wird der Standard-Sachbearbeiter der Shop-Schnittstelle verwendet. N
Import.AU.Pos.Bemerk.VersandLagerVerwerfen Positionsbemerkung "Versand von Lager" beim Import verwerfen. N
Import.AU.Pos.NeueNummmern Wenn aktiv ("J"), dann werden die Positionen beim Auftragsimport neu durchnummeriert. J
Import.AU.Pos.UstSatz Übernahme der Steuersätze, sofern angegeben, aus der OpenTRANS-Datei. N
Import.AU.PrioShopLieferant Beim Importieren der Bestellungen werden vorzugsweise die hinterlegten Shop-Lagerlieferanten als Lieferant für Position und Material gezogen. Andernfalls wird immer der erste Lieferant des Artikels gezogen. N
Import.AU.Standard.Filiale Standard Filiale bei Auftragsanlage. Sollte auf anderen Wegen keine Filiale gefunden werden können, wird im Auftrag diese Filiale gesetzt. Benötigt Filiallösung!
Import.AU.StempelArtikelnummer Standard Artikelnummer für Stempel-Artikel, die aus dem Shop übernommen werden
Import.Info.EMail Versendet eine E-Mail als Information, dass ein Auftrag importiert wurde. Die E-Mail wird nur an Benutzer versendet, die "Meldung bei Internetbestellungen (Shop)" aktiviert haben. N
Import.Job.AufgabeBeiFehler Aufgabe bei Fehler in Preispflege-Job für Shop-Sachbearbeiter anlegen. N
Import.Kostenstelle.BestimmtKunde Ist eine Kostenstelle im Auftrag angegeben, so wird der Kunde des Auftrags durch die kostenstelle bestimmt. Ohne Kostenstelle wird die Personennummer der Buyer-Party verwendet. N
Import.Personen.Anlage Shop darf Personen bei Auftragsimport anlegen (J = Anlage erlaubt). Ist eine Person ohne Kundennummer oder die Nummer kann im Personenstamm nicht gefunden werden, wird aufgrund dieser Einstellung entweder ein Datensatz im Personenstamm angelegt oder die Standardkundennummer verwendet. J
Import.Personen.Nummernkreis Anlage der Personen (Import.Personen.Anlage) in angegebenen Nummernkreis. Erlaubt ist 1 oder 9 als erste Ziffern. Je nach Länge können aber auch weitere Vorgaben gemacht werden (z. N. 158 bei Standardlänge 6 generiert Personennummern von 158000 bis 158999 für die Anlage).
Import.Projektnummer Vorbelegung der Projektnummer bei Shopaufträgen
OAuth2.ClientId Client-Id für OAuth2-Authentifizierung (API-Zugriff) 1
OAuth2.ClientSecret Client-Secret für OAuth2-Authentifizierung (API-Zugriff) 0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
OAuth2.TokenEndpoint Token-Endpoint für OAuth2-Authentifizierung (API-Zugriff) https://meinshop.brshop24.de/oauth/token
Positionserfassung.Starten Aufrufen der Positionserfassung bei Shop-Aufträgen aus der Liste FTP-Eingang N

Zuordnungen

Manche Definitionen sind im Adminbereich des Shops zu machen, werden jedoch für die Kommunikation mit der API für die Anlage oder Änderung von Datensätzen benötigt. In der Einstellungsliste finden Sie daher die Schaltfläche F8 Zuord. Über diese gelangen Sie zu den relevanten Zuordnungen und Einstellungen für bestimmte Werte im Datenexport (z. B. Verknüpfung OBS-Mengeneinheiten zu Shop-Mengeneinheiten).

A Anreden

Liste Zuordnung für Personenanreden. Relevant bei Export von Benutzern und Adressen.

D Lieferstatus Einstellungen

Hier erfolgen zwar keine Verknüpfungen mit Stammdaten von OBS, jedoch ermöglicht dieser Menüpunkt Einstellungen für den Artikelexport vorzunehmen, die Auswirkungen auf den hinterlegten Lieferstatus, Export des Bestands und die Anzeige eines Artikels (aktiv/inaktiv) haben.
Einstellungsmöglichkeiten in Eingabemaske:

Feld Erklärung
Artikelbestand exportieren Häkchen aktiviert den Export von Bestand abhängig der Einstellungen im Lager.
Artikel deaktivieren, wenn Bestand 0 Bei gesetztem Häkchen ist die Auswirkung abhängig davon, ob in Artikelbestand exportieren ebenfalls das Häkchen gesetzt ist. Ist dies der Fall und die Bestandsermittlung kommt auf einen Bestand von 0, so wird ein Artikel automatisch als inaktiv exportiert.
ACHTUNG: Die Einstellungen im OBS-Artikelstamm werden hierbei nicht geändert. Sollte der Artikel später wieder einen Bestand haben, so wird der Artikel auch wieder im Shop aktiviert.
Lieferstatus bei Bestand 0 Ändert den Lieferstatus bei aktivem Bestandsexport und einem ermittelten Bestand von 0 autamatisch auf den hier zugeorndeten Status, wenn der Artikel exportiert wird.

E Einheiten

Liste Zuordnung für Mengeneinheiten. Relevant beim Export eigener Artikel für die Basis-Mengeneinheit und Grundpreisangabe.

L Lager und Lagerlieferanten

Die Einstellung der Lager und Zuordnung der Partner zu OBS-Lieferanten ist relevant für den Export von Preisen und eigenen Artikeln. Da im brShop24 eine eindeutige Identifikation eines Artikels über die Kombination Lager und Artikelnummer erfolgt, benötigt OBS beide Angaben im Export.

S Spediteure/Paketdienstleister

Zuordnung der Paket- bzw. Versanddienstleister aus Ihrem Shop zu OBS-Versandarten. Dies ist relevant für die Übernahme des gewählten Dienstleisters zur entsprechenden Versandart. Der Dienstleister wird seit August 2023 von Büroring in der OpenTRANS-Datei mitgeliefert.

T Artikeltausch

Der Artikelaustausch bitete Ihnen die Möglichkeit in den Auftragsimport einzugreifen. Bestimmte Pauschalen können mit Dummy-Artikelnummer in der Auftragsdatei stehen. Damit die Artikel korrekt identifiziert werden können, können Sie hier die OBS-Artikel zuordnen.

U Umsatzsteuer

Verwaltung für die Zuordnung von OBS-Steuersätzen. Diese sind relevant für den Export eigener Artikel.

Abgerufen von „http:///index.php?title=Kostenpflichtige_Module/Internet-Shop/brShop24/Konfiguration&oldid=62503“