PlentyUpdateVariations Step

• Version: REST 1.0
• Add-On

  ---

Aktualisieren Sie Varianten in Ihrem plentymarkets Shop.

Inputs

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

Name	Datentyp	Beschreibung	Pflichtfeld	Werte
account	ACCOUNT	Ihre plentymarkets 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 plentymarkets. 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 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 plentymarkets 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 plentymarkets. 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 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 plentymarkets backend: Settings / Orders / Shipping / Order referrer Nein TagIDs MULTIPLEVALUE List of tag ids which will be added to variation. Nein