PlentyAddVariations Step

• Version: REST 1.0
• Add-On

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
productSpreadsheet	SPREADSHEET	Das Eingangs-SPREADSHEET, das die zu importierenden Variantendaten enthält.	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 CategoryVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Categories are not inherited from the main variation.ID of the item’s main variation = Inheritance of categories is active. optional Nein MarketVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Markets are not inherited from the main variation.ID of the item’s main variation = Inheritance of markets is active. optional Nein ClientVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Clients (stores) are not inherited from the main variation.ID of the item’s main variation = Inheritance of clients (stores) is active. optional Nein SalesPriceVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Sales prices are not inherited from the main variation.ID of the item’s main variation = Inheritance of sales prices is active. optional Nein SupplierVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Suppliers are not inherited from the main variation.ID of the item’s main variation = Inheritance of suppliers is active. optional Nein WarehouseVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Warehouses are not inherited from the main variation.ID of the item’s main variation = Inheritance of warehouses is active. optional Nein UnitID SINGLE The id of the unit Ja 1 UnitContent SINGLE The content of the unit Ja 1 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 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
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

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, das die Ergebnisse des Imports enthält.	Ja
	Folgende Felder sind im Output enthalten: Feld Datentyp Beschreibung Pflichtfeld Standardwert ItemID SINGLE ID of item. Ja identifier SINGLE The identifier column to import Spreadsheet into a Datastore. Nein VariantID SINGLE VariantID of created variation. Nein parent_identifier SINGLE The parent_identifier column to import Spreadsheet into a Datastore. Nein MainVariantID SINGLE VariantID of main variation. Nein 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 CategoryVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Categories are not inherited from the main variation.ID of the item’s main variation = Inheritance of categories is active. optional Nein MarketVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Markets are not inherited from the main variation.ID of the item’s main variation = Inheritance of markets is active. optional Nein ClientVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Clients (stores) are not inherited from the main variation.ID of the item’s main variation = Inheritance of clients (stores) is active. optional Nein SalesPriceVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Sales prices are not inherited from the main variation.ID of the item’s main variation = Inheritance of sales prices is active. optional Nein SupplierVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Suppliers are not inherited from the main variation.ID of the item’s main variation = Inheritance of suppliers is active. optional Nein WarehouseVariationId SINGLE Either the ID of the variation or the ID of the item’s main variation. No other values are permitted.ID of the variation = Warehouses are not inherited from the main variation.ID of the item’s main variation = Inheritance of warehouses is active. optional Nein UnitID SINGLE The id of the unit Ja 1 UnitContent SINGLE The content of the unit Ja 1