Kostenpflichtige Module/Internet-Shop/brShop24/Konfiguration
- A Preise aktualisieren
- C Personen übertragen
- E Kategorien verwalten
- G Kataloge verwalten
- I Merkliste übertragen
- K Varianten übertragen
- L Artikelvarianten übertragen
- M Referenzarten übertragen
- N Lagerbestände verwalten
- U Bestellungen einlesen
- V leere Passworte füllen
- W Update-Informationen zurücksetzen
- X Konfiguration
- Z Protokoll
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.