|
|
| (182 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| {{Kostenpflichtige Module}}
| | #WEITERLEITUNG [[OBS/Stammdaten/Schnittstellen/Internet-Shop/brShop24]] |
| {{Hinweis|Die Schnittstelle befindet sich derzeit noch in der Entwicklung. Eine Ausführliche }}
| |
| 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=
| |
| Diese Schnittstelle unterstützt den Im- und Export von Daten wie folgt:
| |
| {| class="wikitable"
| |
| |-
| |
| ! Import!! Export
| |
| |-
| |
| | Bestellungen (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ü=
| |
| =Erklärungen=
| |
| =Installation/Einrichtung=
| |
| ==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 it '''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"=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.
| |
