PlentyAddItems - PlentyONE

Version: REST 1.0

← PlentyONE Add-On Übersicht

Mit diesem Step können Sie in PlentyONE Items (sog. Hauptvariante) anlegen.

• Artikel > je nach zu setzenden Feldern
• tag > create
• tag > delete
• tag > update
• tagRelationship > create
• tagRelationship > delete
• tagRelationship > update

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	Das Limit begrenzt die Anzahl der anzulegenden Artikel auf den angegebenen Wert. Leer für unbeschränkt.	Nein
productSpreadsheet	SPREADSHEET	Das Eingangs-SPREADSHEET mit Artikeldaten die importiert werden sollen	Ja
mappingdefinition	STRING	Die konfigurierte Zuordnung	Nein
	Folgende Felder sind zu konfigurieren: Feld Datentyp Beschreibung Pflichtfeld Standardwert ItemID SINGLE The ID of the item. The ID must be unique. Nein ItemTextName1 SINGLE The default name of the item. By default, this name is displayed in the online store. For Default items, this name is also used for markets. Character limit: max. 240 characters. Nein ItemTextName2 SINGLE Alternative item name that can be used e.g. for markets. Character limit: max. 240 characters Nein ItemTextName3 SINGLE Alternative item name that can be used e.g. for markets. Character limit: max. 240 characters Nein ItemTextShortDescription SINGLE The preview text of the item. This short description text can be displayed as a teaser in item lists. Nein ItemTextMetaDescription SINGLE The meta description of the item. This description is analysed by search engines and displayed in search results. This text should be treated as an advertising text to maximise click-through from search engine result pages. Nein ItemTextDescription SINGLE The detailed description of the item. Nein ItemTextTechnicalData SINGLE Technical data of the item. Nein ItemTextKeywords SINGLE HTML meta keywords to tag the item for search engines. More than one keyword can be separated by commas. Nein ItemTextUrlPath SINGLE The item's URL path in the online store. By default, the URL path consists of the categories and the item name. The path is assigned automatically when the item is created and is displayed as part of the URL when the item is selected in the online store. Nein ItemTextLang SINGLE The language of the item text. Nein MainVariantNumber SINGLE The unique variation number of the variation. Nein MainVariantExternalItemID 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 MainVariantModel SINGLE The model of the variation. Value is inherited from the item's main variation if inheritance is active. Nein MainVariantMainWarehouseID SINGLE The ID of the main warehouse of the variation. Nein MainVariantName SINGLE The name of the variation Nein MainVariantAvailabilityID SINGLE The availability of the variation. Nein MainVariantIsActive SINGLE Flag that indicates if the variation is active. Only active variations can be offered in the online store and/or on markets. Nein MainVariantPurchasePrice SINGLE The net purchase price. Value e.g. is used for price calculations. Nein MainVariantVATInternalID SINGLE The ID of the VAT rate of the variation. VAT rates are created for each client (store) and linked to the variation. Nein MainVariantExtraShippingCharge1 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 MainVariantExtraShippingCharge2 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 MainVariantUnitsContained SINGLE The number of sales units contained in one package. Nein MainVariantPalletTypeId SINGLE The ID of the pallet type Nein MainVariantPackingUnits 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 MainVariantPackingUnitTypeId SINGLE The ID of the packing unit type Nein MainVariantTransportationCosts SINGLE The net transportation costs for the variation. This value is used for price calculations and for calculating the acquisition price. Nein MainVariantStorageCosts SINGLE The net storage costs for the variation Nein MainVariantCustoms SINGLE The customs rate in percent Nein MainVariantCustomsTariffNumber SINGLE The customs tariff number of the variation; usually a 11 digit code number based on the Harmonised System Nein MainVariantOperatingCosts SINGLE The operating costs for the variation in percent Nein MainVariantAutomaticClientVisibility SINGLE Indicates if the variation is set as available for any clients (stores). Nein MainVariantIsHiddenInCategoryList 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 MainVariantIsVisibleInListIfNetStockIsPositive 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 MainVariantIsInvisibleInListIfNetStockIsNotPositive 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 MainVariantAvailableUntil SINGLE The last date the item will be available for sale. Nein MainVariantWidthMM SINGLE The width of the variation in millimetres (mm) Nein MainVariantLengthMM SINGLE The length of the variation in millimeters (mm) Nein MainVariantHeightMM SINGLE The height of the variation in millimetres (mm) Nein MainVariantWeightG 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 MainVariantWeightNetG SINGLE The net weight of the variation in gramms (g). This is the weight of the variation without packaging. Nein MainVariantMayShowUnitPrice SINGLE Display unit price in the online store Nein MainVariantMaximumOrderQuantity 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 MainVariantMinimumOrderQuantity SINGLE The minimum order quantity. Decimal values are possible to allow orders by weight or length. Nein MainVariantIntervalOrderQuantity SINGLE The quantity intervals the variation can be ordered in. Decimal values are possible to allow orders by weight or length. Nein MainVariantPicking SINGLE The order picking type of the variation. Nein MainVariantPosition SINGLE The position of the variation. Value is inherited from the item's main variation if inheritance is active. Nein MainVariantEstimatedAvailableAt SINGLE The estimated delivery date of variations on reorder. Nein MainVariantPriceCalculationId SINGLE The ID of the price calculation linked to the variation. Nein MainVariantStockLimitation SINGLE The stock limitation for the variation. Nein MainVariantIsVisibleIfNetStockIsPositive 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 MainVariantIsInvisibleIfNetStockIsNotPositive 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 MainVariantIsAvailableIfNetStockIsPositive 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 MainVariantIsUnavailableIfNetStockIsNotPositive 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 MainVariantReleasedAt 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 MainVariantUnitID SINGLE The id of the unit Ja 1 MainVariantUnitContent SINGLE The content of the unit Ja 1 MainVariantCategoryID SINGLE Category is required to create new Variations. Please enter at least a Category ID or Path to create new Variations. Nein MainVariantCategoryPath MULTIPLEVALUE Category is required to create new Variations. Please enter at least a Category ID or Path to create new Variations. Nein MainVariantBarcodes MAP Enter barcodes as map (BarcodeID=CodeValue;... e.g. 1=1243123;2=3446) Nein MainVariantSalesPrices MAP Enter prices as map (PriceID=PriceValue;... e.g. 1=131.23;2=34.46) Nein MainVariantAttributeValues MULTIPLEVALUE Enter attribute value ids as semicolon separated list (e.g. 23;46) Nein MainVariantAttributeValuesString MAP Enter attribute values as map of attribute backendname and attribute value backendname(e.g. Size=XL;Color=red) Nein MainVariantClientIDs MULTIPLEVALUE Plenty ids of mandants Nein MainVariantMarketIDs MULTIPLEVALUE Nein ProducerID SINGLE The ID of the manufacturer of the item. Nein ProducerName SINGLE The manufacturer name of the item. Nein Marking1ID SINGLE Flag 1 of the item. Nein Marking2ID SINGLE Flag 2 of the item. Nein StockType SINGLE The stock type of the item. Nein StoreSpecial SINGLE Option to present items more prominently in the online store. Nein Condition SINGLE The condition of the item. Nein FreeText1 SINGLE The content of the free text field 1. Nein FreeText2 SINGLE The content of the free text field 2. Nein FreeText3 SINGLE The content of the free text field 3. Nein FreeText4 SINGLE The content of the free text field 4. Nein FreeText5 SINGLE The content of the free text field 5. Nein FreeText6 SINGLE The content of the free text field 6. Nein FreeText7 SINGLE The content of the free text field 7. Nein FreeText8 SINGLE The content of the free text field 8. Nein FreeText9 SINGLE The content of the free text field 9. Nein FreeText10 SINGLE The content of the free text field 10. Nein FreeText11 SINGLE The content of the free text field 11. Nein FreeText12 SINGLE The content of the free text field 12. Nein FreeText13 SINGLE The content of the free text field 13. Nein FreeText14 SINGLE The content of the free text field 14. Nein FreeText15 SINGLE The content of the free text field 15. Nein FreeText16 SINGLE The content of the free text field 16. Nein FreeText17 SINGLE The content of the free text field 17. Nein FreeText18 SINGLE The content of the free text field 18. Nein FreeText19 SINGLE The content of the free text field 19. Nein FreeText20 SINGLE The content of the free text field 20. Nein IsShippableByAmazon SINGLE Flag that indicates if a shipping package is to be used for this item. Nein Position SINGLE The position of the item Nein OwnerId SINGLE The PlentyONE user that is assigned as owner of this item. Nein ProducingCountryID SINGLE The ID of the country in which the item was manufactured. Nein RevenueAccount SINGLE The revenue account the item is linked to. An individual revenue account can be saved for each item in plentymarkets. If this is not done, PlentyONE automatically determines a revenue account based on the VAT rate. Nein CouponRestriction SINGLE Indicates if the item can be purchased using a promotional coupon. Nein ConditionApi SINGLE The condition of the item that is transferred to markets via API. Nein IsSubscribable SINGLE Flag that indicates if the item can be ordered as a subscription item. If yes, the item can be ordered for delivery at regular intervals. Nein AmazonFbaPlatform SINGLE Indicates the platform used for Fulfilment by Amazon (FBA). Nein AmazonProductType SINGLE The Amazon product type of the item. Nein AmazonFedas SINGLE The FEDAS product classification key of the item. Nein EbayPresetId SINGLE The eBay preset ID. Nein EbayCategory SINGLE The eBay category 1 of the item. This category is used when a new listing is created. Nein EbayCategory2 SINGLE The eBay category 2 of the item. This category is used when a new listing is created. Nein EbayStoreCategory SINGLE The ID of the eBay store category 1 of the item. This value is used for new listings. Nein EbayStoreCategory2 SINGLE The ID of the eBay store category 2 of the item. This value is used for new listings. Nein RakutenCategoryId SINGLE The ID of the Rakuten category of this item. Nein AgeRestriction SINGLE The age customers must be to purchase the item. Items with an age rating of 18+ must be linked to a shipping profile for which the PostIdent option is activated. Nein Feedback SINGLE The feedback, i.e. rating, that this item received. Possible values are 1 to 5 or 1 to 10 depending on the maximum rating setting. An initial feedback can be saved for items. The saved value will then be displayed as the initial feedback. Nein ItemShippingProfiles MULTIPLEVALUE All active shipping profiles as semicolon (;) separated list Nein
autoCreateManufacturers	STRING	Diese Option ermöglicht das automatische Anlegen von Herstellern wenn diese noch nicht vorhanden sind (Zielspalte 'ProducerName' ).	Nein	Ja Nein
attributeMode	STRING	Wählen Sie einen Modus für die automatische Erstellung von Attributen und Attributwerten aus (Zielspalte 'MainVariantAttributeValuesString').	Nein	Inaktiv Nur neue Attributwerte anlegen Neue Attribute und Attributwerte automatisch anlegen
defaultLanguage	STRING	Wählen Sie die Sprache für Texte, Kategorien, etc.	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	Werte
results	SPREADSHEET	Ein SPREADSHEET mit den Daten der importierten Artikel bzw. Hauptvarianten
	Folgende Felder sind im Output enthalten: Feld Datentyp Beschreibung Standardwert identifier SINGLE The identifier column to import Spreadsheet into a Datastore. ItemID SINGLE The ID of the item. The ID must be unique. ItemTextName1 SINGLE The default name of the item. By default, this name is displayed in the online store. For Default items, this name is also used for markets. Character limit: max. 240 characters. ItemTextName2 SINGLE Alternative item name that can be used e.g. for markets. Character limit: max. 240 characters ItemTextName3 SINGLE Alternative item name that can be used e.g. for markets. Character limit: max. 240 characters ItemTextShortDescription SINGLE The preview text of the item. This short description text can be displayed as a teaser in item lists. ItemTextMetaDescription SINGLE The meta description of the item. This description is analysed by search engines and displayed in search results. This text should be treated as an advertising text to maximise click-through from search engine result pages. ItemTextDescription SINGLE The detailed description of the item. ItemTextTechnicalData SINGLE Technical data of the item. ItemTextKeywords SINGLE HTML meta keywords to tag the item for search engines. More than one keyword can be separated by commas. ItemTextUrlPath SINGLE The item's URL path in the online store. By default, the URL path consists of the categories and the item name. The path is assigned automatically when the item is created and is displayed as part of the URL when the item is selected in the online store. ItemTextLang SINGLE The language of the item text. MainVariantID SINGLE MainVariantNumber SINGLE The unique variation number of the variation. MainVariantExternalItemID 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. MainVariantModel SINGLE The model of the variation. Value is inherited from the item's main variation if inheritance is active. MainVariantMainWarehouseID SINGLE The ID of the main warehouse of the variation. MainVariantName SINGLE The name of the variation MainVariantAvailabilityID SINGLE The availability of the variation. MainVariantIsActive SINGLE Flag that indicates if the variation is active. Only active variations can be offered in the online store and/or on markets. MainVariantPurchasePrice SINGLE The net purchase price. Value e.g. is used for price calculations. MainVariantVATInternalID SINGLE The ID of the VAT rate of the variation. VAT rates are created for each client (store) and linked to the variation. MainVariantExtraShippingCharge1 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. MainVariantExtraShippingCharge2 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. MainVariantUnitsContained SINGLE The number of sales units contained in one package. MainVariantPalletTypeId SINGLE The ID of the pallet type MainVariantPackingUnits 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. MainVariantPackingUnitTypeId SINGLE The ID of the packing unit type MainVariantTransportationCosts SINGLE The net transportation costs for the variation. This value is used for price calculations and for calculating the acquisition price. MainVariantStorageCosts SINGLE The net storage costs for the variation MainVariantCustoms SINGLE The customs rate in percent MainVariantCustomsTariffNumber SINGLE The customs tariff number of the variation; usually a 11 digit code number based on the Harmonised System MainVariantOperatingCosts SINGLE The operating costs for the variation in percent MainVariantAutomaticClientVisibility SINGLE Indicates if the variation is set as available for any clients (stores). MainVariantIsHiddenInCategoryList 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. MainVariantIsVisibleInListIfNetStockIsPositive 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. MainVariantIsInvisibleInListIfNetStockIsNotPositive 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). MainVariantAvailableUntil SINGLE The last date the item will be available for sale. MainVariantWidthMM SINGLE The width of the variation in millimetres (mm) MainVariantLengthMM SINGLE The length of the variation in millimeters (mm) MainVariantHeightMM SINGLE The height of the variation in millimetres (mm) MainVariantWeightG 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. MainVariantWeightNetG SINGLE The net weight of the variation in gramms (g). This is the weight of the variation without packaging. MainVariantMayShowUnitPrice SINGLE Display unit price in the online store MainVariantMaximumOrderQuantity 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. MainVariantMinimumOrderQuantity SINGLE The minimum order quantity. Decimal values are possible to allow orders by weight or length. MainVariantIntervalOrderQuantity SINGLE The quantity intervals the variation can be ordered in. Decimal values are possible to allow orders by weight or length. MainVariantPicking SINGLE The order picking type of the variation. MainVariantPosition SINGLE The position of the variation. Value is inherited from the item's main variation if inheritance is active. MainVariantEstimatedAvailableAt SINGLE The estimated delivery date of variations on reorder. MainVariantPriceCalculationId SINGLE The ID of the price calculation linked to the variation. MainVariantStockLimitation SINGLE The stock limitation for the variation. MainVariantIsVisibleIfNetStockIsPositive 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. MainVariantIsInvisibleIfNetStockIsNotPositive 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. MainVariantIsAvailableIfNetStockIsPositive 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. MainVariantIsUnavailableIfNetStockIsNotPositive 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. MainVariantReleasedAt 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. MainVariantUnitID SINGLE The id of the unit 1 MainVariantUnitContent SINGLE The content of the unit 1 ProducerID SINGLE The ID of the manufacturer of the item. ProducerName SINGLE The manufacturer name of the item. Marking1ID SINGLE Flag 1 of the item. Marking2ID SINGLE Flag 2 of the item. StockType SINGLE The stock type of the item. StoreSpecial SINGLE Option to present items more prominently in the online store. Condition SINGLE The condition of the item. FreeText1 SINGLE The content of the free text field 1. FreeText2 SINGLE The content of the free text field 2. FreeText3 SINGLE The content of the free text field 3. FreeText4 SINGLE The content of the free text field 4. FreeText5 SINGLE The content of the free text field 5. FreeText6 SINGLE The content of the free text field 6. FreeText7 SINGLE The content of the free text field 7. FreeText8 SINGLE The content of the free text field 8. FreeText9 SINGLE The content of the free text field 9. FreeText10 SINGLE The content of the free text field 10. FreeText11 SINGLE The content of the free text field 11. FreeText12 SINGLE The content of the free text field 12. FreeText13 SINGLE The content of the free text field 13. FreeText14 SINGLE The content of the free text field 14. FreeText15 SINGLE The content of the free text field 15. FreeText16 SINGLE The content of the free text field 16. FreeText17 SINGLE The content of the free text field 17. FreeText18 SINGLE The content of the free text field 18. FreeText19 SINGLE The content of the free text field 19. FreeText20 SINGLE The content of the free text field 20. IsShippableByAmazon SINGLE Flag that indicates if a shipping package is to be used for this item. Position SINGLE The position of the item OwnerId SINGLE The PlentyONE user that is assigned as owner of this item. ProducingCountryID SINGLE The ID of the country in which the item was manufactured. RevenueAccount SINGLE The revenue account the item is linked to. An individual revenue account can be saved for each item in plentymarkets. If this is not done, PlentyONE automatically determines a revenue account based on the VAT rate. CouponRestriction SINGLE Indicates if the item can be purchased using a promotional coupon. ConditionApi SINGLE The condition of the item that is transferred to markets via API. IsSubscribable SINGLE Flag that indicates if the item can be ordered as a subscription item. If yes, the item can be ordered for delivery at regular intervals. AmazonFbaPlatform SINGLE Indicates the platform used for Fulfilment by Amazon (FBA). AmazonProductType SINGLE The Amazon product type of the item. AmazonFedas SINGLE The FEDAS product classification key of the item. EbayPresetId SINGLE The eBay preset ID. EbayCategory SINGLE The eBay category 1 of the item. This category is used when a new listing is created. EbayCategory2 SINGLE The eBay category 2 of the item. This category is used when a new listing is created. EbayStoreCategory SINGLE The ID of the eBay store category 1 of the item. This value is used for new listings. EbayStoreCategory2 SINGLE The ID of the eBay store category 2 of the item. This value is used for new listings. RakutenCategoryId SINGLE The ID of the Rakuten category of this item. AgeRestriction SINGLE The age customers must be to purchase the item. Items with an age rating of 18+ must be linked to a shipping profile for which the PostIdent option is activated. Feedback SINGLE The feedback, i.e. rating, that this item received. Possible values are 1 to 5 or 1 to 10 depending on the maximum rating setting. An initial feedback can be saved for items. The saved value will then be displayed as the initial feedback. ItemShippingProfiles MULTIPLEVALUE All active shipping profiles as semicolon (;) separated list