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

Aus OBS Wiki
Zur Navigation springen Zur Suche springen
 
(4 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 brShop24 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 brShop24=
=Einstellungen über Schlüssel=
==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]]
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"
Zeile 18: Zeile 19:
|}
|}


=Übersicht Einstellungen brShop24=
==Übersicht aller Einstellungen für brShop24==
==Allgemein.Aktiv==
{| class="wikitable"
aktiviert oder deaktiviert die Schnittstelle
|-
==Allgemein.Debug==
! Schlüssel!! Erklärung!! Beispiel
Debugmodus für Shop aktivieren. Erweitert das Protokoll um zusätzliche Einträge und sollte nur in Problemfällen aktiviert werden.
|-valign="top"
'''Für Administratoren (Level 9)'''<br />
| Allgemein.Aktiv|| aktiviert (J) oder deaktiviert (N) die Schnittstelle|| J
==Allgemein.Debug.LogLevel==
|-valign="top"
Level für Logeinträge während des Debuggens (0 bis 5). 0=Keine 5=Alles
| 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
'''Für Administratoren (Level 9)'''<br />
|-valign="top"
==Allgemein.Schnittstelle.Sachbearbeiter==
| 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
Shopsachbearbeiter als Empfänger für Nachrichten und Aufgaben aus der Shopschnittstelle
|-valign="top"
==Allgemein.Shop.URL==
| Allgemein.Schnittstelle.Sachbearbeiter|| Shopsachbearbeiternummer als Empfänger für Nachrichten und Aufgaben aus der Shopschnittstelle|| 01
Endpunkt-URL für die API.<br />
|-valign="top"
Beispiel: https://meinshop.brshop24.de/apitest
| Allgemein.Shop.URL|| Endpunkt-URL für die API|| <nowiki>https://meinshop.brshop24.de/apitest</nowiki>
==Allgemein.Standard.Personen.Preisgruppe==
|-valign="top"
Personenanlage in Preisgruppe
| Allgemein.Standard.Personen.Preisgruppe|| Personenanlage in Preisgruppe||
==Allgemein.Standard.Zahlungsbedingung==
|-valign="top"
Standardzahlungsbedingung für Shopaufträge
| Allgemein.Standard.Zahlungsbedingung|| Standardzahlungsbedingung für Shopaufträge||
==Export.GraphQL.Max.batchPriceList==
|-valign="top"
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.
| 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
==Export.Liste.Bestellvorlage.AnzahlMax==
|-valign="top"
maximale Anzahl an Artikeln pro generierter Bestellvorlage
| 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
==Export.Liste.Bestellvorlage.Basis==
|-valign="top"
Bestellvorlage Standard-Datenbasis. 1=Auftrag 2=Rechnung
| Export.Liste.Bestellvorlage.AnzahlMax|| maximale Anzahl an Artikeln pro generierter Bestellvorlage|| 100
==Export.Liste.Bestellvorlage.Zeitraum.Monate==
|-valign="top"
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.
| Export.Liste.Bestellvorlage.Basis|| Bestellvorlage Standard-Datenbasis.<br />1 = Auftrag<br />2 = Rechnung|| 2
==Export.Person.Adr.OhneZeile3==
|-valign="top"
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 />
| Export.Liste.Bestellvorlage.Pos.Alternativ|| In Bestellvorlage Alternativ-Positionen mit einbeziehen.|| J
J = Export nur wenn Adresszeile 3 leer<br />
|-valign="top"
N = Inhalt wird ignoriert und Adresse ohne Zeile 3 im Shop angelegt
| Export.Liste.Bestellvorlage.Pos.Eventual|| In Bestellvorlage Eventual-Positionen mit einbeziehen.|| J
==Import.Adresse.Auftraggeber.Prio==
|-valign="top"
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).
| Export.Liste.Bestellvorlage.Pos.OhneBerechnung|| In Bestellvorlage Positionen ohne Berechnung mit einbeziehen.|| J
==Import.Adresse.KontaktInAdresse==
|-valign="top"
Kontakt wird in Adresse übernommen (Name, Zusatz1 oder Zusatz2), sofern dort Platz ist.
| Export.Liste.Bestellvorlage.Pos.Option|| In Bestellvorlage Option-Positionen mit einbeziehen.|| J
==Import.Adresse.Rechnung==
|-valign="top"
Rechnungsempfänger übernehmen. Dies benötigt eventuell die Erlaubnis Personen anlegen zu dürfen.
| Export.Liste.Bestellvorlage.Pos.Optional|| In Bestellvorlage Optional-Positionen mit einbeziehen.|| J
==Import.Adresse.Versand==
|-valign="top"
Versandanschrift übernehmen
| Export.Liste.Bestellvorlage.Pos.Verbrauchsmat|| In Bestellvorlage Verbrauchsmaterial-Positionen mit einbeziehen.|| J
==Import.Adresse.Versand.Check==
|-valign="top"
Legt fest, mit welcher Adresse die Versandadresse der Shop-Bestellung verglichen wird. 0=BUYER_PARTY aus Datei 1=Auftraggeber
| Export.Liste.Bestellvorlage.VK0|| In Bestellvorlage Positionen mit VK<=0 einbeziehen.|| N
==Import.Adresse.Versand.Prio==
|-valign="top"
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).
| 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
==Import.AU.Adressuebernahme==
|-valign="top"
Adresse in Auftrag übernehmen
| 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
==Import.AU.Datei.Typ==
|-valign="top"
Import Typ Auftragsdateien. Bestimmt mit welchem Import die Auftragsdaten importiert werden.
| 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.AU.FTPEingang.Anlegen==
|-valign="top"
Aktiviert die Anlage einer Info in FTP-Eingang bei Import der Bestellung.
| 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.AU.Kostenstellenuebernahme==
|-valign="top"
Aktiviert die Übernahme von Kostenstellen aus der Datei (COST_CATEGORY_ID).
| Import.Adresse.KontaktInAdresse|| Kontakt wird in Adresse übernommen (Name, Zusatz1 oder Zusatz2), sofern dort Platz ist.|| J
==Import.AU.Kostenstellen.Info==
|-valign="top"
Textbaustein für Kostenstelleninfo als Auftragstext (Position). Für die Anlage der Info muss die Kostenstellenübernahme aktiv sein.<br />
| Import.Adresse.Rechnung|| Rechnungsempfänger übernehmen. Dies benötigt eventuell die Erlaubnis Personen anlegen zu dürfen.|| J
Platzhalter für den Textbaustein siehe [[OBS/Häufig_gestellte_Fragen/Wie_funktionieren_Platzhalter#Auftragsimport_OpenTRANS|Wie funktionieren Platzhalter: Auftragsimport OpenTRANS]].
|-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
|}
 
=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 {{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).
==A Anreden==
[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Anreden#brShop24|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.<br />
Einstellungsmöglichkeiten in Eingabemaske:
{| class="wikitable"
|-
! Feld!! width="640px"|Erklärung
|- valign="top"
| 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"
| 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.}}
|-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.
|}


==Import.AU.Materialanlage==
==E Einheiten==
Für Shopaufträge Material automatisch anlegen?
[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/Einheiten|Liste Zuordnung]] für Mengeneinheiten. Relevant beim Export eigener Artikel für die Basis-Mengeneinheit und Grundpreisangabe.
==Import.AU.Person.Sachbearb==
==L Lager und Lagerlieferanten==
Ü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.
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.
==Import.AU.Pos.NeueNummmern==
==S Spediteure/Paketdienstleister==
Wenn aktiv ("J"), dann werden die Positionen beim Auftragsimport neu durchnummeriert.
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.
==Import.AU.Pos.UstSatz==
==T Artikeltausch==
Übernahme der Steuersätze, sofern angegeben, aus der OpenTRANS-Datei.
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.
==Import.AU.PrioShopLieferant==
==U Umsatzsteuer==
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.
Verwaltung für die Zuordnung von OBS-Steuersätzen. Diese sind relevant für den Export eigener Artikel.
==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.
==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.
==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.
==Import.Personen.Anlage==
Shop darf Personen anlegen
==Import.Personen.Nummernkreis==
Wenn Personenanlage erlaubt, wird die Personennummer beginnend mit 1 oder 9 generiert. Der Nummernkreis kann hier vorgegeben werden. Der Nummernkreis kann auch entsprechend weiter eingeschränkt werden z. B. 123 (123001 bis 123999 bei 6-stelligen Personennummern).
==Import.Projektnummer==
Vorbelegung der Projektnummer bei Shopaufträgen
==OAuth2.ClientId==
OAuth2 Client-Id
==OAuth2.ClientSecret==
OAuth2 Client-Secret
==OAuth2.TokenEndpoint==
OAuth2 Token-URL
==Positionserfassung.Starten==
Aufrufen der Positionserfassung bei Shop-Aufträgen aus der Liste FTP-Eingang

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
OBS-Waage
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“