Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
Nächste ÜberarbeitungBeide Seiten der Revision
plenty:setup [2019/10/09 20:18] – [PlentyMarket REST-API Zugang anlegen] ellenplenty:setup [2022/02/18 12:53] – sonja
Zeile 222: Zeile 222:
  
  
-==== PlentyMarket REST-API Zugang anlegen ==== 
  
-<WRAP box 90%> +==== Anlage eines Rest-API Benutzers in Plentymarkets ====
-Legen Sie im PlentyMarket Backend unter "Grundeinstellungen / Benutzer / Stammdaten" einen neuen Benutzer an. +
-</WRAP>+
  
 +Um auf die Schnittstellen für "Plenty 2 FiBu" zugreifen zu können, muss zunächst\\
 +ein sogenannter "Rest-API-Benutzer" mit speziellen Rechten für den Zugriff angelegt werden.\\
 +Das Vorgehen ist im Folgenden beschrieben:\\
  
-{{:plenty:benutzeranlegen_plenty.jpg?600|}}+Wählen Sie sich bitte zunächst in das Backend Ihres Plentymarket-Systems ein. Dort gelangen Sie über das Menü\\ 
 +"Einrichtung" in die Funktion "Einstellungen". Im Bereich "Benutzer" wählen Sie die Funktion "Konten" aus.\\ 
 +Klicken Sie auf den Button "Neu" (Abb. 1).\\
  
 +{{:plenty:rest-api-nutzer_1.png?800|}}\\
 +Abb. 1
  
-<WRAP box 90%> +Es öffnet sich die in Abb. 2 dargestellte Maske.\\ 
-Wählen Sie einen Benutzername, hier wurde beispielsweise "JeraRESTAPI" gewählt.\\ +Vergeben Sie bitte einen Benutzername, z.B. "plenty2datev", und tragen die zugehörige E-Mailadresse in das hierfür\\ 
-Anschließend wählen Sie einen den realen Namen und wählen die gewünschte UI-Sprache aus.\\ +vorgesehene Feld ein. Sprache und Zeitzone stellen Sie bitte auf "Deutsch" und "Europe/Amsterdam", wie in Abbildung 2 gezeigt.\\ 
-Wichtig ist, dass Sie die REST-API für den Zugang auswählen.\\ +Wählen Sie bitte über das Klappmenü den Eintrag "REST-API". Vergeben Sie bitte noch ein Passwort Ihrer Wahl und beachten Sie\\ 
-Speichern Sie diesen Benutzer ab.+dabei, dass Sie hierfür acht Zeichen benutzen müssen, allerdings keine Sonderzeichen erlaubt sind (Abb. 3). Das vergebene \\ 
 +Passwort muss im nächsten Feld der Maske nochmals bestätigt werden.\\ 
 +Anschließend speichern Sie den Benutzer über das Symbol "Diskette" ab (Abb. 3).\\
  
-Sie müssen nun den Benutzer bearbeiten um die benötigten Rechte zu vergeben.\\ +{{:plenty:rest-api-nutzer_2.png?800|}}\\ 
-Hierzu wechseln Sie in den Reiter Berechtigungen.\\ +Abb. 2
-Als erstes wählen Sie alle verfügbaren Lager aus.\\ +
-Anschließend wählen Sie alle sichtbaren Auftragsstatuse aus.\\ +
-Hierzu können Sie das Häckchen bei "alle" setzen. +
-</WRAP>+
  
 +{{:plenty:rest-api-nutzer_3.png?800|}}\\
 +Abb. 3
  
-{{:plenty:berechtigung_auftragsstatus.jpg?600|}}\\ +Der neu angelegte Benutzer wird Ihnen nun in der Benutzerliste angezeigt. Zur weiteren Bearbeitung öffnen\\ 
-{{:plenty:plenty_sichtbarenauftragsstatuse.jpg?600|}}\\ +Sie bitte den Benutzer über das Symbol "Stift" (Abb. 4).\\
-{{:plenty:auftragsstatus2.jpg?600|}}+
  
-<WRAP box 90%> +{{:plenty:rest-api-nutzer_4.png?800|}}\\ 
-Es werden <color #ed1c24>keine</color> setzbaren Auftragsstatus ausgewählt.\\+Abb. 4
  
-</WRAP>+Es öffnet sich die in Abbildung 5 dargestellte Maske. Bitte aktivieren Sie in den Stammdaten unter der Funktion\\ 
 +"Rollen" die Option "ALLE". Bitte speichern Sie den Benutzer über das Symbol "Diskette" ab.\\
  
-{{:plenty:setzbarestatuse1.jpg?600|}}\\+{{:plenty:rest-api-nutzer_5.png?800|}}\\ 
 +Abb. 5
  
-{{:plenty:setzbare3.jpg?600|}}+Öffnen Sie den Benutzer bitte erneut und wechseln in den Reiter "Berechtigungen". Dort aktivieren Sie bitte in\\ 
 +der Funktion "Sichtbarer Auftragsstatus" die Option "ALLE" (Abb. 6).\\ 
 +__**HINWEIS:**__  
 +**Die Option "Setzbarer Aufsichtsstatus" bitte deaktiviert lassen.**\\
  
-<WRAP box 90%> +{{:plenty:rest-api-nutzer_6.png?800|}}\\ 
-Bitte wählen Sie nun alle Mandanten (Shops) aus.\\+Abb. 6
  
-</WRAP>+Scrollen Sie bitte in derselben Maske nach unten und wählen die Mandanten (Shops) aus, auf welche der Benutzer\\ 
 +Zugriff haben soll. Anschließend speichern Sie die Einstellungen bitte über das Symbol "Diskette" ab. (Abb. 7).\\
  
-{{:plenty:mandanten.jpg?600|}}+{{:plenty:rest-api-nutzer_7.png?800|}}\\ 
 +Abb. 7
  
-<WRAP box 90%> +Wechseln Sie bitte in den Bereich "Einrichtung -> Einstellungen -> Benutzer -> Rechte" (Abb. 8)\\
-Nun müssen Sie den Reiter wechseln.Unter Benutzer/Rechte finden Sie den Punkt Berechtigungen.\\ +
-Bitte setzen Sie einen Hacken bei Aufträge. Hier ist auch eine Feinauswahl je nach Bedarf möglich.\\+
  
-</WRAP>+{{:plenty:rest-api-nutzer_9.png?800|}}\\ 
 +Abb. 8
  
-{{:plenty:berechtigung1.jpg?600|}}\\ +Bitte öffnen Sie den angelegten Benutzer per Doppelklick und aktivieren Sie in der Funktion "Rechte/Berechtigungen"\\ 
-{{:plenty:berechtigung2.jpg?600|}}\\ +die Option "Artikel und Aufträge" und speichern Sie die Einstellungen über das Symbol "Diskette" ab (Abb. 9).\\
-{{:plenty:berechtigung_3.jpg?600|}}\\+
  
-<WRAP box 90%> +{{:plenty:rest-api-nutzer_10.png?800|}}\\ 
-Anschließend wechseln Sie in den Reiter Ressourcen.\\ +Abb. 10
-Hier wählen Sie alle Ressourcen d.h. Webshops, Kassen etc. aus.\\ +
-Als letzten Schritt müssen Sie den Benutzer und das Passwort Ihrer REST-API\\ +
-in der Schnittstelle Plenty2Datev eintragen.\\ +
-Hierzu gehen Sie in der Schnittstelle auf Setup/ plenty-marked\\ +
-Achtung bitte setzen Sie nun einen Hacken bei REST-API und geben Ihren Benutzername und das Passwort ein.\\ +
-Nun kann die Schnittstelle automatisch die Buchungsdaten bei Plenty-Marked abholen.\\+
  
-</WRAP>+Wechseln Sie bitte nun in den Bereich "Ressourcen" und aktivieren Sie unter der Funktion "Auftragsherkünfte" die Option\\ 
 +"Alle Herkünfte". Anschließend speichern Sie bitte die Einstellungen über das Symbol "Diskette" ab (Abb. 11).\\
  
  
-<WRAP box 90%> +{{:plenty:rest-api-nutzer_12.png?800|}}\\ 
-Wenn der API-Nutzer nicht genügend Rechte hat, erhalten Sie in der Schnittstelle folgende Fehlermeldung: +Abb. 11
-</WRAP>+
  
 +__**HINWEIS:**__ \\
 +**Wird später ein Marktplatz ergänzt, ist dieser nachträglich zu aktivieren.**\\
 +
 +Den Namen des angelegten REST-API-Benutzers und das vergebene Passwort sind in der Schnittstelle "Plenty 2 Datev"\\
 +zu hinterlegen. Öffnen Sie hierzu die Schnittstelle, wählen Sie im Menü den Button "Setup" und dort die Funktion\\
 +"Plenty Einstellungen" aus. Es öffnet sich, die in Abb. 12 gezeigte Maske. Bitte speichern Sie Ihre Änderungen einmal\\ 
 +innerhalb der Maske über den Button "Änderungen speichern" und einmal über den grünen Haken links oben in der \\
 +Schnittstelle "Einstellungen speichern".\\
 +
 +{{:plenty:rest-api-nutzer_13.png?800|}}\\
 +Abb. 12
 +
 +__**HINWEIS:**__ \\
 +**Wenn der API-Nutzer nicht genügend Rechte hat, erhalten Sie in der Schnittstelle folgende Fehlermeldung:**
  
 {{:plenty:plentyrestapierror.png?300|}} {{:plenty:plentyrestapierror.png?300|}}