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/15 16:16] – [PlentyMarket REST-API Zugang anlegen] ellen | plenty:setup [2022/02/21 09:05] – 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 27: | Zeile 27: | ||
<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? | + | plenty:benutzer |
=== Request Bremse === | === Request Bremse === | ||
Zeile 222: | Zeile 141: | ||
- | ==== PlentyMarket REST-API Zugang anlegen ==== | ||
- | <WRAP box 90%> | + | ==== Anlage eines Rest-API Benutzers in Plentymarkets ==== |
- | Legen Sie im PlentyMarket Backend unter " | + | |
- | </ | + | |
- | {{:plenty: | + | 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 " | ||
- | <WRAP box 90%> | + | {{: |
- | Wählen Sie einen Benutzername, | + | Abb. 1 |
- | Anschließend wählen Sie einen den realen Namen und wählen die gewünschte UI-Sprache aus.\\ | + | |
- | Wichtig ist, dass Sie die REST-API für den Zugang auswählen.\\ | + | |
- | Speichern Sie diesen Benutzer ab. | + | |
- | Sie müssen nun den Benutzer bearbeiten um die benötigten Rechte zu vergeben.\\ | + | Es öffnet sich die in Abb. 2 dargestellte Maske.\\ |
- | Hierzu wechseln | + | Vergeben |
- | Als erstes wählen | + | vorgesehene Feld ein. Sprache und Zeitzone stellen Sie bitte auf " |
- | Anschließend wählen | + | Wählen |
- | Hierzu können | + | 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 | ||
+ | {{: | ||
+ | Abb. 2 | ||
- | {{:plenty:berechtigung_auftragsstatus.jpg?600|}}\\ | + | {{: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\\ |
- | Es werden <color # | + | Sie bitte den Benutzer über das Symbol " |
- | </ | + | {{: |
+ | Abb. 4 | ||
- | {{: | + | Es öffnet sich die in Abbildung 5 dargestellte Maske. Bitte aktivieren Sie in den Stammdaten unter der Funktion\\ |
+ | " | ||
+ | {{: | ||
+ | Abb. 5 | ||
- | <WRAP box 90%> | + | Öffnen |
- | Bitte wählen | + | der Funktion " |
+ | __**HINWEIS: | ||
+ | **Die Option " | ||
- | </ | + | {{: |
+ | 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 " | ||
- | <WRAP box 90%> | + | {{: |
- | Nun müssen Sie den Reiter wechseln.Unter Benutzer/ | + | Abb. 7 |
- | Bitte setzen Sie einen Hacken bei Aufträge. Hier ist auch eine Feinauswahl je nach Bedarf möglich.\\ | + | |
- | </WRAP> | + | Wechseln Sie bitte in den Bereich " |
- | {{:plenty:berechtigung1.jpg?600|}}\\ | + | {{:plenty:rest-api-nutzer_9.png?800|}}\\ |
- | {{: | + | Abb. 8 |
- | {{: | + | |
- | <WRAP box 90%> | + | Bitte öffnen |
- | Anschließend wechseln Sie in den Reiter Ressourcen.\\ | + | die Option " |
- | Hier wählen Sie alle Ressourcen d.h. Webshops, Kassen etc. aus.\\ | + | |
- | Als letzten Schritt müssen | + | |
- | 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 | + | |
- | Nun kann die Schnittstelle automatisch die Buchungsdaten bei Plenty-Marked abholen.\\ | + | |
- | </ | + | {{: |
+ | Abb. 10 | ||
+ | Wechseln Sie bitte nun in den Bereich " | ||
+ | "Alle Herkünfte" | ||
- | <WRAP box 90%> | ||
- | Wenn der API-Nutzer nicht genügend Rechte hat, erhalten Sie in der Schnittstelle folgende Fehlermeldung: | ||
- | </ | ||
+ | {{: | ||
+ | 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, | ||
+ | " | ||
+ | innerhalb der Maske über den Button " | ||
+ | Schnittstelle " | ||
+ | |||
+ | {{: | ||
+ | Abb. 12 | ||
+ | |||
+ | __**HINWEIS: | ||
+ | **Wenn der API-Nutzer nicht genügend Rechte hat, erhalten Sie in der Schnittstelle folgende Fehlermeldung: | ||
{{: | {{: |