Kostenpflichtige Module/Internet-Shop/brShop24
- 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
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.
Siehe auch die Punkte Umstellung/Migration VShop 4 und FAQ Parallelbetrieb.
Funktionsumfang
Diese Schnittstelle unterstützt den Im- und Export von Daten wie folgt:
Import | Export |
---|---|
Auftragsimport (OpenTRANS 1.0) | Preislisten |
Depots + Partner | Kundengruppen |
Anreden | Ansprechpartner (Benutzer und Personen) |
Kundentypen | Kostenstellen |
Kundenqualifikation | Adressen (Personenstamm) |
Job-Informationen (Ergebnis/Protokoll Preispflege) | Shopping-Listen (Meistgekaufte Artikel/Top-Artikel) |
Kundengruppen (Migration) | |
Benutzer (Migration) | |
Kostenstellen (Migration) |
Vergleich zur Schnittstelle VShop 4
Stand: 13.10.2021
VShop 4 | brShop24 | |
Bestellungen importieren | ja | ja |
Kundendaten abfragen | ja ("Kunde vorhanden?") | ja ("Kunde vorhanden?" und Migration) |
Kundendaten übertragen | ja | ja |
(Kunden-)Gruppe | Aus Personennummer (Hauptperson) | eigene Verwaltung |
Benutzerkonto | aus Person und Ansprechpartner | aus Ansprechpartner |
Kostenstellen | nur als Kostenstelle (mit Budget) | Kostenstelle (noch ohne Budget; fehlt im Shop bisher) und Versandadresse |
Shopping-Listen | ja | ja |
Adressen/Adressbuch | nein (nur Standardadresse im Benutzerkonto) | ja |
Anreden | nein | Import (Definition/Zuordnung) |
Kundentyp | nein | Import (Definition/Zuordnung) |
Kundenqualifikation | nein | Import (Definition/Zuordnung) |
Artikelvorlage setzen | ja | nein |
Preise übertragen | ja | ja (nur Preislisten) |
Lager | Import (Definition/Zuordnung) | Import (Definition/Zuordnung) |
Partner | Import (Definition/Zuordnung) | Import (Definition/Zuordnung) |
Warengruppen/Kategorien | Import (Definition/Zuordnung) | nein |
Artikel | ja | nein |
übertragen | ja | nein |
Abgleich (eigene Artikel) | ja | nein |
Sterne | ja | nein |
monatliche Kosten | 20 Euro | 60 Euro |
Bekannte Probleme
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.
- fehlende Kostenstellen
- In der Auftragsdatei werden nach aktuellem Stand keine Kostenstellen geliefert. Somit kann OBS diese bei der Auftragsgenerierung hinterlegen.
Die Kostenstellen werden nach Informationen von Büroring jetzt in die openTRANS-Order übernommen (Stand 25.02.2021).
- Anzeige in FTP-Eingang
- Bei aktivierter Anzeige von importierten Bestellungen im FTP-Eingang, wird bisher in der Spalte Typ nichts angezeigt.
Behoben mit Version 003663 (Info 005482).
Personendaten
- Export Kostenstellen Budgets
- Die Budgetverwaltung wurde bisher noch nicht im brShop24 umgesetzt und steht daher auch in der API noch nicht zur Verfügung.
- Anzeige Webshop-Einstellungen
- Die Anzeige des Kundenstatus funktioniert aktuell nur, wenn die Kundennummer auch in einer Kundengruppe steht.
Behoben mit Version 003591 (Info 005378).
- Übertragung Adressen
- Die Adressen werden nicht angelegt, weil der Typ mit einem ungültigen Wert an die API übergeben wird.
Behoben mit Version 003587 (Info 005365).
- Zuordnung Adressen Kundengruppe
- Adressen werden bei Übertragung auch in der Kundengruppe zugeordnet, obwohl es sich um eine System-Gruppe handelt.
Behoben mit Version 003600.
- Zuordnung Adressen Benutzer
- Im Benutzer wird eine übertragene Adresse nicht zugeordnet.
Behoben mit Version 003665 (Info 005483).
- Einfügen neuer Kundengruppen
- Die Datensätze werden im OBS nicht korrekt angelegt und können daher nicht exportiert werden.
Behoben mit Version 003594 (Infos 005375 und 005393).
- Adressen aus Kostenstellen
- Werden bisher nicht übertragen.
Behoben mit Version 003606 (Info 005398). Adressen aus Kostenstellen werden jetzt als Versandadressen hinterlegt
- Zuordnung Kostenstellen
- Kostenstellen werden bei Übertragung auch in der Kundengruppe zugeordnet, wenn es sich um eine System-Gruppe handelt.
Behoben mit Version 003600. Kostenstellen werden bei Systemgruppen nicht mehr exportiert. Benutzer erhalten einen Hinweis bei Export der Personendaten aus den Webshop-Einstellungen und werden gefragt, ob die Personedaten trotzdem exportiert werden sollen.
- Im Shop ist der Adresstyp vertauscht
- Adressen die eigentlich "Postanschrift" haben sollten, bekommen "Postfach Anschrift" und umgekehrt.
Behoben vorraussichtlich mit Version 003683 (Info 005494).
- Benutzer ist immer Admin
- Die Funktionalität über Eigenschaft 9011 wurde noch nicht übernommen aus der VShop-Schnittstelle übernommen, da sie dort problembehaftet ist.Die Fehlerhafte Übertragung in dieser Schnittstelle wurde somit vorerst vollständig entfernt.
Behoben vorraussichtlich mit Version 003735.
Preise/Preislisten
- Keine Aktualisierung für Kunden mit Kundennummer im Benutzer
- Preislisten werden nicht erkannt, wenn die Kundennummer nur im Benutzer vorkommt.
Behoben mit Version 003592 (Info 005384).
- doppelte Preislisten bei Fehler in Preislistenupdate
- Tritt in der Aktualisierung der Preislistenkopfdaten ein Fehler auf, so wird die Preisliste ein weitere Mal angelegt.
Behoben mit Version 003630 (Info 005452).
- Keine Aktualisierung der Kopfdaten
- Wurden im OBS Änderungen an den Kopfdaten (Name, Prio, Gültigkeitszeitraum) vorgenommen, konnte es passieren, dass diese nicht in den Shop übertragen wurden.
Behoben mit Version 003703 (Info 005515).
Bestellvorlagen/Shoppinglisten
- Anzeige im Shop
- Nach aktuellem Stand können die Bestellvorlagen, die es auch schon für den VShop 4 exportiert werden konnten, in den brShop24 übertragen werden. Die Anzeige im Frontend (Ansicht für den Kunden) ist jedoch noch nicht umgesetzt. Sie können aktuell nur über den Admibereich prüfen, ob die Bestellvorlagen im Shop angekommen sind.
Installation/Einrichtung
Eine neue Schnittstelle muss vom Support freigegeben werden. Fragen Sie dies am besten per OBS Ticketsystem an.
Voraussetzungen und Vorbereitung
Für bestimmte Funktionalitäten der Schnittstelle werden bestimmte Module im Shop und/oder OBS vorausgesetzt:
- Migration
- Freigabe im Shop zur Nachpflege der API-ID. Fragen Sie diesbezüglich beim Support vom Büroring nach.ACHTUNG: Ist dies nicht freigegeben, so kann OBS keine Verknüpfung zwischen den Daten herstellen. Sie könnten somit keine Aktualisierung der vorhandenen Daten vornehmen. Im schlimmsten Fall werden Daten sogar doppelt angelegt.
- Preispflege
- Die Preispflege dieser Schnittstelle arbeitet mit dem kostenpflichtigen OBS-Modul Preislisten. Wenn Sie die Übertragung eigener Preise in den Shop planen und dieses Modul noch nicht nutzen, muss dies zuerst umgestellt werden.
Für die Einrichtung der API werden im OBS die URL zum Shop und die OAuth2-Zugangsdaten für den API-Server benötigt. Die OAuth2-Zugangsdaten umfassen:
- Client ID
- Client Secret
- Access Token URL
Soweit bekannt ist, werden die Shop-Aufträge immer als OpenTRANS-Datei (Version 1.0) per FTP zur Verfügung gestellt. Sie benötigen somit ebenfalls die FTP-Zugangsdaten für die Abholung der Auftragsdateien:
- FTP-Host
- Benutzername
- Passwort
- Abholungsverzeichnis
Kommunikation mit dem Shop
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 für Sie angelegte Schnittstelle vom Typ brShop24 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:
- Allgemein.Shop.URL: Ihre Shop-URL mit API-EndpunktHINWEIS: Nach aktuellem Stand ist der API-Endpunkt immer unter "/apitest" zu erreichen. Tragen Sie also die URL zu Ihrer Shop-Hauptseite mit der Erweiterung "/apitest" in dieses Feld ein.
Beispiel: https://meinshop.brshop24.de/apitest - OAuth2.ClientId
- OAuth2.ClientSecret
- OAuth2.TokenEndpoint (z. B. https://meinshop.brshop24.de/oauth/token)
Zuordnungen
Nach der Einrichtung der Verbindung sollten Sie die Definitionen importieren (Shop-Menü).
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:
- Die Einstellungen für "Anreden" werden für den Export von Personen benötigt.
- L Lager und Lagerlieferanten (Voraussetzung für Preisexport)
- Die Einstellungen für "Depot" und "Partner" werden für den Export von Preisen und Artikel benötigt.
Automatiken
Eine Übersicht aller verfügbaren Automatiken finden Sie auf der entsprechenden Hilfe-Seite für Shop-Automatiken.
Wichtig/Muss
- Bestellungen importieren (Makro: ShopGetBestellungen)
- Dies dient zum Import für die Dateien im Format OpenTRANS-Order. Die Aufträge/Bestellungen werden mit diesen Dateien vom Büroring zum Import in die eigenen Systeme zur Verfügung gestellt. In der Regel erhalten Sie die Dateien per FTP. Für die Einrichtung der vollständigen Abholung siehe Abholung und Import Aufträge.
- Automatik für die Job-Informationen (Makro: ShopCheckExterneJobs)
- Dient zur Verarbeitung des Protokolls für die Preispflege. Da die Preise nicht direkt in die Shop-Datenbank eingefügt, sondern aus einer Aufgabenliste abgearbeitet werden, erhält OBS so den Status zu den offenen Jobs. Außerdem werden aufgetretene Probleme verarbeitet.
Empfohlen
- Preise aktualisieren (Makro: ShopSetPreise)
- Die Einrichtung der automatischen Preispflege wird empfohlen, wenn Sie ebenfalls die automatische Artikelpflege nutzen und Preise sich täglich ändern können. Sie sorgt dafür, dass die Änderungen automatisch in den Shop übertragen werden.HINWEIS: Es wird empfohlen diese Automatik erst im Anschluss an eine OBS-Migration der Preislisten einzutragen, sollten von Büroring Preisdaten aus einem früheren VShop in den brShop24 migriert worden sein.
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
- Nummer, Name und Bezeichnung können Sie frei vergeben. Tragen Sie bei Kunden-Nr die Personennummer des Lieferanten Büroring ein. Status muss auf 01 stehen, damit der Job aktiv ist.
- In Source-File tragen Sie vom Start-Verzeichnis des FTP-Login aus gesehen den Pfad zusammen mit der Maske für die Dateien ein.HINWEIS: Soweit bekannt ist, wird für den Shop der gleiche FTP-Server verwendet, der auch für den Austausch der Bestellungen und Lieferavisen verwendet wird. Sie könnten den Pfad somit auch aus dem Job für die Abholung der Lieferavisen kopieren. Damit hier keine falschen Dateien abgeholt werden, sollte in Source-File mit einem Prefix für die Dateinamen gearbeitet werden. Bisher wird den Dateien des brShop24 der Prefix order-be- gegeben.
Das Feld Destination-File muss mit dem Dateipfad des Servers zum xml-Verzeichnis der Shop-Schnittstelle gefüllt werden. Sie können hier auch die Kurzform verwenden. Beid er Abholung ergänzt OBS dann automatisch den Pfad.
Beispiel Kurzform für Schnittstelle 001 (Nummer 001 im Pfad mit der richtigen Schnittstellennummer ersetzen!): data\shop\001\xml\
Tragen Sie als Typ den Wert "BR24" ein. - Übertragungsart bleibt auf dem Standard "FTP/S". Tragen Sie in Host die Adresse des FTP-Servers und in Benutzer und Passwort Ihre Zugangsdaten ein. Die Standardwerte für Port und Passiv sollten mit "21" und "Ja" wie im Beispiel zu sehen beibehalten werden, sofern Sie keine abweichende Information erhalten haben.
- Tragen Sie das E-Mail-Konto (muss im OBS eingerichtet sein und E-Mails empfangen können) im Feld Konto ein und definieren Sie die Bedingungen für die Regel.
- Als Aktion tragen Sie "Anhang speichern unter" ein und wählen über die Schaltfläche # rechts daneben den Dateipfad zum xml-Verzeichnis der Shop-Schnittstelle aus.
Die Aktionen "Als gelesen markieren" und "Als erledigt markieren" sind optional, helfen jedoch dabei die Liste der empfangenen E-Mails übersichtlich zu halten.
Import
Nutzen Sie dazu unsere Hilfe-Seite für Shop-Automatiken. Der Import von Bestellungen erfolgt mit ShopGetBestellungen.
Mit der Schnittstelle Starten
Daten migrieren
Sofern Sie in der Vergangenheit einen VShop 4 verwendet haben und die Daten vom Büroring in den neuen brShop24 migriert wurden, empfehlen wir nach Abschluss der Einrichtung eine Datenmigration im OBS durchzuführen (siehe auch Umstellung/Migration VShop 4). Dabei werden die vom VShop 4 migrierten Kundendaten aus dem Shop ausgelesen und in OBS importiert. OBS versucht die importierten Daten anschließend mit den Stammdaten zu verknüpfen und erstellt für die Kunden die Webshop-Einstellungen und gibt die Ansprechpartner frei.
Nach den Kundengruppen und Benutzern werden die Kostenstellen eingelesen und versucht den Einträgen im OBS zuzuordnen. Der Anzeigename (Shop) einer Kostenstelle muss dabei mit der Bezeichnung der Kostenstelle übereinstimmen und innerhalb der Kundengruppe eindeutig sein.
Außerdem werden die Preislisten aus den im Shop vorhandenen Preislisten ermittelt und für die Schnittstelle freigegeben. Die Preislisten werden stattdessen nach erfolgreicher Zuordnung im Shop geleert und neu befüllt. So sind die Preisdaten auch gleich auf dem aktuellen Stand und für die spätere Aktualisierung sind die Daten im OBS entsprechend vorbereitet.
Datenhoheit
Es gibt einige spezifische Daten im Shop, die von OBS nicht angefasst werden (dürfen). Das betrifft z. B. die Standard-Kundengruppen des brShop24. Für OBS-Daten hat jedoch OBS die Datenhoheit. Im Shop können Sie dies an den verfügbaren Funktionen (Bild 1) erkennen. Die von OBS gepflegten Daten werden über die API (Bild 2) angelegt und haben bei den Funktionen statt dem Stift-Symbol (Daten bearbeiten) nur ein Auge-Symbol (Daten ansehen).
Umstellung/Migration VShop 4
Nach aktuellem Stand wird für Kunden mit VShop 4 vom Büroring eine Migration des bestehenden VShop 4 auf den neuen brShop24 durchgeführt. Dabei soll auch gewählt werden können, welche Daten bei der Migration übernommen werden. Wie dies genau aussieht, müssen Sie jedoch mit dem Büroring klären. Es gibt jedoch auch einige Punkte, die Sie bei der Migration für die Umstellung im OBS bedenken müssen.
- Neue API
- Im Unterschied zum VShop 4 läuft die Schnittstelle zum brShop24 über eine API. OBS dies bringt ein paar Einschränkungen für die migrierten Daten mit sich. Es ist OBS nicht möglich die Daten wiederzufinden, die von OBS zuvor in den VShop 4 übertragen wurden. Wie sich dies auf die Pflege von Daten auswirkt, muss noch in Erfahrung gebracht werden, da im Testsystem keine migrierten Daten zur Verfügung stehen.
- Besonderheit Preisdaten
- OBS arbeitet in Schnittstelle über eine sogenannte API-ID, also eine Identifikationsnnummer speziell für die neue API. OBS kann nur Preisdaten verändern, die auch über die API in den Shop übertragen wurden. Wir empfehlen daher die Preisdaten möglichst über OBS zu pflegen und nicht migrieren zu lassen.
- Schnittstelle im OBS
- Die Schnittstelle muss im OBS freigeschaltet und eingerichtet werden (siehe dazu Installation/Einrichtung). Dies kann bereits vor der Migration geschehen. Bedenken Sie jedoch, dass die Aufträge erst importiert werden können, nachdem die Schnittstelle eingerichtet wurde. Gebe Sie uns also rechtzeitig Bescheid, damit wir die Schnittstelle freigeben können. Die Einrichtung kann auf Wunsch von uns kostenpflichtig übernommen werden.HINWEIS: Die Freischaltung der Schnittstelle hat auch eine Anpassung des Vertrags zur Folge. Bitte beachten Sie, dass die Schnittstelle brShop24 mit 60 Euro statt 20 Euro berechnet wird.
- Modul Preislisten
- Für den brShop24 wird das Modul Preislisten für die Pflege von Preisen über die Schnittstelle vorrausgesetzt. Sollten Sie dieses Modul noch nicht nutzen, so müsste dies zuvor eingerichtet werden, wenn Sie Preise aus OBS in den Shop übertragen möchten. Die Einrichtung des Moduls kann mehrere Stunden in Anspruch nehmen. Wir empfehlen die Umstellung vor der Migration durchzuführen, da dies die Arbeitsweise mit Artikelpreisen verändert. Eine Schulung wird ebenfalls empfohlen.
- Migration Freigaben OBS VShop 4 nach brShop24 (siehe Migration)
- Über das Shop-Menü können Kundengruppen und Benutzer mit dem OBS-Personenstamm abgeglichen werden. Im Personenstamm werden dann für gefundene Datensätze Webshop-Einstelungen angelegt. Ansprechpartnern, welchen ein Benutzer eindeutig zugeordnet werden konnten, erhalten die Eigenschaft 9013 und die Zuordnung zur Schnittstelle. Sollte die eindeutige Zuordnung ohne Benutzername erfolgt sein, so wird auch der Benutzername im Ansprechpartner hinterlegt. Außerdem werden die Preislisten mit dem Shop abgeglichen, freigegeben und übertragen.HINWEIS: Es ist nicht möglich die Passwörter auszulesen. Diese können also nicht im Ansprechpartner hinterlegt werden. Sollten Sie zu einem späteren Zeitpunkt die den Benutzer im Shop aktualisieren wollen, müssten diesen zuvor ein Passwort gegeben werden, sollte noch keines vorhanden sein.ACHTUNG: Damit die Migration auch die Kundendaten verknüpfen kann, muss diese Funktionalität im Shop freigeschaltet sein. Wenden Sie sich hierzu an den Support des Büroring.
Menü
- Depots/Lager mit Partner
- Anreden
- Kundentypen (u. a. B2B, B2C)
- Kundenqualifikation (u. a. neuer Kunden, Stammkunde)
Für den automatischen Import siehe Automatiken: Definitionen importieren.
Erklärungen/Funktionen
- Kundengruppen verwalten
- Kunden übertragen
- Preise übertragen
- Shoppinglisten übertragen (z. B. Bestellvorlagen)
- Jobinformationen
- Migration