Overview: What are listings?

1. What is a listing?

Listings allow you to send product and offer data to a sales channel. There are two different kinds of listings on PlentyONE:

  • Product listings: A product listing contains general product data for a variation, such as images, technical data, and information on the manufacturer. This product data is usually “universal” and not tied to any particular seller.

  • Offer listings: An offer listing contains seller-specific product data for a variation, such as the price, stock, delivery costs, or condition of the item, for example new or used.

Some sales channels don’t differentiate between products and offers. In such cases you only need to create an offer listing in order to send your offer data to the sales channel.

An explanation on how to create product and offer listings can be found on the manual page Creating listings.
What are product listings and offer listings used for?

  • If the item you want to sell is not listed on the sales channel yet you will need to create a product listing for it first. Creating a product listing sends the product data to the sales channel and allows for the item to be listed.
    In order to actually be able to sell the item on the sales channel you will need to additionally create an offer listing. The offer listing contains data related to the sale of the item, such as its price and stock. In other words, a product listing allows you to list an item on a sales channel that did not previously exist on that sales channel, but in order to sell that item on that sales channel you also need an offer listing for that item.

  • If the item you want to sell is already listed on the sales channel you only need to create an offer listing. Offer listings send the data related to your offer, such as the price, stock, shipping costs etc., to the sales channel.
    In most cases you will only need an offer listing in order to offer a product on a sales channel. Many sales channels do not differentiate between product and offer listings. You only need to send offer listings to these kinds of sales channels.

Different kinds of listings

The marketplaces listed in the Sales Channels menu under eBay / Hood / Ricardo Listings are not part of the sales channels integrated via the Channel Layer. The menu items under eBay / Hood / Ricardo Listings (e.g. Edit listings) only apply to listings for eBay, Hood and Ricardo. These listings are not identical to listings created via the Sales Channels » Accounts » [Create account] menu in order to manage and transmit products and offers via the Channel Layer. These are two different types of listings that are managed entirely separately.

2. Listing overview

You create and manage offers for the sales channel via listings. The Sales channels » Accounts » [Open account] menu offers you an overview of your listings. Here you can create and manage product listings and offer listings. Click on the tile for the sales channel to create product listings or offer listings for the sales channel.

2.1. Offer listings

In the list offer listings menu of the account you gain an overview of your offer listings.

Tip: You can switch between specific views of offers and the listing group view via the menu button and folder.

  • menu gives you an overview of all the offer listings.

  • folder shows you the listing groups of the offer listings. Extend a listing group by clicking chevron_right, to see all listings within the group.

Applying search filters
If you only want to take a look at certain offer listings, apply filters and narrow down the listings which are displayed. To do so, click on Filters (tune) at the top of the menu.

Applying filters:

  1. Open the Sales Channels » Accounts » [Open account] » Offer listings menu.

  2. Click on Filters (tune) at the top of the menu.

  3. Select one or multiple filters.

  4. Click Search (search).
    → The selected filters are applied and the appropriate offer listings are displayed.
    → The filters that were applied are displayed at the top of the menu.

Tip: You can also reset (refresh) the selected filters. Then all offer listings will be displayed again.

  • Single listing view

  • Group view

Table 1 offers an overview of the single listing view of offer listings.

Table 1. Offer listings overview
Column Explanation

Data sync

This column indicates whether data exchange for the offer listing is active or paused.
Tip: You can activate the data exchange in the listing’s line via more_vert » toggle_on Activate data sync .

Group ID

The ID of the listing group to which the offer listing is assigned. By clicking on the ID, you can open the listing group view.

Listing Name

Name of the offer listing.

SKU

SKU of the offer listing.
Note: You can edit the SKU. To do so, click Activate editing mode (edit). Make the changes and click Save (save) to apply them. If you want to exit the editing mode, click Deactivate editing mode (edit_off).

Variation ID

ID of the variation.

Channel

The sales channel to which the listing is exported.

Status on Channel

Displays the listing status on the sales channel, for example if the listing is already listed on the sales channel. Possible status are:

  • help = Unknown

  • progress_activity = Outstanding

  • progress_activity = Creation pending

  • cancel = Failed (before creation)

  • check_circle = Online

  • cancel = Failed (on update)

  • pause_circle = Paused

  • unpublished = Offline

Note: For platforms with multiple sales channels, the number after the status icon indicates on how many sales channels the offer listing has this status.

List on

The sales channels on which the offer listing is to be offered are displayed here.
Click on the pencil icon (edit) to add or remove sales channels.

Errors

The error overview.
No entry = No errors occurred.
circle = Errors occurred. The number indicates the number of errors.

Template

The template selected for the listing.

Catalogue

The catalogue selected for the listing.

Creation date

The date and time on which the listing was created.

more_vert

Click here to display more actions.

toggle_on Activate data sync

Activate to permit the data exchange between the sales channel and the listing.
Note: Even if the Activate data sync option is activated, the listing will not be immediately listed on the sales channel. The listing data is only permitted to be exported to the sales channel. It depends on the respective sales channels when a listing is online.

delete Delete listing

delete Delete listing

preview Preview export results

Generates the preview of the export results. The preview opens in a separate window.

Table 2 offers an overview of the group view of offer listings.

Table 2. Group view of the offer listings
Column Explanation

Data sync

This column indicates whether data exchange for the listing group is active or paused.
Tip: You can activate the data exchange in the listing group’s line via more_vert » toggle_on Activate data sync.

Group name

Name of the listing group

SKU

SKU of the listing group.

Channel

The sales channel to which the listing group is exported.

Errors

The error overview.
No entry = No errors occurred.
circle = Errors occurred. The number indicates the number of errors.

Template

The template selected for the listing group.

Catalogue

The catalogue selected for the listing group.

Creation date

The date and time on which the listing group was created.

more_vert

Click here to display more actions.

toggle_on Activate data sync

Activate to permit the data exchange between the sales channel and the listing group.
Note: The data sync must also be activated for the single listing to list an offer listing on a sales channel.
Even if the Activate data sync option is activated in a listing group, the listings in this group will not be immediately listed on the sales channel. The listing data is only permitted to be exported to the sales channel. It depends on the respective sales channels when the listings are online.

delete Delete listing group

Delete listing group.

preview Preview export results

Generates the preview of the export results. The preview opens in a separate window.

2.2. Product listings

In the list product listings menu of the account you gain an overview of your product listings.

_Tip: menu You can switch between specific views of product listings and the listing group view via the button folder.

  • menu gives you an overview of all the product listings.

  • folder shows you the listing groups of the product listings. Extend a listing group by clicking chevron_right, to see all listings within the group.

Applying search filters
If you only want to take a look at certain product listings, apply filters and narrow down the listings which are displayed. To do so, click on Filters (tune) at the top of the menu.

Applying filters:

  1. Open the Sales Channels » Accounts » [Open accounts] » Product listings:.

  2. Click on Filters (tune) at the top of the menu.

  3. Select one or multiple filters.

  4. Click Search (search).
    → The selected filters are applied and the appropriate product listings are displayed.
    → The filters that were applied are displayed at the top of the menu.

Tip: You can also reset (refresh) the selected filters. Then all product listings will be displayed again.

  • Single listing view

  • Group view

Table 3 offers an overview of the single listing view of product listings.

Table 3. Overview of product listings
Column Explanation

Data sync

This column indicates whether data exchange for the product listing is active or paused.
Tip: You can activate the data exchange in the listing’s line via more_vert » toggle_on Activate data sync .

Listing Name

Name of the listing.

Variation ID

ID of the variation.

Channel

The sales channel to which the listing is exported.

Errors

The error overview.
No entry = No errors occurred.
circle = Errors occurred. The number indicates the number of errors.

Template

The template selected for the listing.

Catalogue

The catalogue selected for the listing.

Creation date

The date and time on which the listing was created.

more_vert

Click here to display more actions.

toggle_on Activate data sync

Activate to permit the data exchange between the sales channel and the listing.
Note: Even if the Activate data sync option is activated, the listing will not be immediately listed on the sales channel. The listing data is only permitted to be exported to the sales channel. It depends on the respective sales channels when a listing is online.

delete Delete listing

delete Delete listing

preview Preview export results

Generates the preview of the export results. The preview opens in a separate window.

Table 4 offers an overview of the group view of product listings.

Table 4. Group view of the product listings
Column Explanation

Data sync

This column indicates whether data exchange for the listing group is active or paused.
Tip: You can activate the data exchange in the listing group’s line via more_vert » toggle_on Activate data sync.

Group name

Name of the listing group

Channel

The sales channel to which the listing group is exported.

Errors

The error overview.
No entry = No errors occurred.
circle = Errors occurred. The number indicates the number of errors.

Template

The template selected for the listing group.

Catalogue

The catalogue selected for the listing group.

Creation date

The date and time on which the listing group was created.

more_vert

Click here to display more actions.

toggle_on Activate data sync

Activate to permit the data exchange between the sales channel and the listing group.
Note: The data sync must be activated for the single listing to exchange product data with the sales channel.
Even if the Activate data sync option is activated for a listing group, the listing data will not be immediately exported to the sales channel. The listing data is only permitted to be exported to the sales channel. It depends on the respective sales channels when the listings are online.

delete Delete listing group

Delete listing group.

preview Preview export results

Generates the preview of the export results. The preview opens in a separate window.