• Shop URL
  In der Demo-Version können Sie hier die URL Ihres Plentymarket Zugangs eintragen.
  In der Vollversion wird diese nur angezeigt, da die URL in Ihrer Lizenz gespeichert ist.
• Nachkommastellen
  Legen Sie an dieser Stelle fest, mit wie vielen Nachkommastellen die Schnittstelle rechnen soll.

Dieser Pfad wird nur für Debug-Zwecke benutzt. Hier können die Daten, die mit der Plentymarkets API ausgetauscht werden, eingesehen werden.

Wählen Sie zwischen den unterschiedlichen API Zugängen:

• SOAP 1.12
  für PlentyMarket 7
• SOAP 1.15
  für PlentyMarket 7
• SOAP 2.00
  für PlentyMarket 7
• REST-API
  für PlentyMarket 7

Wir empfehlen Ihnen die Nutzung der REST-API.

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.

Diesem API Benutzer müssen Sie Zugriffsrechte auf die API Funktionen

• getcustomers
• searchorders

geben.

Mit diesen beiden API-Funktionen werden die Belege aus Plentymarket ausgelesen.

Weitere Informationen finden Sie unter

Plenty API Dokumentation

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.

Entfernen Sie bitte die Sonderzeichen und versuchen Sie es noch einmal.

Erhalten Sie folgende Fehlermeldung beim Abruf der Belege?

Kann es sein, das Ihre SOAP API nicht freigeschaltet ist.
Die SOAP API ist eine zusätzliche Optopn von PlentyMarkets und mit Kosten verbunden.

Plenty hat ein Limit für die Anzahl der Requests festgelegt. Dies berücksichtigt nun auch die Schnittstelle. Werden mehr als 100 Requests pro Minute ausgeführt, pausiert die Schnittstelle 60 Sekunden, um das Limit von Plenty zu umgehen.
Siehe: Plenty Hinweise "Too Many Requests"

Die API Version kann nun hier ausgewählt werden, da bei einigen Kunden die Version 1.15 nicht verfügbar ist.

Die Version 1.15 benötigt weniger API Calls, da in dieser Version die Umsatzsteuer ID schon im API Call Searchorders zurückgegeben wird und nicht zusätzlich aus den Kundendaten ausgelesen werden muss.

Sie können nun die Anzahl der Belege pro API Call festlegen. Dies ist aber nur mit einem „Own-Server“ eigenen Server möglich.
Zitat PlentyMarkets:
„Alle SOAP-Calls mit einer Limitierung der Datenausgabe haben nun den neuen Parameter CallItemsLimit erhalten. Mit diesem Parameter ist es nun bei Verwendung eines Own-Server möglich, die Limitierung der Datenausgabe selbst zu bestimmen.“

Je nach Kapazität des Servers kann es zu „Timeout“ Problemen kommen. In diesem Fall sollten Sie die Anzahl der Belege pro Request verkleinern. Der Maximalwert ist 25.

Wird in Plentymarket eine Rechnung erstellt, wird auf der Rechnung entweder das Zahlungsdatum oder das „Done“-Datum angedruckt, je nachdem, welcher Fall zuerst eintritt. Also wird die Rechnung zuerst abgeschlossen, so wird das „Done“-Datum gedruckt, wurde die Rechnung aber schon vor diesem Datum bezahlt, so ist das Zahlungsdatum auf der Rechnung zu finden.
In der Plenty-Datenbank kann aber nur entweder nach dem „Paid“-Datum, dem „Done“-Datum oder nach dem Erstellungsdatum des Belegs selektiert werden.

Je nachdem, wie Ihre Fremdwährungsbelege in Plenty abgespeichert werden, wählen Sie

• immer in Euro
  Der Fremdwährungsbeleg ist in z.B. GBP ausgestellt, der Betrag wird aber in Plenty in Euro gespeichert.
• Fremdwährung übernehmen
  Der Fremdwährungsbeleg ist in z.B. GBP ausgestellt, der Betrag wird auch in Plenty in GBP gespeichert.

Sie haben nun die Möglichkeit stornierte Belege auszublenden.
Stornierte Belege haben den OrderStatus 8.

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.

In Belegen kann es in allen Systemen zu Rundungsdifferenzen kommen. Sie können mit dieser Option diese Differenz automatisch korrigieren.

Sie können damit bestimmte Zahlungsarten aus oder einblenden.
z.B.: sie wollen alle Beleg, die die Payment-IDs 6006;6008 haben.
Wählen Sie „Zahlungs-ID / in“ und Payment-ID:6006;6008

Wollen Sie z.B. alle Beleg die über Hitmeister fakturiert wurden, ignorieren, so tragen Sie hier die Payment-ID von Hitmeister ein

Legen Sie im PlentyMarket Backend unter „Grundeinstellungen / Benutzer / Stammdaten“ einen neuen Benutzer an.

Wählen Sie einen Benutzername, hier wurde beispielsweise „JeraRESTAPI“ gewählt.
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.
Hierzu wechseln Sie in den Reiter Berechtigungen.
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.

Es werden keine setzbaren Auftragsstatus ausgewählt.

Bitte wählen Sie nun alle Mandanten (Shops) aus.

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.

Anschließend wechseln Sie in den Reiter Ressourcen.
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.

Wenn der API-Nutzer nicht genügend Rechte hat, erhalten Sie in der Schnittstelle folgende Fehlermeldung: