Metainformationen zur Seite
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision | ||
plenty:setup [2019/10/09 20:18] – [PlentyMarket REST-API Zugang anlegen] ellen | plenty: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: | ||
</ | </ | ||
- | ==== 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. | ||
</ | </ | ||
- | |||
- | |||
Zeile 27: | Zeile 25: | ||
<WRAP box 90%> | <WRAP box 90%> | ||
- | Wählen Sie zwischen | + | 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.\\ | ||
- | |||
- | </ | ||
- | |||
- | |||
- | |||
- | ==== 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 " | ||
- | Sie können hierfür einen beliebigen Namen benutzen, im Beispiel unten haben wir den Benutzer " | ||
- | Vergeben Sie bitte ein Passwort. \\ | ||
- | Diesen Benutzer und das Passwort müssen Sie in der Schnittstelle eintragen. | ||
- | </ | ||
- | |||
- | |||
- | |||
- | {{: | ||
- | |||
- | \\ | ||
- | |||
- | <WRAP box 90%> | ||
- | Diesem API Benutzer müssen Sie Zugriffsrechte auf die API Funktionen | ||
- | |||
- | * getcustomers | ||
- | * searchorders | ||
- | |||
- | geben. \\ | ||
- | </ | ||
- | |||
- | {{: | ||
- | |||
- | <WRAP box 90%> | ||
- | Mit diesen beiden API-Funktionen werden die Belege aus Plentymarket ausgelesen.\\ | ||
- | |||
- | </ | ||
- | |||
- | |||
- | <WRAP important 90%> | ||
- | **Achten Sie bitte darauf, den Benutzer auch als API Benutzer anzulegen und nicht als " | ||
- | |||
- | </ | ||
- | |||
- | |||
- | |||
- | <WRAP box 90%> | ||
- | Weitere Informationen finden Sie unter | ||
- | |||
- | [[https:// | ||
- | </ | ||
- | |||
- | |||
- | === 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 box 90%> | ||
- | Entfernen Sie bitte die Sonderzeichen und versuchen Sie es noch einmal. | ||
- | </ | ||
- | |||
- | |||
- | === Plenty SOAP API freischalten === | ||
- | |||
- | <WRAP box 90%> | ||
- | Erhalten Sie folgende Fehlermeldung beim Abruf der Belege? | ||
- | </ | ||
- | |||
- | |||
- | {{: | ||
- | |||
- | <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. | ||
</ | </ | ||
+ | === REST API einrichten === | ||
- | {{:plenty:plentysoapapi.png? | + | {{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 " | + | |
- | </ | + | |
+ | Um auf die Schnittstellen für " | ||
+ | ein sogenannter " | ||
+ | Das Vorgehen ist im Folgenden beschrieben: | ||
- | {{: | + | Wählen Sie sich bitte zunächst in das Backend Ihres Plentymarket-Systems ein. Dort gelangen Sie über das Menü\\ |
+ | " | ||
+ | Klicken Sie auf den Button " | ||
+ | {{: | ||
+ | Abb. 1 | ||
- | <WRAP box 90%> | + | Es öffnet sich die in Abb. 2 dargestellte Maske.\\ |
- | Wählen | + | Vergeben |
- | Anschließend wählen | + | vorgesehene Feld ein. Sprache und Zeitzone stellen Sie bitte auf " |
- | Wichtig ist, dass Sie die REST-API für den Zugang auswählen.\\ | + | Wählen |
- | Speichern | + | 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 müssen nun den Benutzer bearbeiten um die benötigten Rechte zu vergeben.\\ | + | {{: |
- | 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 " | + | |
- | </ | + | |
+ | {{: | ||
+ | Abb. 3 | ||
- | {{: | + | Der neu angelegte Benutzer wird Ihnen nun in der Benutzerliste angezeigt. Zur weiteren Bearbeitung öffnen\\ |
- | {{: | + | Sie bitte den Benutzer über das Symbol " |
- | {{: | + | |
- | <WRAP box 90%> | + | {{: |
- | Es werden <color # | + | Abb. 4 |
- | </ | + | Es öffnet sich die in Abbildung 5 dargestellte Maske. Bitte aktivieren Sie in den Stammdaten unter der Funktion\\ |
+ | " | ||
- | {{: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 " |
+ | der Funktion " | ||
+ | __**HINWEIS:**__ | ||
+ | **Die Option " | ||
- | <WRAP box 90%> | + | {{: |
- | Bitte wählen Sie nun alle Mandanten (Shops) aus.\\ | + | 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 " | ||
- | {{:plenty:mandanten.jpg?600|}} | + | {{:plenty:rest-api-nutzer_7.png?800|}}\\ |
+ | Abb. 7 | ||
- | <WRAP box 90%> | + | Wechseln |
- | Nun müssen | + | |
- | Bitte setzen Sie einen Hacken bei Aufträge. Hier ist auch eine Feinauswahl je nach Bedarf möglich.\\ | + | |
- | </ | + | {{: |
+ | Abb. 8 | ||
- | {{: | + | Bitte öffnen Sie den angelegten Benutzer per Doppelklick und aktivieren Sie in der Funktion " |
- | {{: | + | die Option " |
- | {{: | + | |
- | <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/ | + | |
- | 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.\\ | + | |
- | </ | + | Wechseln Sie bitte nun in den Bereich " |
+ | "Alle Herkünfte" | ||
- | <WRAP box 90%> | + | {{: |
- | Wenn der API-Nutzer nicht genügend Rechte hat, erhalten | + | 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 " | ||
+ | zu hinterlegen. Öffnen Sie hierzu die Schnittstelle, wählen | ||
+ | " | ||
+ | innerhalb | ||
+ | Schnittstelle | ||
+ | |||
+ | {{:plenty: | ||
+ | Abb. 12 | ||
+ | __**HINWEIS: | ||
+ | **Wenn der API-Nutzer nicht genügend Rechte hat, erhalten Sie in der Schnittstelle folgende Fehlermeldung: | ||
{{: | {{: |