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:31] – [PlentyMarket SOAP-API 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 194: Zeile 111:
  
 <WRAP box 90%> <WRAP box 90%>
-Real Belege sind in Plenty sogenannte Frmdbelege, die durch ein anderes System erstellt wurden.\\+Real Belege sind in Plenty sogenannte Fremdbelege, die durch ein anderes System erstellt wurden.\\
 Sie können damit entscheiden, ob diese Belege übernommen werden sollen oder nicht. Sie können damit entscheiden, ob diese Belege übernommen werden sollen oder nicht.
 </WRAP> </WRAP>
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:rest-api-nutzer_3.png?800|}}\\
 +Abb. 3
  
-{{:plenty:plentyrestapirights.png?400|}}+Der neu angelegte Benutzer wird Ihnen nun in der Benutzerliste angezeigt. Zur weiteren Bearbeitung öffnen\\ 
 +Sie bitte den Benutzer über das Symbol "Stift" (Abb. 4).\\
  
-<WRAP box 90%> +{{:plenty:rest-api-nutzer_4.png?800|}}\\ 
-Wenn der API-Nutzer nicht genügend Rechte hat, erhalten Sie in der Schnittstelle folgende Fehlermeldung: +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: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|}}