Directory of data fields

This page serves purely as a reference. It explains the various tabs and data fields within an item data record. Links direct you to further information and step-by-step instructions for using the individual data fields in a larger context.

Settings differ for each item type

Depending on which type of item you’re working with, you might see some of the settings described on this page and not others. Don’t worry! PlentyONE automatically displays the settings that are relevant to your item type and hides the rest.

Tab: Item ID

When you open an item, the item’s ID is displayed in the tab by default. But you can decide if you’d rather see the item’s name or number in the tab. Of course you can change this setting again any time.

item id

Customising the item tab:

  1. Go to Item » Edit item.

  2. Search for and open an item.
    → The item data record opens in a new tab.

  3. Right-click on the item tab.
    → A drop-down list opens.

  4. Click on Rename.
    → The Select tab title window opens.

  5. Decide which data should be displayed.

  6. Click on Save.

If you select the setting Variation name of main variation or Variation number of main variation and this information is not saved for an item, then the Item ID will be shown instead.
The item’s tab title only changes once you have reloaded the item.

1. Upper row of tabs

An item is a complete data record that always includes one more more variations. An item is composed of general data that applies to all of the item variations (item data) as well as data that is managed separately for each variation (variation data).

In the item data record, you’ll find the item data displayed in the upper row of tabs and variation data displayed in the lower row of tabs. In other words, the upper row of tabs includes general data that applies to all of the item’s variations.

upper tab row

1.1. Global

This tab includes a wide range of basic item options. Here you’ll also find a timestamp, which tells you when the item data record was created and when it was last modified.

Saving global item data:

  1. Go to Item » Edit item.

  2. Search for and open the item.

  3. Click on the Global tab in the upper row. This tab is divided into several areas.

  4. Carry out the settings.

  5. Save () the settings.

1.1.1. Basic settings

Setting Explanation

Condition

Select the item’s condition from the drop-down list. New is set by default.

Condition for API

Select the item’s API condition from the drop-down list. New is set by default.

Note: The API condition is used for the market Amazon.

Type

Select the appropriate stock type from the drop-down list.

Stock type Explanation

Stocked item;
Production item;
Special order item

These types do not have a pre-defined function. However, they are well-suited for differentiating between various types of products.

Example of use: Imagine you sell mass-produced items and custom-made items. Orders that include custom-made items need to be processed differently. In this case, you could designate your mass-produced items as "Stocked items" and your custom-made items as "Special order items". Then you could set up an event procedure, which automatically switches orders containing custom-made items to a particular status.

Colli

Select if the item is to be shipped in several packages. For additional packages, individual items with the stock type Colli must be created in PlentyONE, but these items should not be activated for the plentyShop.

Note: You are limited to these four stock types. It is not possible to create additional stock types.

Manufacturer

Who makes this item? Select the appropriate manufacturer from the drop-down list.

Note: This list only includes the manufacturer data records that you’ve already saved in PlentyONE.

Manufacturing country

Which country was the item manufactured in? Select the appropriate country from the drop-down list.

Revenue account

Enter up to 11 digits for the revenue account.

Max. order quantity

Enter a value to limit how many copies of the item can be bought at once.

  • 0 = The maximum order quantity applies per variation. This quantity is saved in the variation’s tab Settings under the option Max. order quantity.

  • Value greater than 0 = Customers cannot order more than this total quantity. This limit applies to all of the item’s variations. Decimal values are possible, e.g. allowing customers to order products by weight or length. This value takes priority over the maximum order quantity saved within the individual variations.

Age rating

Select the appropriate age rating from the drop-down list.

Note: Items with an 18+ age rating must be linked to a shipping profile for which the PostIdent option was activated.

Promotional coupon/POS discount

Should it be possible to redeem promotional coupons for this item? Select the appropriate answer from the drop-down list.

  • Permitted = Customers can redeem promotional codes when they buy a variation of this item. Cashiers can grant discounts while selling the item with PlentyONE POS. Customer class discounts are applied automatically.

  • Not permitted = Customers cannot redeem promotional codes when they buy a variation of this item. Cashiers cannot grant discounts while selling the item with PlentyONE POS. Customer class discounts are not applied.

  • Purchasable with coupon only = The item variation can only be purchased if a promotional code was entered.

Subscription

Is a subscription available for the item? Select the appropriate answer from the drop-down list.

Note: Subscriptions are set up in the scheduler. The scheduler is an individual module in PlentyONE that allows an item to be shipped in regular intervals. The scheduler menu is only visible in PlentyONE if you’ve booked the module.

Shipping package

Do you want to use shipping packages for this item? Select the appropriate answer from the drop-down list.

Note: Shipping packages have specific dimensions. If you enter dimensions for your variations, then the appropriate shipping package will automatically be assigned.

Serial number

Should it be possible to scan this item’s serial number during a process? Select the appropriate answer from the drop-down list.

1.1.2. Item image

Click on the image to access the Images tab.

1.1.3. Shipping profiles

Select () at least one shipping profile per item. Otherwise the shipping costs may not be calculated correctly. No shipping profile is selected by default. If an order contains items without a shipping profile, then the items will be given the default shipping profile for the default online store. If no default shipping profile was specified, then the shipping profile with the highest priority will be used.

1.1.4. Online store

Setting Explanation

Store special

Should this item be highlighted with a store special? If so, then select the appropriate type of store special from the drop-down list. In other words, decide whether you want to call this item a special offer, a new item or a top item.

Item feedback

Enter an initial rating for the item.

Note: When using the item feedback function, the number entered here will be displayed as the item’s initial rating. Every time new feedback is submitted, an average value will be calculated automatically from these numbers. Go to Setup » Client » Settings » Feedback » Tab: Item if you want to change the Maximum rating.

1.2. Variations

Open this tab to:

1.3. Tab: Variation ID

When you open a variation, the variation’s ID is displayed in the tab by default. But you can decide if you’d rather see the variation’s name or number in the tab. Of course you can change this setting again any time.

Customising the variation tab:

  1. Go to Item » Edit item.

  2. Search for and open an item.
    → The main variation automatically opens too.

  3. Right-click on the main variation tab.
    → A drop-down list opens.

  4. Click on Rename.
    → The Select tab title window opens.

  5. Decide which data should be displayed.

  6. Click on Save.

If you select the setting Variation name or Variation number and this information is not saved for a variation, then the Variation ID will be shown instead.
The variation’s tab title only changes once you have reloaded the item.
If the drop-down list doesn’t appear when you right-click, then switch to the tab of the main variation.

1.4. Set

This tab is only visible for items of the type Set.

Open this tab to:

1.5. Multi-Channel

You’ll need to save settings in this tab if you’re preparing items to be sold on marketplaces like Amazon, eBay or Neckermann.at.

Saving settings for marketplaces:

  1. Go to Item » Edit item.

  2. Search for and open the item.

  3. Click on the Multi-Channel tab in the upper row. This tab is divided into several areas.

  4. Carry out the settings.

  5. Save () the settings.

1.5.1. Amazon

These settings are only relevant if you want to sell on Amazon.

Setting Explanation

Product type (Deprecated)

Select the appropriate Amazon product type from the drop-down list. You can think of the product type as the Amazon category under which this item should appear. When you transmit your items to Amazon, you’ll transmit one product type at a time, i.e. one category at a time.

Note: You can download an overview of Amazon product types here. The table lists the product types and their corresponding IDs.

Product type

Select the appropriate Amazon product type from the drop-down list. The product type is the Amazon category under which this item should appear. These product types are used for the new connection to Amazon.
Product types cannot be imported, because they come directly from Amazon. You have the option to import values that are assigned to items.

Note: There are only active values in the drop down list. In the Setup » Markets » Amazon » Add catalogue templates menu you can activate and deactivate values.

FBA Fulfillment

Should the item be sold via FBA? If so, then select the appropriate Amazon marketplace from the drop-down list.

  • AMAZON_EU = Europe

  • AMAZON_FE = Far East

  • AMAZON_NA = North America

Amazon FBA

Should the item be sold via FBA? If so, then select this option ().

Note: By doing so, the FBA stock of this item can be imported into PlentyONE and Amazon Multi-Channel orders that are shipped with FBA can be booked.

1.5.2. Listing default settings

These settings relate to listing templates. The basic idea is simple. Rather than individually configuring the settings for every single eBay offer, you create a template, which includes the typical offer settings.

Setting Explanation

Listing template

Choose a previously created listing template to link it with this item.

Category 1;
Category 2

Enter the eBay category IDs for this item.

Use case: in the first step, you’ll create listing templates that apply to all categories. Then in the second step, you’ll specify the category ID for each individual item.

Store category 1;
Store category 2

Enter the eBay store category for this item.

Use case: in the first step, you’ll create listing templates that apply to all store categories. Then in the second step, you’ll specify the store category for each individual item.

1.5.3. eBay title

Enter the eBay listing’s title here. This links the listing title to the item.

Background info: Listings are retrieved on an hourly basis. While being retrieved, the listing is assigned to an item. Listings and items are matched smoothly if the listing was created with PlentyONE or if the item has the same name as the listing title.

If the item name differs, you can enter the listing title. This improves the matching accuracy. This link also makes it possible to import listings that were set up with other tools into PlentyONE and have them automatically assigned to the correct item.

1.5.4. Category link

This setting is only relevant if you sell on Rakuten. Here you’ll link the item with a Rakuten category.

Either enter the category ID directly into the text field. Or choose a main category from the drop-down list and then use the pop-up window to figure out the category ID.

1.5.5. Neckermann.at Enterprise

These settings are only relevant if you want to sell on Neckermann.at.

1.6. Texts

In this tab, you’ll save item texts like a preview text, technical data and keywords.

Would you rather save variation-specific texts?

The texts in this tab apply to the entire item. In other words, the texts apply to all of the variations. It’s also possible to save variation-specific texts.

  1. First, you’ll create properties of the type Text or HTML.

  2. Then you’ll link these properties with the appropriate variations.

Saving item texts:

  1. Go to Item » Edit item.

  2. Search for and open the item.

  3. Click on the Texts tab in the upper row.

  4. Choose the appropriate language from the left drop-down list.

  5. Enter the item texts in this language.

  6. Save () the settings.

Table 1. Entering item texts
Setting Explanation

Language

Select a language from the drop-down list Open language. This allows you to see and edit the item texts for this language. The same language is automatically selected under Save as.

Alternative workflow: While translating, you may find it helpful to initially see the source text and then overwrite it with your translation. To do so, proceed as follows.

  1. Select the source language from the drop-down list Open language.

  2. Overwrite the source text with your translation.

  3. Select the target language from the drop-down list Save as.

  4. Save () the changes.

Delete language texts

Deletes all of the text fields for whichever language was selected under Open language. You will be asked to confirm your decision.

Name 1

Enter a name for the item. This is the item’s default name, which is used in the plentyShop and on marketplaces.

Note: The item name is used to create the item URL. Open the plentyShop LTS assistant and navigate to the step SEO if you want to decide whether name 1, 2 or 3 should be used for the meta title and the item URL.

Name 2

Enter a name for the item. This is an alternative item name that can be used for example for markets.

Note: The item name is used to create the item URL. Open the plentyShop LTS assistant and navigate to the step SEO if you want to decide whether name 1, 2 or 3 should be used for the meta title and the item URL.

Name 3

Enter a name for the item. This is an alternative item name that can be used for example for markets.

Note: The item name is used to create the item URL. Open the plentyShop LTS assistant and navigate to the step SEO if you want to decide whether name 1, 2 or 3 should be used for the meta title and the item URL.

Preview text

Enter a preview text for the item. The preview text can be entered in HTML format or as plain text.

Note: The preview text is a short text which can be displayed in item lists.

Item text

Enter an item text. The item text is a detailed description, which is displayed in the item layout in the plentyShop.

Note: Click on the drop-down list in the upper right corner and select your preferred editor for entering text or HTML.

Technical data

Enter technical data for the item.

Note: Click on the drop-down list in the upper right corner and select your preferred editor for entering text or HTML.

URL path

The item’s URL path in the plentyShop. By default, the URL path consists of the categories and the item name. PlentyONE automatically assigns the path when the item is created. The path is displayed as part of the URL when the item is viewed in the plentyShop.

Meta description

Enter a meta description for the item.

Note: The meta description makes it easier for search engines to find the item.

Meta keywords

Enter keywords for the item.

Note: The meta keywords make it easier for search engines to find the item.

Item template

Not recommended. It’s technically possible to select a template to alter the design of the detail view of an item. However, we don’t recommend doing so for two reasons:

  • Item templates overwrite your “normal” product pages and are therefore not particularly useful in real life situations.

  • This procedure is more complicated than designing product pages with ShopBuilder.

1.7. Fields

Add free text fields to the detailed view of an item. Customers can then enter values into the free text fields, such as an additional request or dimensions.

Once you’ve defined free text fields, you’ll activate them here for the appropriate items.

Activating free text fields:

  1. Go to Item » Edit item.

  2. Search for and open the item.

  3. Click on the Fields tab in the upper row.

  4. Enter the values into the required free text fields.

  5. Save () the settings.

1.8. Characteristics

Have you finished creating your characteristics and sorting them into groups? Then you’re ready to link your characteristics to items.

For example, if you created a characteristic called “Bluetooth”, then next you would specify which of your products are equipped with Bluetooth.

Linking a characteristic with an item:

  1. Go to Item » Edit item.

  2. Search for and open the item.

  3. Click on the Characteristics tab. The screen is divided into two areas:

    • Characteristics that have already been linked to the item are displayed in the upper area called Characteristics,

    • Characteristics that have not yet been linked are displayed in the lower area called Activate further characteristics. Here, the characteristics are sorted into their groups.

  4. Expand the characteristic group in the lower area if needed () and select the characteristic ().

  5. Save () the settings.
    → The characteristic is now linked to the item and displayed in the upper area.

Linking a characteristic with multiple items

Use the item group function if you want to link several items at once.

Saving additional information

Depending on the scenario, it might be necessary to save additional information. For example, if the characteristic is something like a weight or a length, then it will be necessary to enter a numeric value.

  1. Carry out additional settings in the Characteristics tab. Note Table 2.

  2. Save () the settings.

Modifying the additional information for multiple items

Use the group function in the menu Setup » Item » Characteristics » Tab: Group function if you want to edit this information for several items at once.

  1. Select the characteristic’s language.

  2. Property selection: Choose the characteristic that you want to edit.

  3. Value to be changed: Enter the old value for the characteristic.

  4. New value: Enter the new value for the characteristic.

  5. When you save the settings, the characteristic value will be changed for all of the items that have this value.

1.9. Images

First, you’ll upload images of the item and its variations here. For example, you could upload images of a t-shirt in red, blue and green. Then you’ll assign the images to the appropriate variations. This causes customers e.g. to automatically see an image of the green t-shirt when selecting this variation in the plentyShop.

100 images can be uploaded per item

You can upload up to 100 images per item, i.e. per item ID. This is a hard limit in the user interface. If you were to upload e.g. 150 images, then only the first 100 would appear in the user interface. Note that the limit applies to the entire item, i.e. to all of the variations together.

Uploading images

  1. Go to Item » Edit item » [Open item] » Tab: Images.

  2. Drag & drop images into the appropriate area or click on Select files and upload the images.

  3. Carry out the additional settings. Note Table 3.

  4. Save () the settings.

Table 3. Uploading an item image
Setting Explanation

0

The first image automatically receives the position number 0. Additional images are then given the position numbers 1, 2, 3 etc. Enter different position numbers if you want to sort the images in your plentyShop. Alternatively, click on the symbols Down or Up to change the order of the images.

Availability

Which sales channels should this image appear on? Select () the appropriate clients and/or markets.

Market attribute link

Select an attribute value to link the item image for marketplaces with this attribute value. The image will only be transferred to marketplaces where item variations have this attribute value.

Note: This option is only shown if:

Alternative text

Enter an alternative text for the image. If an image can not be displayed (e.g. due to the browser settings, firewall, etc.), then the customer will see the alternative text instead. The alternative text is not relevant for SEO. It is simply displayed as an alternative to the image.

Note: The alternative text is limited to 256 characters.

Name

Enter a name for the image. The name is relevant for SEO, i.e. it helps search engines index the item. Use appropriate keywords in the image names to make the images more relevant to search engines. This also increases traffic on the page, for example if the image is found with the Google image search.

Note: The image name is limited to 256 characters.

Size

Displays the image size in pixels and kilo bytes.
Technical specifications

File formats

The file formats supported for images are: PNG, JPG, GIF, SVG

File names

Image file names may contain the following characters:

  • Letters (a-z, A-Z) excluding umlauts

  • Numbers (0-9)

  • Underscores (_)

  • Hyphens (-)

Spaces and special characters such as umlauts are not permitted. When you upload images, spaces and special characters are replaced by hyphens (-).

Image sizes

Every time an item image is uploaded, PlentyONE creates the following versions:

  • High-resolution item image

  • Medium-sized item image

  • Item attribute image

  • Two preview images

Since PlentyONE does not scale up images, the source image must have at least the size and quality specified in the Sizes area. Larger images will be scaled down to the specified size.

Original images

Original images are no longer accessible after they have been uploaded. When you upload an image, PlentyONE uses it to generate the image sizes that are accessible via URL. The original image will no longer be accessible - also not via URL.

Linking images with variations

Once you’ve uploaded the images, you’ll match them with the appropriate variations. This causes customers e.g. to automatically see an image of a green t-shirt when selecting the green variation in the plentyShop.

Linking images with variations:

  1. Go to Item » Edit item » [Open item] » Tab: Images.
    → You’ll see a list of all the images saved for the item.

  2. Select the images () that you want to link.

  3. Click on Variation link.
    → A pop-up window will open.

  4. If needed, use the filters on the left to find specific variations.

  5. Select whichever variations () you want to link to the chosen images.

  6. Click on Link.
    → The images will be linked to the selected variations.

  7. Save () the settings.
    → If a customer selects the variation in the plentyShop, then he will automatically see the appropriate item image.

Removing the link again

Underneath an image, click on Variation link to see which variations were linked to the image. Select the variations () that should no longer be linked and click on Unlink.
Alternative: upload images in the lower row of tabs

Search for and open a variation. Then click on Images in the lower row of tabs. Here you can upload an image for the currently opened variation. In other words, the image is simultaneously uploaded and linked to the variation.

1.10. Stock

In this tab:

1.11. Cross-selling

In the Cross-Selling tab, you can link items to any number of similar items from your assortment.

1.12. Media

Tab is outdated

This tab is no longer supported. Files that you upload in this tab can not be used for the plentyShop. Instead of uploading files in this tab, create a property of the type "File".

This tab is only relevant for the outdated Callisto webshop. Here you can upload files such as product information or brochures. Your customers can then download these files from the product page or from the "my account" area. The files that you upload in this tab must meet the following requirements:

  • The file must be intended for the old Callisto webshop

  • Permitted file formats: PDF, EXCEL, X_EXCEL, DOC, DOCX, MSWORD, RTF, TEXT, RICHTEXT, ZIP, HTML, SWF

  • Maximum file size: 10 MB per file

  • Maximum number of files: 10 files per item (of which a maximum of 1 file in SWF format)

Uploading files

Proceed as described below to upload files in the Media tab. Then decide where the files should be available.

Uploading a file:

  1. Go to Item » Edit item.

  2. Search for and open the item.

  3. Click on the Media tab in the upper row.

  4. Drag & drop files into the appropriate area or click on Select files and upload the files.

  5. Carry out the additional settings. Note Table 4.

  6. Save () the settings.

Table 4. Uploading a file
Setting Explanation

Title

Edit the title, if needed.

Size

The file size is displayed here.

Email

This setting does not serve any function.

My account

Activate to make the file available for download in the My Account area.

CMS

Activate to make the file available in the old online store Callisto.

Inserting a download link into the online shop

Use the template function GetDocumentLinks() of the Callisto design to add download links to the files saved in the Media tab to the old online store Callisto. This template function can be used in all templates in the ItemView folder. The function returns a list of links that customers can use to download the saved documents.

Inserting the template function:

  1. Go to Shop » Web design.

  2. Open a template in the Layout » ItemView folder.

  3. Insert the code example into the template.

  4. Save () the settings.
    → A list of download links is displayed at the respective position in the online store.

{%
    for ($_link in GetDocumentLinks()) 
    {
        print($_link."<br/>");
    }
%}
Limiting the list of download links to specific data types

Limit the list of download links to specific data types by specifying a file ending. The template function GetDocumentLinks(".pdf"), for example, displays only the download links to saved PDF files.

1.13. Statistics

In the tab Statistics, you can analyse statistical data about the item. For example, there are statistics that let you analyse the item’s revenue according to various criteria.

2. Lower row of tabs

An item is a complete data record that always includes one more more variations. An item is composed of general data that applies to all of the item variations (item data) as well as data that is managed separately for each variation (variation data).

In the item data record, you’ll find the item data displayed in the upper row of tabs and variation data displayed in the lower row of tabs. In other words, the lower row of tabs contains data that applies to a specific variation. Namely, the variation whose ID is currently displayed in the upper tab row.

Keep in mind that the main variation can pass data onto its sub-variations, i.e. they can inherit its data. You can deactivate the inheritance function if you would prefer to modify the variations individually.

lower tab row

2.1. Settings

This tab includes a wide range of basic options for the variation. Here you’ll also find a timestamp, which tells you when the variation was created and when it was last modified.

Saving settings for the variation:

  1. Go to Item » Edit item.

  2. Search for and open the variation.

  3. Click on the Settings tab in the lower row. This tab is divided into several areas.

  4. Carry out the settings.

  5. Save () the settings.

2.1.1. Basic settings

Setting Explanation

Variation name

Enter a name for the variation.

Variation No.

Enter a number for the variation.

Recommendation: If you leave this field blank, then PlentyONE will automatically assign the next available variation number. The number will be assigned according to the pattern saved in the menu Setup » Item » Settings.

External variation ID

Enter an external variation ID.

Use case: The external variation number facilitates importing items and variations from an external system.

Model

Enter a model name for the variation.

Position

Enter a position number for the variation.

Variations can be sorted by their position number in the back end and front end.

Back end: Search for items in the menu Item » Edit items. Move your mouse cursor over the column header Position. Click on the small triangle () to display the items in ascending or descending order by their position number.

Front end: Select the appropriate sorting option in the plentyShop LTS assistant.

Note: Open the plentyShop LTS assistant and navigate to Pagination and sorting » Additional sorting options. If the option Calculate the variation position based on monthly sales is set to Yes, then manually entered position numbers will be overwritten.

2.1.2. Availability

This area relates to the item availability. In other words, when the variation is visible or purchasable.

Note that there is also the Tab: Availability, which you’ll use to specify where the variation is available.

Setting Explanation

Active

Activate the variation () when you’re ready for it to go live.

Background info: Variations only become visible in the plentyShop or on marketplaces once they have been activated. In other words, you can work on inactive variations without your customers noticing.

Availability

Symbols 1-10

How long is the variation’s delivery time? Select the appropriate availability level from the drop-down list.

Note: The availability levels are configured in the menu Setup » Item » Availability. There you can find the availability IDs, texts, symbols and average delivery times in days.

Note: The availability is a static setting. In other words, the selected availability level does not change, regardless of the actual stock levels. The setting is only relevant if stock availability is not set automatically.

Show in online store:

  • Available automatically if net stock is positive

  • Not available automatically if net stock is 0 or negative

Should customers be able to buy the product in the online shop if it is in stock?

Note: Both functions complement each other and are only applied if the Limitation option is set to To net stock.

Available automatically if net stock is positive

Select this option (toggle_on) if the variation should automatically be available and purchasable in the plentyShop when it is in stock.

Not available automatically if net stock is 0 or negative

Select this option (toggle_on) if the variation should automatically be unavailable when it is out of stock.

Visibility

Client:

  • Visible automatically if net stock is positive

  • Invisible automatically if net stock is 0 or negative

Should customers be able to see the product in the online shop if it is in stock?

Note: Both functions complement each other and are only applied if the Limitation option is set to To net stock.

Visible automatically if net stock is positive

Select this option (toggle_one) if the variation should automatically be visible in the plentyShop when it is in stock.

Invisible automatically if net stock is 0 or negative

Select this option (toggle_on) if the variation should automatically be invisible when it is out of stock. Select this option (toggle_on) if the variation should automatically be invisible when it is out of stock. When this happens, customers will not be able to access the variation with a direct URL either.

Relationship to other settings: These options take priority over the item list options further below. We recommend that you either control the visibility with the “client” option or the “item list” option. They should not be combined.

Item list

Should customers only be able to access the product via the direct URL? Or should customers be able to see the product in your shop’s categories, search results and item lists if it is in stock?

Always invisible

Select this option (toggle_on) if the variation should only be accessible via the direct URL. If the option is activated, then the variation will always be invisible in your plentyShop item lists. This means, the variation will not appear in the categories, search results, store specials, cross-selling lists and lists of last seen items.

Visible automatically if net stock is positive

Select this option (toggle_on) if the variation should be visible in the online store item lists when it is in stock. This means, the variation will appear in the categories, search results, store specials, cross-selling lists and lists of last seen items.

Note: The functions Visible automatically if net stock is positive and Invisible automatically if net stock is 0 or negative complement each other and are only applied if the Limitation option is set to To net stock.

Invisible automatically if net stock is 0 or negative

Select this option (toggle_on) if the variation should be invisible in the item list if its not in stock. When this happens, the variation can only be accessed using the direct URL. The variation will not appear in the categories, search results, store specials, cross-selling lists and lists of last seen items.

Note: The functions Visible automatically if net stock is positive and Invisible automatically if net stock is 0 or negative complement each other and are only applied if the Limitation option is set to To net stock.

Relationship to other settings: Both of the client visibility options take priority over the "item list" options. We recommend that you either control the visibility with the “client” option or the “item list” option. They should not be combined.

Availability in supply

Shows the expected delivery date for variations that were reordered.

Limitation

Should PlentyONE monitor this product’s stock levels?

None

This setting is useful for situations where you could technically count the stock units, but it doesn’t matter whether the stock is negative or not. The product is available, just without any particular stock value.

Note: Some marketplaces only consider the stock value that is assigned to the variation. So if you select this setting, then the marketplace might never have an active offer for the product because it might never understand this as a positive stock value. Check how your target marketplaces will interpret the stock limitation setting before you begin selling on them.

To net stock

This is the most commonly used option. It prevents you from accidentally overselling items. The stock is limited to the net stock. This net stock level is transmitted to marketplaces.

What does net stock mean?
This number indicates how many copies of the item are currently available for sale. The net stock is a subset of the physical stock. Substract all reserved quantities from the physical stock and you will get the net stock. Further information.

Do not administer stock for this variation

This setting is useful for situations where it would be very time-consuming to count the stock units. For example, imagine you sell construction supplies and you have millions of copies of a screw.

Note: Some marketplaces only consider the stock value that is assigned to the variation. So if you select this setting, then the marketplace might never have an active offer for the product because it might never understand this as a positive stock value. Check how your target marketplaces will interpret the stock limitation setting before you begin selling on them.

Note: If this setting is selected, then the variation’s Stock tab will not include the sub-tabs Correction, Stock, Supply and Item movement.

Max. order quantity

Enter a number. This is the maximum quantity that is permitted per order.

Note: Decimal values are possible, e.g. allowing customers to order products by weight or length.

Note: You can use the maximum order quantity in combination with pre-orders, for example to prevent competitors from completely buying out the variation at a reduced price.

Min. order quantity

Enter a number. This is the minimum quantity that is permitted per order.

Note: Decimal values are possible, e.g. allowing customers to order products by weight or length.

Interval order quantity

Enter a number. This specifies which quantity intervals the variation can be ordered in.

Note: Decimal values are possible, e.g. allowing customers to order products by weight or length.

Release date

When should the variation become available? Select the date from the calendar.

If you would rather directly enter the date into the field, then use the following format: DD.MM.YYYY

Note: The variation can be visible in the plentyShop before this date, e.g. for preorders.

Available until

When is the last day that the variation should be available? Select the date from the calendar.

If you would rather directly enter the date into the field, then use the following format: DD.MM.YYYY

2.1.3. Sales prices

Here you can link existing sales prices to the variation and enter monetary prices. The monetary prices can be:

  • Manual entry

  • Price calculation

  1. Go to Item » Edit item » [Open variation] » Tab: Settings » Area: Sales prices.

  2. Select the previously created sales price from the left drop-down list.

  3. Click on Add ().
    → The sales price is added and displayed in the list.

  4. Enter the monetary price into the Price field.

  5. Save () the settings.

  1. Go to Item » Edit item » [Open variation] » Tab: Settings » Area: Sales prices.

  2. Choose a previously created price calculation from the right drop-down list.

  3. Save () the settings.

  4. Reload the item data record if needed. To do so, right-click on the item tab and then click on Reload.
    → The sales price and the automatically calculated monetary price will be displayed in the list.

PlentyONE works with gross prices

Behind the scenes, PlentyONE works with gross prices. Technically, you can use the middle drop-down list to decide whether you want gross prices or net prices to be displayed in the item data record. But this only affects how the prices are displayed. Only gross prices are saved internally in the database.
Deleting the link again

Open the variation and click on Delete () in the line of a sales price. This deletes the link between the sales price and the variation. The sales price itself is not deleted. The sales price is simply removed from the variation. Afterwards, the sales price will be available in the left drop-down list again.
Inheritance behaviour

If inheritance is active, then combinations of sales price and monetary price will be passed down from the main variation to the sub-variations. If you want to maintain individual prices for the sub-variations, deactivate the inheritance and then add the sales price.

2.1.4. Barcode

Barcodes such as GTIN, ISBN, UPC and QR are used to identify items in PlentyONE. Link barcodes with your item variations.

Manually linking barcodes with variations:

  1. Go to Item » Edit item.

  2. Search for and open the variation.

  3. Click on the Settings tab in the lower row.

  4. In the Barcode area, select the previously saved barcode configuration from the drop-down list.

  5. Click on Add ().
    → The barcode type is added and displayed in the list.

  6. Enter the code into the Code field.

  7. Save () the settings.

Automatically assigning barcodes from the number range

If you bought a range of GTIN 13 barcodes, then PlentyONE can automatically assign the next available barcode to your item.

To do so, proceed as described above. Rather than manually entering the barcode into the Code field, click on Generate GTIN ().

2.1.5. ASIN/ePID/MOIN

ID Explanation

ASIN

The "Amazon Standard Identification Number" is a 10-digit, alphanumeric product identification that is provided by Amazon. The ASIN and ISBN are identical for books. The ASIN can be found on Amazon’s product page.

ePID

The "eBay Product ID" is a product identification that is provided by eBay.

MOIN

The "My OTTO Identification Number" is an alphanumeric product identification that is provided by OTTO Market. Starting August 11th, 2021, every product on OTTO Market must have a MOIN.

Note: The MOIN is assigned by OTTO Market. You do not create it yourself. If you sell a product on OTTO Market and it’s also available through other sellers, then all of the offers will have the same MOIN.

Manually linking the ASIN, ePID or MOIN with a variation:

  1. Go to Item » Edit item » [Open variation] » Tab: Settings » Area: ASIN/ePID/MOIN.

  2. Click on Add ().
    → A new entry is added to the list.

  3. Select ASIN, ePID or MOIN from the right drop-down list.

  4. If needed, select the country platform from the left drop-down list.

  5. Enter the ASIN, ePID or MOIN into the field.

  6. Save () the settings.

2.1.6. Bundle

This area is only visible for item bundles.

Choose settings in this area to have the weight and purchase price automatically calculated for item bundles.

2.1.7. Item image

Click on the image to access the Images tab.

2.1.8. Tags

Here you can link the variation to any number of tags.

  1. Click in the text field.

  2. Select the tag from the drop-down list or enter the first few letters of the tag’s name and then use the auto-complete function.

  3. The tag will be linked to the variation when you save your changes.
    → Use the tag filter to search for all of the variations that have this tag.

Note: Here you can only link the tags that were made available for the Variation area.

Inheritance behaviour

Tags that you link to the main variation are passed on to the item’s other variations. To save other tags for a variation, deactivate inheritance and save different tags.

If you remove all tags from a variation, inheritance is not activated. This behaviour differs from other inheritance settings in the system. Instead, the variation is saved without any tags.

2.1.9. Dimensions

Setting Explanation

Content

Quantity

Enter a number into the field on the left.

Unit

Select a unit from the drop-down list on the right.

Length/Width/Height

Enter the variation’s dimensions. Make sure you enter the dimensions in millimetres.

Gross weight

Enter the variation gross weight in grams.

Background info: For individually packaged variations, the gross weight is the weight of the variation including packaging. The value is used to calculate shipping packages and weight-based shipping costs.

Item bundles: The gross weight can automatically be calculated based on the bundle components.

Net weight

Enter the variation’s net weight in grams.

Background info: The net weight is the weight of the variation without packaging.

Item bundles: The gross weight can automatically be calculated based on the bundle components.

Units contained

Units contained describes several sales units combined in one package. Default setting: 1.

Note: This value does not influence how the unit price is calculated.

Show unit price

Select this option (toggle_on) if you want the unit price to be displayed in the plentyShop.

Background info: The unit price tells you how much the item costs per pound, litre or other unit of measure. It’s calculated based on the item’s unit, content and price. The unit price allows consumers to compare prices. In some countries, the unit price must be specified for products that are sold by weight, volume, length or surface area.

2.1.10. Costs

This data is used to calculate your sales prices.
Setting Explanation

Acquisition price

Click on this button to see the acquisition price in gross and net. The acquisition price results from the procurement calculation. It is calculated based on the price requested by the supplier minus discounts and bonuses. Plus procurement costs for transportation, insurance and packaging.

VAT

Select the variation’s VAT rate from the drop-down list.

Net purchase price

Enter the net purchase price.

Note: The purchase price is either calculated automatically or managed manually depending on how the settings were saved in the menu Setup » Stock » Stock » Incoming items.

Item bundles: the net purchase price can automatically be calculated based on the bundle components.

Moving average purchase price (net)

Enter the net moving average purchase price.

Note: It is recalculated every time stock is booked in. It is calculated from the purchase prices of all stocks that are available for the variation in the warehouse. Go to Setup » Stock » Stock » Incoming items and see which warehouses were activated with the setting Warehouse for moving average price. The moving average purchase price only takes items into account that were booked into one of these warehouses. If no warehouse is active, then no moving average purchase price is calculated.

Item bundles: the moving average purchase price can automatically be calculated based on the bundle components.

Net transportation costs

Enter the net transportation costs for the variation.

Note: This value is used for price calculations and for calculating the acquisition price.

Net storage costs

Enter the net storage costs for the variation.

Customs

Enter the customs value as a percentage.