| Field |
Description |
Type |
Required |
Default-Value |
| ItemID |
|
Integer |
|
|
| ItemTextName1 |
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. |
Text
|
|
|
| ItemTextName2 |
Alternative item name that can be used e.g. for markets. Character limit: max. 240 characters |
Text
|
|
|
| ItemTextName3 |
Alternative item name that can be used e.g. for markets. Character limit: max. 240 characters |
Text
|
|
|
| ItemTextShortDescription |
The preview text of the item. This short description text can be displayed as a teaser in item lists. |
Text
|
|
|
| ItemTextMetaDescription |
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. |
Text
|
|
|
| ItemTextDescription |
The detailed description of the item. |
Text
|
|
|
| ItemTextTechnicalData |
Technical data of the item. |
Text
|
|
|
| ItemTextKeywords |
HTML meta keywords to tag the item for search engines. More than one keyword can be separated by commas. |
Text
|
|
|
| ItemTextUrlPath |
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. |
Text
|
|
|
| ItemTextLang |
The language of the item text. |
Text
|
|
|
| MainVariantNumber |
The unique variation number of the variation. |
Text
|
|
|
| MainVariantExternalItemID |
The external variation ID of this variation. The external variation number is optional and allows importing items and variations from external systems to plentymarkets. |
Text
|
|
|
| MainVariantModel |
The model of the variation. Value is inherited from the item's main variation if inheritance is active. |
Text
|
|
|
| MainVariantMainWarehouseID |
The ID of the main warehouse of the variation. |
Integer |
|
|
| MainVariantName |
The name of the variation |
Text
|
|
|
| MainVariantAvailabilityID |
The availability of the variation.
Show allowed values |
Integer |
|
|
| MainVariantIsActive |
Flag that indicates if the variation is active. Only active variations can be offered in the online store and/or on markets. |
Decimal |
|
|
| MainVariantPurchasePrice |
The net purchase price. Value e.g. is used for price calculations. |
Decimal |
|
|
| MainVariantVATInternalID |
The ID of the VAT rate of the variation. VAT rates are created for each client (store) and linked to the variation. |
Integer |
|
|
| MainVariantExtraShippingCharge1 |
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. |
Decimal |
|
|
| MainVariantExtraShippingCharge2 |
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. |
Decimal |
|
|
| MainVariantUnitsContained |
The number of sales units contained in one package. |
Integer |
|
|
| MainVariantPalletTypeId |
The ID of the pallet type |
Integer |
|
|
| MainVariantPackingUnits |
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. |
Integer |
|
|
| MainVariantPackingUnitTypeId |
The ID of the packing unit type |
Integer |
|
|
| MainVariantTransportationCosts |
The net transportation costs for the variation. This value is used for price calculations and for calculating the acquisition price. |
Decimal |
|
|
| MainVariantStorageCosts |
The net storage costs for the variation |
Decimal |
|
|
| MainVariantCustoms |
The customs rate in percent |
Decimal |
|
|
| MainVariantOperatingCosts |
The operating costs for the variation in percent |
Decimal |
|
|
| MainVariantAutomaticClientVisibility |
The ID of the packing unit type
Show allowed values- Variation is not available in any client (store). (0)
- Variation is available in at least one client (store). (1)
|
Integer |
|
|
| MainVariantIsHiddenInCategoryList |
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. |
Decimal |
|
|
| MainVariantIsVisibleInListIfNetStockIsPositive |
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. |
Decimal |
|
|
| MainVariantIsInvisibleInListIfNetStockIsNotPositive |
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). |
Decimal |
|
|
| MainVariantAvailableUntil |
The last date the item will be available for sale. |
Text
|
|
|
| MainVariantWidthMM |
The width of the variation in millimetres (mm) |
Integer |
|
|
| MainVariantLengthMM |
The length of the variation in millimeters (mm) |
Integer |
|
|
| MainVariantHeightMM |
The height of the variation in millimetres (mm) |
Integer |
|
|
| MainVariantWeightG |
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. |
Integer |
|
|
| MainVariantWeightNetG |
The net weight of the variation in gramms (g). This is the weight of the variation without packaging. |
Integer |
|
|
| MainVariantMayShowUnitPrice |
Display unit price in the online store |
Decimal |
|
|
| MainVariantMaximumOrderQuantity |
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. |
Decimal |
|
|
| MainVariantMinimumOrderQuantity |
The minimum order quantity. Decimal values are possible to allow orders by weight or length. |
Decimal |
|
|
| MainVariantIntervalOrderQuantity |
The quantity intervals the variation can be ordered in. Decimal values are possible to allow orders by weight or length. |
Decimal |
|
|
| MainVariantPicking |
The order picking type of the variation.
Show allowed values- no order picking type
- single picking (single_picking)
- no single picking (no_single_picking)
- exclude frompicklist (exclude_frompicklist)
|
Text
|
|
|
| MainVariantPosition |
The position of the variation. Value is inherited from the item's main variation if inheritance is active. |
Integer |
|
|
| MainVariantEstimatedAvailableAt |
The estimated delivery date of variations on reorder. |
Text
|
|
|
| MainVariantPriceCalculationId |
The ID of the price calculation linked to the variation. |
Integer |
|
|
| MainVariantStockLimitation |
The stock limitation for the variation.
Show allowed values- No limitation (0)
- Stock is limited to net stock (1)
- Do not administer stock for this variation. (2)
|
Integer |
|
|
| MainVariantIsVisibleIfNetStockIsPositive |
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. |
Decimal |
|
|
| MainVariantIsInvisibleIfNetStockIsNotPositive |
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. |
Decimal |
|
|
| MainVariantIsAvailableIfNetStockIsPositive |
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. |
Decimal |
|
|
| MainVariantIsUnavailableIfNetStockIsNotPositive |
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. |
Decimal |
|
|
| MainVariantReleasedAt |
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. |
Text
|
|
|
| MainVariantUnitID |
The id of the unit
Show allowed values- Piece(C62) (1)
- Kilogram(KGM) (2)
- Gram(GRM) (3)
- Milligram(MGM) (4)
- Litre(LTR) (5)
- 12 pieces/dozen(DPC) (6)
- Two pack(OP) (7)
- Bale(BL) (8)
- Dispenser(DI) (9)
- Bag(BG) (10)
- Sheet(ST) (11)
- Block(D64) (12)
- Block(PD) (13)
- Quire(QR) (14)
- Box(BX) (15)
- Coil(CL) (16)
- Container(CH) (17)
- Tin(TN) (18)
- Can(CA) (19)
- Dozen(DZN) (20)
- Bucket(BJ) (21)
- Case(CS) (22)
- Cask(Z3) (23)
- Bottle(BO) (24)
- Fluid ounce(OZA) (25)
- Jar(JR) (26)
- Cardboard box(CG) (27)
- Carton(CT) (28)
- Kit(KT) (29)
- Ball(AA) (30)
- Metre(MTR) (31)
- Millilitre(MLT) (32)
- Millimetre(MMT) (33)
- Pair(PR) (34)
- Packet(PA) (35)
- Bundle(PK) (36)
- Pallet/unit load(D97) (37)
- Square metre(MTK) (38)
- Square centimetre(CMK) (39)
- Square millimetre(MMK) (40)
- Square centimetre (non-standard)(SCM) (41)
- Square millimetre (non-standard)(SMM) (42)
- Role(RO) (43)
- Sack(SA) (44)
- Set(SET) (45)
- Reel(RL) (46)
- Each(EA) (47)
- Tube(TU) (48)
- Ounce(OZ) (49)
- Wet ton(WE) (50)
- Centimetre(CMT) (51)
- Inch(INH) (52)
|
Integer |
Yes |
1 |
| MainVariantUnitContent |
The content of the unit |
Decimal |
Yes |
1 |
| MainVariantCategoryID |
Category is required to create new Variatons. Please enter at least a Category ID or Path to create new Variations. |
Integer |
|
|
| MainVariantCategoryPath |
Category is required to create new Variatons. Please enter at least a Category ID or Path to create new Variations. |
List (Delimiter ; )
|
|
|
| MainVariantBarcodes |
Enter barcodes as map (BarcodeID=CodeValue;... e.g. 1=1243123;2=3446) |
Key-Value Pair |
|
|
| MainVariantSalesPrices |
Enter prices as map (PriceID=PriceValue;... e.g. 1=131.23;2=34.46) |
Key-Value Pair |
|
|
| MainVariantAttributeValues |
Enter attribute value ids as semicolon separated list (e.g. 23;46) |
List (Delimiter ; )
|
|
|
| MainVariantAttributeValuesString |
Enter attribute values as map of attribute backendname and attribute value backendname(e.g. Size=XL;Color=red) |
Key-Value Pair |
|
|
| MainVariantClientIDs |
Plenty ids of mandants |
List (Delimiter ; )
|
|
|
| MainVariantMarketIDs |
|
List (Delimiter ; )
|
|
|
| ProducerID |
|
Integer |
|
|
| ProducerName |
|
Text
|
|
|
| Marking1ID |
Flag 1 of the item.
Show allowed values- 0
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
|
Integer |
|
|
| Marking2ID |
Flag 2 of the item.
Show allowed values |
Integer |
|
|
| StockType |
The stock type of the item.
Show allowed values- Stocked item (0)
- Production item (1)
- Colli (2)
- Special order item (3)
|
Integer |
|
|
| StoreSpecial |
Option to present items more prominently in the online store.
Show allowed values- (0)
- Special offer (1)
- New items (2)
- Top items (3)
|
Integer |
|
|
| Condition |
The condition of the item.
Show allowed values- New (0)
- Used (1)
- Boxed as new (2)
- New with label (3)
- Factory seconds (4)
|
Integer |
|
|
| FreeText1 |
The content of the free text field 1. |
Text
|
|
|
| FreeText2 |
The content of the free text field 2. |
Text
|
|
|
| FreeText3 |
The content of the free text field 3. |
Text
|
|
|
| FreeText4 |
The content of the free text field 4. |
Text
|
|
|
| FreeText5 |
The content of the free text field 5. |
Text
|
|
|
| FreeText6 |
The content of the free text field 6. |
Text
|
|
|
| FreeText7 |
The content of the free text field 7. |
Text
|
|
|
| FreeText8 |
The content of the free text field 8. |
Text
|
|
|
| FreeText9 |
The content of the free text field 9. |
Text
|
|
|
| FreeText10 |
The content of the free text field 10. |
Text
|
|
|
| FreeText11 |
The content of the free text field 11. |
Text
|
|
|
| FreeText12 |
The content of the free text field 12. |
Text
|
|
|
| FreeText13 |
The content of the free text field 13. |
Text
|
|
|
| FreeText14 |
The content of the free text field 14. |
Text
|
|
|
| FreeText15 |
The content of the free text field 15. |
Text
|
|
|
| FreeText16 |
The content of the free text field 16. |
Text
|
|
|
| FreeText17 |
The content of the free text field 17. |
Text
|
|
|
| FreeText18 |
The content of the free text field 18. |
Text
|
|
|
| FreeText19 |
The content of the free text field 19. |
Text
|
|
|
| FreeText20 |
The content of the free text field 20. |
Text
|
|
|
| IsShippableByAmazon |
Flag that indicates if a shipping package is to be used for this item. |
Decimal |
|
|
| Position |
The position of the item |
Integer |
|
|
| OwnerId |
The plentymarkets user that is assigned as owner of this item. |
Integer |
|
|
| ProducingCountryID |
The ID of the country in which the item was manufactured. |
Integer |
|
|
| CustomsTariffNumber |
The customs tariff number of the item; usually a 11 digit code number based on the Harmonised System |
Text
|
|
|
| RevenueAccount |
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, plentymarkets automatically determines a revenue account based on the VAT rate. |
Integer |
|
|
| CouponRestriction |
Indicates if the item can be purchased using a promotional coupon.
Show allowed values- Permitted (0)
- Not permitted (1)
- Purchasable with coupon only (2)
|
Integer |
|
|
| ConditionApi |
The condition of the item that is transferred to markets via API.
Show allowed values- New (0)
- Used but as new (1)
- Used but very good (2)
- Used but good (3)
- Used but acceptable (4)
- Factory seconds (5)
|
Integer |
|
|
| IsSubscribable |
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. |
Decimal |
|
|
| AmazonFbaPlatform |
Indicates the platform used for Fulfilment by Amazon (FBA).
Show allowed values- Do not use (0)
- AMAZON EU (Europe) (1)
- AMAZON FE (Far East) (2)
- AMAZON NA (North America) (3)
|
Integer |
|
|
| AmazonProductType |
The Amazon product type of the item.
Show allowed values- ToysAndGames (1)
- BabyProducts (2)
- BedAndBath (3)
- FurnitureAndDecor (4)
- Kitchen (5)
- OutdoorLiving (6)
- SeedsAndPlants (7)
- PC (8)
- PDA (9)
- ConsumerElectronics (10)
- Watches (11)
- Sports (12)
- Shirt (13)
- Sweater (14)
- Pants (15)
- Shorts (16)
- Eyewear (17)
- Dress (18)
- Suit (19)
- Blazer (20)
- Outerwear (21)
- SocksHosiery (22)
- Underwear (23)
- Bra (24)
- Shoes (25)
- Hat (26)
- Bag (27)
- Accessory (28)
- Sleepwear (29)
- Swimwear (30)
- VideoGames (31)
- VideoGamesHardware (32)
- VideoGamesAccessories (33)
- Software (34)
- SoftwareGames (35)
- PersonalCareAppliances (36)
- HealthMisc (37)
- BuildingMaterials (38)
- Hardware (39)
- MajorHomeAppliances (40)
- OrganizersAndStorage (41)
- PlumbingFixtures (42)
- SecurityElectronics (43)
- Tools (44)
- AutoPart (45)
- AutoAccessoryMisc (46)
- FashionNecklaceBraceletAnklet (47)
- FashionRing (48)
- FashionEarring (49)
- FashionOther (50)
- FineNecklaceBraceletAnklet (51)
- FineRing (52)
- FineEarring (53)
- FineOther (54)
- LightsAndFixtures (55)
- LightBulbs (56)
- LightingAccessories (57)
- OfficeProducts (60)
- EducationalSupplies (61)
- PaperProducts (62)
- WritingInstruments (63)
- Food (64)
- Beverages (65)
- AlcoholicBeverages (66)
- Wine (67)
- HardLiquor (68)
- HouseholdSupplies (69)
- BrassAndWoodwindInstruments (70)
- Guitars (71)
- InstrumentPartsAndAccessories (72)
- KeyboardInstruments (73)
- MiscWorldInstruments (74)
- PercussionInstruments (75)
- SoundAndRecordingEquipment (76)
- StringedInstruments (77)
- NotebookComputer (78)
- PersonalComputer (79)
- Monitor (80)
- VideoProjector (81)
- Printer (82)
- Scanners (83)
- InkOrToner (84)
- ComputerComponent (85)
- ComputerDriveOrStorage (86)
- BeautyMisc (87)
- PETSUPPLIES (88)
- Shoes (89)
- Handbag (90)
- Shoeaccessory (91)
- Abbigliamento moto (92)
- Accessories (93)
- Accessorio auto (94)
- Calzado de moto (95)
- Gloves (96)
- Helmet (97)
- Helmets (98)
- Jantes (99)
- Montaje de ruedas y neumáticos (100)
- Moto (101)
- Neumático (102)
- Parte auto (103)
- Parts (104)
- Pièces motocyclette (105)
- Pieza de moto (106)
- Pieza para coche (107)
- Pneumatici (108)
- Pneus (109)
- Pneus montés sur jantes (110)
- PowersportsPart (111)
- ProtectiveClothing (112)
- ProtectiveGear (113)
- RidingApparel (114)
- Ridingboots (115)
- Rims (116)
- TireAndWheelAssemblies (117)
- Tires (118)
- Vehicles (119)
- BabyProducts (120)
- AdultCostume (121)
- BabyCostume (122)
- Skirt (123)
- CarryingCaseOrBag (124)
- Computer (125)
- ComputerAddOn (126)
- ComputerCoolingDevice (127)
- ComputerInputDevice (128)
- ComputerProcessor (129)
- ComputerSpeaker (130)
- FlashMemory (131)
- Keyboards (132)
- MemoryReader (133)
- Motherboard (134)
- NetworkingDevice (135)
- RAMMemory (136)
- SoundCard (137)
- SystemCabinet (138)
- SystemPowerDevice (139)
- TabletComputer (140)
- VideoCard (141)
- Webcam (142)
- AccessoryOrPartOrSupply (143)
- Antenna (144)
- AudioOrVideo (145)
- AudioVideoAccessory (146)
- AVFurniture (147)
- Battery (148)
- Binocular (149)
- BlankMedia (150)
- CableOrAdapter (151)
- Camcorder (152)
- camerabagsandcases (153)
- CameraFlash (154)
- CameraLenses (155)
- CameraOtherAccessories (156)
- CameraPowerSupply (157)
- CarAlarm (158)
- CarAudioOrTheater (159)
- CarElectronics (160)
- DigitalCamera (161)
- DigitalPictureFrame (162)
- DigitalVideoRecorder (163)
- DVDPlayerOrRecorder (164)
- FilmCamera (165)
- GPSOrNavigationAccessory (166)
- GpsOrNavigationSystem (167)
- HandheldOrPDA (168)
- Headphones (169)
- HomeTheaterSystemOrHTIB (170)
- MediaPlayer (171)
- MediaPlayerOrEReaderAccessory (172)
- MediaStorage (173)
- MiscAudioComponents (174)
- Phone (175)
- PhoneAccessory (176)
- PhotographicStudioItems (177)
- PortableAudio (178)
- PortableAvDevice (179)
- PowerSuppliesOrProtection (180)
- RadarDetector (181)
- Radio (182)
- RadioOrClockRadio (183)
- ReceiverOrAmplifier (184)
- RemoteControl (185)
- Speakers (186)
- StereoShelfSystem (187)
- Telescope (188)
- Television (189)
- Tuner (190)
- TVCombos (191)
- TwoWayRadio (192)
- VCR (193)
- VideoProjector (194)
- Beer (195)
- Spirits (196)
- Type (199)
- Home (200)
- Electrical (201)
- BigiotteriaAltro (202)
- BigiotteriaAnello (203)
- BigiotteriaCollanaBraccialeCavig (204)
- BigiotteriaOrecchini (205)
- GioielleriaAltro (206)
- GioielleriaAnello (207)
- GioielleriaCollanaBraccialeCavig (208)
- GioielleriaOrecchini (209)
- CookingOven (210)
- Cooktop (211)
- Dishwasher (212)
- LaundryAppliance (213)
- MicrowaveOven (214)
- Range (215)
- RefrigerationAppliance (216)
- TrashCompactor (217)
- VentHood (218)
- luggage (219)
- Vehicles (220)
- Fahrzeugteile (221)
- Fahrzeugzubehör (222)
- Felgen (223)
- Handschuhe (224)
- Helme (225)
- Kompletträder (226)
- Reifen (227)
- Schutzkleidung (228)
- Stiefel (229)
- ArtSupplies (230)
- BarCodeReader (231)
- Calculator (232)
- inkortoner (233)
- MultiFunctionDevice (234)
- OfficeElectronics (235)
- Phone (236)
- Printer (237)
- Scanners (238)
- VoiceRecorder (239)
- PetSuppliesMisc (240)
- Eyewear (241)
- GolfClubHybrid (242)
- GolfClubIron (243)
- GolfClubPutter (244)
- GolfClubIron (245)
- GolfClubWedge (246)
- GolfClubWood (247)
- SportingGoods (248)
- ToysAndGames (249)
- Kitchen (250)
- OutdoorLiving (251)
- SeedsAndPlants (252)
|
Integer |
|
|
| AmazonFedas |
The FEDAS product classification key of the item. |
Text
|
|
|
| EbayPresetId |
The eBay preset ID. |
Integer |
|
|
| EbayCategory |
The eBay category 1 of the item. This category is used when a new listing is created. |
Decimal |
|
|
| EbayCategory2 |
The eBay category 2 of the item. This category is used when a new listing is created. |
Decimal |
|
|
| EbayStoreCategory |
The ID of the eBay store category 1 of the item. This value is used for new listings. |
Decimal |
|
|
| EbayStoreCategory2 |
The ID of the eBay store category 2 of the item. This value is used for new listings. |
Decimal |
|
|
| RakutenCategoryId |
The ID of the Rakuten category of this item. |
Integer |
|
|
| AgeRestriction |
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.
Show allowed values- None available (0)
- Released for ages 3 and up (3)
- Ages 6 and up (6)
- Ages 9 and up (9)
- Ages 12 and up (12)
- Ages 14 and up (14)
- Ages 16 and up (16)
- Ages 18 and up (18)
- Not marked (50)
- Not required (88)
- Unknown (99)
|
Integer |
|
|
| Feedback |
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.
Show allowed values |
Integer |
|
|
| ItemShippingProfiles |
All active shipping profiles as semicolon (;) separated list |
List (Delimiter ; )
|
|
|
PlentyAddItems