Octopia: Cdiscount Integration

Cdiscount was the first online market in France. Today, it is still one of the most popular and most widely used French online sales platforms. In order to sell items on Cdiscount, you need to make your catalogue of items completely available in French.

1. Registering with Octopia

Cdiscount has cancelled its existing SOAP API connection and is now available via the Octopia sales channel in PlentyONE. The setup of Cdiscount in PlentyONE differs depending on whether you are already registered with Octopia and selling on Cdiscount or whether you want to start selling on Cdiscount for the first time.

Are you already registered with Octopia and selling on Cdiscount?

You do not need to register again with Cdiscount or Octopia.
To connect to Octopia and set up your sales channel, carry out the following steps:

  1. Grant PlentyONE in Octopia the permission to communicate with the Octopia REST-API.
    → You will receive a SellerID that is needed for the setup.

  2. Create an account for Octopia.

  3. Carry out the channel settings for Octopia.

  4. Activate your Octopia account.

  5. Activate the order referrer for Cdiscount.

You can then continue with preparing your items and variations.

Are you not registered with Cdiscount or Octopia yet?

To register and set up your sales channel, carry out the following steps:

  1. Register with Octopia for the Cdiscount sales channel.

  2. Grant PlentyONE in Octopia the permission to communicate with the Octopia REST-API.
    → You will receive a SellerID that is needed for the setup.

  3. Create an account for Octopia.

  4. Carry out the channel settings for Octopia.

  5. Activate your Octopia account.

  6. Activate the order referrer for Cdiscount.

You can then continue with preparing your items and variations.

1.1. Registering with Octopia as a new customer

If you are not yet registered with Octopia and have not yet sold on Cdiscount, you first need to create a Seller account for Cdiscount at Octopia.

Note: If you register via this link, the first 3 months of Octopia subscription fees are free.

1.2. Authorise PlentyONE to communicate with the Octopia REST-API

Cdiscount has cancelled its existing SOAP API connection and is now available via the Octopia sales channel in PlentyONE. Before you can set up Cdiscount in PlentyONE, you need to grant PlentyONE the permission to communicate with the Octopia REST API at Octopia. You will receive a SellerID from Octopia. This SellerID is required to set up Cdiscount in PlentyONE.

Receiving a SellerID from Octopia:

  1. Click here.
    Note: This page is only available in English.

  2. In the I’M USING A FEED AGREGATOR section, select the option My agregator only requests my SellerId.
    → The screen for selecting the agregator opens.

  3. In the Pick your agregator drop-down list, select the option plentysystems.

  4. Activate the option Using the API requires acceptation of the platform’s Terms & Conditions to agree to the Terms & Conditions.
    Note: To use the API, the terms and conditions have to be accepted.

  5. Click Grant Access to "plentysystems" to grant access to PlentyONE.
    → The Seller Authentication window opens.

  6. Click Proceed with seller authentication to continue with the authentication process.
    → The Octopia login window opens.

  7. Enter the Email address corresponding to your Octopia SellerZone login details.

  8. Enter the Password corresponding to your Octopia SellerZone login details.

  9. Click Log In.
    → A seller authentication is performed.
    → PlentyONE is granted permission to communicate with the Octopia REST API.
    → You receive your SellerID.

2. Frequency of data exchange

After you have set up Cdiscount in PlentyONE, data is exchanged with the sales channel in the intervals described in Section 2:

Table 1. Frequency of data exchange
Data Interval

Item export

daily

Offer export

every 15 minutes

Stock synchronisation

every 15 minutes

Price synchronisation

every 15 minutes

Order import

every 15 minutes

Import of cancellations

hourly

3. Setting up the data exchange

In order for the interface to successfully carry out the item export, the order import and the stock synchronisation, certain settings are mandatory. Pay attention to the following list.

Product creation on Octopia

The product creation serves as a query to add a new product to Octopia’s product database. As soon as Octopia approves and adds your item to its database, you cannot make any further changes to the item data. Therefore, check if you have saved all the necessary data. The check list serves as list for all mandatory settings for the product creation. Further settings can be carried out as desired.
Offer creation on Cdiscount

Every created item is saved in a database on Cdiscount. Every item can be identified by at least one EAN. Marking products with EANs enables sellers to create offers for these products. The setup is simpler in comparison to the previous product creation and makes it easy to get started on Cdiscount.
The offer creation as well as the synchronisation (stock) are controlled by one file.
The following check list contains all mandatory settings for an item to be transferred in this file.
Table 2. Mandatory settings for Cdiscount
Settings section Settings

Offer creation / Stock synchronisation

Basic settings for the sales channel

  • An account for Octopia is created.

  • The following channel settings for Octopia are carried out:

    • SellerID is entered.

    • Language for product display is selected.

    • Create cron for export is activated.

    • Update cron for export is activated.

  • The account for Octopia is activated.

Catalogue settings

Listing settings

  • An offer listing is created.

  • The offer listing is activated.

  • The listing contains at least one variation.

Variation settings

  • The variation in the listing is active.

Product creation

Basic settings for the sales channel

  • An account for Octopia is created.

  • The following channel settings for Octopia are carried out:

    • The SellerID is entered.

  • The account for Octopia is activated.

Item settings

  • Item descriptions are entered in French.

  • A manufacturer is saved for the item and linked with Cdiscount.

Variation settings for single items

  • The variation is active.

  • A barcode is created and linked.

  • An SKU is set.

  • At least one category which is linked with Cdiscount is saved for the item.

  • At least one category which is linked with Cdiscount is activated for the standard client.

  • At least one image is saved for the item and released for Cdiscount.

Further variation settings for variation items

  • The variation’s attributes are linked with Cdiscount.

Catalogue settings

Listing settings

  • A product listing is created.

  • The product listing is activated.

  • The listing contains at least one variation.

Order import

Basic settings for the sales channel

  • An account for Octopia is created.

  • In the channel settings for Octopia, the following Cdiscount settings are carried out:

    • Either the Order import for fulfilment by Cdiscount or the Order import for fulfilment by seller is activated.

    • A Cdiscount C Logistique order warehouse is assigned.

    • A Cdiscount C Logistique order status is selected.

  • The account for Octopia is activated.

Variation settings

  • An SKU is set.

Import of cancellations

Basic settings for the sales channel

  • An account for Octopia is created.

  • In the channel settings for Octopia, the following Cdiscount settings are carried out:

    • The cron to Import cancelled orders is activated.

    • The Status for cancelled orders is selected.

  • The account for Octopia is activated.

4. Setting up Octopia in PlentyONE

In order to export product data, you first need to set up Octopia in PlentyONE. To do so, proceed as described in the following chapters.

4.1. Creating an account

In the Sales Channels » Accounts menu, create an account for Octopia.

Creating an account:

  1. Open the Sales Channels » Accounts menu.

  2. Click on Create account (add).
    → The window Create account opens.

  3. Select Octopia from the drop-down list Platform.

  4. Select the Client (Shop) from the drop-down list.

  5. Enter a name for the account.

  6. Click on add CREATE.
    → The account for Octopia is created.

4.2. Account overview

In the Sales channels » Accounts menu, you can create your Octopia account. In addition, you can find an overview of the account here.

Table 3 contains an overview of the accounts in the Sales Channels » Accounts menu.

Table 3. Accounts in the Sales Channels » Accounts menu.
Setting Explanation

bigtop_updates Connection

Connection status of the account.
Accounts can have the following connection statuses:

  • Connected (bigtop_updates) = The account is connected to the sales channel.

  • Disconnected (signal_disconnected) = The account is not connected to the sales channel.
    Note: If the account is Disconnected, this may be due to missing or incorrect basic settings for the sales channel.

Name

Account name.

more_vert More

Click here to display more actions.

settings Account settings

Open the account settings.

error Errors

Open errors for Product listings oder Offer listings. The number of errors for the product listings or offer listings for this account is shown in brackets.

list Product listings

Open the overview of product listings for this account.

toggle_off Activate account

Activate the account.

delete Delete account

Delete the account.

Listings online

Hover over Listings online to see the number of product listings and offer listings that are listed on sales channels for this account.

Errors

Hover over Errors to see the number of errors that occurred for product listings and offer listings.

4.3. Carrying out the channel settings for Octopia

Next, carry out the channel settings for Octopia.

Carrying out the channel settings for Octopia:

  1. Open the Sales Channels » Accounts menu.

  2. Click on the tile for Octopia.
    → A view with channel settings opens.

  3. Carry out the settings. Pay attention to the explanations given in Section 4.3.

  4. Save () the settings.

Table 4. Channel settings for Octopia
Setting Explanation

General

SellerID

Enter the SellerID that you received from Octopia.
This is a mandatory field.

Select language

Select the language the products should be displayed in.

Create cron for product data export

Activate the toggle button if you want to create a cron for the product data export.

Update cron for product data

Activate the toggle button if you want to update a cron for the product data export.

Trigger cron

Cron for product creation

Click Trigger to trigger the cron for product creation.

Cron for product update

Click Trigger to trigger the cron for product update.

Full export for Cdiscount

Click Trigger to trigger the full export for Cdiscount.

Cdiscount Settings

Order import for fulfilment by Cdiscount

Activate the toggle to automatically import orders for fulfilment by Cdiscount into PlentyONE every 15 minutes.
Note: To carry out the import, a Cdiscount C Logistique order warehouse and a Cdiscount C Logistique order status must be selected.

Order import for fulfilment by seller

Activate the toggle to automatically import orders for fulfilment by seller into PlentyONE every 15 minutes.
Note: To carry out the import, a Cdiscount C Logistique order warehouse and a Cdiscount C Logistique order status must be selected.

Import cancelled orders

Activate the toggle to automatically import cancelled orders into PlentyONE every hour.
Note: For this, also select a Status for cancelled orders.

Cdiscount C Logistique order warehouse

Select which warehouse is to be assigned to C Logistique orders.
Automatic warehouse assignment (default setting) = The warehouse is assigned according to the normal order logic, i.e. based on your warehouse, item and stock settings.

Cdiscount C Logistique order status

Select the status for Cdiscount C Logistique orders. Status [7] outgoing items booked is set by default. However, no stock is booked from the warehouse. The status can be edited as desired for future order imports. Once an order entered status [7], the order cannot enter a smaller status.

Status for blocked cancellation request

Select the status for cancellation requests that have been rejected by Cdiscount.
Note: Set up an event-based flow or an event procedure to automatically send cancellations to Cdiscount.

Status for cancelled orders

Select the status for cancelled orders that are imported into PlentyONE.

Item ID for instalment purchase fee

Select the item ID that you have created for the instalment fee. This item ID is automatically assigned to the instalment fee order item.

ECO Tax item ID

Select the item ID that you have created for the instalment fee. This item ID is automatically assigned to the ECO tax order item.

4.4. Modifying the account settings

In the Account settings tab, you can adjust the account’s name.

Carrying out account settings:

  1. Open the Sales Channels » Accounts menu.

  2. Open the account for Octopia.

  3. Open the settings Account settings tab.

  4. Enter the name.

  5. Save () the settings.

4.5. Activating the account

In the Sales Channels » Accounts menu, activate the account to enable the data exchange with Octopia.

Activating the account for Octopia:

  1. Open the Sales Channels » Accounts menu.

  2. Click More (more_vert) in the tile for Octopia.
    → A drop-down list with further options appears.

  3. Select the Activate account (toggle_on) option from the drop-down list.
    → The account is activated and data can be exchanged with Octopia.

5. Activating order referrer and order validation for Cdiscount

Once you have created an account for Octopia and carried out the channel settings, activate the order referrer for Cdiscount in PlentyONE and the automatic order validation in the Cdiscount back end.

5.1. Activating the order referrer

Order referrer ID

The order referrer ID for Cdiscount will change in one of the next releases. You will receive further information and the new order referrer ID in the Changelog in good time before the change. This section will be adjusted accordingly with the new order referrer ID.

Go to Setup » Orders » Order referrer to activate the order referrer. This ensures that orders are assigned to the correct sales channel.

What is an order referrer?

An order referrer tags an order with the sales channel on which the order was generated. Sales channels can be e.g. your online shop or markets on which you sell your items. Each sales channel has an individual order referrer. Some order referrers are available by default in your PlentyONE system. Further order referrers are added e.g. if you install a new plugin. For further information about the order referrer, see the page Order referrer of the PlentyONE manual.

Activating the order referrer for Cdiscount:

  1. Go to Setup » Orders » Order referrer.

  2. Click Search (search).

  3. In the list, navigate to the option Cdiscount with ID 143.

  4. On the right of the referrer’s line, click on Edit (edit).
    → The window Edit referrer opens.

  5. Activate the option Visible in selection (toggle_on).

  6. Click on Save (save).
    → The referrer is active.

Note: If you use Cdiscount C-Logistics, you also have to activate the referrer for Cdiscount C-Logistics (143.02 Cdiscount.com C Logistique).

5.2. Activating order validation in the Cdiscount back end

To import orders from Cdiscount into PlentyONE, the orders must be validated in the Cdiscount back end. Therefore, activate the Automatically validate orders option in the Cdiscount back end.

Note: If this option is not activated, you have to manually validate each order in the Cdiscount back end to have it imported into PlentyONE.

6. Distinction of single items and variation items

Only specific product types, such as clothing, can be offered as variation items on Cdiscount. Therefore, all variations will be exported to Cdiscount as single items by default.

Variations can only be listed as variation items on Cdiscount if the following settings were made:

  • The variation is linked with attributes for clothing size or clothing colour.

Characteristics

Characteristics are no longer supported. Existing characteristics must be replaced by properties.

Product names of single items

Attributes are added to the product names of variations which are listed as single items on Cdiscount. The attributes are shown in square brackets behind the product name on Cdiscount.
For variations which are listed as variation items on Cdiscount, attributes will not be added to the product name.

Table 5. Example for product names on Cdiscount
Name of the single item The attribute’s name Product name on Cdiscount

Ladies’ bicycle, 18 inch, mountain bike

blue

Ladies’ bicycle, 18 inch, mountain bike [blue]

7. Exporting Product Data

Item data are exported to Octopia using catalogues. Go to Data » Catalogues to create catalogues for Octopia.

What is a catalogue?

Catalogues are used to export data from your PlentyONE system. There are two different catalogue formats:

  • Marketplace formats are used to export item data to markets.

  • Standard formats are used to export data from your PlentyONE system into a file.

Catalogues with marketplace formats allow you to tailor your item information exactly to the needs of the market. Because here, you assign a suitable PlentyONE data field to each of the data fields of the market. When your variation data is exported to the market, the market’s data fields are then filled with the correct PlentyONE data.

7.1. Creating a product catalogue

Item data are exported to Octopia using catalogues. Go to Data » Catalogues to create catalogues for Octopia. Afterwards, link the Octopia data fields with offer data saved in PlentyONE in the catalogue you created. If you have activated the catalogue, the account, the listing and the variations, the product data is automatically exported to Octopia once a day.

Note: This means that you have to create a separate product catalogue for each Octopia product category that you want to sell your items in.

Creating a product catalogue:

  1. Go to Data » Catalogues.

  2. Click on Create catalogue (add).

  3. Enter a name for the catalogue.

  4. In the drop-down list Marketplace, select the option Octopia.

  5. In the drop-down list Export type, select the option Listing.

  6. Select the Octopia category to which you want to export your products from the Category dropdown list.
    → A new field for Account is added.
    Note: You can only create product catalogues for this sales channel.

  7. In the drop-down list Account, select the account for which the catalogue is to be created.
    Tip: This is the account you created for Octopia in the Sales Channels » Accounts menu.

  8. Click CREATE CATALOGUE.
    → The catalogue is created.
    → The catalogue is opened for editing.

7.1.1. Mapping data fields in the catalogue

After you have created a catalogue, map the sales channel’s data fields to item data saved in PlentyONE. This chapter describes how you map data fields and what particularities apply for item exports to Octopia.

  • The market expects product data that cannot be saved in the PlentyONE item menu? Then create a property for this data. Link this property with your variations. The actual values are saved as property values for this property. Is this your first time working with properties? Then read up on the principles of properties first.

Getting to know the catalogue menu for marketplace formats
catalogue menu colours
Availability Explanation

Navigation

When you open a catalogue, the view Mapping is shown. On the very left is the navigation.

  • Switch to other views of the catalogue.

  • Open the catalogue settings.

  • Use filters that limit the data that is exported.

  • Go back to the list of catalogues.

  • Create a new catalogue.

Toolbar

The toolbar provides actions for the catalogue. For example, save your mappings, restore an older version of the catalogue or hide or show optional marketplace data fields.

Marketplace data field

To the right of the navigation, all data fields available for the market are listed. Mandatory fields are marked with an asterisk (✱).
Tip: Show or hide optional marketplace data fields in the toolbar. To do so, click on the further actions (more_vert).

PlentyONE data fields

On the right side of the catalogue, you map the marketplace data fields to appropriate PlentyONE data fields. In the screenshot above, a few of the fields are already mapped.

Mapping catalogue fields:

  1. Go to Data » Catalogues.

  2. Click on the catalogue.
    → The Mapping tab opens.
    → In the left-hand column, the market’s data fields are listed.
    Tip: Mandatory fields are flagged with an asterisk (*).
    → In the right column, you map the PlentyONE data fields. Any PlentyONE data fields that you already mapped are also shown in this column.

  3. Map suitable PlentyONE data fields to the market data fields.
    For each marketplace data field, you have a number of mapping options. Expand the info boxes below to get more information about each of these mapping options.

    • Simple 1:1 mapping

    • Simple 1:1 mapping with properties

    • Complex 1:1 mapping

    • 1:1 mapping with fallback data fields

    • 1:n mapping

    • Own value mapping

    • Mapping with mathematical calculations

  4. Save () the catalogue.
    → The mappings are saved.

Simple 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

In a simple 1:1 mapping, you map a PlentyONE data field to the marketplace data field. If no suitable setting exists in PlentyONE. you can map a property instead.

As such, simple 1:1 mappings allow you to:

  • I want to fill this marketplace data field with the data from this PlentyONE setting.

  • If the data field is empty for a variation, no value is exported for this variation.

Creating a simple 1:1 mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. Click on the plus to the right of the PlentyONE data field you want to select.
    → The PlentyONE data field is added to the right.

  4. Click on Confirm.

Example: Sales price and RRP for Otto Market

This gif shows you how to map the marketplace data fields Sales price and RRP for Otto Market to PlentyONE data fields:

gif catalogue mapping simple en
Simple 1:1 mapping: with properties: 1 marketplace data field, no PlentyONE data field

Reminder: In a simple 1:1 mapping, you map a PlentyONE data field to the marketplace data field. However, what can you do if PlentyONE does not offer a suitable data field? Then it’s the properties' moment to shine. Properties allow you to save any kind of information in your properties.

Creating a property:

  1. Create a property with the necessary values.
    Tip: Find out how to do that here.

Creating a simple 1:1 mapping with properties:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Expand the group Property.
    → The property groups are shown.

  3. Expand the group you need.

  4. Click on the Plus sign on the right of the property you want.

  5. From the drop-down list Language, select the language in which you send the data to the market.

  6. Click on Confirm.
    → The property is mapped to the marketplace data field.

Complex 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

Like with the simple 1:1 mappings, you map a PlentyONE setting or property to a marketplace data field. Complex mappings are necessary whenever a marketplace data field has more than one possible value. Instead of mapping data fields, for complex mappings you map individual values of these data fields. For example, you cannot simply map the PlentyONE data field Shipping profile to the marketplace data field Shipping method. Why? The market cannot know which of your shipping profiles in PlentyONE corresponds to which of their shipping methods.

Do not enter own values for complex mappings. All values that you enter must be saved for the variations, either in a setting or as a property value. This also applies if the value Comparative value is shown. You still need to enter exactly the value of the setting or property that you mapped.

In complex mappings, the value of the market is always exported. Only when you map an own value, the own value that you enter is exported.

You can recognise complex mappings from the field that is shown below the name of the marketplace data field. Click on the field to show the values available for the marketplace data field.

catalogue complex mappings

Examples for complex 1:1 mappings are:

  • Categories

  • Brands

  • Shipping setting

Important: For complex mappings, do not map own values or properties of the type None.

Creating a complex 1:1:n mapping:

  1. Click on the field for the marketplace data field.
    → A list of the available values is shown.

  2. Select the value that you want to map a PlentyONE data field to.
    → The value is mapped.

  3. Next to the marketplace data field, click on + Add data field.
    → To the left, the available PlentyONE data fields are listed in groups.

  4. Click on a group.
    → The PlentyONE data fields of the group are shown.

  5. Click on the PlentyONE data field for which you want to map values.
    Important: Do not map own values or properties of the type None.

  6. Your next steps depend on the PlentyONE data field you selected:

    • Alternative 1: The available values for the PlentyONE data value are shown on the left.

      • Next to the value you want to select, click on the plus.
        → The value is added to the field on the right.

      • Click on Confirm.

    • Alternative 2: The PlentyONE data field is inserted and the field Comparative value is shown.

      • In the field Comparative value, enter a value that is saved in the setting or the property of the mapped PlentyONE data field.

      • Click on Confirm.

    • Alternative 3: The PlentyONE data field is inserted and a drop-down list is shown.

      • Select a value from the drop-down list.

      • Click on Confirm.
        → The value of the marketplace data field is exported, not the value of the PlentyONE data field.
        Exception: Only when you map an own value, the own value that you enter is exported.

Example: Delivery time in days for Otto Market

This gif shows you how to map suitable PlentyONE values to the values of the marketplace data fields Delivery time in days for Otto Market:

gif catalogue mapping complex en
1:1 mapping with fallback data fields: 1 marketplace data field, 1 PlentyONE data field with alternative(s)

In a 1:1 mapping with one or more fallback data fields, you map a PlentyONE data field to the marketplace data field. In addition, you specify one or more fallback data fields. This ensures that the system keeps looking if the first PlentyONE data field is missing or empty.

So this mapping specifies:

  • I want to fill the marketplace data field with the data from the selected PlentyONE setting.

  • If that data field is missing or empty for a variation, the first fallback data field is checked. The value of that fallback data field is exported instead.

  • If the first fallback data field is also missing or empty for the variation, the second fallback data field is checked. If a value is found, the value of the second fallback data field is exported for the variation etc.

Two separate fallback conditions are available:

Null (default)

The fallback data field is used if the data field above is mapped in the catalogue but not linked to the variation.

The condition "Null" is useful when you want to map fallback data fields for the following types of PlentyONE data fields:

  • SKU

  • Barcodes

  • Sales prices

  • Properties

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Empty

The fallback data field is used if the data field above is mapped in the catalogue and linked to the variation, but is empty.

The condition "Empty" is useful when you want to map fallback data fields for the following type of PlentyONE data fields:

  • PlentyONE data fields that are available for variations by default

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Note: Even if you assign one or more fallback data fields, the value of only one of those fields is exported. For each variation, the mapped PlentyONE data fields are checked in the order in which you mapped them. This means that if the first data field does not provide a value for a variation, the first fallback data field is exported etc.

Creating a 1:1 mapping with fallback data fields:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. Click on the plus to the right of the PlentyONE data field you want to select.
    → The PlentyONE data field is added to the right.

  4. In the list of PlentyONE data fields, click on the plus icon next to the PlentyONE data field that you want to map.
    → The fallback data field is added with the fallback condition "null".

  5. Alternative 1: To add the fallback data field with the fallback condition "null":

    1. Click on Confirm.
      → The fallback data field is exported if the data field above is not linked to the variation.

  6. Alternative 2: To add the fallback data field with the fallback condition "empty":

    1. To the left of the fallback data field, click on the cog ().
      → The window Data column settings is shown.

    2. For the setting Fallback condition, select the option Empty.

    3. Click on Save.
      → The fallback data field is added with the fallback condition "empty".

    4. Click on Confirm.
      → The fallback data field is exported if the data field above is empty for the variation.

Example: Fallback data field for SKU for Otto Market

This GIF shows you the mapping for the OTTO Market marketplace data field SKU. The PlentyONE data field SKU is mapped to this marketplace data field. The PlentyONE data field Variation ID is mapped as the fallback data field. The fallback condition "null" is applied automatically.

Result: The fallback data field Variation ID is exported if the data field SKU is not linked to the variation.

gif catalogue mapping fallback en
1:n mapping: 1 marketplace data field, several PlentyONE data fields

In a 1:n mapping, you map several PlentyONE data fields to the marketplace data field. You can link these data fields with a separator.

So this mapping specifies:

  • I want to combine these PlentyONE data fields during export so that the marketplace data field is filled with the data of these two or more PlentyONE settings.

Creating a 1:n mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. Click on the plus to the right of the PlentyONE data field you want to select.
    → The PlentyONE data field is added to the right.

  4. Click on Confirm.

  5. To the right of the mapped PlentyONE data field, click on Add data field ().
    → To the left, the list of available PlentyONE data fields again are shown in groups.

  6. Map one or several additional PlentyONE data fields to the marketplace data field as described above.

  7. Click on Confirm.

  8. To the very right of the row, click on Settings ().

  9. Select a separator from the drop-down list Separator or add a custom separator.

  10. Click on Save.

  11. Save () the catalogue.
    → The mappings are saved.
    → During the export, the content of the PlentyONE data fields is combined and exported as one field.

Own value mapping: 1 marketplace data field, the same value for all variations

You are sure that you want to export the same value for all variations of a catalogue for a marketplace data field? Then specify an own value. This own value is then exported for all variations.

So this mapping specifies:

  • For this marketplace data field, I want to export the value that I entered in the field Own value for all variations of this catalogue. The value you enter is always exported. The value overwrites the market value also in complex mappings where usually the value of the market is exported. As such, make sure you enter an own value that the market accepts for this marketplace data field.

Creating an own value mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the plus next to Own value at the top of the list.
    → The field for the own value is added to the view.

  3. Enter a value into the input field.
    → This value is exported for all variations.

Example: Diameter information

You want to export diameter information for some of your variations. The diameter is saved in centimetres for all your variations. Instead of creating a property for the unit and linking this property to the variations, you can enter the own value cm.

This is an example of how you can map an own value for the diameter unit:

gif catalogue own value en
Mapping with mathematical calculations: 1 Marketplace data field, the PlentyONE value is recalculated using the formula during export

Mathematical calculations allow you to change numerical values automatically during the export.

  • This function only works for data fields that contain numerical values.

  • This functionality is new and not available for all catalogue formats.

So this mapping specifies:

  • I want the numerical value of a PlentyONE data field to be recalculated during the export. Basic arithmetic operations are available for the formulas.

Recalculating numerical values:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. At the very top of the list, click on the plus icon next to Formula (calculate).
    → The data field Formula is added to the field on the right.

  3. Click into the data field.
    → The window Modify value is shown.

  4. Enter a numerical value or select a PlentyONE data field at the bottom right of the window to add it to the calculation (add).
    Tip: Use the search function. This helps you to find data fields quickly.

  5. Optional: If the symbol more_vert is shown in the data field, select the correct assignment for the data field.
    Tip: A number tells you how many assignments are necessary for the data field.

    1. Click on the icon more_vert.

    2. In the window shown, select the assignments from the drop-down list.

    3. Save the settings.

  6. Enter numbers and mathematical operators with the on-screen calculator or the keyboard.

  7. Save the settings.
    → The entered formula is displayed in the overview.
    → The calculation will be carried out in the next export.

To help you with mapping your data fields for the catalogue, we have created a list of recommended data field mappings. Note that these mappings are recommendations only. Depending on how you manage your item data, other mappings may be more appropriate than the recommendation given here.

  • Need more information about the PlentyONE data fields? All data fields are described on the manual page for the export type Listing.

List of recommended data field mappings for the format Product

7.1.3. Transmitting shipping costs to Cdiscount

In order to transmit the shipping costs to Cdiscount, carry out the respective mapping in the catalogue. To do so, proceed as follows.

Transmitting shipping costs to Cdiscount:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Click on the catalogue for which you want to add the shipping costs.
    → The catalogue opens.

  3. Assign the desired data source to the Default shipping costs data field.
    Optional: Use the data fields Additional charges 1 and Additional charges 2 to add any additional costs.

  4. Save (save) the changes.
    → During catalogue export, the shipping costs are transmitted to Cdiscount according to the defined mapping.

7.1.4. Transmitting shipping preparation time to Cdiscount

In order to transmit the shipping preparation time to Cdiscount, carry out the respective mapping in the catalogue. To do so, proceed as follows.

Transmitting shipping preparation time to Cdiscount:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Click on the catalogue for which you want to add the shipping preparation time.
    → The catalogue opens.

  3. The data field Preparation time is already mapped to the data source Availability days. This value is taken from the Setup » Item » Availability menu.
    Tip: If required, use the Own value to transmit any desired value.

  4. Save (save) the changes.
    → During catalogue export, the shipping preparation time is transmitted to Cdiscount according to the defined mapping.

7.1.5. Activating the catalogue export

You have set up Octopia in PlentyONE and created a catalogue for exporting your item data? Then activate the catalogues you want to export to Octopia in the Data » Catalogues menu and continue with creating product listings.
Once you have activated the product catalogue, the Octopia account, the product listing and the variations, the product data will be automatically exported to Octopia every 15 minutes.

Activating the catalogue export to Octopia:

  1. Go to Data » Catalogues.
    → The catalogues are listed.

  2. Scroll to the Octopia catalogue.

  3. In the Active column, move the toggle button to the right ().
    → The catalogue is active.
    → The catalogue data is exported to Octopia every 15 minutes.
    Tip: Go to Data » Catalogue export status for information about the status of the export.

8. Exporting offer data

Offer data is exported to Cdiscount using catalogues. Go to Data » Catalogues to create catalogues for Cdiscount.

What is a catalogue?

Catalogues are used to export data from your PlentyONE system. There are two different catalogue formats:

  • Marketplace formats are used to export item data to markets.

  • Standard formats are used to export data from your PlentyONE system into a file.

Catalogues with marketplace formats allow you to tailor your item information exactly to the needs of the market. Because here, you assign a suitable PlentyONE data field to each of the data fields of the market. When your variation data is exported to the market, the market’s data fields are then filled with the correct PlentyONE data.

8.1. Creating an offer catalogue

Offer data is exported to Cdiscount via a catalogue. Go to Data » Catalogues to create catalogues for Cdiscount. Afterwards, link the Cdiscount data fields with offer data saved in PlentyONE in the catalogue you created. If you have activated the catalogue, the account, the listing and the variations, the offer data is automatically exported to Cdiscount every 15 minutes.

Note: This means that you have to create a separate offer catalogue for each Cdiscount product category that you want to sell your items in.

Do I always have to create a product catalogue and an offer catalogue?

If you only want to offer products that already exist on Octopia, you do not need to create a product catalogue beforehand. You can directly create an offer catalogue.

Creating an offer catalogue:

  1. Go to Data » Catalogues.

  2. Click on Create catalogue (add).

  3. Enter a name for the catalogue.

  4. Select the option cdiscount from the Market drop-down list.

  5. In the drop-down list Export type, select the option Listing.

  6. From the drop-down list Category, select the option Offer CDiscount.

  7. In the drop-down list Account, select the account for which the catalogue is to be created.
    Tip: This is the account you created for Octopia in the Sales Channels » Accounts menu.

  8. Click CREATE CATALOGUE.
    → The catalogue is created.
    → The catalogue is opened for editing.

8.1.1. Mapping data fields in the catalogue

After you have created a catalogue, map the sales channel’s data fields to item data saved in PlentyONE. This chapter describes how you map data fields and what particularities apply for item exports to Octopia.

  • The market expects product data that cannot be saved in the PlentyONE item menu? Then create a property for this data. Link this property with your variations. The actual values are saved as property values for this property. Is this your first time working with properties? Then read up on the principles of properties first.

Getting to know the catalogue menu for marketplace formats
catalogue menu colours
Availability Explanation

Navigation

When you open a catalogue, the view Mapping is shown. On the very left is the navigation.

  • Switch to other views of the catalogue.

  • Open the catalogue settings.

  • Use filters that limit the data that is exported.

  • Go back to the list of catalogues.

  • Create a new catalogue.

Toolbar

The toolbar provides actions for the catalogue. For example, save your mappings, restore an older version of the catalogue or hide or show optional marketplace data fields.

Marketplace data field

To the right of the navigation, all data fields available for the market are listed. Mandatory fields are marked with an asterisk (✱).
Tip: Show or hide optional marketplace data fields in the toolbar. To do so, click on the further actions (more_vert).

PlentyONE data fields

On the right side of the catalogue, you map the marketplace data fields to appropriate PlentyONE data fields. In the screenshot above, a few of the fields are already mapped.

Mapping catalogue fields:

  1. Go to Data » Catalogues.

  2. Click on the catalogue.
    → The Mapping tab opens.
    → In the left-hand column, the market’s data fields are listed.
    Tip: Mandatory fields are flagged with an asterisk (*).
    → In the right column, you map the PlentyONE data fields. Any PlentyONE data fields that you already mapped are also shown in this column.

  3. Map suitable PlentyONE data fields to the market data fields.
    For each marketplace data field, you have a number of mapping options. Expand the info boxes below to get more information about each of these mapping options.

    • Simple 1:1 mapping

    • Simple 1:1 mapping with properties

    • Complex 1:1 mapping

    • 1:1 mapping with fallback data fields

    • 1:n mapping

    • Own value mapping

    • Mapping with mathematical calculations

  4. Save () the catalogue.
    → The mappings are saved.

Simple 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

In a simple 1:1 mapping, you map a PlentyONE data field to the marketplace data field. If no suitable setting exists in PlentyONE. you can map a property instead.

As such, simple 1:1 mappings allow you to:

  • I want to fill this marketplace data field with the data from this PlentyONE setting.

  • If the data field is empty for a variation, no value is exported for this variation.

Creating a simple 1:1 mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. Click on the plus to the right of the PlentyONE data field you want to select.
    → The PlentyONE data field is added to the right.

  4. Click on Confirm.

Example: Sales price and RRP for Otto Market

This gif shows you how to map the marketplace data fields Sales price and RRP for Otto Market to PlentyONE data fields:

gif catalogue mapping simple en
Simple 1:1 mapping: with properties: 1 marketplace data field, no PlentyONE data field

Reminder: In a simple 1:1 mapping, you map a PlentyONE data field to the marketplace data field. However, what can you do if PlentyONE does not offer a suitable data field? Then it’s the properties' moment to shine. Properties allow you to save any kind of information in your properties.

Creating a property:

  1. Create a property with the necessary values.
    Tip: Find out how to do that here.

Creating a simple 1:1 mapping with properties:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Expand the group Property.
    → The property groups are shown.

  3. Expand the group you need.

  4. Click on the Plus sign on the right of the property you want.

  5. From the drop-down list Language, select the language in which you send the data to the market.

  6. Click on Confirm.
    → The property is mapped to the marketplace data field.

Complex 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

Like with the simple 1:1 mappings, you map a PlentyONE setting or property to a marketplace data field. Complex mappings are necessary whenever a marketplace data field has more than one possible value. Instead of mapping data fields, for complex mappings you map individual values of these data fields. For example, you cannot simply map the PlentyONE data field Shipping profile to the marketplace data field Shipping method. Why? The market cannot know which of your shipping profiles in PlentyONE corresponds to which of their shipping methods.

Do not enter own values for complex mappings. All values that you enter must be saved for the variations, either in a setting or as a property value. This also applies if the value Comparative value is shown. You still need to enter exactly the value of the setting or property that you mapped.

In complex mappings, the value of the market is always exported. Only when you map an own value, the own value that you enter is exported.

You can recognise complex mappings from the field that is shown below the name of the marketplace data field. Click on the field to show the values available for the marketplace data field.

catalogue complex mappings

Examples for complex 1:1 mappings are:

  • Categories

  • Brands

  • Shipping setting

Important: For complex mappings, do not map own values or properties of the type None.

Creating a complex 1:1:n mapping:

  1. Click on the field for the marketplace data field.
    → A list of the available values is shown.

  2. Select the value that you want to map a PlentyONE data field to.
    → The value is mapped.

  3. Next to the marketplace data field, click on + Add data field.
    → To the left, the available PlentyONE data fields are listed in groups.

  4. Click on a group.
    → The PlentyONE data fields of the group are shown.

  5. Click on the PlentyONE data field for which you want to map values.
    Important: Do not map own values or properties of the type None.

  6. Your next steps depend on the PlentyONE data field you selected:

    • Alternative 1: The available values for the PlentyONE data value are shown on the left.

      • Next to the value you want to select, click on the plus.
        → The value is added to the field on the right.

      • Click on Confirm.

    • Alternative 2: The PlentyONE data field is inserted and the field Comparative value is shown.

      • In the field Comparative value, enter a value that is saved in the setting or the property of the mapped PlentyONE data field.

      • Click on Confirm.

    • Alternative 3: The PlentyONE data field is inserted and a drop-down list is shown.

      • Select a value from the drop-down list.

      • Click on Confirm.
        → The value of the marketplace data field is exported, not the value of the PlentyONE data field.
        Exception: Only when you map an own value, the own value that you enter is exported.

Example: Delivery time in days for Otto Market

This gif shows you how to map suitable PlentyONE values to the values of the marketplace data fields Delivery time in days for Otto Market:

gif catalogue mapping complex en
1:1 mapping with fallback data fields: 1 marketplace data field, 1 PlentyONE data field with alternative(s)

In a 1:1 mapping with one or more fallback data fields, you map a PlentyONE data field to the marketplace data field. In addition, you specify one or more fallback data fields. This ensures that the system keeps looking if the first PlentyONE data field is missing or empty.

So this mapping specifies:

  • I want to fill the marketplace data field with the data from the selected PlentyONE setting.

  • If that data field is missing or empty for a variation, the first fallback data field is checked. The value of that fallback data field is exported instead.

  • If the first fallback data field is also missing or empty for the variation, the second fallback data field is checked. If a value is found, the value of the second fallback data field is exported for the variation etc.

Two separate fallback conditions are available:

Null (default)

The fallback data field is used if the data field above is mapped in the catalogue but not linked to the variation.

The condition "Null" is useful when you want to map fallback data fields for the following types of PlentyONE data fields:

  • SKU

  • Barcodes

  • Sales prices

  • Properties

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Empty

The fallback data field is used if the data field above is mapped in the catalogue and linked to the variation, but is empty.

The condition "Empty" is useful when you want to map fallback data fields for the following type of PlentyONE data fields:

  • PlentyONE data fields that are available for variations by default

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Note: Even if you assign one or more fallback data fields, the value of only one of those fields is exported. For each variation, the mapped PlentyONE data fields are checked in the order in which you mapped them. This means that if the first data field does not provide a value for a variation, the first fallback data field is exported etc.

Creating a 1:1 mapping with fallback data fields:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. Click on the plus to the right of the PlentyONE data field you want to select.
    → The PlentyONE data field is added to the right.

  4. In the list of PlentyONE data fields, click on the plus icon next to the PlentyONE data field that you want to map.
    → The fallback data field is added with the fallback condition "null".

  5. Alternative 1: To add the fallback data field with the fallback condition "null":

    1. Click on Confirm.
      → The fallback data field is exported if the data field above is not linked to the variation.

  6. Alternative 2: To add the fallback data field with the fallback condition "empty":

    1. To the left of the fallback data field, click on the cog ().
      → The window Data column settings is shown.

    2. For the setting Fallback condition, select the option Empty.

    3. Click on Save.
      → The fallback data field is added with the fallback condition "empty".

    4. Click on Confirm.
      → The fallback data field is exported if the data field above is empty for the variation.

Example: Fallback data field for SKU for Otto Market

This GIF shows you the mapping for the OTTO Market marketplace data field SKU. The PlentyONE data field SKU is mapped to this marketplace data field. The PlentyONE data field Variation ID is mapped as the fallback data field. The fallback condition "null" is applied automatically.

Result: The fallback data field Variation ID is exported if the data field SKU is not linked to the variation.

gif catalogue mapping fallback en
1:n mapping: 1 marketplace data field, several PlentyONE data fields

In a 1:n mapping, you map several PlentyONE data fields to the marketplace data field. You can link these data fields with a separator.

So this mapping specifies:

  • I want to combine these PlentyONE data fields during export so that the marketplace data field is filled with the data of these two or more PlentyONE settings.

Creating a 1:n mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. Click on the plus to the right of the PlentyONE data field you want to select.
    → The PlentyONE data field is added to the right.

  4. Click on Confirm.

  5. To the right of the mapped PlentyONE data field, click on Add data field ().
    → To the left, the list of available PlentyONE data fields again are shown in groups.

  6. Map one or several additional PlentyONE data fields to the marketplace data field as described above.

  7. Click on Confirm.

  8. To the very right of the row, click on Settings ().

  9. Select a separator from the drop-down list Separator or add a custom separator.

  10. Click on Save.

  11. Save () the catalogue.
    → The mappings are saved.
    → During the export, the content of the PlentyONE data fields is combined and exported as one field.

Own value mapping: 1 marketplace data field, the same value for all variations

You are sure that you want to export the same value for all variations of a catalogue for a marketplace data field? Then specify an own value. This own value is then exported for all variations.

So this mapping specifies:

  • For this marketplace data field, I want to export the value that I entered in the field Own value for all variations of this catalogue. The value you enter is always exported. The value overwrites the market value also in complex mappings where usually the value of the market is exported. As such, make sure you enter an own value that the market accepts for this marketplace data field.

Creating an own value mapping:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. Click on the plus next to Own value at the top of the list.
    → The field for the own value is added to the view.

  3. Enter a value into the input field.
    → This value is exported for all variations.

Example: Diameter information

You want to export diameter information for some of your variations. The diameter is saved in centimetres for all your variations. Instead of creating a property for the unit and linking this property to the variations, you can enter the own value cm.

This is an example of how you can map an own value for the diameter unit:

gif catalogue own value en
Mapping with mathematical calculations: 1 Marketplace data field, the PlentyONE value is recalculated using the formula during export

Mathematical calculations allow you to change numerical values automatically during the export.

  • This function only works for data fields that contain numerical values.

  • This functionality is new and not available for all catalogue formats.

So this mapping specifies:

  • I want the numerical value of a PlentyONE data field to be recalculated during the export. Basic arithmetic operations are available for the formulas.

Recalculating numerical values:

  1. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available PlentyONE data fields are shown in groups.

  2. At the very top of the list, click on the plus icon next to Formula (calculate).
    → The data field Formula is added to the field on the right.

  3. Click into the data field.
    → The window Modify value is shown.

  4. Enter a numerical value or select a PlentyONE data field at the bottom right of the window to add it to the calculation (add).
    Tip: Use the search function. This helps you to find data fields quickly.

  5. Optional: If the symbol more_vert is shown in the data field, select the correct assignment for the data field.
    Tip: A number tells you how many assignments are necessary for the data field.

    1. Click on the icon more_vert.

    2. In the window shown, select the assignments from the drop-down list.

    3. Save the settings.

  6. Enter numbers and mathematical operators with the on-screen calculator or the keyboard.

  7. Save the settings.
    → The entered formula is displayed in the overview.
    → The calculation will be carried out in the next export.

To help you with mapping your data fields for the catalogue, we have created a list of recommended data field mappings. Note that these mappings are recommendations only. Depending on how you manage your item data, other mappings may be more appropriate than the recommendation given here.

  • Need more information about the PlentyONE data fields? All data fields are described on the manual page for the export type Listing.

List of recommended data field mappings for the format Offer

8.1.3. Adding several item conditions

Via a complex mapping, you can add several item conditions to your Cdiscount catalogue. To do so, proceed as follows.

Adding several item conditions:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Open the Cdiscount catalogue with the export type Listing for which you want to add item conditions.

  3. Go to the Condition group section.

  4. Click in the Condition field and select the desired condition from the dropdown list.

  5. Afterwards, map a data source.
    Tip: Under Item, several PlentyONE data sources are available for item conditions.

  6. Click below on + Add condition to add another condition.

  7. Repeat these steps until all item conditions have been added.

  8. Save (save) the settings.
    → The selected item conditions are added.
    Note: If you did not select a mapping in the Condition group section, the default mapping in the Condition field will still be valid.

8.1.4. Adding a discount campaign for items

In the Cdiscount offer catalogue you can add discounts for specific items. Note that the discounted price of the item needs to be at least 5% lower than the lowest price of the last 30 days.

Adding a discount campaign for items:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Open the Cdiscount catalogue for which you want to add the discount.
    → The Mapping tab opens.

  3. Carry out the settings. Pay attention to the explanations given in Table 6.

  4. Save () the settings.
    → The discount is applied.

Table 6. Add discount campaign
Setting Explanation

Discounted price

Map the discounted price that should be used for the item.
Note: The price mapped under Discounted price is not directly transmitted to Cdiscount. Instead, a percentage ("discountValue") is calculated from the Price (sales price of the item) and the discounted price. This percentage is exported to Cdiscount.

Start date

Add the start date from which the discounted price should apply.
Note: Use the following format to export dates: DD-MM-YYYY.

End date

Add the end date until which the discounted price should apply.
Note: Use the following format to export dates: DD-MM-YYYY.

8.1.5. Activating the catalogue export

You have set up Octopia in PlentyONE and created a catalogue for exporting your offer data? Then activate the catalogues you want to export to Octopia in the Data » Catalogues menu and continue with creating offer listings.
Once you have activated the offer catalogue, the Octopia account, the offer listing and the variations, the offer data will be automatically exported to Octopia every 15 minutes.

Activating the catalogue export to Octopia:

  1. Go to Data » Catalogues.
    → The catalogues are listed.

  2. Scroll to the Octopia catalogue.

  3. In the Active column, move the toggle button to the right ().
    → The catalogue is active.
    → The catalogue data is exported to Octopia every 15 minutes.
    Tip: Go to Data » Catalogue export status for information about the status of the export.

9. Managing listings

You create and manage offers for Octopia/Cdiscount 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 Octopia/Cdiscount to create product listings or offer listings for Octopia/Cdiscount.

9.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 7 offers an overview of the single listing view of offer listings.

Table 7. 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 8 offers an overview of the group view of offer listings.

Table 8. 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.

9.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 9 offers an overview of the single listing view of product listings.

Table 9. 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 10 offers an overview of the group view of product listings.

Table 10. 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.

9.3. Creating listings

You create and manage products on Octopia as well as offers on Cdiscount via listings. Carry out the following steps to create listings for Octopia/Cdiscount.

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.

9.3.1. Creating offer listings

Select the template Offer CDiscount for offers.

Offer listings are created in three steps:

  • First, you enter listing details, meaning you select the platform, template, and catalogue for the listing.

  • Next, you select the variations from which the offer listings are created.

  • Lastly, check and confirm your selection and create the listings.

You can also create offer listings directly from your product listings. Here you can learn how to do that.

Step 1: Specify listing details:

  1. Open the Sales Channels » Accounts menu.

  2. Open the account for Octopia.
    → The Offer listings menu opens.

  3. Click add Create offers.
    → The Create offers tab opens.

  4. Select the platform Octopia.

  5. Select the template for the catalogue.
    Tip: Only templates that are available for the platform Octopia are displayed.

  6. Select a catalogue with your mappings for offer data.
    Tip: If you have no fitting catalogue yet, click on add Create catalogue. You will be forwarded to the Data » Catalogues menu and can create a catalogue.

  7. Optional: Activate Automatically activate listings after creation, if listing data should be automatically transferred to Octopia/Cdiscount after the listing is created.

  8. Click arrow_forward NEXT.
    → The Select variations view opens. Next, select the variations you want to add to the listing.

Step 2: Select variations:

  1. Select the variations you want to create the offer listing for.
    Tip: Use the search to filter for variations.
    Note: Only variations that are linked to Octopia/Cdiscount in the Item » Items » [Open item] » [Open variation] menu are displayed.
    Tip: If you want to create offer listings for all available variations, click on Click here to create listings for all [] variations above. You will be automatically redirected to the Preview and confirmation step. Offer listings can be created for a maximum of 50,000 variations at a time.

  2. Click add ADD TO SELECTED VARIATIONS.
    → The selected variations are displayed in the Selected variations section.
    Note: If you check a variation in the Selected variations section, you can remove the variation from the selection by clicking Remove from list.

  3. Click arrow_forward NEXT.
    → The selected variations will be displayed in a new view. In the last step, you preview and confirm your selection.

Step 3: Preview and confirm selection:

  1. Preview your settings in the Listing details section.

  2. Preview your selected variations in the Listing preview section. The listings are grouped by items. Extend a listing group (chevron_right) to see which variations are contained in the respective listing group.

  3. If everything is set and done, click CREATE OFFER LISTINGS.
    Note: If you activated Automatically activate listings after creation a window with a summary of your settings opens. Click check CONFIRM to create the offer listings.

9.3.2. Creating product listings

Select the respective product category as template for products.

Product listings are created in three steps:

  • First, you enter listing details, meaning you select the channel, template, and catalogue for the listing.

  • Next, you select the variations from which the product listings are created.

  • Lastly, check and confirm your selection and create the listings.

Create product listings via group function

You have the option to create product listings directly in the Item menu via the variation group function. Here^ you find more information on the variation group function.

Step 1: Specify listing details:

  1. Open the Sales Channels » Accounts menu.

  2. Open the account for Octopia.
    → The Offer listings menu opens.

  3. Switch into the Product listings menu via the side navigation to the left.

  4. Click on add Create products.
    → The tab Create products opens.

  5. Select :sales-channel-selection: pass:quotes[the platform *Octopia*].

  1. Select the template for the catalogue.
    Tip: Only templates that are available for :sales-channel-selection: pass:quotes[the platform *Octopia*] are displayed.

  2. Select a catalogue with your mapping for item data.
    Tip: If you have no fitting catalogue yet, click on add Create catalogue. You will be forwarded to the Data » Catalogues menu and can create a catalogue.

  3. Optional: Activate Automatically activate listings after creation, if listing data should be automatically transferred to Octopia/Cdiscount after the listing is created.

  4. Click arrow_forward NEXT.
    → The Select variations view opens. Next, select the variations you want to add to the listing.

Step 2: Select variations:

  1. Select the variations you want to create the product listing for.
    Tip: Use the search to filter for variations.
    Note: Only variations that are linked to Octopia/Cdiscount in the Item » Items » [Open item] » [Open variation] menu are displayed.
    Tip: If you want to create product listings for all available variations, click on Click here to create listings for all [] variations above. You will be automatically redirected to the Preview and confirmation step. Product listings can be created for a maximum of 50,000 variations at a time.

  2. Click add ADD TO SELECTED VARIATIONS.
    → The selected variations are displayed in the Selected variations section.
    Note: If you check a variation in the Selected variations section, you can remove the variation from the selection by clicking Remove from list.

  3. Click arrow_forward NEXT.
    → The selected variations will be displayed in a new view. In the last step, you preview and confirm your selection.

Step 3: Preview and confirm selection:

  1. Preview your settings in the Listing details section.

  2. Preview your selected variations in the Listing preview section. The listings are grouped by items. Extend a listing group (chevron_right) to see which variations are contained in the respective listing group.

  3. If everything is set and done, click CREATE PRODUCT LISTINGS.
    Note: If you activated Automatically activate listings after creation a window with a summary of your settings opens. Click check CONFIRM to create the offer listings.

10. Creating properties

Next, create properties and link the properties to variations. Then link the properties you have created to Cdiscount properties. Properties have to be created in French.

Creating a new property:

  1. Go to Setup » Settings » Properties » Configuration.

  2. Click on Create property.

  3. Customise the settings to meet your needs.

  4. Save () the settings.

11. Permitting payment method in customer classes

The payment method Cdiscount is automatically available in your PlentyONE system as soon as an active Cdiscount account exists. No separate configurations are needed for this. You just need to permit the payment method in one or more customer classes.

What are customer classes?

Customer classes allow you to divide your customer base according to specific criteria. Examples of use for customer classes are:

  • Create two separate customer classes for end customers (B2C) and business customers (B2B) respectively. Depending on the customer class, customers either see net prices or gross prices in your plentyShop.

  • Give discounts to specific customer classes.

For more information about customer classes, head over to the to the Managing contacts page.

Permitting the payment method in a customer class:

  1. Go to Setup » CRM » Customer classes.

  2. Open the customer class for which you want to permit the payment method.

  3. For the setting Allowed payment methods, activate the option Cdiscount.

  4. Save () the settings.

12. Automating order processing

You can automatically notify Cdiscount about changes to the order status. There are two ways to do this:

  • Option 1: PlentyONE Flow (recommended)

  • Option 2: Event procedures (old method)

12.1. Option 1: PlentyONE Flow (recommended)

Create event-based Flows to automatically inform Cdiscount about changes to the order status. The following actions are available for Cdiscount in the PlentyONE Flow Studio:

  • Automatically inform Cdiscount that the items have been shipped. (How?)

  • Automatically inform Cdiscount about cancellations. (How?)

What is PlentyONE Flow?

With PlentyONE Flow (short: "Flow"), you can automate workflows for your business processes. Flow provides you with two functions in the Automation menu:

  • In Flow Studio, you create and configure automated workflows. Depending on the trigger type, there are three flow types: event-based, time-based or manual.

  • In the Flow Tracker, you can monitor ongoing or finished workflows.

The central element in both functions is the Canvas – a graphical interface on which the workflows are visualised with Actions and Controls. In Flow Studio the canvas can be edited, in Flow Tracker it is only used for visualisation and is therefore read-only.

12.1.1. Send shipping confirmation to Cdiscount

Create an event-based flow to automatically inform Cdiscount when you have shipped the items of an order.
In order to successfully transfer a shipping confirmation, the following data must be saved for the order.

  • Shipping service provider

  • Outgoing items must be booked

  • external order number

Creating an event-based flow

  1. Go to Automation » Flow Studio.

  2. Click Create flow (add).
    → A stepper opens and guides you through the following three steps.

    1. General

      1. Enter a unique name and, if necessary, a description for the new flow.

      2. Click Next.

    2. Trigger

      1. Select Event-based as the trigger.

      2. Click Next.

    3. Settings

      1. If desired, select a UI from the optional drop-down list Flow available in.
        → The option to manually trigger the flow directly from the selected UI is added to the group functions in that UI.
        Note: UIs currently selectable: Order UI.

      2. From the drop-down list Trigger selection, select the event according to Table 11.
        Note: If the trigger event has additional settings, then these are invariably mandatory. Without performing these settings, you will not be able to save the flow.

      3. Save ​​() the settings.
        → The flow is created.
        → The Flow Studio Canvas appears, on which two elements are already displayed: The trigger type and the placeholder for the next step.
        Note: With some event-based flows you cannot save the flow if it consists of only a trigger. In such cases, you need to add at least one further step.

  3. Configure the new flow according to Table 11.

  4. Save ​​() the settings.

Note: The selected statuses, controls and filters in Table 11 only serve as an example. Select the status, controls and filters for the flow which best suit your workflow.

Table 11. Event-based flow for sending shipping confirmations to Cdiscount
Setting Option Selection

Trigger selection

Select a trigger, for example:

  • Order > Order status changed

or

  • Order > Outgoing items booked

Select an order status, for example:

  • [7] Outgoing items booked

Controls

Branch

  • Object type: Order

  • Filter settings for the branch:
    Note: If you want to use multiple filters, add the additional filters as conditions (playlist_add). Select AND as the relationship between the conditions.

Filter Operator Input field

Order > Order referrer

Is in (IN)

Select the order referrers for the Cdiscount sales channels that you want to use this Flow for.

Actions

Plugin (Legacy) > Octopia

Octopia: Send fulfillment notification to Octopia

12.1.2. Automatically sending cancellations

Create an event-based flow to automatically inform Cdiscount about cancellations.
Different flows can be created, depending on the reason for the cancellation. The following actions are available for Cdiscount to report a cancellation:

  • Octopia: Send cancellation request to Octopia - Customer Cancellation

  • Octopia: Send cancellation request to Octopia - Customer Claim

  • Octopia: Send cancellation request to Octopia - Seller refusal

  • Octopia: Send cancellation request to Octopia - Customer Withdrawal

Creating an event-based flow

  1. Go to Automation » Flow Studio.

  2. Click Create flow (add).
    → A stepper opens and guides you through the following three steps.

    1. General

      1. Enter a unique name and, if necessary, a description for the new flow.

      2. Click Next.

    2. Trigger

      1. Select Event-based as the trigger.

      2. Click Next.

    3. Settings

      1. If desired, select a UI from the optional drop-down list Flow available in.
        → The option to manually trigger the flow directly from the selected UI is added to the group functions in that UI.
        Note: UIs currently selectable: Order UI.

      2. From the drop-down list Trigger selection, select the event according to Table 12.
        Note: If the trigger event has additional settings, then these are invariably mandatory. Without performing these settings, you will not be able to save the flow.

      3. Save ​​() the settings.
        → The flow is created.
        → The Flow Studio Canvas appears, on which two elements are already displayed: The trigger type and the placeholder for the next step.
        Note: With some event-based flows you cannot save the flow if it consists of only a trigger. In such cases, you need to add at least one further step.

  3. Configure the new flow according to Table 12.

  4. Save ​​() the settings.

Note: The selected statuses, controls and filters in Table 12 only serve as an example. Select the status, controls and filters for the flow which best suit your workflow.

Table 12. Event-based flow to send a cancellation to Cdiscount
Setting Option Selection

Trigger selection

Select a trigger, for example:

  • Order > Order status changed

Select a status, for example:

  • [8] Cancelled

or

  • [8.1] Cancelled by customer

Controls

Branch

  • Object type: Order

  • Filter settings for the branch:
    Note: If you want to use multiple filters, add the additional filters as conditions (playlist_add). Select AND as the relationship between the conditions.

Filter Operator Input field

Order > Order type

Is in (IN)

Sales order

Order > Order referrer

Is in (IN)

Select the order referrers for the Cdiscount sales channels that you want to use this Flow for.

Actions

Plugin (Legacy) > Octopia

Select an action for Octopia: Send cancellation request to Octopia with the appropriate reason.

12.2. Option 2: Event procedures (old method)

Set up event procedures to automatically inform Cdiscount about changes to the order status. The following event procedures are available for Cdiscount:

  • Automatically inform Cdiscount that the items have been shipped. (How?)

  • Automatically inform Cdiscount about cancellations. (How?)

  • Automatically inform Cdiscount about returns. (How?)

12.2.1. Send shipping confirmation to Cdiscount

Set up an event procedure to automatically inform Cdiscount when you have shipped the items of an order.
In order to successfully transfer a shipping confirmation, the following data must be saved for the order.

  • Shipping service provider

  • Outgoing items must be booked

  • external order number

Setting up an event procedure

  1. Go to Setup » Orders » Events.

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

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 13.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 13.

  7. Select the setting Active ().

  8. Save () the settings.

Note: The selected statuses and filters in Table 13 only serve as an example. Select filters and statuses for the event procedure which best suit your workflow.

Table 13. Event procedure for sending shipping confirmations to Cdiscount
Setting Option Selection

Event

Order change: Status change
or Order change: Outgoing items booked

[7] Outgoing items booked

Filter

Order > Referrer

CDiscount.fr

Procedure

Plugins

Octopia: Send fulfillment notification to Octopia

12.2.2. Automatically sending cancellations

Set up an event procedure to automatically inform Cdiscount of cancellations.
Different event procedures can be created, depending on the reason for the cancellation. The following event procedures are available for Cdiscount to report a cancellation:

  • Octopia: Send cancellation request to Octopia - Customer Cancellation

  • Octopia: Send cancellation request to Octopia - Customer Claim

  • Octopia: Send cancellation request to Octopia - Seller refusal

  • Octopia: Send cancellation request to Octopia - Customer Withdrawal

Setting up an event procedure

  1. Go to Setup » Orders » Events.

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

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 14.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 14.

  7. Select the setting Active ().

  8. Save () the settings.

Note: The selected statuses and filters in Table 14 only serve as an example. Select filters and statuses for the event procedure which best suit your workflow.

Table 14. Event procedure to send cancellation to Cdiscount
Setting Option Selection

Event

Order change: Status change

Select a status, for example:
[8] Cancelled
or
[8.1] Cancelled by customer

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

CDiscount.fr

Procedure

Plugins

Select an event procedure for Octopia: Send cancellation request to Octopia with the appropriate reason.

12.2.3. Automatically sending returns

Set up an event procedure to automatically send returns to Cdiscount.

Credit notes for returns always for the sum of an order item

If a Cdiscount order has more than one order item and the customer returns only one a partial amount of this order item, Cdiscount will always refund the total sum of this order item. This is due to a limitation on Cdiscount.
Example: The customer orders two sweaters for 30€ each and a jacket for 50€ and returns one of the pullovers. A credit note for the sum of this order item is created, in this case this would be 60€.
Setting up an event procedure

  1. Go to Setup » Orders » Events.

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

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 15.

  5. Save () the settings.

  6. Carry out the additional settings according to Table 15.

  7. Select the setting Active ().

  8. Save () the settings.

Note: The selected statuses and filters in Table 15 only serve as an example. Select filters and statuses for the event procedure which best suit your workflow.

Table 15. Event procedure for automatically sending returns to Cdiscount
Setting Option Selection

Event

Order generation: New return

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

CDiscount.fr

Procedure

Return

Send return to Cdiscount

13. Viewing the data log

Events in your system are logged in the menu Data » Log. This allows you to check the data log for errors without relying on our support.
For Cdiscount, you can download and view log files for offers here.

Viewing the data log and downloading the log file:

  1. Go to Data » Log.

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

  3. Enter the option REPORT in the Level field.

  4. Optional: Select a date if you only want to see entries for a specific day.

  5. Click Search () to display the results.

  6. Click Download (download) at the very right of the row with the desired log file.
    → The log file is downloaded in JSON format.

The downloaded log file contains entries for each offer per EAN. In each of these entries you will find the current integration status under offer_integration_status. Under property_list you will see the error or info message if a corresponding event has occurred.

Note: If you have any questions about the error messages, you can view them in the Octopia backend.