Skip to content

PlentyUpdateVariations - PlentyONE

Version: REST 1.0

← PlentyONE Add-On Übersicht

Aktualisieren Sie Varianten 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 Varianten, die aktualisiert werden sollen. Leer lassen für unbegrenzt. Nein
productSpreadsheet SPREADSHEET Eine Spreadsheet, dass die in Variantendaten enthält. Ja
mappingdefinition STRING Die Mapping-Definition JSON-String Nein
Folgende Felder sind zu konfigurieren :

Feld Datentyp Beschreibung Pflichtfeld Standardwert
VariantID SINGLE The ID of the variation. 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. 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
DefaultShippingCosts SINGLE The default shipping costs for the variation. Nein
MayShowUnitPrice SINGLE Display unit price in the online store 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
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
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
MaximumOrderQuantity SINGLE The maximum order quantity permitted per order. Decimal values are possible to allow orders by weight or length. 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
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 available in the online store if net stock is positive. If true, the variation automatically becomes available when the net stock changes to positive. Nein
IsUnavailableIfNetStockIsNotPositive 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
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
UnitCombinationID SINGLE Nein
ClientIDs MULTIPLEVALUE A list of the plenty ids (clients store ids) of the variation. Nein
MarketIDs MULTIPLEVALUE A list of market ids of the variation. See PlentyONE backend: Settings / Orders / Shipping / Order referrer Nein
RemoveClientIDs MULTIPLEVALUE A list of plenty Ids (clients store ids) to be removed from variation Nein
RemoveMarketIDs MULTIPLEVALUE A list of market ids to be removed from variation Nein
TagIDs MULTIPLEVALUE List of tag ids which will be added to variation. Nein
RemoveTagIDs MULTIPLEVALUE A list of tag ids to be removed from variation Nein
marketLinksMode STRING Marktplatz Verknüpfungen hinzufügen oder alle alten Marktplatz Verknüpfungen entfernen Nein
  • Marktplatz Verknüpfungen hinzufügen
  • Marktplatz Verknüpfungen entfernen
  • Marktverknüpfungen nach Spalte entfernen

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, dass die Ergebnisse der Aktualisierung enthält. Ja
Folgende Felder sind im Output enthalten :

Feld Datentyp Beschreibung Pflichtfeld Standardwert
ItemID SINGLE The ID of the item that this variation belongs to. Nein
identifier SINGLE The identifier column to import Spreadsheet into a Datastore. Nein
VariantID SINGLE The ID of the variation. Ja
MainVariantID SINGLE The variation ID of the item's 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. 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
DefaultShippingCosts SINGLE The default shipping costs for the variation. Nein
MayShowUnitPrice SINGLE Display unit price in the online store 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
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
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
MaximumOrderQuantity SINGLE The maximum order quantity permitted per order. Decimal values are possible to allow orders by weight or length. 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
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 available in the online store if net stock is positive. If true, the variation automatically becomes available when the net stock changes to positive. Nein
IsUnavailableIfNetStockIsNotPositive 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
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
UnitCombinationID SINGLE Nein
UnitID SINGLE The id of the unit. Nein
UnitContent SINGLE The content of the unit Nein
ClientIDs MULTIPLEVALUE A list of the plenty ids (clients store ids) of the variation. Nein
MarketIDs MULTIPLEVALUE A list of market ids of the variation. See PlentyONE backend: Settings / Orders / Shipping / Order referrer Nein
TagIDs MULTIPLEVALUE List of tag ids which will be added to variation. Nein