Skip to main content

ricardo.ch

With plentymarkets, you have full access to ricardo.ch, the biggest online market in Switzerland. Learn how to list your items, retrieve orders, and edit your listings. Invoicing and shipping is also carried out directly via your plentymarkets system.

1. Registering with ricardo.ch

First, register with ricardo.ch. After you have finished the registration, use the access data to set up your ricardo.ch account in plentymarkets. Please note that the ricardo.ch website is currently only available in German and French.

2. Setting up ricardo.ch in plentymarkets

In this chapter, you will learn how to create, edit and delete accounts as well as how to update your token. Furthermore, it is described how to create offer templates and text templates and how to set up event procedures for ricardo.ch.

2.1. Activating accounts

Go to System » Markets » ricardo » Accounts to activate new accounts for ricardo.ch. You need to have your access data consisting of the user name and password. Proceed as follows to add one or more accounts.

Activating a new account:

  1. Go to System » Markets » ricardo » Accounts.

  2. Click on Add account.
    → The window Unlock or change account opens.

  3. Enter a name for the Account.

  4. Click on the gear-wheel icon to unlock your account.
    → You are forwarded to ricardo.ch and have to authenticate your data.

  5. Enter the access data (nickname and password) of your ricardo.ch account and click on Authorize.

  6. Close the window.

  7. Click on Synchronise account data now (token).
    → The account is displayed in the Accounts menu.

When ricardo.ch is successfully connected to your plentymarkets system, the following automatic processes are available:

  • Hourly order import

  • Hourly data exchange

A token can be renewed no earlier than 24 hours before the regular duration ends.

Updating the token:

  1. Go to System » Markets » ricardo » Accounts.

  2. Click on Update token.
    → The window Unlock or change account opens.

  3. Click on the gear-wheel icon to update your token.
    → You are forwarded to ricardo.ch and have to authenticate your data.

  4. Enter the access data (nickname and password) of your ricardo.ch account and click on Authorize.

  5. Close the window.

  6. Click on Synchronise account data now (token).
    → The account is displayed in the Accounts menu.

Top up your credit balance

You can top up your ricardo.ch credit balance directly on ricardo.ch. You need to have credit in order to start listings.

Go to System » Markets » ricardo » Accounts to rename or delete accounts.

Renaming an account:

  1. Go to System » Markets » ricardo » Accounts.

  2. Click on the account you want to rename.

  3. Enter a new name.

  4. Click on Rename account.
    → The account is renamed.

Deleting an account:

  1. Go to System » Markets » ricardo » Accounts.

  2. Click on Delete account.
    → The account is deleted.

  3. Click on Reload to update the account list.

2.2. Updating options

The setting Update options in the System » Markets » ricardo » Accounts menu allows you to update your listing settings and to fix problems, e.g. if no payment method of a ricardo.ch listing has been selected.

Original currency and standard currency are different

Additional information is saved for orders that are imported with a different currency than the standard currency saved in plentymarkets. In this case, both the original currency and the original gross and net amounts will be saved for every item included in the order.

2.3. Synchronising offer templates

The setting Synchronise offer templates allows you to synchronise your ricardo.ch offer templates with plentymarkets. The offer templates are available for your ricardo.ch listings in the Listings » Edit listings menu. You can find them in the Market tab in the Link to template drop-down list.

2.4. Saving text templates for ricardo.ch

Go to System » Markets » ricardo » Settings to save texts for Terms of guarantee, Payment conditions and Delivery conditions, as well as texts for Automatic feedback. You can enter German and French text templates in the text fields. Expand Other to set which item name is to be used in the listing title or listing subtitle for the second language.

Table 1. Settings for the second language
Setting Explanation

Terms of guarantee;
Payment conditions;
Delivery conditions

Enter the condition texts for ricardo.ch in German and French. The texts are used in those listings for which you have selected the option According to the description in the drop-down lists for Warranty, Payment conditions and Delivery conditions in the Listings » Edit listings » Tab: Market menu.

Automatic feedback

Enter up to four feedback texts. These texts are randomly selected by plentymarkets and used to evaluate the purchaser.

Other

Select Name 1, Name 2 or Name 3 to determine the item names for listing title and subtitle in the second language. Select No subtitle if no subtitle is to be displayed for the ricardo.ch listings.

2.5. Automatically posting feedback

Set up an event procedure to automatically send feedback to ricardo.ch.

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window opens.

  3. Enter a name.

  4. Select the event listed in table 2.

  5. Save the settings.

  6. Configure the settings as described in Table 2 below.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 2. Event procedure for automatically posting feedback on ricardo.ch
Setting Option Selection

Event

Order change: Outgoing items booked

Filter 1

Order > Referrer

ricardo

Procedure

Market listings > Post feedback on ricardo

3. Preparing listings

Go to System » Listings to carry out the settings for all listings regardless of the market. In order to create listings in plentymarkets, you must carry out the following settings and have created your items.

3.1. Carrying out the basic settings

The settings in the System » Listings » Settings menu apply to all listings.

Carrying out the basic settings for listings:

  1. Go to System » Listings » Settings.

  2. Configure the settings as described in Table 3 below.

  3. Save the settings.

Table 3. Basic settings for listings
Setting Explanation

Create new market listing

Choose whether an error message should be shown if there is already a listing featuring this item or whether the system should not check for duplicate market listings.

Item name column for the listing title

Select Name 1, Name 2 or Name 3. This item name is transferred. Item names are entered in the texts tab of the item.

Other users will be logged out automatically

Whenever you carry out changes in this menu and save the settings, other users are logged out automatically and need to log in again. This ensures that the changes also apply to the other user profiles.

3.2. Setting up stock

Decide whether to automatically end listings and adjust their quantity to the net stock in the System » Listings » Stock menu. Furthermore, select the warehouse which should be used for listings. Note the specifications of the market concerning the termination of listings and legal regulations.

Setting up stock:

  1. Go to System » Listings » Stock.

  2. Configure the settings as described in Table 4 below.

  3. Save the settings.

Table 4. Options for stock
Setting Explanation

End/hide offers automatically

Select deactivated or activated.
activated = All listings are automatically ended if an item reaches a stock of 0 or lower and if the setting limited (without reservation) is saved in the listing for the option Stock dependence.
deactivated = All listings continue until they are manually ended or until they expire.

Adjust quantity to the net stock when listing

Select deactivated or activated.
activated = If the setting limited (with reservation) or limited (without reservation) is saved in the listing for the option Stock dependence, then the quantity will be adjusted to the net stock.
deactivated = The listing is only listed if there is sufficient stock available. In this case, sufficient means that stock is larger than the maximum quantity for sale, selected in the listing.

Warehouse selection

Select whether items are to be used only from the main warehouse or from all available distribution warehouses.

It is not possible to end offers with bids

It is not possible to end a listing in plentymarkets if a bid already exists for it.

3.3. Setting up the checkout process

Carry out the settings for the listings' checkout in the System » Listings » Checkout menu.

Setting up the checkout:

  1. Go to System » Listings » Checkout.

  2. Configure the settings as described in Table 5 below.

  3. Save the settings.

Table 5. Settings for the checkout
Setting Explanation

Default order status

Select Status 1 (incomplete data) or Status 3 (waiting for payment).
Status 1 = The customer is guided through the order process and has to actively complete all steps. This takes place within the online store and therefore, the customer is encouraged to buy additional items.
Status 3 = The customer receives a summary of the order and does not have to be active. However, the customers can change some data, e.g. their addresses.
You can also change the order status in the listing settings. This listing setting takes priority over the setting that is chosen here.

Default order status for orders containing unknown items (ID: -2)

Select Status 2 (waiting for activation) or Status 3 (waiting for payment). If a listing cannot be assigned to an item during the order import, it receives the ID -2.

Item names in order items

Select Copy item name from the market or Copy item name from the store.
Copy item name from the market = The item name is transferred from the market.
Copy item name from the store = The item name saved in plentymarkets is transferred.

Down-selling in the checkout process

Select Enable or Disable.
Down-selling means that the customer can reduce the quantity purchased on ricardo during the checkout. Up-selling is generally possible for fixed-price items. This is why it cannot be selected here.

Shipping costs for new orders coming from ricardo

Select Transfer from ricardo or Have it calculated by plentymarkets.
Transfer from ricardo = Shipping costs are transferred from ricardo.
Have it calculated by plentymarkets = Shipping costs are calculated based on the shipping profiles in plentymarkets.

Shipping costs for items purchased during checkout

Select how shipping costs are calculated if the customer increases the quantity purchased during the checkout.
Regular = The extra shipping charge entered in the item’s settings is added to the shipping costs.
No further shipping costs = No extra shipping costs are added for items purchased during checkout.
Yes, but with online store shipping costs = The shipping costs of the online store are added.

Item assignment after sale

Select one of the following options to assign a listing to an item during the order import:
Automatically
No automatic assignment based on title
No automatic assignment
Automatic assignment based on title only
Assignment based on external item ID
Assignment of SKU to variation number
The item ID -2 is used if a listing could not be assigned or should not be assigned.

3.4. Setting up the listing scheduler

With plentymarkets, you can automatically place listings on the market at a certain time and you can automatically restart finished listings. Use the listing scheduler to set up these automatic procedures. Listings can be linked to several listing schedulers.

If you want plentymarkets to automatically start listings at a certain time, you have to define time intervals in the listing scheduler. Either select days of the week or up to three days of the month in the listing scheduler. In both cases, you also have to choose starting times for the listing.

Setting up the listing scheduler:

  1. Go to System » Listings » Scheduler.

  2. Click on Create new listing scheduler to add a new listing scheduler.

  3. Carry out the settings as described in Table 6 below.

  4. Save the settings.

Table 6. Settings for the listing scheduler
Setting Explanation

Name

Enter a name for the listing scheduler.

Lister

Select Active or Inactive (do not list any listings).

Runtime

Select use listing runtime or select one of the given runtime options in days. If a runtime in days is selected for the listing scheduler, the system will always use this runtime for the listing even if a different runtime has been entered for the listing itself.

Start times

Define one or several daily starting times. For technical reasons, if you select several starting times, then they all have to be at least 60 minutes apart from each other.

Distribution

Select a time limit in minutes. The listings linked to this listing scheduler will be started in equal time intervals throughout the selected period of time. If the value 120 minutes was selected for the distribution of 10 listings, then one listing would be started every 12 minutes.

Day

Define up to three days that listings should be started on.

Weekday

Activate days of the week that the listing should be started on.

3.5. Managing layout templates

Use layout templates to give listings a certain layout. The advantage of such a template is that you use plain text only in the actual item description without any design elements. This reduces the need for maintenance of the item description. Furthermore, basic and general information such as the legal disclosure and shipping information can be saved in the layout template. When adjusting the layout template, these adjustments are applied to all listings linked to this template. In plentymarkets, you can create and adjust as many layout templates as you like.

Layout templates for listings use the same structure as the plentymarkets web design. The content that you want to display for listings can be saved using template variables and functions in the Main frame tab in the System » Listings » Layouts menu. The content is structured with HTML and CSS. The different tabs are described below.

Commissioning third-party providers

HTML and CSS skills are necessary to create a layout template. We recommend that you commission a service provider to create a layout template if you are not experienced in doing so. Go to System » Listings » Layouts to import a layout template that was created externally into plentymarkets.

Main frame

In the Main frame tab, enter the visible content for listings that are set up with this layout template. Replace dynamic content such as the item description, item images, listing description and so on with template variables and functions. They are replaced by the corresponding content of the listing.

HTML structure

In the HtmlStructure tab, enter the HTML code that provides the content of the layout template with the desired structure. The template variable $MainFrame displays the dynamic content saved in the Main frame tab.

CSS

In the CSS tab, set up the cascading style sheet (CSS) that is used to display the layout template. CSS denotes a mark-up language for structured documents. While HTML lets you create the pure content, CSS offers you more possibilities to influence the format and structure of this content, e.g. font type and size.

3.5.1. Creating layout templates

Creating a layout template:

  1. Go to System » Listings » Layouts.

  2. Click on Add.
    → The Create new layout window opens.

  3. Enter a name for the new layout template.

  4. Save the settings.
    → The new layout template is created and displayed in the overview.

  5. Enter code into the Main frame, HtmlStructure and CSS tabs.

  6. Pay attention to the explanations given in Table 7 and carry out the settings in the Settings tab as desired.

  7. Save the settings.

Table 7. Layout templates
Setting Explanation

LayoutTitle

Enter a name for the layout template.

plentymarkets signature

Select which plentymarkets signature is to be used in the listing.
plentymarkets logo and slogan = The standard signature is displayed.
plentymarkets logo, slogan and privacy policy = The plentymarkets signature is displayed including a note about the privacy policy.
Slogan = The plentymarkets signature is displayed without a logo.

Gallery 1-3

Enter the JavaScript code for the content of the data fields Gallery 1 to 3. Enter the template variable at the desired location within the Main frame tab of the layout template.
Make sure that the images used are available via URL. To do so, upload the images on the server e.g. using FTP or the image gallery.

3.5.2. Example code for a layout template

An example code for a layout template is available below. Image 1 shows the preview of a listing that is linked to a layout template based on this code. In this example, plentymarkets logo and slogan was selected for the option plentymarkets signature in the Settings tab.

DE Einstellungen Listings Layout Vorlagen 01

Image 1: Linking listings to different layout templates

Main frame

Example code tab: Main frame

Example of how visible listing content can be represented:

<div class="wrapper clearfix">
	{% $_categories = GetListingStoreCategories('tree') %}

<ul>
{% for $_levelOneCategory in $_categories %}
	<li>
	{% $_name  = $_levelOneCategory['name'] %}
	{% $_url = $_levelOneCategory['url'] %}

	<a href="$_url">$_name</a>

	{% if count($_levelOneCategory['children']) %}
		<ul class="children">
			{% for $_levelTwoCategory in $_levelOneCategory['children'] %}
				<li class="child-level">
					{% $_name = $_levelTwoCategory['name'] %}
					{% $_url = $_levelTwoCategory['url'] %}
					<a href="$_url">$_name</a>
				</li>
			{% endfor %}
		</ul>
	{% endif %}
	</li>
{% endfor %}
</ul>

	<div style="width: $_listingWidth; float: left;" class="listing-content">
		<h1>{% GetItemName(1) %}</h1>
		<span class="item-data">Art.-Nr. $ItemId</span>
		<figure>$MiddleSizeImage[1]</figure>
		<div class="price-block">
			{% if $ListingType == $LISTING_TYPE_FIXED %}
				Jetzt kaufen: $BuyItNowPrice Euro
			{% else %}
				Startpreis: $MinimumBid Euro
			{% endif %}
		</div>

		<hr>
		{% GetItemDescription() %}
		<hr>

		{% if $Free[3] %}
			<span class="info">Artikel umfasst: $Free[3]</span>
		{% else %}
			<span class="info">Artikel ohne Zubehör</span>
		{% endif %}

		<div class="item-properties">
			<b>Merkmale:</b>
			{% $_propertyList = ["Farbe", "Material"] %}
			{% for $_key,$_property in $_propertyList %}
				{% GetItemPropertyByName($_property, $PROPERTY_VALUE) %}
				{% if ($_key + 1) < count($_propertyList) %},{% endif %}
			{% endfor %}
		</div>

		<div class="properties-list">
			{% PropertyList() %}
		</div>
	</div>
</div>

HTML structure

Example code tab: HtmlStructure

Example code of a possible HTML structure:

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>$ListingTitle</title>
    {% GetCSSFile() %}
</head>
<body>
    $MainFrame
</body>
</html>

CSS

Example code tab: CSS

Example code of a possible CSS structure:

/* General styling */
* {
   margin: 0px;
   padding: 0px;
}

body {
    font-family: Arial;
    font-size: 12px;
}

ul
{
    margin: 10px 0;
    list-style-type: none;
}

hr {
    border: medium none;
    border-bottom: 1px solid #ccc;
    margin-bottom: 10px;
}

.wrapper {
    width: 640px;
    margin: 10px auto;
}


/* Menu */
.menu {
    float: left;
    width: 200px;
}

.left_menu {
    margin: 0;
}
    .left_menu li {
        border-bottom: 1px solid #ccc;
    }
        .left_menu li:last-child {
            border-bottom: medium none;
        }

        .left_menu > li > ul,
        .left_menu > li > ul > li > ul {
            margin: 0 0 0 30px;
            display:none;
        }

        .left_menu li a {
            color: #222;
            text-decoration: none;
            display: block;
            padding: 5px;
        }
            .left_menu li a:hover {
                background: #222;
                color: #fff;
            }


/* Listing Content */
.listing-content {
    float: left;
    padding: 20px;
}
    .listing-content .item-data {
        color: #999;
        font-size: 11px;
    }

    .listing-content figure {
        text-align: center;
    }

    .listing-content .price-block {
        font-size: 22px;
        font-weight: bold;
        text-align: right;
    }

    .listing-content p {
        line-height: 16px;
    }

/* Info element block */
.info {
    font-weight: bold;
    margin: 10px 0;
    display: block;
}

    .info::before {
        content: 'i';
        padding: 5px 0;
        font-size: 15px;
        border: 1px solid lightblue;
        border-radius: 65px;
        width: 23px;
        height: 12px;
        display: inline-block;
        text-align: center;
        font-family: initial;
        background: lightblue;
        color: white;
        margin-right: 6px;
    }


/* Auto-Generated Character List */
.PlentyArticleCharacterList {
    margin: 0 10;
}
    .PlentyArticleCharacter > div {
        float: left;
    }

    .PlentyArticleCharacterName {
        font-weight: bold;
        margin-right: 5px;
    }


/* Clearfix */
.clearfix:before,
.clearfix:after,
.PlentyArticleCharacter {
    content: " "; /* 1 */
    display: table; /* 2 */
}


.clearfix:after, .PlentyArticleCharacter:after {
    clear: both;
}

3.5.3. Importing layout templates

It is possible to create and edit layout templates externally and then import them into plentymarkets. A ZIP file is used for the import.

Importing layout templates:

  1. Go to System » Listings » Layouts.

  2. Click on Import.
    → The Import layout window opens.

  3. Enter a name for the new layout template.

  4. Click on Upload files.

  5. Select the ZIP file that includes your layout template in the Upload files window.

  6. Click on Open.
    → The layout template is imported and displayed in the overview.

3.5.4. Linking a layout template

Now link the listings to the layout template. Use one listing template for several listings. Individual listings are linked directly within the listing.

Linking listings to layout templates:

  1. Go to Listings » Edit listings.

  2. Open a listing and click on the Description and layout tab.

  3. Use the drop-down list to select which layout template you want to link to the listing.

  4. Save the settings.
    → The listing is linked to this layout template.

3.5.5. Template variables and template functions

Fill the HTML layout with the desired and necessary template variables and functions and this way, have the corresponding content of the listing placed in the layout. Pay attention to upper and lower case letters in the template variables and functions.

Fill in the item description {% GetItemDescription() %} instead of the description that is saved with the listing. This way, you only need to maintain one description text for your online store and listings.

The following table explains the template variable and functions in the Layout templates menu in alphabetical order:

Table 8. Template variables and template functions for layout templates
Variable/function Explanation

Function

{GetCSSFile() %}

Generates the <link> tag for the CSS file.

{% GetItemDescription() %}

Item description
Optional parameter:
lang = language that should be used. The following languages can be used: DE, EN, FR, IT, ES, TR, NL, PL, NN, DA, SE, CZ, ZH, VI
*Examples:*
GetItemDescription() = Item text in the listing’s language
GetItemDescription('en') = Item text in English

{% GetItemName() %}

Item name
Optional parameters:
nameId = name that should be displayed (1–3)
lang = language that should be used. The following languages can be used: DE, EN, FR, IT, ES, TR, NL, PL, NN, DA, SE, CZ
*Examples:*
GetItemName() = Name 1 in the listing’s language
GetItemName(2, 'en') = Name 2 in English

{% GetItemPropertyById() %}

Item properties
The following parameters are required:
character ID = ID of the property
type = unit or value
*Examples:*
GetItemPropertyById(2, 'unit') = Unit type of the property with ID 2
GetItemPropertyById(3, 'value') = Value of the property with ID 3

{% GetItemPropertyByName() %}

Item properties
The following parameters are required:
characterName = The property’s back end name
type = unit or value
*Examples:*
GetItemPropertyByName('abstract_motives', 'unit') = Unit type of the property with the backend name "abstract_motives"
GetItemPropertyByName('abstract_motives', 'value') = Value of the property with the back end name "abstract_motives"

{% GetItemShortDescription() %}

Item preview text
Optional parameter:
lang = language that should be used. The following languages can be used: DE, EN, FR, IT, ES, TR, NL, PL, NN, DA, SE, CZ, ZH, VI
*Examples:*
GetItemShortDescription() = Preview text in the listing’s language
GetItemShortDescription('en') = Preview text in English

{% GetItemTechnicalData() %}

Technical data
Optional parameter:
lang = language that should be used. The following languages can be used: DE, EN, FR, IT, ES, TR, NL, PL, NN, DA, SE, CZ, ZH, VI
*Examples:*
GetItemTechnicalData() = Technical data in the listing’s language
GetItemTechnicalData('en') = Technical data in English

{GetPlentymarketsBranding() %}

Displays the plentymarkets signature (table 1).

{% PropertyList() %}

Property list

Variable

$AgeRating

Age rating

$BasePrice

Unit price

$BasePriceLot

Content for unit price

$BasePriceUnit

Unit for unit price
Usually, e.g. for food items, a unit price as well as the unit or a reference quantity has to be specified. Please make sure to comply with the according legal regulation in your country.

$BuyItNowPrice

Fixed price (buy it now)

$EbayStoreNavigation

eBay shop category link list

$Free[1] …​ $Free[20]

Free item variables

$Gallery[1], $Gallery[2], $Gallery[3]

Fills in the content of the listing gallery data field (see above).
Examples: http://www.sellerfox.de, http://www.ayee.net

$GalleryImage

Gallery image

$GalleryImageURL

Gallery image URL

$Image[1], $Image[2], …​

Item images

$ImageURL[1], $ImageURL[2], …​

Item images URL

$ItemAvailabilityDetails

Stock overview diagram

$ItemAvailabilityIcon

Availability symbol

$ItemAvailabilityString

Availability text

$ItemConditionId

Item condition
0: New
1: Used
2: NEW & with original packaging
3. NEW with label

$ItemEAN

EAN

$ItemHeight

Height

$ItemId

Item ID

$ItemISBN

ISBN

$ItemLength

Length

$ItemMedia

Item media

$ItemModel

Model

$ItemNo

Item number

$ItemProducer

Manufacturer

$ItemRRP

RRP

$ItemShipping[1], $ItemShipping[2]

Extra shipping charge 1 / 2

$ItemWeight

Weight

$ItemWidth

Width

$ListingDescription

Listing description

$ListingTitle

Title of the listing

$ListingSubitle

Subtitle of the listing

$Lot

Content

$MiddleSizeImage[1], $MiddleSizeImage[2], …​

Medium-sized item image

$MiddleSizeImageURL[1], $MiddleSizeImageURL[2], …​

URL of medium-sized item image

$MinimumBid

Listing starting price

$PreviewImage[1], $PreviewImage[2], …​

Preview images

$PreviewImageURL[1], $PreviewImageURL[2], …​

Preview images URL

$ProducerLogo

Manufacturer logo

$ProducerURL

Manufacturer URL

$ReferrerID

ID of the referrer

$ReleaseDate

Release date

$Unit

Unit (gram, litre, pieces)

$UnitString[1], $UnitString[2]

Item unit 1 / 2

$VAT

VAT

Use if-logic

You can use the if/else logic for layout templates. It functions the same way that the logic works in the plentymarkets web design area.

Listings for ricardo

Since ricardo does not allow the use of special HTML tags, only the information saved for the linked layout template in the Main frame tab are displayed in the ricardo listings.

3.6. Creating directories

Create any number of directories or subdirectories for organising your listings.

Creating directories:

  1. Go to System » Listings » Directories.

  2. Click on the New directory tab.

  3. Enter a name for the directory or subdirectory.
    → If you want to create a subdirectory, use the Directory option to select which main directory it should be in.

  4. Save the settings.

3.7. Editing directories

Rename or delete your subdirectories and directories here.

Editing a directory:

  1. Go to System » Listings » Directories.

  2. Click on the Directory tab.

  3. Edit or delete the directory.

  4. Save the settings.

4. Creating listings

plentymarkets provides you with multiple possibilities for creating listings. Make sure that you create your items first. Then create your listings in the item overview using batch processing or via an existing listing. Use the data format ItemListingMarketRicardo in order to automatically create large quantities of items.

4.1. Creating a new listing

You can create a new listing in the menu Item » Edit item by clicking on the New listing procedure in the line of an individual item.

Or: Open an item and click on New listing in the tool bar.

Creating a new listing:

  1. Go to Item » Edit item.

  2. Click on New listing in the line of an item.
    → The New market listing window opens.

  3. Carry out the settings and pay attention to the explanations given in Table 9.

  4. Save the settings.
    → The listing is created and the listing overview opens.

Table 9. Settings in the window New market listing
Setting Explanation

Item ID

The ID appears automatically. It is the same ID that the item has. Click on the ID to open the item in the background.

Type

Select the listing type. For ricardo, the listing types Auction and Fixed price are available.
The listing type Shop item is only available for Hood and cannot be selected for ricardo.

Number per lot

Define the quantity of items offered in a single listing. The listing price applies to the entire quantity.

Stock dependence

Select the stock dependence of the listing. Select one of the following options:
unlimited (with synchronisation) = The maximum amount that can be purchased is transferred to the platform. The current stock is not taken into consideration for this setting. Once the stock has been synchronised with plentymarkets, the maximum amount that can be purchased is offered again on the platform.
limited (with reservation) = The current stock from the warehouse is transferred. If the stock in the warehouse exceeds the maximum amount that can be purchased, then only the amount that is set in the listing is transferred. The amount is reserved for the current listing. This amount is not available for other markets.
limited (without reservation) = The current stock from the warehouse is transferred. If the stock in the warehouse exceeds the maximum amount that can be purchased, then only the amount that is set in the listing is transferred. The amount is not reserved for the current listing. The amount is available for other markets. Overselling can occur if the item is purchased on several different markets at the same time.
unlimited (with synchronisation) = The maximum amount that can be purchased is transferred to the platform. The current stock is not taken into consideration for this setting. Once a purchase is made, the quantity is not synchronised and not refilled, but it remains as it is.

Tie to item price

Tie the price of the fixed price listing to the item price. When the price changes, it is not automatically changed on the market. You have to update the price manually or carry out a stock synchronisation. The price on the market can also change after the stock is synchronised if the exchange rate changed.

Transfer as item number

Select one of the following options which is transferred as the item number:
do not transmit = No item number is transferred.
Transmit EAN = The International Article Number (EAN) is transferred.
Transmit ISBN = The ISBN is transferred.
transmit ePID = The eBay Product ID is transferred.
Transmit UPC = The Universal Product Code is transferred. In order to use this option, an EAN has to be selected for the setting UPC from EAN field.
transmit MPN = The Manufacturer’s Part Number is transferred.
Transmit GTIN = The Global Trade Item Number is transferred.
Custom-made or no-name product = Select this option if the item is not uniquely identified or if it is not a brand-name item.

Content

Select the listing’s content.

Markets

Select one or multiple markets. eBay, Hood and ricardo are available.

Listing template

Select a listing template.

4.2. Adding a market listing to an existing listing

If you have already created a listing for an item, then you can add further market listings to it.

Creating a new market listing:

  1. Go to Listings » Edit listings.

  2. Click on the Listing ID (LID) to open a listing.
    → Make sure that you click on the Listing ID (LID) and not on the market listing ID.

  3. Click on New Market listing.
    → A new window opens.

  4. Select one or more markets.

  5. Save the settings.
    → The market listing is created and opened.

For further information about the settings of a market listing, refer to the Editing listings chapter.

4.3. Creating multiple listings

Create multiple listings with the Group function or the Batch processing function in the Item menu. The group function creates listings for previously selected items. The batch processing function creates listings for previously filtered items. If no listing template is selected in the menu Item » Edit item » Tab: Multi-Channel in the section Listing default settings, then eBay listings are created automatically. If you want to create multiple ricardo listings, then make sure you selected a listing template with specific settings for ricardo in the menu Item » Edit item » Tab: Multi-Channel in the section Listing default settings.

Creating multiple listings with the group function:

  1. Go to Item » Edit item.

  2. Activate the items that you want to create listings for.

  3. Click on Group function.

  4. Activate the option Create listing in the Procedures area.
    → Irrelevant settings are greyed out.

  5. Click on Apply to create the listings.

Creating listings with batch processing:

  1. Go to Item » Batch processing.

  2. Filter the items.

  3. Activate the option Create listing in the Procedures area.
    → Irrelevant settings are greyed out.

  4. Click on Apply to create the listings.

Filtering categories

If you want to create listings for items in a specific category, then select the category in the appropriate level. You do not have to select the parent categories.

5. Editing listings

All listings are displayed in the Listings » Edit listings menu. This listing overview displays the most important settings at a glance. Use the Customise the layout function to select the settings to be displayed. Make changes to individual listings in the overview. Furthermore, edit multiple listings with the Group function or the Batch processing function.

Table 10. Listing overview
Setting Explanation

MLID

ID of the market listing.

LID

ID of the listing.

Item ID

ID of the item associated with the listing.

Variation No.

Item number of the item associated with the listing.

Directory

Directory that the listing was sorted into in the Listings » Edit listings » Tab: Base menu.

Platform

Market or platform on which the listing is offered.

Category

The listing’s category. The category is displayed, set or edited in the Market tab.

Title

Name of the listing.

Duration

Duration of the listing.

Quantity

Maximum number of items to be sold on this market.

Stock (net)

Net stock of the listing.

Stock dependence

Stock dependence of the listing. The listing depends on the stock availability or not.

Verification

Verification of the listing’s settings. The result is displayed here.

Listing fee

Listing fee of the listing. The fee is calculated by the market based on the selected settings.

Fixed price

Price for fixed price offers.

Starting price

Price of the listing when it is started.

Lister

Endless listers set up for the listing are displayed here. The listing will continuously be started automatically.

Online status

Status of the listing. Displays whether the listing is active.

Special sale

Special sales set up for the listing are displayed here.

5.1. Editing an individual listing

All created listings are displayed in the listing overview. Open a market listing to change the basic settings and market settings as well as edit texts and the layout. Proceed as follows to edit a listing.

Editing a market listing:

  1. Go to Listings » Edit listings.

  2. Click on a market listing.
    → The market listing opens.

  3. Carry out the settings and pay attention to the explanations given in Table 11, Table 12, and Table 13.

  4. Save the settings.

Table 11. Editing a market listing
Setting Explanation

Save

Save the settings. Changes to listings become effective after saving the settings.

Copy

Copy the market listing with all of its settings.

Listing scheduler

Select a listing scheduler for the market listing. Select a listing scheduler in the Activate listing scheduler window.

Start

Start market listing. Select a starting time in the Start market listing window.

Listing template

Apply a listing template to the market listing. Select a listing template in the Apply listing template window.

Preview

Open the market listing’s preview window.

Active listing

Open an overview of all active listings.

LID

Open an overview of all market listings for this listing ID.

Item ID

Open the item associated to the market listing.

Check

Check whether the market listing is ready to be uploaded to ricardo.

Delete

Delete the market listing.

5.1.1. Carrying out the basic settings

The Base tab of a market listing includes settings that apply to all markets and platforms. The options in this tab may differ from one listing type to another. For example, a fixed price listing does not include the options Starting price and Minimum price.

Table 12. A market listing’s Base tab
Setting Explanation

Last change

Date and time when changes were last made.

Listing fee

Fee that needs to be paid for the listing. The fee is calculated by the market based on the selected settings.

Active

Activate the listing. Active listings are automatically started with the listing scheduler. It is not possible to click on Start until the listing is activated.

Market

The market that the listing is set up for.

Account

The account that the market listing was set up with. The account can be changed.

Directory

The directory that the market listing was sorted into. The directory can be changed.

Duration

Determine the duration from 1 day to 10 days.

Endless lister

Activate the endless lister to automatically start the listing over and over again.

Market listings active at the same time

Choose 1 to 8 listings that can be active at the same time. This setting is only available if Endless lister is active.

Maximum quantity for sale

The maximum number of items to be sold on this market.

Starting price

Enter an amount. The listing of the type Auction is started with this price.

Minimum price

Enter the minimum price. Offers are then accepted or rejected automatically based on this price.

Fixed price

Enter an amount for a listing of the type Fixed price. If you activated the option Tie to item price when creating the listing, the fixed price will be displayed in CHF and cannot be changed.

VAT

Select the country and the VAT rate. If the options No country and No VAT are selected, then no VAT is displayed in the listing.

Add unit price specification

Select whether the unit price (e.g. £10 per litre) should be displayed and where it should be displayed.

Order status

Select a status that the sold listing should be imported with.

Warehouse

Select a warehouse or use the basic setting that was selected for the Warehouse selection option in the Stock menu.

List with all variations

Activate to upload the listing with all variations. This option must be deactivated for ricardo.

Variations

Select an item’s variation that is to be uploaded to the market.

5.1.2. Editing the description and the layout

Use the Description and layout tab to enter texts for the listing and to select a layout.

Table 13. A market listing’s Description and layout tab
Setting Explanation

Title

The item name is transferred by default. The title can be changed.

Subtitle

Enter a subtitle.

Layout template

Select a layout template.

Number of images

Select how many images should be uploaded for the market listing. A maximum of 12 images can be transferred.

Language

Select a language. The listing is uploaded to the market in this language. If language-neutral template variables are used in the description, then the text is displayed in the language that was selected here.

Description

Enter a description for the market listing.
Click on Insert item description to insert the item description into this text field. The language that is selected above needs to be the same language as the item description.
The Set up editor function is available for editing the description in the syntax editor. Specify whether you want to display control characters and spaces instead of tabs.

5.1.3. Changing the market settings

In the Market tab you can change the settings for the market ricardo.

Table 14. A market listing’s Market tab
Setting Explanation

Category 1 ID

Enter a category ID or click on Search to select a category.

Condition

Select the item condition. The options will become visible once the category has been selected.

Warranty

Select No warranty or According to the description. Enter a descriptive text under terms of guarantee.

Conditions

Select According to the description, upon pick-up or in advance. Enter a descriptive text under payment conditions. As an alternative, the customer pays upon pick-up of the item or before receiving the item.

Payment methods

Activate one, several or all payment methods for the listing.

Delivery costs

Enter an amount for the shipping costs. The shipping costs are specified here for every individual listing.

Individual shipping costs for each item

Activate in order to calculate individual shipping costs for every item sold.

Delivery conditions

Select the delivery conditions. Enter a descriptive text for the option According to the description under delivery conditions.

Package size

Select the size of the letter or package.

Availability

Select the availability to determine how quickly the item can be delivered to the customer.

Additional options

Activate one, several or all options. Further information about the additional options for ricardo can be found on the ricardo website (German and French only).

Increment

Enter an amount. Customers need to increase the current offer by this amount.

Number of reactivations

Select how often the item should be reactivated.

Reactivate until sold out

Activate in order to reactivate items until they are sold out.

Use secondary language

Activate the secondary language. It is possible to list ricardo listings in German and French at the same time. The secondary language is exported from the item master data. It is therefore necessary that you save all descriptions for the item in both languages.

Link to template

Select an offer template which should be used for the listing (German and French only).

5.2. Editing multiple listings

Edit multiple listings with the Group function or the Batch processing function in the Listings menu. The group function edits previously selected listings. The batch processing function edits previously filtered listings.

Which method should you use?

It will be faster to use the group function or batch processing depending on the number and type of listings you want to edit. Use batch processing with the Manufacturer filter if you only want to edit the listings of a certain manufacturer. This way, you can edit all of the listings for one manufacturer without having to select every single listing. Use the group function if the listings you wish to edit cannot be grouped with a certain filter.

Using the group function:

  1. Go to Listings » Edit listings.

  2. Select the listings that you want to edit.

  3. Click on Group function.
    → The Group function window opens.

  4. Configure the settings as described in Table 15 below.

  5. Click on Execute to apply the settings to the listings.

Table 15. Editing listings with the Group function or Batch processing
Setting Explanation

Procedures

Start listing

Activate this option to start the listings.
Start at time above = Select a date and time. The listings are started at this time.
Start within = Select a time period. The listings are started within this time period. The time interval between listings changes depending on the number of listings.

Copy listings

Activate to copy the selected listings.

Copy item description

Activate to use the item description as the listing description.

Copy item name

Activate and select a name. This name is saved in the selected listings.

Check market listings

Activate to check the selected market listings.

Delete listings

Activate to delete the selected listings.

Listing settings

Tie to item price

Tie the price of the fixed price listing to the item price. When the price changes, it is not automatically changed on the market. You have to update the price manually or carry out a stock synchronisation. The price on the market can also change after the stock is synchronised if the exchange rate changed.

Stock dependence

Select the stock dependence of the listing.

Number per lot

Define the quantity of items offered in a single listing. The listing price applies to the entire quantity.

Transfer as item number

Select which number should be transferred as the item number.

Type

Select the listing type. For ricardo, the listing types Auction and Fixed price are available.

ricardo

Account

The account that the market listing was set up with. The account can be changed.

Category

Enter a category ID or click on Search to select a category.

Condition

Select the item condition. The options will become visible once the category has been selected.

Duration

Determine the duration from 1 day to 10 days.

Payment methods

Activate one, several or all payment methods for the listing.

Warranty

Select No warranty or According to the description. Enter a descriptive text under terms of guarantee.

Conditions

Select According to the description, upon pick-up or in advance. Enter a descriptive text under payment conditions. As an alternative, the customer pays upon pick-up of the item or before receiving the item.

Delivery costs

Enter an amount for the shipping costs. The shipping costs are specified here for every individual listing.

Individual shipping costs for each item

Activate in order to calculate individual shipping costs for every item sold.

Delivery conditions

Select the delivery conditions. Enter a descriptive text for the option According to the description under delivery conditions.

Package size

Select the size of the letter or package.

Availability

Select the availability to determine how quickly the item can be delivered to the customer.

Additional options

Activate one, several or all options. Further information about the additional options for ricardo can be found on the ricardo website (German and French only).

Number of reactivations

Select how often the item should be reactivated.

Reactivate until sold out

Activate in order to reactivate items until they are sold out.

Subtitle

Enter a subtitle.

Use secondary language

Activate the secondary language. It is possible to list ricardo listings in German and French at the same time. The secondary language is exported from the item master data. It is therefore necessary that you save all descriptions for the item in both languages.

Link to template

Select an offer template which should be used for the listing (German and French only).

Market listing settings

Directory

The directory that the market listing was sorted into. The directory can be changed.

Warehouse

Select a warehouse or use the basic setting that was selected for the Warehouse selection option in the Stock menu.

Order status

Select a status that the sold listing should be imported with.

Endless lister (listings active at the same time)

Activate to select 1 to 8 listings that can be active at the same time.

Layout template

Select a layout template.

Language

Select a language. The listing is uploaded to the market in this language. If language-neutral template variables are used in the description, then the text is displayed in the language that was selected here.

Ready for use

Activate the listing. Active listings are automatically started with the listing scheduler. It is not possible to click on Start until the listing is activated.

Unit price specification

Select whether the unit price (e.g. £10 per litre) should be displayed and where it should be displayed.

VAT

Select the country and the VAT rate. If the options No country and No VAT are selected, then no VAT is displayed in the listing.

Starting price

Enter an amount. The listing of the type Auction is started with this price.

Minimum price

Enter the minimum price. Offers are then accepted or rejected automatically based on this price.

Fixed price

Enter an amount for a listing of the type Fixed price.

Number of images

Select how many images should be uploaded for the market listing. A maximum of 12 images can be transferred.

Maximum quantity for sale

The maximum number of items to be sold on this market.

List all variations

Activate to upload the listing with all variations. This option must be deactivated for ricardo.

Listing scheduler

Select a listing scheduler for the market listing. Select a listing scheduler in the Activate listing scheduler window.

Carrying out batch processing:

  1. Go to Listings » Batch processing » Listings.

  2. Select the filters based on Table 16.

  3. Configure the settings as described in Table 15 below.

  4. Click on Execute to apply the settings to the listings.

Table 16. Filter options for batch processing
Setting Explanation

MLID

Select the operator and enter one or more market listing IDs to filter market listings. Use commas to separate multiple market listing IDs.

LID

Select the operator and enter one or more listing IDs to filter listings. Use commas to separate multiple listing IDs.

Directory

Select a directory or ALL directories.

Flag 1;
Flag 2

Select a flag to only display listings with this flag.

Item ID

Enter an item’s ID to search for the listings that include this item. Use commas to separate multiple item IDs.

Variation No.

Enter an item’s number to search for the listings that include this item. Wildcard search, i.e. displays all listings that include item numbers starting with this sequence.

Store visibility

Select one of the following options for the visibility of listings in the online store:
ALL = All of the listings are edited.
Invisible = Only invisible listings are edited.
Visible = Only visible listings are edited.
Only invisible in item listings = Items are neither displayed in a category nor are they displayed with the search function. Items are only displayed with a direct link.

Available

Select an availability or ALL to only edit listings that include items with the selected availability.

Stock

Select a stock level or ALL to only edit listings that include items with the selected stock level.

Warehouse

Select a specific warehouse or ALL to only edit listings that include items with this warehouse as the main warehouse.

Manufacturer

Select a manufacturer or ALL to only edit listings that include items with the selected manufacturer.

Market

Select a market or ALL to only edit listings uploaded to the selected market.

Account

Select an account or ALL to only edit listings uploaded with the selected account.

6. Copying listings

You can copy one or more listings at the same time. Copying listings can be useful if you want to upload another listing for the same item but you want to change a few of the options. In order to avoid duplicate listings in your plentymarkets system, change the settings of the listing after copying.

6.1. Copying an individual listing

Copy a market listing, e.g. if you want to upload the same listing with a different variation to ricardo. The copied listing has the same settings as the original. You only have to change the variation after copying.

Copying a market listing:

  1. Go to Listings » Edit listings.

  2. Open a market listing.

  3. Click on Copy.
    → You are asked to confirm your decision.

  4. Click on Copy.
    → The market listing is created and opened.

For further information about the settings of a listing, refer to the Editing listings chapter.

6.2. Copying multiple listings

Copy multiple listings with the Group function or the Batch processing function in the Listings menu. The group function copies previously selected listings. The batch processing function copies previously filtered listings.

Using the group function to copy listings:

  1. Go to Listings » Edit listings.

  2. Activate the listings that should be copied.

  3. Click on Group function.

  4. Activate the option Copy listings in the Procedures section.

  5. Click on Execute to copy the listings.

Using batch processing to copy listings:

  1. Go to Listings » Batch processing » Listings.

  2. Filter the listings.

  3. Activate the option Copy listings in the Procedures section.

  4. Click on Execute to copy the listings.

Copying and changing listings

If you change settings in the batch processing or group function area and you select the procedure Copy listings, then the settings are applied to the copied listings. This means that your listings are changed when copied.

7. Searching for listings

Filters help you to search for listings. For example, with the Market filter, you only display listings of a single market. If no filters are used, all listings are displayed in the overview. You can also filter by categories and directories.

7.1. Filtering by settings

The following filters and functions are available in the Listings » Edit listings menu:

Table 17. Filter options for listings
Setting Explanation

Search

Perform a search.

Reset

Reset filters.

Market listing ID

Enter one or more market listing IDs. Use commas to separate multiple market listing IDs.

Listing ID

Enter one or more listing IDs. Use commas to separate multiple listing IDs.

Item ID

Enter one or more item IDs. Use commas to separate multiple item IDs.

Variation No.

Enter an item’s number to search for the listings that include this item. Wildcard search, i.e. displays all listings that include item numbers starting with this sequence.

Listing data

Enter the title, subtitle or description of a listing.

Market

Select one market or ALL. Select ricardo to display market listings created for this market only.

Account

Select an account or ALL to only display listings uploaded with the selected account.

Category ID

Enter the category ID to only display listings with this category.

Flag 1;
Flag 2

Select a flag to only display listings with this flag.

Listing type

Select one listing type or ALL. For ricardo, the listing types Auction and Fixed price are available.

Verification

Select a verification result or ALL to only display listings with the selected result.

Status

Select the listing status to only display listings with the selected status.

Warehouse

Select a warehouse or ALL to only display listings with items from the selected warehouse.

Duration

Select a duration from 1 day to 10 days or ALL to display listings with the selected duration.

Quantity

Enter the quantity of items that can be purchased to only display listings with the selected quantity of items.

Layout

Select a layout template or ALL to only display listings with the selected layout.

Endless lister

Search for listings with or without endless lister or display ALL.

Listing scheduler

Select a listing scheduler or ALL to only display listings with the selected listing scheduler.

Updated from

Select a date to display all of the listings that were updated on this day or after.

Updated to

Select a date to display all of the listings that were updated on this day or before.

Stock

Select a stock level or ALL to only display listings with the selected stock level.

Stock dependence

Select a stock dependence or ALL to only display listings with the selected stock dependence.

Variations

Search for listings with or without variations or display ALL. Select the option ALL for ricardo.

Special sale

Search for listings with or without special sales or display ALL.

7.2. Filtering by categories

Select a category in the Category tab. Only listings with items of the selected category are displayed. If you no longer want to search within a specific category, then click on the Filter tab and deactivate the option With category.

7.3. Filtering by directories

Select a directory in the Directory tab. Only listings with items sorted into the selected directory are displayed. If you no longer want to search within a specific directory, then click on the Filter tab and deactivate the option With directory.

8. Starting listings

Listings can be started in several ways. Start individual listings manually. Multiple listings can be started automatically using listing schedulers or endless listers. Items are exported when starting listings.

8.1. Manually starting listings

An individual market listing can be started in the detailed view. The market listing must be active in order to be started. Use the group function to start multiple market listings manually. You can restart listings that have been listed before using the group function for active listings.

Starting an individual market listing:

  1. Go to Listings » Edit listings.

  2. Click on a market listing.
    → The market listing opens.

  3. Click on Start in the tool bar.
    → The Start market listing window opens.

  4. Select a date and time.

  5. Click on Start to start the market listing at the selected time.

Starting several market listings:

  1. Go to Listings » Edit listings.

  2. Activate the listings that you want to start.

  3. Click on Group function.
    → The Group function window opens.

  4. Select Start listings as the procedure.

  5. Select a starting time according to Table 18.

  6. Click on Execute to start the market listings.

Starting several market listings with active listings:

  1. Go to Listings » Active listings.

  2. Activate the listings that you want to start.

  3. Click on Group function.
    → The Group function window opens.

  4. Select Start in the Procedures area.

  5. Select a starting time according to Table 18.

  6. Click on Execute to start the market listings.

Table 18. Options for specifying when a listing should be started
Setting Explanation

Start at time above

Select a date and time. The listings are started at this time.

Start within

Select a time period. The listings are started within this time period. The time interval between listings changes depending on the number of listings.

Starting a market listing in the future

If the selected starting time is in the future, then the listing is included in the Future listings menu until it is started. This menu includes all of the listings that have a starting time in the future.

8.2. Automatically starting listings with the listing scheduler

In plentymarkets, there are multiple ways to automatically start listings or restart listings once they have already been started. Use the listing scheduler to specify starting times for listings. Go to System » Listings » Scheduler to set up the listing scheduler.

Uploading listings with the listing scheduler:

  1. Go to Listings » Active listings.

  2. Open a market listing.

  3. Click on Listing scheduler in the tool bar.
    → The window Activate listing scheduler opens.

  4. Select one, several or all of the listing schedulers.

  5. Save the settings.

8.3. Automatically starting listings with the endless lister

The Endless lister option automatically restarts your expired listings.

Setting up the endless lister:

  1. Go to Listings » Active listings.

  2. Open a market listing.

  3. Click on the Base tab and activate the Endless lister.
    → It is now possible to select the Listings active at the same time option. This option determines how many active listings can be listed on the market at the same time.

  4. Save the settings.

Deleting listings with endless lister

If you delete a listing that has the Endless lister option activated, then this listing is started again. In this case, you would not have prevented the listing from being started. In order to delete the listing, you have to deactivate the endless lister first.

8.4. Future listings

The Listings » Future listings menu includes all started listings that have a starting time in the future. You can open the item and the market listing in the overview to edit or check the settings. You can also delete listings and thus prevent them from being started.

9. Creating listing templates

Use the group function or batch processing to create, edit or delete listing templates. You can save specific settings in listing templates and then use them over and over for listings instead of having to enter the settings again each time. Listing templates can be used for individual listings as well as for the group function and batch processing. Listing templates can be selected in the menu Item » Edit item » Open item » Tab: Multi-Channel before listings are created via group function or batch processing. Listing templates can also be selected in the New market listing window when creating an individual listing.

Creating listing templates with the group function:

  1. Go to Listings » Edit listings.

  2. Activate the listings that you want to edit.

  3. Click on Group function.
    → The Group function window opens.

  4. Carry out the settings as desired. Pay attention to the information given in Table 15 in the Editing multiple listings chapter.

  5. Click on Save new template.
    → The Name of template window opens.

  6. Enter a name for the template.

  7. Save the settings.
    → The template is created.

Creating a listing template with batch processing:

  1. Go to Listings » Batch processing » Listings.

  2. Carry out the settings as desired. Pay attention to the information given in Table 15 in the Editing multiple listings chapter.

  3. Click on Save new template.
    → The Name of template window opens.

  4. Enter a name for the template.

  5. Save the settings.
    → The template is created.

As long as you are logged in, the template created last is automatically preselected when opening the group function.

10. Active listings

Active listings are currently available on a market or were recently available. In this chapter, you will learn how to search for, update, or end active listings.

10.1. Searching for active listings

All active listings are displayed in an overview in the Listings » Active Listings menu. Use the filters for settings, categories or directories to narrow down the listings that are displayed. In addition to the filters described in Table 17, the following options are available:

Table 19. Filter options for active listings
Setting Explanation

Relisted

Search for listings that have been relisted, have not been relisted or display ALL.

Update error

Search for listings with or without update errors or display ALL.

Start time from

Display all listings that were started on this day or after.

Start time to

Display all listings that were started on this day or before.

Active from

Display all listings that were activated on this day or after.

Active to

Display all listings that were activated on this day or before.

End time from

Display all listings that ended on this day or after.

End time to

Display all listings that ended on this day or before.

Sold

Search for listings that have been sold or not or display ALL.

Duplicate listings

Identify duplicate listings using the item ID, the listing ID or the market listing ID or do not check.

Price ID

Enter a price ID to only display listings that have this price ID. If an item is listed several times on different markets or platforms, you filter by price ID and only search for the listings that offer this item at a specific price.

Tie to item price

Activate to only display listings where the price is tied to the item price.

10.2. Editing active listings via group function

Use the group function to start, end, delete, restart, or update listings. The group function edits previously selected listings.

Editing active listings via group function:

  1. Go to Listings » Active listings.

  2. Activate the listings that you want to carry out procedures for.

  3. Click on Group function.
    → The Group function window opens.

  4. Select a procedure according to Table 20.

  5. Click on Execute to carry out the procedure for the selected listings.

Table 20. Group function procedures
Setting Explanation

None

Select this option to update the listings.

Start

Select this option to start the listings. Also select Start at time above or Start within.
Start at time above = Select a date and time. The listings are started at this time.
Start within = Select a time period. The listings are started within this time period. The time interval between listings changes depending on the number of listings.

End and delete

Select this option to end the listings on markets. Afterwards, the listings are removed from the active listings. Certain requirements have to be fulfilled in order for listings to be ended. Ask the markets when it is possible to end listings so that you do not violate their conditions.

End and restart

Select this option to end the listings and then restart them afterwards.

Delete

Select this option to delete listings in plentymarkets. Listings will not be deleted on the market. You have to end the listings in order to remove them from the market. If listings are deleted in plentymarkets but are still running on the market, then the stock is no longer synchronised with plentymarkets.

Update all

Activate in order to update all ricardo options. The None option must be activated in the Procedures area.

Query update status

You can query the update status once you have begun updating the listings. Click on Query update status. The results are displayed in a message.

10.3. Editing active listings with batch processing

Batch processing includes the same options as the group function. However, the batch processing function edits previously filtered listings. The filters used for narrowing down listings are the same as described for search filters in Table 16 and Table 17. The procedures are the same as described for group functions in Table 20.

Editing active listings with batch processing:

  1. Go to Listings » Batch processing » Active listings.

  2. Select the filters based on Table 16 and Table 17.

  3. Carry out the settings and pay attention to the explanations given in Table 20.

  4. Click on Execute to carry out the settings.
    → A new notification window opens.

  5. Confirm the notification with Execute if the changes should be applied to all selected listings.

11. Viewing the API log

The menu Data » API log » Tab: API log contains a history of processes that run via the ricardo.ch interface. The ItemListingControllerRicardo format is available for ricardo.ch.

Viewing the API log:

  1. Go to Data » API log » Tab: API log.

  2. Select the ItemListingControllerRicardo or LeaveFeedback format from the Process drop-down list.

  3. Select a date if you only want to see entries for a specific day.

  4. Select the number of results per page.

  5. Click on Search to display the results.

12. Synchronising data via REST API

Use the REST API or the Data exchange menu to exchange data between your plentymarkets system and ricardo.ch. The data format ItemListingMarketRicardo is used to create new ricardo listings or edit existing listings, e.g. to change or delete parameters.

13. FAQ

I tried to list and I received the error messages DeliveryDescriptionMainLanguageIsEmpty, PaymentDescriptionMainLanguageIsEmpty, or WarrantyDescriptionMainLanguageIsEmpty. What can I do?

In the ricardo options, you selected According to the description for this listing’s guarantee, payment conditions or delivery conditions. However, you haven’t saved these general conditions yet. To do so, go to System » Markets » ricardo » Settings and save the conditions in the sub-menus Terms of guarantee, Payment conditions and Delivery conditions.

I am unable to select payment methods in the ricardo settings of a listing.

Go to System » Markets » ricardo » Accounts and update the options for the ricardo markets in the Update options section.

My listing was not started or I receive the error message Debited. What could be the problem?

You do not have enough credit on your ricardo account or you have reached your credit limit. Top up your account or apply for a credit limit with ricardo.

I receive the error message TokenErr. What can I do?

Go to System » Markets » ricardo » Accounts and update the token.

I receive the error message InvalidPromotion. What is the problem?

One of the additional options is invalid. Check the additional options that are selected.

I receive the error message UnknownCategoryId. What is the problem?

No category was specified or the specified category is invalid.

To top