plentyONE ist eine E-Commerce-Lösung, die verschiedene Funktionen für einen Online-Shop vereint. pixi unterstützt neben anderen Shop-Anbietern auch die Anbindung an plentyONE. Dies erfolgt über das pixi Control Center > Import und Export.
See also: Imports 2.0 - Dokumentation, Imports 2.0 - Problembehandlung
Verbindung zu einem plentyONE Shop einrichten
pixi wird über eine REST-API-Schnittstelle mit einem plentyONE-Shop verbunden. Ältere API-URL-Schnittstellen werden offiziell nicht mehr unterstützt.
plentyONE verwendet unterschiedliche Namenskonventionen für Bestell- und Kundendetails. Um sicherzustellen, dass die Daten korrekt in pixi importiert werden, wird eine passende Tabelle bereitgestellt. In dieser Tabelle werden die Felder in plentyONE mit den entsprechenden Feldern in pixi abgeglichen, und der ursprüngliche Wert im XML-Feld wird durch den übereinstimmenden Wert im Feld pixi ersetzt.
Verbindung zu plentyONE herstellen
Öffnen Sie das pixi Control Center und klicken Sie auf den Reiter Import und Export.
Klicken Sie auf Optionen (
), um die pixi Einstellungen zu öffnen, und dann Bearbeiten bei Anbindung & Import/Export-Channels.
Klicken Sie Neu, um den Assistenten zum bearbeiten/hinzufügen eines neuen Channels zu öffnen.
-
Geben Sie den Namen des Channels (bspw. Plenty|Plenty 7) ein und wählen Sie im Dropdown Channel-Art die Option PlentyREST. Nun können Sie aus folgenden Optionen wählen:
Für alle Channels exportieren: Artikel, die von diesem Kanal importiert wurden, werden an alle aktivierten Kanäle exportiert.
Nur für diesen Channel exportieren: Artikel, die von diesem Kanal importiert wurden, werden auch nur an diesen Kanal exportiert.
Kein Export für diesen Channel: Es werden gar keine Artikel an diesen Kanal exportiert.
Gar keine Artikel an diesen Kanal exportieren: Es werden keine Artikel an diesen Kanal exportiert.
Klicken Sie auf Weiter.
Geben Sie die erforderlichen Channel-Einstellungen ein (eine detaillierte Beschreibung zu den einzelnen Einstellungen finden Sie im Abschnitt Beschreibung der Channel-Einstellungen).
Achtung: Das Sonderzeichen # ist als Shop-Passwort "pixi12345#" nicht zulässig und erzeugt beim Authentication Call bei plentyONE eine Fehlermeldung und liefert keinen access_token zurück.Geben Sie nun die Daten für die Zuordnungstabelle ein. Klicken Sie dazu auf Neu, selektieren Sie den Name des Feldes, geben Sie plenty- und pixi-Wert ein und klicken Sie OK. Eine detaillierte Beschreibung der Einstellungen der Zuordnungstabelle finden Sie im Abschnitt Beschreibung der Einstellungen für die Zuordnungstabelle.
Klicken Sie auf Fertig. Der neue Channel ist nun eingerichtet.
Wählen Sie den neu eingerichteten Channel aus der Liste aus und klicken Sie auf Aktivieren.
Mit dem Klick auf Verbindung überprüfen können Sie testen, ob alles richtig eingerichtet wurde. Wenn der Test erfolgreich war, erhalten Sie ein Hinweisfenster mit der zurückgegebenen Session-ID.
plentyONE REST-Methoden und Endpunkte
Die vollständige Liste aller Methoden finden Sie hier. Mit pixi können die folgenden Endpunkte verwendet werden:
|
Suchen
| |
|
Artikeldaten abrufen
|
Bestelldaten abrufen
|
|
Lagerbestandsdaten
|
Bestellexportdaten
|
Channel-Einstellungen
Die folgende Tabelle enthält eine Liste von Channel-Einstellungen für plentyONE. Die Tabelle entspricht der Tabelle in der englischen Dokumentation für pixi zu weiteren Einstellungen für plentyONE.
Channel-Einstellung |
Beschreibung |
Wert (Beispiel) |
StoreHouse_ID |
[Artikelexport] Der Wert dieser Einstellung wird für den Artikelexport verwendet und ist im XML-Element WarehouseID enthalten. |
1 |
PixiOrderLocation |
[Artikelexport] Diese Einstellung betrifft den Bestandsexport zu plentyONE. Der Wert sollte für den Export auf "0" gesetzt sein. Der Wert ist außerdem im XML-Element StorageLocation enthalten. |
0 |
Benutzername Shop |
Zugangsdaten für plentyONE |
Benutzername |
Shop Passwort |
Zugangsdaten für plentyONE |
Passwort |
Shop API URL |
URL zum plentyONE Shop |
|
PlentyOrderImportStatus |
[Bestellimport] Bestellungen innerhalb von plentyONE mit numerischem Wert werden mit dieser Einstellung zu pixi importiert. Der Standardwert ist in der Spezifikation bei plentyONE zu finden. |
5 |
PlentyOrderImportStatusAfterImport |
[Bestellimport] Der Status der zu pixi importierten Bestellungen wird bei plentyONE auf einen numerischen Wert gesetzt. Die verschiedenen Werte sind bei plentyONE zu finden. |
5.1 |
ItemImport_OrderUnit |
[Artikelimport] 0: Wenn dieser Wert gesetzt ist, ist die Änderung der Verpackungseinheit nach dem Import zu pixi nicht erlaubt. 1: Wenn dieser Wert gesetzt ist, ist die Änderung der Verpackungseinheit nach dem Import zu pixi erlaubt. |
1 |
ItemImport_MinOrderQty |
[Artikelimport] 0: Wenn dieser Wert gesetzt ist, ist die Änderung der Mindestbestellmenge nach dem Import zu pixi nicht erlaubt. 1: Wenn dieser Wert gesetzt ist, ist die Änderung der Mindestbestellmenge nach dem Import zu pixi erlaubt. |
1 |
Free1 as SerialNrReq |
[Artikelimport] 0: Das Feld wird ignoriert. 1: Dieses Feld gibt innerhalb des XML an, dass die Seriennummer eines Artikels erforderlich ist. |
1 |
ItemImport_PlentyGrossPriceId |
[Artikelimport] 0: Der Verkaufspreis wird nicht zu pixi importiert. 1 (standardmäßig): Der Verkaufspreis des Artikels wird importiert. |
1 |
AUS |
[Bestellexport] Der Wert, der dem Status AUS bei plentyONE entspricht. |
7.0 |
STO |
[Bestellexport] Der Wert, der dem Status STO bei plentyONE entspricht. |
8.0 |
NLB |
[Bestellexport] Der Wert, der dem Status NLB bei plentyONE entspricht. |
8.0 |
RET |
[Bestellexport] Der Wert, der dem Status RET bei plentyONE entspricht. |
9.0 |
PlentyItemsVAT0 |
[Artikelimport] Wenn der Wert für im XML = 0 ist, wird die entsprechende MwSt-Höhe in pixi in die Felder gesetzt. Mögliche Werte: MwSt_High, MwSt_Low oder MwSt_None |
MwSt_High |
PlentyItemsVAT1 |
[Artikelimport] Wenn der Wert für im XML =1 ist, wird die entsprechende MwSt-Höhe in pixi in die Felder gesetzt. Mögliche Werte: MwSt_High, MwSt_Low oder MwSt_None |
NULL |
PlentyItemsVAT2 |
[Artikelimport] Wenn der Wert für im XML =2 ist, wird die entsprechende MwSt-Höhe in pixi in die Felder gesetzt. Mögliche Werte: MwSt_High, MwSt_Low oder MwSt_None |
NULL |
PlentyItemsVAT3 |
[Artikelimport] Wenn der Wert für im XML =3 ist, wird die entsprechende MwSt-Höhe in pixi in die Felder gesetzt. Mögliche Werte: MwSt_High, MwSt_Low oder MwSt_None |
NULL |
PlentyCustomerNrExternal |
[Bestellimport] CustomerNrExternal: Die Rechnungs-E-Mail-Adresse wird aus der XML-Datei importiert und als Kundennummer in pixi übernommen. Wenn die Channel-Einstellung für PlentyCustomerNrExternal auf CustomerNrExternal steht, prüft das System nicht auf CustomerID-Werte, wodurch Nutzer von plentyONE auch Bestellungen ohne CustomerID (Gastkonten) importieren können. PlentyID: Die CustomerID wird aus der XML-Datei importiert (<Order><PlentyId>) und als CustomerNrExternal in pixi eingefügt. Die CustomerID wird importiert, wenn die Channel-Einstellung auf PlentyID gesetzt wurde. PlentyOrderNumber: Wenn dieser Parameter gesetzt wird, importiert pixi Bestellungen mit dem Präfix "PON_" und anschließender PlentyOrderID (pixi Bestellnr.) als externe Bestellnummer (Beispiel: PON_355). |
CustomerNrExternal |
|
PlentyLastItemImportDate |
[Artikelimport] |
2020-01-01 |
PlentyLastSupplierImportDate |
[Artikelimport] Das Datum des letzten Lieferantenimports wird in diesem Feld automatisch gespeichert. Hinweis zum Import: |
2020-01-01 |
InternalItemNumber |
[Bestellimport] [Artikelimport] 0: Nutzt die ItemID ItemID (standardmäßig): Nutzt VariationID aus dem plentyONE Shop (ID-Tag) ItemNo: Nutzt VariationNr aus dem plentyONE Shop (Nummern-Tag) |
ItemNo |
Suffixformel für Artikelname |
[Artikelimport] " PU: {{Variation.UnitsContained}}": Die Verpackungseinheit wird beim Artikelimport hinzugefügt. |
" PU: {{Variation.UnitsContained}}" |
PlentyCategoryUseNameHierarchy |
[Artikelimport] 1: Importiert den gesamten Pfad der Kategorien (z. B. Allgemein > Computer > Notebooks) 2: Importiert nur die höchste Kategorie (z. B. Allgemein) |
0 |
Artikelname aus Plenty-Bestellung verwenden |
[Bestellimport] 1: Name der Bestellzeile wird von der Bestellzeile in plentyONE übernommen |
0 |
Shop ID der Bestellung |
[Bestellimport] 1: Greift den Referrer von der zum Channel passenden Tabelle ab Referrer;MultiShop: greift "Referrer;MultiShop" von der zum Channel passenden Tabelle ab |
0 |
Bestellmenge mit VPE multiplizieren |
[Bestellimport] 1 (standardmäßig): |
1 |
Plenty Paket-ID für Tracking-ID Export |
[Bestellexport] 1 (standardmäßig): Die Tracking ID befindet sich im ShippingTrackingId Feld der exportierten XML-Datei |
1 |
B2B Kundenklassen IDs |
[Bestellimport] |
121545,45789 |
Variation Nr. als Lieferantenartikelnr. verwenden |
[Artikelimport] 1: Beim Artikelimport wird die Variation Nr. der Artikelvariante von plentyONE als Lieferantenartikelnummer in pixi verwendet. Für normale Artikel wird die Lieferatenartikelnummer von plentyONE als ebendiese in pixi verwendet. Hinweis: Die Zolltarifnummer der (Artikel-)Variante Vorrang vor der Zolltarifnummer des Hauptartikels. |
0 |
Auftragssplittung unterstützen |
[Bestellimport] 0 (standardmäßig): Wenn auf den Wert = 0 gesetzt wird, werden alle Bestelltypen (z. B. Sales [TypeId=1], Delivery [TypeId=2]) importiert (Funktionalität vor 19.04). 1: Wenn der Wert = 1 gesetzt wird und eine Bestellung in verschiedene Teillieferungen in plentyONE geteilt wurde, werden nur diese importiert und nicht die gesamte (übergeordnete) Bestellung. |
0 |
Warenausgang zurückbuchen |
[Bestellexport] 0 (standardmäßig): Die Lagerbewegung "Warenausgang zurückbuchen" wird nicht für plentyONE ausgelöst. Somit wird der Artikelbestand nicht verringert, nachdem die Bestellung als Versendet markiert wurde. 1: Diese Lagerbewegung "Warenausgang zurückbuchen" wird für plentyONE ausgelöst. Der Artikelbestand wird reduziert, nachdem die Bestellung als Versendet markiert wurde. |
0 |
Kundensperre für Bestellungen mit Kommentar setzen |
[Bestellimport] 0: Kundensperre wird nicht gesetzt, wenn eine Bestellung mit einem Kommentar importiert wird. 1 (standardmäßig): Kundensperre wird gesetzt, wenn eine Bestellung mit einem Kommentar importiert wird. |
1 |
Artikelstatus importieren |
[Artikelimport] |
|
Artikelstatus exportieren |
[Artikelexport] |
|
Bestandsexport nach Bestellexport durchführen |
[Bestellexport] 1 (standardmäßig): Bestandsexport wird nach dem Bestellexport durchgeführt, um den korrekten Bestand in plentyONE abzubilden. ! Wichtig: Wenn diese Einstellung aktiviert ist, muss die Einstellung bei Warenausgang zurückbuchen deaktiviert sein. |
1 |
Bundle-Artikel exportieren |
0 (standardmäßig): Bundle-Artikel werden nicht zu plentyONE exportiert. 1: Bundle-Artikel werden zu plentyONE exportiert. Der Export wird nur dann durchgeführt, wenn der Bundle-Artikel ein normaler Artikel in plentyONE ist. Andernfalls gibt plentyONE einen Fehler zurück. |
0 |
Gewährleistungen (Warranty) importieren |
Wenn diese Einstellung und die Einstellung "Auftragssplittung unterstützen" aktiviert sind, dann werden Gewährleistungsbestellungen (Warranty) zusammen mit Sales und Delivery Bestellungen zu pixi importiert. 0 (standardmäßig): Kein Import 1: Wenn "Auftragssplittung unterstützen" aktiviert ist, werden auch Gewährleistungsbestellungen importiert. |
0 |
ItemImport_LastPageNumber |
Das Channel-Setting ItemImport_LastPageNumber gibt die Anzahl der bereits importierten "Seiten" von Plenty an. Standardmäßig ist das Setting auf = 0 eingestellt, der Zähler wird jedoch nach jeder verarbeiteten Seite automatisch erhöht und kann im Bedarfsfall auch zurückgesetzt werden oder von einer beliebigen "Seite" erneut gestartet werden können. 0 (standardmäßig): Beginnt mit der ersten Seite |
0 |
Attribute importieren |
0 (standardmäßig): Attribute werden nicht importiert. 1: Attribute werden importiert. |
0 |
Attribut-Namen berücksichtigen |
Mit dieser Einstellung wird festgelegt, ob Attribut-Namen als Prefix vor dem Attribut-Wert berücksichtigt werden sollen. 0 (standardmäßig): Attribute werden nicht importiert. 1: Attribute werden importiert. Hinweis: Attribut-Namen und Attribut-Werte werden so importiert wie sie in Plenty definiert werden können. |
0 |
Attribut-Delimiter verwenden |
Standardwert ist (,) = Komma Dieses Setting definiert ein Trennzeichen zwischen Attribut-Name und Attribut-Wert Mögliche Werte sind (,), (;), (:), (|), (-). Zwischen Attribut-Name und Attribut-Wert wird immer ein Doppelpunkt (:) als Trennzeichen verwendet Beispiel mit AttributeDelimiter = ',' T-Shirt Skyline Leipzig, Color: black, Size: (L) T-Shirt Skyline Leipzig, Farbe: black, Größe: (L) Artikelname+ AttributeDelimiter + Attribut 1 + AttributeDelimiter + Attribut 2 Attribut = Attribut-Name + ':' + Attribut-Wert |
|
ItemExport_ExportOnlyPhysicalStockChanges |
Es werden nur geänderte Artikel exportiert (URL-Channel). Der manuelle Export funktioniert unabhängig von dieser Einstellung. |
|
Anzahl der zu importierenden Artikel |
Diese Einstellung legt die Anzahl der Artikel fest, die zu pixi importiert werden. Der Standardwert ist 100. Mit dieser Einstellung ist es möglich, die Anzahl der Artikel pro Importvorgang auf einen niedrigen Wert zu begrenzen, sodass Bestellungen regelmäßiger importiert werden können. |
100 |
DSGVO-Daten immer für Polling exportieren |
E-Mail-Adresse und Telefonnummer werden für das Polling exportiert. |
0 |
Anzahl der zu exportierenden Artikel (Stapel) |
Mit dieser Einstellung lässt sich die Anzahl der pro Stapel zu exportierenden Artikel steuern. Auch Bundles werden im Exportprozess berücksichtigt. Wenn Bundleinformationen gesendet werden, wird das Lager nicht aktualisiert, aber die XML wird auf den Status "OK" gesetzt. |
500 |
Beschreibung der Einstellungen für die Zuordnungstabelle
Die Tabelle enthält eine Liste aller verfügbaren Tabelleneinstellungen für die Verbindung zu plentyONE.
XML-Element |
Name |
Beschreibung |
Beispiel |
|||||||||||||||
Wenn TypeId "1" |
LocationID |
Der Wert für die LocationID sollte der passenden Tabelle mit der korrespondierenden Location im pixi Control Center > Locations zugeordnet sein. |
Wert externes System: 1 |
|||||||||||||||
ShopID |
Der Wert für die ShopID sollte der passenden Tabelle mit der korrespondierenden ShopID im pixi Control Center > Shops zugeordnet sein. Weitere Informationen finden Sie bei Order Shop ID. |
Wert externes System: 4.01 |
||||||||||||||||
Wenn TypeId "3" |
Payment |
Der Wert für die Paymemt sollte der passenden Tabelle mit dem korrespondierenden (Zahlungs-)code im pixi Control Center > Zahlungsarten zugeordnet sein. |
Wert externes System: 9 |
|||||||||||||||
Wenn TypeId "2" |
ShipVendor |
Der Wert für die ShipVendor sollte der passenden Tabelle mit dem korrespondierenden Versanddienstleister-Code im pixi Control Center > Logistikdienstleister zugeordnet sein. |
Wert externes System: 6 |
|||||||||||||||
Wenn TypeId "2" |
ShipInstruct |
Wenn die Einstellung nicht aktiviert ist, werden die Werte in pixi hardcoded und hängen vom Land der Lieferdresse und dem Zahlungstyp ab:Wenn im Control Center > Datenbank-Einstellungen > Import / Export > Bestellimport (Opentrans) die Einstellung openTRANS, Import der DHL Felder aktiviert ist, werden die ShipInstruct Werte von der zugeordneten Tabelle gelesen.
|
Wert externes System: 6
In diesem Fall wird die Bestellungen mit folgenden Informationen importiert
|
|||||||||||||||
Referrer |
Der Wert für die Referrer sollte der passenden Tabelle mit der korrespondierenden ShopID im pixi Control Center > Shops zugeordnet sein. Weitere Informationen finden Sie bei Order Shop ID. |
Wert externes System: 104.01 |
||||||||||||||||
Referrer;Multishop; |
Der Wert für die Referrer;Multishop sollte der passenden Tabelle mit der korrespondierenden ShopID im pixi Control Center > Shops zugeordnet sein. Weitere Informationen finden Sie bei Order Shop ID. |
Wert externes System: 4.04 |
Bedingungen für Import und Export festlegen
Bedingungen sind festgelegte Regeln, die den Import von Artikeln oder Bestellungen mit fehlenden oder falschen bzw. inkompatiblen Daten zu pixi verhindern.
Weitere Informationen: Imports 2.0 - Setup
Datenbank-Einstellungen bearbeiten
Das grundlegende Setup und die Konfiguration von Imports 2.0 ist auch für plentyONE anwendbar. Hier sind die Einstellungen vorzunehmen:
Control Center > Datenbank-Einstellungen > Imports 2.0
Control Center > Datenbank-Einstellungen> Imports 2.0 > Export
Control Center > Datenbank-Einstellungen > Import / Export
Die folgenden Datenbank-Einstellungen wirken sich auf die Verbindung zu plentyONE aus:
Einstellung |
Beschreibung |
Allgemein > Anzahl der Dezimalstellen für Preise |
Legt fest, wann ein Preis gerundet wird. Standardmäßig wird nach zwei Dezimalstellen gerundet. |
Allgemein > Lief.-Artikel-Nr. und EK des Lieferanten MGS anzeigen |
Wenn ON, dann wird die Artikelnummer des Lieferanten MGS (falls vorhanden) übernommen.
Wenn OFF, dann wird die Artikelnummer vom letzten Lieferanten für den Artikel übernommen. |
Import / Export > Bestellimport (Opentrans) > openTRANS, Import der DHL Felder |
Aktivieren Sie diese Einstellung, wenn Sie benutzerdefinierte DHL DHL Versandinformation aus dem Shop importieren möchten. |
Starten oder Stoppen der Imports/Exports
In diesem Artikel finden Sie weitere Informationen zum Starten bzw. Stoppen von Imports/Export: Starten der Import- und Export-Prozesse
Bestellimport und Bestellexport
Bestelldaten werden durch REST-Methoden direkt von plentyONE importiert. Nach dem Import werden die Daten in die XML-Struktur des Control Centers eingefügt, so dass ein erneuter Import stattfinden kann, falls Fehler aufgetreten sind.
Hier erfahren Sie mehr Bestellimport: plentyONE - Order Import & Bestellexport: plentyONE - Order Export