|
|
| (170 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| {{Kostenpflichtige Module}}
| | #WEITERLEITUNG [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24]] |
| {{Achtung|Die Schnittstelle befindet sich derzeit noch in der Entwicklung!}}
| |
| Der brShop24 wird von der Genossenschaft [https://www.bueroring.de 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 [https://de.wikipedia.org/wiki/GraphQL 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|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|Nach aktueller Planung sollen bis Anfang April Funktionalitäten für den Import von Aufträgen und der Übertragung von Kunden, Preisen und eigenen Artikeln umgesetzt sein. Der Umfang der einzelnen Funktionalitäten kann sich in den ersten Mnaten noch ändern (aktuell gibt es z. B. noch keine Möglichkeit Kostenstellen wie im VShop 4 zu übertragen).}}
| |
| Diese Schnittstelle unterstützt den Im- und Export von Daten wie folgt:
| |
| {| class="wikitable"
| |
| |-
| |
| ! Import!! Export
| |
| |-
| |
| | Auftragsimport (OpenTRANS 1.0)|| Personen/Ansprechpartner
| |
| |}
| |
| {{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.}}
| |
| | |
| =Menü=
| |
| | |
| {{Vorlage:KlapptextFAQ
| |
| |menu_b
| |
| |B Preislisten verwalten
| |
| |Öffnet die [[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen#Preislisten_verwalten|Preislistenverwaltung der Schnittstelle]].
| |
| }}
| |
| | |
| {{Vorlage:KlapptextFAQ
| |
| |menu_x
| |
| |X Konfiguration
| |
| |Öffnet die [[OBS/Stammdaten/Schnittstellen/Internet-Shop/Konfiguration|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/System/Ticket-System|OBS Ticketsystem]] beim OBS-Support.}}
| |
| }}
| |
| | |
| {{Vorlage:KlapptextFAQ
| |
| |menu_y
| |
| |Y Testumgebung
| |
| |Öffnet eine Testumgebung, um die Anbindung zu testen.
| |
| }}
| |
| | |
| {{Vorlage:KlapptextFAQ
| |
| |menu_z
| |
| |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=
| |
| *[[Kostenpflichtige_Module/Internet-Shop/brShop24/Personen_übertragen|Kunden übertragen]]
| |
| *[[Kostenpflichtige_Module/Internet-Shop/brShop24/Preise_übertragen|Preise übertragen]]
| |
| | |
| =Installation/Einrichtung=
| |
| Eine neue Schnittstelle muss vom Support freigegeben werden. Fragen Sie dies am besten per [[OBS/System/Ticket-System|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 [https://de.wikipedia.org/wiki/GraphQL GraphQL]. Um mit Ihrem Shop kommunizieren zu können, '''benötigen''' Sie die '''[https://de.wikipedia.org/wiki/Uniform_Resource_Locator URL] zu Ihrem Shop''' und folgende '''[https://de.wikipedia.org/wiki/OAuth 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. <nowiki>https://meinshop.brshop24.de</nowiki>)
| |
| *OAuth2.ClientId
| |
| *OAuth2.ClientSecret
| |
| *OAuth2.TokenEndpoint (z. B. <nowiki>https://oauth.brshop24.de/token</nowiki>)
| |
| {{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.<br />
| |
| ===Abholung===
| |
| {{Vorlage:KlapptextFAQ
| |
| |abholung_ftp
| |
| |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 [[OBS/Zusatzprogramme/FTP_Jobliste|''FTP Jobliste'']].
| |
| }}
| |
| {{Vorlage:KlapptextFAQ
| |
| |abholung_email
| |
| |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.
| |
| *[[OBS/Stammdaten/Weitere_Stammdaten/E-Mail_Konten|Einrichten eines E-Mail-Kontos]]
| |
| *[[OBS/Stammdaten/E-Mail/Regeln|Filter-Regel einrichten]]
| |
| }}
| |
| | |
| ===Import===
| |
| Nutzen Sie dazu unsere [[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken|'''Hilfe-Seite für Shop-Automatiken''']]. Der Import von Bestellungen erfolgt mit [[Kostenpflichtige_Module/Internet-Shop/Einrichtung/Automatiken#Bestellungen_einlesen|'''ShopGetBestellungen''']].
| |
| | |
| ==weitere Automatiken==
| |
| Eine Übersicht aller verfügbaren Automatiken finden Sie auf der entsrepchenden [[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 />
| |
| Die Einrichtung der '''automatischen Preispflege''' wird '''empfohlen''', '''wenn''' Sie ebenfalls die '''automatische Artikelpflege''' nutzen und Preise sich täglich ändern können.
| |
