Step: PlentyGetVariations - REST API
Dieser Step ruft Varianten- und Artikelinformation aus plentymarkets ab.
Benötigte Plentymarkets REST API Berechtigungen:
- Artikel > variation > show
- Artikel > item > show
- Artikel > Attribute > Attribute anzeigen
- Artikel > Attributnamen > Attributnamen anzeigen
- Artikel > Attribute > Attribute anzeigen
- Artikel > Attributwerte > Attributwerte anzeigen
- Artikel > Attributwertnamen> Attributwertnamen anzeigen
- Artikel > Artikelbilder > Bilder anzeigen
- Artikel > Barcodes > Barcodes anzeigen
- Artikel > itemCrossSelling > show
- Artikel > Hersteller > Hersteller anzeigen
- Artikel > Merkmale > Merkmale anzeigen
- Artikel > propertyGroup > show
- Artikel > propertyGroupName > show
- Artikel > Merkmalnamen > Merkmalnamen anzeigen
- Artikel > Merkmaltyp Auswahl > Merkmaltyp Auswahl anzeigen
- Artikel > Verkaufspreise > Verkaufspreise anzeigen
- Artikel > Varianten - Bilder > Bilder anzeigen
- tag > show
- tagRelationship > show
Anhang: Feldmapping PlentyGetItemsBase STEP (SOAP API) zu PlentyGetVariations (REST API)
PlentyGetItemsBase (SOAP API) |
PlentyGetVariations (REST API) |
Kommentar |
---|---|---|
ItemID | ItemID | |
VariantID | VariantID | |
SKU | "0-0-" + VariantID | |
MainVariantID | MainVariantID | |
IsMainVariant | IsMainVariant | |
ItemNo | VariantNumber | |
ExternalItemID | ExternalItemID | |
Model | Model | |
EAN1-4 | in VariationBarcodes | |
ISBN | in VariationBarcodes | |
MainWarehouseID | MainWarehouseID | |
phyStockMainWarehouse | in VariationStocksPhysical | |
netStockMainWarehouse | in VariationStocksNetto | |
StorageLocationID | nicht mehr vorhanden | PlentyGetCurrentStocks Step verwenden |
Texts_Name | ItemTextsName1 | |
Texts_Name2 | ItemTextsName2 | |
Texts_Name3 | ItemTextsName3 | |
Texts_ShortDescription | ItemTextsShortDescription | |
Texts_LongDescription | ItemTextsDescription | |
Texts_MetaDescription | ItemTextsMetaDescription | |
Texts_Lang | ItemTextsLang | |
Texts_Keywords | ItemTextsKeywords | |
Texts_TechnicalData | ItemTextsTechnicalData | |
ImageUrl0-4 | in ItemImageUrls oder ItemImageUrlsMiddle oder ItemImageUrlsPreview | |
AllImagesList | ItemImageUrls | |
Availability_AllMandantIds | VariationClientIDs | |
Availability_AvailabilityID | AvailabilityID | |
Availability_AvailableUntil | AvailableUntil | |
Availability_Inactive | aus IsActive | |
Availability_Webshop | in VariationMarketIDs | |
Availability_WebAPI | in VariationMarketIDs | |
Availability_AmazonFBA | ItemAmazonFbaPlatform | |
Availability_AmazonFEDAS | ItemAmazonFedas | |
Availability_AmazonMultichannel | in VariationMarketIDs | |
Availability_AmazonMultichannelCom | in VariationMarketIDs | |
Availability_AmazonMultichannelDe | in VariationMarketIDs | |
Availability_AmazonMultichannelEs | in VariationMarketIDs | |
Availability_AmazonMultichannelFr | in VariationMarketIDs | |
Availability_AmazonMultichannelIt | in VariationMarketIDs | |
Availability_AmazonMultichannelUk | in VariationMarketIDs | |
Availability_AmazonProduct | ItemAmazonProductType | |
Availability_CouchCommerce | in VariationMarketIDs | |
Availability_GartenXXLDe | in VariationMarketIDs | |
Availability_Gimahhot | in VariationMarketIDs | |
Availability_GoogleShopping | in VariationMarketIDs | |
Availability_GrosshandelDe | nicht mehr vorhanden | |
Availability_Hitmeister | in VariationMarketIDs | |
Availability_Hood | in VariationMarketIDs | |
Availability_Laary | in VariationMarketIDs | |
Availability_Mercateo | in VariationMarketIDs | |
Availability_NeckermannAtCrossDocking | in VariationMarketIDs | |
Availability_NeckermannAtCrossDockingProductType | nicht mehr vorhanden | |
Availability_NeckermannAtCrossDockingProvisionType | nicht mehr vorhanden | |
Availability_NeckermannAtEnterprise | in VariationMarketIDs | |
Availability_NeckermannAtEnterpriseProductType | nicht mehr vorhanden | |
Availability_NeckermannAtEnterpriseProvisionType | nicht mehr vorhanden | |
Availability_Otto | in VariationMarketIDs | |
Availability_PlusDe | in VariationMarketIDs | |
Availability_Restposten | in VariationMarketIDs | |
Availability_Shopgate | in VariationMarketIDs | |
Availability_SumoScout | in VariationMarketIDs | |
Availability_Twenga | in VariationMarketIDs | |
Availability_Yatego | in VariationMarketIDs | |
Availability_Zalando | in VariationMarketIDs | |
Availability_Zentralverkauf | in VariationMarketIDs | |
ItemURL | nicht mehr vorhaden | |
DeepLink | ItemTextsUrlPath | |
BundleType | BundleType | |
TariffNumber | ItemCustomsTariffNumber | |
Position | ItemPosition | |
WebShopSpecial | ItemStoreSpecial | |
Stock_Limitation | StockLimitation | |
Category1_Path | Category1_Path | |
Category1_ID | Category1_ID | |
Category1_Level | Category1_Level | |
Category1_Name | Category1_Name | |
Category1_PathNames | Category1_PathNames | |
AllCategoryPaths | AllCategoryPaths | |
Condition | ItemCondition | |
Marking1ID | ItemMarking1ID | |
Marking2ID | ItemMarking2ID | |
LastUpdate | UpdatedAt | |
Inserted | CreatedAt | |
Published | ReleasedAt | |
ProducerID | ItemProducerID | |
ProducerName | ItemProducerName | |
ProducingCountryID | ItemProducingCountryID | |
Type | ItemType | |
VATInternalID | VATInternalID | |
PriceSet_ID | nicht mehr vorhaden | |
PriceSet_PurchasePriceNet | PurchasePrice | |
PriceSet_VAT | nicht mehr vorhaden | Mapping über VATInternalID möglich |
PriceSet_RecommendedRetailPrice | in VariationSalesPrices | |
PriceSet_Price1 - 12 | in VariationSalesPrices | |
PriceSet_WeightInGramm | WeightG | |
PriceSet_Unit | UnitID | bei SOAP ISO, jetzt ID siehe https://developers.plentymarkets.com/rest-doc/introduction#units |
PriceSet_Unit1 | nicht mehr vorhaden | |
PriceSet_Unit2 | nicht mehr vorhaden | |
PriceSet_BestOfferAutoAcceptancePrice | nicht mehr vorhaden | |
PriceSet_CarryingCosts | TransportationCosts | |
PriceSet_InventoryCosts | StorageCosts | |
PriceSet_ItemShipping3 | ExtraShippingCharge1 | |
PriceSet_ItemShipping4 | ExtraShippingCharge2 | |
PriceSet_HeightInMM | HeightMM | |
PriceSet_LengthInMM | LengthMM | |
PriceSet_WidthInMM | WidthMM | |
PriceSet_Lot | UnitContent | |
PriceSet_Position | Position | |
PriceSet_Package | PackingUnits | |
PriceSet_TypeOfPackage | PalletTypeId | |
PriceSet_PackagingUnit | UnitsContained | |
PriceSet_RebateLevelPrice6 | nicht mehr vorhaden | |
PriceSet_RebateLevelPrice7 | nicht mehr vorhaden | |
PriceSet_RebateLevelPrice8 | nicht mehr vorhaden | |
PriceSet_OperatingCostsPercental | OperatingCosts | |
PriceSet_ScoMinimumPrice | nicht mehr vorhaden | |
PriceSet_TollPercental | Customs | |
FreeText1-20 | ItemFreeText1-20 | |
OthersAPICondition | ItemConditionApi | |
Properties | ItemProperties | |
PropertiesWithGroups | ItemPropertiesWithGroups | |
PropertyGroups | ItemPropertyGroups | |
ParcelServicePresetIDs | ItemShippingProfiles | |
LinkedItemsItemIDs | ItemCrossSellingCrossItemIDs | |
Variant_AttributeValueIDs | Variant_AttributeValueIDs | |
Variant_FrontendAttributeName | Variant_FrontendAttributeName | |
Variant_BackendAttributeName | Variant_BackendAttributeName | |
VariantImages | in ImageUrls oder ImageUrlsMiddle oder ImageUrlsPreview | |
VariantImagesMap | nicht mehr voranden | |
AllVariantImages | nicht mehr voranden |
Inputs
Das sind die Optionen, mit denen man den Step konfigurieren kann.
Name | Datentyp | Beschreibung | Pflichtfeld | Werte | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
account | ACCOUNT | Ihre PlentyONE Verbindung | Ja | |||||||||||
limit | STRING | Limitieren Sie die Anzahl der abgerufenen Varianten | Nein | |||||||||||
lastUpdate | DATETIME | Verwenden Sie diesen Filter um alle Variaten abzurufen, die nach diesem Datum aktualisiert wurden. | Nein | |||||||||||
lastUpdateTo | DATETIME | Verwenden Sie diesen Filter um alle Variaten abzurufen, die vor diesem Datum aktualisiert wurden. | Nein | |||||||||||
createdFrom | DATETIME | Verwenden Sie diesen Filter um alle Variaten abzurufen, die nach diesem Datum erstellt wurden. | Nein | |||||||||||
createdTo | DATETIME | Verwenden Sie diesen Filter um alle Variaten abzurufen, die vor diesem Datum erstellt wurden. | Nein | |||||||||||
isActive | STRING | Verwenden Sie diesen Filter um aktive und inaktive Varianten zu filtern. | Nein |
| ||||||||||
isMain | STRING | Verwenden Sie diesen Filter Hauptvarianten zu filtern. | Nein |
| ||||||||||
childrenFilter | STRING | Filter schränkt das Ergebnis auf Varianten ein, die (aktive) Children haben. | Nein |
| ||||||||||
bundleType | STRING | Verwenden Sie diesen Filter Pakete bzw. Paketbestandteile zu filtern. | Nein |
| ||||||||||
variantId | STRING | Verwenden Sie diesen Filter um eine Varianten mit dieser ID zu filtern. Mehrere Varianten IDs können Komma-getrennt angegeben werden. | Nein | |||||||||||
variantIdSpreadsheet | SPREADSHEET | Ein SPREADSHEET, dass alle Varianten IDs enthält, die abgerufen werden sollen. | Nein | |||||||||||
variantIdMappingDefinition | STRING | Das Mapping als JSON String | Nein | |||||||||||
Folgende Felder sind zu konfigurieren:
| ||||||||||||||
itemId | STRING | Verwenden Sie diesen Filter um eine bestimmte Artikel-ID zu filtern. Mehrere IDs können durch Komma getrennt werden. Begrenzt auf max. 100 Item IDs. | Nein | |||||||||||
numberExact | STRING | Verwenden Sie diesen Filter um eine Varianten mit dieser Varianten-Nummer zu filtern. | Nein | |||||||||||
plentyID | STRING | Verwenden Sie diesen Filter um Varianten eines bestimmten Mandanten (Shops) zu filtern. Mehrere IDs können durch Komma getrennt werden. | Nein | |||||||||||
flagOne | STRING | Verwenden Sie diesen Filter um Varianten mit einer bestimmte Markierung 1 (ID) zu filtern. | Nein | |||||||||||
flagTwo | STRING | Verwenden Sie diesen Filter um Varianten mit einer bestimmte Markierung 2 (ID) zu filtern. | Nein | |||||||||||
variationTagId | STRING | Verwenden Sie diesen Filter um Varianten mit bestimmten Tags (ID) zu filtern. Mehrere Tag-IDs können Komma-getrennt angegeben werden. | Nein | |||||||||||
manufacturerId | STRING | Verwenden Sie diesen Filter um Varianten mit einen bestimmten Hersteller (ID) zu filtern. Mehrere Hersteller-IDs können Komma-getrennt angegeben werden. | Nein | |||||||||||
stockWarehouseId | STRING | Dieser Filter beschränkt das Ergebnis auf Varianten die einen physikalischen Bestand (größer 0) im angegebenen Lager haben. | Nein | |||||||||||
referrerId | STRING | Dieser Filter schränkt die Liste der Ergebnisse auf Varianten ein, die für bestimmte Märkte sichtbar sind. Trennen Sie mehr als eine Marktplatz ID durch ein Komma. In diesem Fall müssen alle Märkte an der Variante aktiv sein. | Nein | |||||||||||
additionalFields | STRINGLIST | Wählen Sie aus welche zusätzlichen Varianten-Information abgerufen werden sollen. Bitte beachten Sie, dass die entsprechenden Spalten im Ergebnis leer sind, wenn diese nicht ausgewählt wurden. Hinweis: wählen sie nur die benötigen Informationen aus um die Datenmenge (Traffic) und Laufzeiten klein zu halten. | Nein |
| ||||||||||
language | STRING | Wählen sie die Sprache aus in der Texte, Merkmal Attribute, Kategorien etc. ausgegeben werden sollen. | Nein |
| ||||||||||
enableProducerName | STRING | Diese Option ermöglicht den zusätzlichen Abruf von der Hersteller Namen. Hinweis: Aktivieren Sie den Abruf nur wenn Sie die Informationen benötigen, damit Sie die Datenmenge (Traffic) und Laufzeiten klein zu halten. | Nein |
| ||||||||||
batchSize | NUMBER | Legt die Anzahl der Varianten pro Seite / API-Aufruf fest. Verwenden sie diese Option, um festzulegen wie viele Variante pro API Call abgerufen werden. Diese Option kann verwendet werden, falls Fehler oder timeouts beim Abruf auftreten. Versuchen Sie in diesen Fällen die Anzahl der Varianten pro API Call zu verkleinern. Der maximale und der Standardwert ist 250. | Nein |
Outputs
Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.
Name | Datentyp | Beschreibung | Pflichtfeld | Werte | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
variations | SPREADSHEET | Ein SPREADSHEET mit den abgerufenen Varianten aus plentymarkets. | Ja | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Folgende Felder sind im Output enthalten:
|