Version vom 21. Oktober 2020, 10:09 Uhr

ACHTUNG: Die Schnittstelle befindet sich derzeit noch in der Entwicklung! Das Wiki orientiert sich am aktuellen Entwicklungsstand. Die Schnittstelle kann zwar im OBS aktiviert werden, ist jedoch noch nicht für den Live-Betrieb gedacht. Wer die Schnittstelle dennoch für den Live-Betrieb verwenden möchte, kann sich an den Support für eine Freischaltung wenden. Bitte beachten Sie jedoch, dass wir den Schnittstelle vor der offiziellen Freigabe nicht supporten werden. Eine Verwendung erfolgt auf eigene Gefahr. Siehe dazu auch Bekannte Probleme unter Funktionsumfang.

Der brShop24 wird von der Genossenschaft Büroring eG entwickelt und angeboten. Diese ECommerce-Lösung soll langfristig den bisher angebotenen VShop 4 Pro ablösen. Für die Anbindung an den brShop24 steht Ihnen eine Schnittstelle basierend auf GraphQL zur Verfügung. Aktuell ist geplant die Übertragung von Personen und Preislisten ab Anfang März 2020 und Artikel ab Anfang April 2020 zu unterstützen.

ACHTUNG: Für die Preisübertragung wird das kostenpflichtige Modul Preislisten vorausgesetzt!

ACHTUNG: Die Schnittstellen für VShop 4 Pro und brShop24 sind nicht kompatibel! Laut Büroring wird kein paralleler Betrieb von VShop 4 Pro und brShop24 möglich sein. Sollten Sie sich also für eine Umstellung Ihres VShop 4 Pro auf den das neue System brShop24 entscheiden, so muss dies im OBS ebenfalls umgestellt werden!

Funktionsumfang

ACHTUNG: Die hier aufgeführten Funktionen sind unter Vorbehalt in der aktuellen Version von OBS enthalten, da sich die Funktionalitäten in API und OBS noch ändern können.

Diese Schnittstelle unterstützt den Im- und Export von Daten wie folgt:

Import	Export
Auftragsimport (OpenTRANS 1.0)	Personen/Ansprechpartner
Depot/Partner	Preislisten

HINWEIS: Zu Beginn wird es nur Bestelldateien im Format OpenTRANS 1.0 geben. Das neuere Format 2.1 ist aber bereits eingeplant und soll zu einem späteren Zeitpunkt folgen.

Bekannte Probleme

HINWEIS: Die hier aufgeführten Probleme sollen einen Überblick zum Stand einzelner Funktionen geben, sollten Sie sich dazu entscheiden mit der Schnittstelle zu arbeiten.

Import Bestellungen

eindeutige Identifikation von Artikeln

Nach aktuellem Stand wird nur der aktuelle Katalog von Büroring eingespielt. sollten jedoch auch von anderen Lieferanten Artikel im Shop verkauft werden, kann es bei den Artikelnummern zu "doppelten" Artikeln kommen. Derzeit fehlt noch die Möglichkeit dies beim Import unterscheiden zu können.

Export Personen

Updates nicht funktionsfähig

OBS unterstützt die Aktualisierung von Kunden- und Personendaten bisher nicht

Kundentypen

In OBS lässt sich bisher kein Typ (B2B/B2C) für einen Kunden einstellen.

Menü

B Preislisten verwalten

Öffnet die Preislistenverwaltung der Schnittstelle.

X Konfiguration

Öffnet die Konfiguration der Schnittstellen. Hier können die Einstellungen der Schnittstelle angepasst werden.

HINWEIS: Um Anpassungen vorzunehmen wird für die meisten Einstellungen ein Level von 3 oder 5 benötigt. Es ist möglich dieses Level anzupassen, auch kann ein Benutzer für die Schnittstelle ein abweichendes Benutzerlevel erhalten. Melden Sie sich bei Bedarf per OBS Ticketsystem beim OBS-Support.

Y Testumgebung

Öffnet eine Testumgebung, um die Anbindung zu testen.

Z Protokoll

Über den Menüpunkt Z Protokoll des Shops-Menüs erhalten Sie Zugriff auf das Shop-Protokoll. Es werden vorrangig Hinweise zu Fehlern oder Problemen bei Im- und Exporten protokolliert. Über die Konfiguration kann mit Aktivierung des Debugmodus (Schlüssel Shop.Debug) eine erweiterte Protokollierung aktiviert werden. Dafür benötigt ein Benutzer jedoch Administrationsrechte (Level 9) für die Schnittstelle.

Erklärungen/Funktionen

Installation/Einrichtung

Eine neue Schnittstelle muss vom Support freigegeben werden. Fragen Sie dies am besten per OBS Ticketsystem an.

HINWEIS: Die vollständige Einrichtung kann ebenfalls vom Support übernommen werden. Dies wird dann jedoch nach Aufwand berechnet (in der Regel zwischen 15 und 30 Minuten). Teilen Sie uns dazu die Daten für die Anbindung (siehe unten) und die gewünschten Automatiken mit.

Kommunikation mit dem Shop

Die Anbindung erfolgt über GraphQL. Um mit Ihrem Shop kommunizieren zu können, benötigen Sie die URL zu Ihrem Shop und folgende OAuth2-Zugangsdaten:

Access Token URL
Client ID
Client Secret

Tragen Sie die Daten in den Einstellungen der Schnittstelle ein. Zu den Schnittstellen gelanden Sie über das Menü Stammdaten. Wählen sie dort unter I Schnittstellen den Punkt I Internet-Shop. Gehe Sie auf die Schnittstelle und drücken F10 um das Shop-Menü zu öffnen. Die Einstellungen rufen Sie mit X Konfiguration auf. Die Daten müssen in folgende Einstellungen eingetragen werden:

Shop.URL: Ihre Shop-URL (z. B. https://meinshop.brshop24.de)
OAuth2.ClientId
OAuth2.ClientSecret
OAuth2.TokenEndpoint (z. B. https://oauth.brshop24.de/token)

HINWEIS: Mit der Einstellung Shop.Aktiv lässt sich eine Schnittstelle deaktivieren. Falls die Daten für die Kommunkation richtig sind, prüfen Sie, ob diese Einstellung auf "J" (aktiv; "N" für inaktiv) steht.

Abholung und Import Aufträge

Die Aufträge generiert OBS aus XML-Dateien im OpenTRANS-Format. Die Dateien können vom Büroring per FTP oder E-Mail bereitgestellt werden. Abhängig von der gewählten Methode muss im OBS entweder die automatische Abholung vom FTP oder das E-Mail-Konto eingerichtet sein. Ist dies nicht der Fall, werden ebenfalls die entsprechenden Zugangsdaten benötigt. Die Dateien sind in der Verzeichnisstruktur von OBS unter ..\data\shop\<Schnittstelle-Nr.>\xml zu speichern.

Abholung

Abholung per FTP

Für die Einrichtung benötigen Sie mindestens die Host-URL oder IP des FTP-Servers sowie Benutzername und Passwort. Wie Sie einen FTP-Job einrichten erfahren Sie auf unserer Wiki-Seite FTP Jobliste.

Abholung per E-Mail

Für den Empfang von Dateien per E-Mail muss das Konto im OBs eingerichtet sein und eine Filter-Regel für das Speichern des Anhangs in einem Verzeichnis ("Anhang speichern unter") eingerichtet werden.

Import

Nutzen Sie dazu unsere Hilfe-Seite für Shop-Automatiken. Der Import von Bestellungen erfolgt mit ShopGetBestellungen.

weitere Automatiken

Eine Übersicht aller verfügbaren Automatiken finden Sie auf der entsrepchenden Hilfe-Seite für Shop-Automatiken.

HINWEIS: Achten Sie darauf, dass brShop24 in der Angabe Verfügbar in enthalten ist!

Die Einrichtung der automatischen Preispflege wird empfohlen, wenn Sie ebenfalls die automatische Artikelpflege nutzen und Preise sich täglich ändern können.

Zuordnungen

Für manche Funktionen der Schnittstelle werden zusätzliche Zuordnungen für bestimmte Daten benötigt. Die Zuordnung finden Sie in der Konfiguration unter F8. Folgende Punkte finden Sie derzeit dort:

L Lager und Lagerlieferanten

Die Einstellungen für "Depot" und "Partner" werden für den Export von Preisen und Artikel benötigt.

Häufig gestellte Fragen (FAQ)

Allgemein

Können im OBS brShop24 und VShop4 parallel betrieben werden?

Ja, es ist mögliche beide Shops im OBS zu verwalten. OBS ist in der Lage mehrere Schnittstellen, auch des gleichen Typs, zu verwalten. Die Schnittstellen arbeiten unabhängig voneinander. Nach aktuellem Stand plant Büroring jedoch einen VShop 4 vollständig zu migieren, so dass der brShop24 dann Ihren VShop 4 ersetzt. Ob hier ein Parallelbetrieb auf Seiten Bürorings möglich ist, müssten Sie mit dem Büroring klären.

Preise/Preislisten

Warum wird eine Preisliste wird nicht in den Shop übertragen?

Bitte beachten Sie hier die Voraussetzungen für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel nicht übertragen werden, soltle der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten Depots ab. Stellen Sie also sicher, dass die Depots entsprechdn gepflegt sind.

@@ Zeile 100: / Zeile 100: @@
 *[[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner|L Lager und Lagerlieferanten]]
 :Die Einstellungen für "Depot" und "Partner" werden für den Export von Preisen und Artikel benötigt.
+=Häufig gestellte Fragen (FAQ)=
+==Allgemein==
+{{Vorlage:KlapptextFAQ
+|faq_brshop24_allg_parallelbetrieb
+|Können im OBS brShop24 und VShop4 parallel betrieben werden?
+|Ja, es ist mögliche beide Shops im OBS zu verwalten. OBS ist in der Lage mehrere Schnittstellen, auch des gleichen Typs, zu verwalten. Die Schnittstellen arbeiten unabhängig voneinander. Nach aktuellem Stand plant Büroring jedoch einen VShop 4 vollständig zu migieren, so dass der brShop24 dann Ihren VShop 4 ersetzt. Ob hier ein Parallelbetrieb auf Seiten Bürorings möglich ist, müssten Sie mit dem Büroring klären.
+}}
+==Preise/Preislisten==
+{{Vorlage:KlapptextFAQ
+|faq_brshop24_pl_keineuebertragung
+|Warum wird eine Preisliste wird nicht in den Shop übertragen?
+|Bitte beachten Sie hier die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Voraussetzungen|Voraussetzungen]] für die Übertragung von Preislisten. Der Knackpunkt bei der Übertragung von Preislisten ist der Abgleich der Artikel. Um den Datenverkehr möglichst gering zu halten, versucht OBS nur die benötigten Daten zu übertragen. Das bedeutet, dass Artikelpreise für Artikel  nicht übertragen werden, soltle der Artikel gar nicht im Shop vorkommen. Ein Abgleich aller Artikel mit dem Shop würde jedoch zu viel Zeit in Anspruch nehmen. Daher gleicht OBS die Daten über die in der Schnittstelle gepflegten [[Kostenpflichtige_Module/Internet-Shop/Konfiguration/Zuordnungen/DepotPartner#Depots.2FLager_in_Schnittstelle_brShop24|Depots]] ab. Stellen Sie also sicher, dass die Depots entsprechdn gepflegt sind.
+}}

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

Version vom 21. Oktober 2020, 10:09 Uhr

Inhaltsverzeichnis

Funktionsumfang

Bekannte Probleme

Import Bestellungen

Export Personen

Menü

Erklärungen/Funktionen

Installation/Einrichtung

Kommunikation mit dem Shop

Abholung und Import Aufträge

Abholung

Import

weitere Automatiken

Zuordnungen

Häufig gestellte Fragen (FAQ)

Allgemein

Preise/Preislisten

Navigationsmenü

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

Version vom 21. Oktober 2020, 10:09 Uhr

Funktionsumfang

Bekannte Probleme

Import Bestellungen

Export Personen

Menü

Erklärungen/Funktionen

Installation/Einrichtung

Kommunikation mit dem Shop

Abholung und Import Aufträge

Abholung

Import

weitere Automatiken

Zuordnungen

Häufig gestellte Fragen (FAQ)

Allgemein

Preise/Preislisten

Navigationsmenü

Suche