Kostenpflichtige Module/Internet-Shop/brShop24: Unterschied zwischen den Versionen
Nimz (Diskussion | Beiträge) |
Nimz (Diskussion | Beiträge) |
||
Zeile 156: | Zeile 156: | ||
==weitere Automatiken== | ==weitere Automatiken== | ||
Eine Übersicht aller verfügbaren Automatiken finden Sie auf der | Eine Übersicht aller verfügbaren Automatiken finden Sie auf der entsprechenden [[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken|Hilfe-Seite für Shop-Automatiken]].{{Hinweis|Achten Sie darauf, dass '''brShop24''' in der Angabe ''Verfügbar in'' enthalten ist!}} | ||
<br /> | <br /> | ||
===Wichtig/Muss=== | |||
*;[[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Bestellungen_einlesen|Bestellungen importieren]] | |||
: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. | |||
*;[[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Informationen.2FProtokoll_externe_Jobs.2FVerarbeitung|Automatik für die Job-Informationen]] | |||
: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=== | |||
*;[[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Preise_aktualisieren|automatischen Preispflege]] | |||
: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. | |||
==Zuordnungen== | ==Zuordnungen== |
Version vom 15. Februar 2021, 11:57 Uhr
- 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 | Personen/Ansprechpartner/Kostenstellen |
Kundentypen | Shopping-Listen (Meistgekaufte Artikel/Top-Artikel) |
Kundenqualifikation | |
Job-Informationen (Ergebnis/Protokoll Preispflege) | |
Kundengruppen (Migration) | |
Benutzer (Migration) |
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.
Personen
- Einfügen neuer Kundengruppen
- Die Datensätze werden im OBS nicht korrekt angelegt und können daher nicht exportiert werden.
- Anzeige Webshop-Einstellungen
- Die Anzeige des Kundenstatus funktioniert aktuell nur, wenn die Kundennummer auch in einer Kundengruppe steht.
- Export Kostenstellen Budgets
- Die Budgetverwaltung wurde bisher noch nicht im brShop24 umgesetzt und steht daher auch in der API noch nicht zur Verfügung.
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.
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)
Installation/Einrichtung
Eine neue Schnittstelle muss vom Support freigegeben werden. Fragen Sie dies am besten per OBS Ticketsystem an.
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)
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
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 entsprechenden Hilfe-Seite für Shop-Automatiken.
Wichtig/Muss
- 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.
- 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
- 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.
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:
- 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.
Mit der Schnittstelle Starten
Sofern die Einrichtung abgeschlossen ist, empfehlen wir als erstes eine Datenmigration durchzuführen (siehe auch Umstellung/Migration VShop 4). Dabei werden die vom VShop 4 migrierten Daten 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.
Außerdem werden die Preislisten aus den im Shop vorhandenen Preislisten ermittelt und für die Schnittstelle freigegeben. Es findet keine Verknüpfung mit den Daten im OBS statt, da der vollständige Abgleich aller Preisdaten zu lange dauern würde!
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 beid er 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.
- 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
- Ü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 Eigenschaft9013 und die Zuordnung zur Schnittstelle. Sollte die eindeutige Zuordnung ohne Benutzername erfolgt sein, so wird auch der Benutzername im Ansprechpartner hinterlegt.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.