PlentyAddVariations - PlentyONE

Version: REST 2.0

← PlentyONE Add-On Übersicht

Dieser Step ermöglicht den Import neuer Varianten zu Artikeln in Ihrem PlentyONE Shop.

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	Beschränken Sie die Anzahl der zu importierten Varianten. Leer lassen für unbegrenzt.	Nein
input	SPREADSHEET	A SpreadSheet containing product data updated in PlentyONE.	Ja
mappingdefinition	STRING	Die konfigurierte Zuordnung der Zielspalten.	Nein
	Folgende Felder sind zu konfigurieren: Feld Datentyp Beschreibung Pflichtfeld Standardwert ItemID SINGLE ID of item. Ja Number SINGLE The unique variation number of the variation. Nein ExternalItemID SINGLE The external variation ID of this variation. The external variation number is optional and allows importing items and variations from external systems to PlentyONE. Nein Model SINGLE The model of the variation. Value is inherited from the item's main variation if inheritance is active. Nein MainWarehouseID SINGLE The ID of the main warehouse of the variation. Nein Name SINGLE The name of the variation Nein AvailabilityID SINGLE The availability of the variation. Nein IsActive SINGLE Flag that indicates if the variation is active. Only active variations can be offered in the online store and/or on markets. Nein PurchasePrice SINGLE The net purchase price. Value e.g. is used for price calculations. Nein MovingAveragePrice SINGLE The moving average purchase price of the variation Nein VATInternalID SINGLE The ID of the VAT rate of the variation. VAT rates are created for each client (store) and linked to the variation. Nein ExtraShippingCharge1 SINGLE The extra shipping charge 1 for the variation. Extra shipping charges are useful for large or bulky items that are particularly expensive to ship. Charge 1 is added to the regular shipping costs for the first item of an order. If different variations are ordered, the extra shipping charge 1 of the variation with the highest charge 1 is selected. Nein ExtraShippingCharge2 SINGLE The extra shipping charge 2 for the variation. Extra shipping charges are useful for large or bulky items that are expensive to ship. Charge 2 is added to the shipping costs for any additional items of an order. Nein UnitsContained SINGLE The number of sales units contained in one package. Nein PalletTypeId SINGLE The ID of the pallet type Nein PackingUnits SINGLE The number of packing units if the item consists of multiple packages. Value is 0 if an item is sent as one package. All items of an order that have the value 0 will be packed into one package. Nein PackingUnitTypeId SINGLE The ID of the packing unit type Nein TransportationCosts SINGLE The net transportation costs for the variation. This value is used for price calculations and for calculating the acquisition price. Nein StorageCosts SINGLE The net storage costs for the variation Nein Customs SINGLE The customs rate in percent Nein CustomsTariffNumber SINGLE The customs tariff number of the variation; usually a 11 digit code number based on the Harmonised System Nein OperatingCosts SINGLE The operating costs for the variation in percent Nein AutomaticClientVisibility SINGLE Indicates if the variation is set as available for any clients (stores). Nein IsHiddenInCategoryList SINGLE Flag that indicates if the variation is hidden in the category list. If true, the variation will not be shown in any item category and will not be returned as a search result. The variation can only be accessed via its URL. Nein IsVisibleInListIfNetStockIsPositive SINGLE Flag that indicates if the variation is visible in the item list of the online store if net stock is positive. If true, the variation automatically becomes visible in categories, search results and item lists (store specials, cross-selling, last seen items) when the net stock changes to positive. Nein IsInvisibleInListIfNetStockIsNotPositive SINGLE Flag that indicates if the variation is invisible in the item list of the online store if net stock is not positive. If true and no net stock is available for the variation, the variation can only be opened using the direct URL. The variation is not shown in the categories, search results or item lists (store specials, cross-selling, last seen items). Nein AvailableUntil SINGLE The last date the item will be available for sale. Nein WidthMM SINGLE The width of the variation in millimetres (mm) Nein LengthMM SINGLE The length of the variation in millimeters (mm) Nein HeightMM SINGLE The height of the variation in millimetres (mm) Nein WeightG SINGLE The gross weight of the variation in gramms (g). This weight includes the packaging for variations that are packaged separately. This value is used for calculating shipping packages and weight-based shipping costs. Nein WeightNetG SINGLE The net weight of the variation in gramms (g). This is the weight of the variation without packaging. Nein MayShowUnitPrice SINGLE Display unit price in the online store Nein MaximumOrderQuantity SINGLE The maximum order quantity permitted per order. Decimal values are possible to allow orders by weight or length. Default value is 0. If value is 0, the maximum order quantity is unlimited. Nein MinimumOrderQuantity SINGLE The minimum order quantity. Decimal values are possible to allow orders by weight or length. Nein IntervalOrderQuantity SINGLE The quantity intervals the variation can be ordered in. Decimal values are possible to allow orders by weight or length. Nein PackingUnitType SINGLE The ID of the packing unit type Nein Picking SINGLE The order picking type of the variation. Nein Position SINGLE The position of the variation. Value is inherited from the item's main variation if inheritance is active. Nein EstimatedAvailableAt SINGLE The estimated delivery date of variations on reorder. Nein PriceCalculationId SINGLE The ID of the price calculation linked to the variation. Nein StockLimitation SINGLE The stock limitation for the variation. Nein IsVisibleIfNetStockIsPositive SINGLE Flag that indicates if the variation is visible in the online store if net stock is positive. If true, the variation automatically becomes visible when the net stock changes to positive. Nein IsInvisibleIfNetStockIsNotPositive SINGLE Flag that indicates if the variation is invisible in the online store if net stock is not positive. If true, the variation automatically becomes invisible when the net stock changes to 0 or negative. Nein IsAvailableIfNetStockIsPositive SINGLE Flag that indicates if the variation is unavailable in the online store if net stock is not positive. If true, the variation automatically becomes available when the net stock changes to 0 or negative. Nein IsUnavailableIfNetStockIsNotPositive SINGLE The release date of the variation. This is the date on which the variation will become available. The variation can be visible in the online store before this date, e.g. for preorders. Nein ReleasedAt SINGLE The release date of the variation. This is the date on which the variation will become available. The variation can be visible in the online store before this date, e.g. for preorders. Nein UnitID SINGLE The id of the unit Ja 1 UnitContent SINGLE The content of the unit Ja 1 SalesPrices MAP Enter prices as map (PriceID=PriceValue;... e.g. 1=131.23;2=34.46) Nein AttributeValues MULTIPLEVALUE Enter attribute value ids as semicolon separated list (e.g. 23;46) Nein AttributeValuesString MAP Enter attribute values as map of attribute backendname and attribute value backendname(e.g. Size=XL;Color=red) Nein ClientIDs MULTIPLEVALUE Enter ClientIDs (PlentyIDs) as semicolon separated list (e.g. 23241;32412) Nein MarketIDs MULTIPLEVALUE Enter MarketIDs as semicolon separated list (e.g. 4.01;4.12) Nein CategoryID SINGLE Category is required to create new Variations. Please enter at least a Category ID or Path to create new Variations. Nein CategoryPath MULTIPLEVALUE Category is required to create new Variations. Please enter at least a Category ID or Path to create new Variations. Nein Barcodes MAP Enter barcodes as map (BarcodeID=CodeValue;... e.g. 1=1243123;2=3446) Nein VariationTagIDs MULTIPLEVALUE Enter TagIDs as semicolon separated list (e.g. 4;12) Nein
attributeMode	STRING	Wählen Sie den Modus für die automatische Erstellung von Attributen und Attributwerten (Spalte 'AttributeValuesString').	Nein	Deaktiviert Nur neue Attributwerte erstellen Anlegen neuer Attribute und Werte
defaultLanguage	STRING	Setzen Sie die Standardsprache der Kategorien...	Nein	Deutsch Englisch Französisch Italienisch Spanisch Türkisch Niederländisch Polnisch Norwegisch Dänisch Schwedisch Tschechisch Russisch Slowakisch Chinesisch Vietnamesisch Portugiesisch Bulgarisch Rumänisch Kroatisch Estnisch Ungarisch Litauisch Lettisch Finnisch Irisch
batchSize	NUMBER	Mit dieser Anzahl legen Sie fest, wie viele Varianten pro Aufruf (API Call) erstellt. Dies ist oft nützlich, um z.B. 50 Varianten pro Aufruf zu erstellen und damit die Anzahl der API-Aufrufe zu reduzieren. Beispiel: Angenommen, Sie haben 112 Zeilen in Ihrem input Spreadsheet: Wenn batchSize=1 ist, werden 112 API Calls ausgeführt (ein Aufruf pro Variante). Wenn batchSize=50, dann werden 3 Calls ausgeführt (1. und 2. Call: 50 Varianten, 3. Call: 12 Varianten). Hinweis: Tritt bei der Erstellung einer Variante eines Batch-Calls ein Fehler auf, wird keine der Varianten aus diesem Batch erstellt.	Ja

Outputs

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

Name	Datentyp	Beschreibung	Werte
results	SPREADSHEET	Ein SPREADSHEET, das die Ergebnisse des Imports enthält.
	Folgende Felder sind im Output enthalten: Feld Datentyp Beschreibung Standardwert identifier SINGLE The identifier column to import Spreadsheet into a Datastore. VariantID SINGLE VariantID of created variation. ItemID SINGLE ID of item. parent_identifier SINGLE The parent_identifier column to import Spreadsheet into a Datastore. MainVariantID SINGLE VariantID of main variation. Number SINGLE The unique variation number of the variation. ExternalItemID SINGLE The external variation ID of this variation. The external variation number is optional and allows importing items and variations from external systems to PlentyONE. Model SINGLE The model of the variation. Value is inherited from the item's main variation if inheritance is active. MainWarehouseID SINGLE The ID of the main warehouse of the variation. Name SINGLE The name of the variation AvailabilityID SINGLE The availability of the variation. IsActive SINGLE Flag that indicates if the variation is active. Only active variations can be offered in the online store and/or on markets. PurchasePrice SINGLE The net purchase price. Value e.g. is used for price calculations. MovingAveragePrice SINGLE The moving average purchase price of the variation VATInternalID SINGLE The ID of the VAT rate of the variation. VAT rates are created for each client (store) and linked to the variation. ExtraShippingCharge1 SINGLE The extra shipping charge 1 for the variation. Extra shipping charges are useful for large or bulky items that are particularly expensive to ship. Charge 1 is added to the regular shipping costs for the first item of an order. If different variations are ordered, the extra shipping charge 1 of the variation with the highest charge 1 is selected. ExtraShippingCharge2 SINGLE The extra shipping charge 2 for the variation. Extra shipping charges are useful for large or bulky items that are expensive to ship. Charge 2 is added to the shipping costs for any additional items of an order. UnitsContained SINGLE The number of sales units contained in one package. PalletTypeId SINGLE The ID of the pallet type PackingUnits SINGLE The number of packing units if the item consists of multiple packages. Value is 0 if an item is sent as one package. All items of an order that have the value 0 will be packed into one package. PackingUnitTypeId SINGLE The ID of the packing unit type TransportationCosts SINGLE The net transportation costs for the variation. This value is used for price calculations and for calculating the acquisition price. StorageCosts SINGLE The net storage costs for the variation Customs SINGLE The customs rate in percent CustomsTariffNumber SINGLE The customs tariff number of the variation; usually a 11 digit code number based on the Harmonised System OperatingCosts SINGLE The operating costs for the variation in percent AutomaticClientVisibility SINGLE Indicates if the variation is set as available for any clients (stores). IsHiddenInCategoryList SINGLE Flag that indicates if the variation is hidden in the category list. If true, the variation will not be shown in any item category and will not be returned as a search result. The variation can only be accessed via its URL. IsVisibleInListIfNetStockIsPositive SINGLE Flag that indicates if the variation is visible in the item list of the online store if net stock is positive. If true, the variation automatically becomes visible in categories, search results and item lists (store specials, cross-selling, last seen items) when the net stock changes to positive. IsInvisibleInListIfNetStockIsNotPositive SINGLE Flag that indicates if the variation is invisible in the item list of the online store if net stock is not positive. If true and no net stock is available for the variation, the variation can only be opened using the direct URL. The variation is not shown in the categories, search results or item lists (store specials, cross-selling, last seen items). AvailableUntil SINGLE The last date the item will be available for sale. WidthMM SINGLE The width of the variation in millimetres (mm) LengthMM SINGLE The length of the variation in millimeters (mm) HeightMM SINGLE The height of the variation in millimetres (mm) WeightG SINGLE The gross weight of the variation in gramms (g). This weight includes the packaging for variations that are packaged separately. This value is used for calculating shipping packages and weight-based shipping costs. WeightNetG SINGLE The net weight of the variation in gramms (g). This is the weight of the variation without packaging. MayShowUnitPrice SINGLE Display unit price in the online store MaximumOrderQuantity SINGLE The maximum order quantity permitted per order. Decimal values are possible to allow orders by weight or length. Default value is 0. If value is 0, the maximum order quantity is unlimited. MinimumOrderQuantity SINGLE The minimum order quantity. Decimal values are possible to allow orders by weight or length. IntervalOrderQuantity SINGLE The quantity intervals the variation can be ordered in. Decimal values are possible to allow orders by weight or length. PackingUnitType SINGLE The ID of the packing unit type Picking SINGLE The order picking type of the variation. Position SINGLE The position of the variation. Value is inherited from the item's main variation if inheritance is active. EstimatedAvailableAt SINGLE The estimated delivery date of variations on reorder. PriceCalculationId SINGLE The ID of the price calculation linked to the variation. StockLimitation SINGLE The stock limitation for the variation. IsVisibleIfNetStockIsPositive SINGLE Flag that indicates if the variation is visible in the online store if net stock is positive. If true, the variation automatically becomes visible when the net stock changes to positive. IsInvisibleIfNetStockIsNotPositive SINGLE Flag that indicates if the variation is invisible in the online store if net stock is not positive. If true, the variation automatically becomes invisible when the net stock changes to 0 or negative. IsAvailableIfNetStockIsPositive SINGLE Flag that indicates if the variation is unavailable in the online store if net stock is not positive. If true, the variation automatically becomes available when the net stock changes to 0 or negative. IsUnavailableIfNetStockIsNotPositive SINGLE The release date of the variation. This is the date on which the variation will become available. The variation can be visible in the online store before this date, e.g. for preorders. ReleasedAt SINGLE The release date of the variation. This is the date on which the variation will become available. The variation can be visible in the online store before this date, e.g. for preorders. UnitID SINGLE The id of the unit 1 UnitContent SINGLE The content of the unit 1