stepPlentyONE Skip to content

Step: PlentyAddItemImages - REST API

Mit diesem Step für Plentymarkets können Artikel Bilder hinzugefügt und mit Varianten verknüpft werden.

Benötigte Plentymarkets REST API  Berechtigungen:

  • Artikel - Artikelbilder - Bilder hochladen

  • Artikel - Artikelbilder - Bilder löschen

  • Artikel - Artikelbilder - Bilder anzeigen

  • Artikel - Varianten-Bilder - Bilder hochladen

Step Konfiguration:

siehe Step-Hilfe

Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name Datentyp Beschreibung Pflichtfeld Werte
account ACCOUNT Ihre PlentyONE Verbindung Ja
limitItems STRING Das Limit begrenzt die Anzahl der Bilder auf den angegebenen Wert. Leer für unbeschränkt. Nein
itemSpreadsheet SPREADSHEET Das Eingangs-SPREADSHEET mit Artikel ID (Item ID) und den Bild URLs(ImageUrl) die importiert werden sollen Ja
mappingdefinition STRING Die konfigurierte Zuordnung Nein
Folgende Felder sind zu konfigurieren:

Feld Datentyp Beschreibung Pflichtfeld Standardwert
ItemIDSINGLEItemID of article which should be linked to imagesJa
ImageUrlsMULTIPLEVALUEComma separated list of image urlsJa
LinkedVariantIDsMULTIPLEVALUEComma separated list of VariantIDs which should be linked to imagesNein
ImageAvailabilityMapMAPMap of image availabilities, example: mandant=-1.00;marketplace=-1.00;listing=104.00. The value '-1' sets all availabilities for this type. Use 'none' as value to add image without availabilities.Nein
PositionSINGLEPosition of first image url.Nein
ImageNameLanguageSINGLENein
ImageNameSINGLENein
ImageNameAlternateSINGLENein
MarketAttributeSINGLEAttribute backend name marketplace link, example: sizeNein
MarketAttributeValueSINGLEAttribute Value backend name marketplace link, example: XXLNein
RemoveImageIDsMULTIPLEVALUEComma separated list of ImageIDs which should be removed.Nein
mode STRING Bilder hinzufügen - Bilder werden den vorhandenen Bilder des Artikels hinzugefügt. | Vorhandenene Bilder entfernen - Alle am Artikel vorhandenene Bilder werden zunächst gelöscht. Anschließend werden die Bilder des Eingags-SPREADSHEETs importiert. | Bilder über Zielspalte entfernen - Die in der Zielspalte 'RemoveImageIDs' angegebenen Bilder(Image IDs) werden zunächst gelöscht. Anschließend werden die Bilder des Eingags-SPREADSHEETs importiert. Ja
  • Bilder hinzufügen
  • Alle vorhandenen Bilder entfernen
  • Bilder über Zielspalte entfernen
checkImageExists STRING Wenn diese Option aktiviert ist, wird mit einem zusätzlichen Abruf (HEAD request) geprüft, ob die Bild Url vorhanden ist. Nein
  • Aktiviert
  • Deaktiviert

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name Datentyp Beschreibung Pflichtfeld Werte
results SPREADSHEET Ein SPREADSHEET mit den Daten der importierten Bilder Ja
Folgende Felder sind im Output enthalten:

Feld Datentyp Beschreibung Pflichtfeld Standardwert
UploadUrlSINGLENein
identifierSINGLEThe identifier column to import Spreadsheet into a Datastore.Nein
ImageIDSINGLEJa
ItemIDSINGLEJa
TypeSINGLENein
FileTypeSINGLENein
PathSINGLENein
PositionSINGLENein
LastUpdateSINGLENein
InsertSINGLENein
Md5ChecksumSINGLENein
WidthSINGLENein
HeightSINGLENein
SizeSINGLENein
StorageProviderIdSINGLENein
AttributeValueIdSINGLENein
CleanImageNameSINGLENein
UrlSINGLENein
UrlMiddleSINGLENein
UrlPreviewSINGLENein
UrlSecondPreviewSINGLENein
DocumentUploadPathSINGLENein
DocumentUploadPathPreviewSINGLENein
DocumentUploadPreviewWidthSINGLENein
DocumentUploadPreviewHeightSINGLENein
AvailabilitiesMandantMULTIPLEVALUENein
AvailabilitiesMarketplaceMULTIPLEVALUENein
AvailabilitiesListingMULTIPLEVALUENein
LinkedVariantIDsMULTIPLEVALUENein