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/08 20:34] – [Beleg Parameter] ellenplenty:setup [2022/02/21 09:07] – jerawiki
Zeile 4: Zeile 4:
 //(Finden Sie im Menü unter "Setup / Plenty-Einstellungen")// //(Finden Sie im Menü unter "Setup / Plenty-Einstellungen")//
  
-{{:plenty:plentysetup.png?500|}}+{{:plenty:setup.png?600|}}
  
-==== Webshop ====+==== Plenty Shop ====
 <WRAP box 90%> <WRAP box 90%>
  
Zeile 14: Zeile 14:
 </WRAP> </WRAP>
  
-==== XML-Pfad ====+==== Pfad ====
  
  
Zeile 20: Zeile 20:
 Dieser Pfad wird nur für Debug-Zwecke benutzt. Hier können die Daten, die mit der Plentymarkets API ausgetauscht werden, eingesehen werden. Dieser Pfad wird nur für Debug-Zwecke benutzt. Hier können die Daten, die mit der Plentymarkets API ausgetauscht werden, eingesehen werden.
 </WRAP> </WRAP>
- 
- 
  
  
Zeile 27: Zeile 25:
  
 <WRAP box 90%> <WRAP box 90%>
-Wählen Sie zwischen den unterschiedlichen API Zugängen:\\+Wählen Sie bitte den REST-API API Zugang:\\
  
-  * **SOAP 1.12** \\ für PlentyMarket 7 +  * **SOAP 1.12** \\ für PlentyMarket 7 (wird offiziell nicht mehr von Plenty unterstützt) 
-  * **SOAP 1.15** \\ für PlentyMarket 7 +  * **SOAP 1.15** \\ für PlentyMarket 7 (wird offiziell nicht mehr von Plenty unterstützt) 
-  * **SOAP 2.00** \\ für PlentyMarket 7+  * **SOAP 2.00** \\ für PlentyMarket 7 (wird offiziell nicht mehr von Plenty unterstützt)
   * **REST-API** \\ für PlentyMarket 7   * **REST-API** \\ für PlentyMarket 7
  
-Wir empfehlen Ihnen die Nutzung der REST-API.\\ 
- 
-</WRAP> 
- 
- 
- 
-==== PlentyMarket SOAP-API Parameter ==== 
- 
-=== API Zugangsdaten === 
- 
-<WRAP box 90%> 
-Die Schnittstelle greift per API auf Ihre Plentymarket Daten zu. Dafür muss im Plentymarket Backend eine API Benutzer angelegt werden. 
-Legen Sie diesen unter "Einstellungen / Grundeinstellungen / Benutzer / Konten" an. 
-Sie können hierfür einen beliebigen Namen benutzen, im Beispiel unten haben wir den Benutzer "plenty2datev" genannt.\\ 
-Vergeben Sie bitte ein Passwort. \\ 
-Diesen Benutzer und das Passwort müssen Sie in der Schnittstelle eintragen. 
-</WRAP> 
- 
- 
- 
-{{:plenty:apiuser1.png?500|}} 
- 
-\\ 
- 
-<WRAP box 90%> 
-Diesem API Benutzer müssen Sie Zugriffsrechte auf die API Funktionen 
- 
-  * getcustomers 
-  * searchorders 
- 
-geben. \\ 
-</WRAP> 
- 
-{{:plenty:apirights.png?300|}} 
- 
-<WRAP box 90%> 
-Mit diesen beiden API-Funktionen werden die Belege aus Plentymarket ausgelesen.\\ 
- 
-</WRAP> 
- 
- 
-<WRAP important 90%> 
-**Achten Sie bitte darauf, den Benutzer auch als API Benutzer anzulegen und nicht als "Admin".** 
- 
-</WRAP> 
- 
- 
- 
-<WRAP box 90%> 
-Weitere Informationen finden Sie unter 
- 
-[[https://www.plentymarkets.eu/handbuch/soap-api/einfuehrung-soap-api/#4|Plenty API Dokumentation]] 
-</WRAP> 
- 
- 
-=== Plenty Passwort === 
- 
-<WRAP box 90%> 
-Vor dem Abruf der Daten, wird von der Schnittstelle mit dem hinterlegten Benutzername und Passwort ein API Token von Plenty angefordert.\\ 
-Unter Umständen erhalten Sie dann folgende Fehlermeldung. 
-</WRAP> 
- 
- 
-{{:plenty:plentypassworderror.png?300|}} 
- 
-<WRAP box 90%> 
-Entfernen Sie bitte die Sonderzeichen und versuchen Sie es noch einmal. 
-</WRAP> 
- 
- 
-=== Plenty SOAP API freischalten === 
- 
-<WRAP box 90%> 
-Erhalten Sie folgende Fehlermeldung beim Abruf der Belege? 
-</WRAP> 
- 
- 
-{{:plenty:plentynosoapapi.png?300|}} 
- 
-<WRAP box 90%> 
-Kann es sein, das Ihre SOAP API nicht freigeschaltet ist.\\ 
-Die SOAP API ist eine zusätzliche Optopn von PlentyMarkets und mit Kosten verbunden. 
 </WRAP> </WRAP>
  
 +=== REST API einrichten ===
  
-{{:plenty:plentysoapapi.png?600|}}+{{section>plenty:benutzer}}
  
 === Request Bremse === === Request Bremse ===
Zeile 222: Zeile 139:
  
  
-==== PlentyMarket REST-API Zugang anlegen ==== 
  
-<WRAP box 90%> +==== Anlage eines Rest-API Benutzers in Plentymarkets ====
-Legen Sie im PlentyMarket Backend unter "Grundeinstellungen / Benutzer / Konten" einen neuen Benutzer an. +
-</WRAP> +
- +
  
-{{:plenty:plentyrestapi1.png?600|}}+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:\\
  
-<WRAP box 90%> +Wählen Sie sich bitte zunächst in das Backend Ihres Plentymarket-Systems ein. Dort gelangen Sie über das Menü\\ 
-Bei der Benutzerklasse müssen Sie "API" auswählen.\\ +"Einrichtung" in die Funktion "Einstellungen". Im Bereich "Benutzer" wählen Sie die Funktion "Konten" aus.\\ 
-Speichern Sie diesen Benutzer ab.+Klicken Sie auf den Button "Neu" (Abb. 1).\\
  
-Sie müssen nun den Benutzer bearbeiten um die benötigten Rechte zu vergeben.\\ +{{:plenty:rest-api-nutzer_1.png?800|}}\\ 
-Achten Sie bitte darauf, auch die Berechtigungen in der REST API durchzuführen.\\ +Abb. 1 
-Ist der Reiter REST-API nicht vorhanden, ist die REST-API bei Ihnen nicht verfügbar. + 
-</WRAP>+Es öffnet sich die in Abb. 2 dargestellte Maske.\\ 
 +Vergeben Sie bitte einen Benutzername, z.B. "plenty2datev", und tragen die zugehörige E-Mailadresse in das hierfür\\ 
 +vorgesehene Feld ein. Sprache und Zeitzone stellen Sie bitte auf "Deutsch" und "Europe/Amsterdam", wie in Abbildung 2 gezeigt.\\ 
 +Wählen Sie bitte über das Klappmenü den Eintrag "REST-API". Vergeben Sie bitte noch ein Passwort Ihrer Wahl und beachten Sie\\ 
 +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).\\
  
 +{{:plenty:rest-api-nutzer_2.png?800|}}\\
 +Abb. 2
  
-{{:plenty:plentyrestapirights.png?400|}}+{{:plenty:rest-api-nutzer_3.png?800|}}\\ 
 +Abb. 3
  
-<WRAP box 90%> +Der neu angelegte Benutzer wird Ihnen nun in der Benutzerliste angezeigt. Zur weiteren Bearbeitung öffnen\\ 
-Wenn der API-Nutzer nicht genügend Rechte hat, erhalten Sie in der Schnittstelle folgende Fehlermeldung: +Sie bitte den Benutzer über das Symbol "Stift" (Abb. 4).\\ 
-</WRAP>+ 
 +{{:plenty:rest-api-nutzer_4.png?800|}}\\ 
 +Abb. 4 
 + 
 +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:rest-api-nutzer_5.png?800|}}\\ 
 +Abb. 5 
 + 
 +Ö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.**\\ 
 + 
 +{{:plenty:rest-api-nutzer_6.png?800|}}\\ 
 +Abb. 6 
 + 
 +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:rest-api-nutzer_7.png?800|}}\\ 
 +Abb. 7 
 + 
 +Wechseln Sie bitte in den Bereich "Einrichtung -> Einstellungen -> Benutzer -> Rechte" (Abb. 8)\\ 
 + 
 +{{:plenty:rest-api-nutzer_9.png?800|}}\\ 
 +Abb. 8 
 + 
 +Bitte öffnen Sie den angelegten Benutzer per Doppelklick und aktivieren Sie in der Funktion "Rechte/Berechtigungen"\\ 
 +die Option "Artikel und Aufträge" und speichern Sie die Einstellungen über das Symbol "Diskette" ab (Abb. 9).\\ 
 + 
 +{{:plenty:rest-api-nutzer_10.png?800|}}\\ 
 +Abb. 10 
 + 
 +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).\\ 
 + 
 + 
 +{{:plenty:rest-api-nutzer_12.png?800|}}\\ 
 +Abb. 11 
 + 
 +__**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|}}