Zalando Layer Integration

Thanks to the Zalando partner programme, online sellers and manufacturers can use Zalando as an additional distribution channel for selling their high-quality products and take advantage of the well-known brand name Zalando.

Zalando is a closed, invite only market. In other words: Zalando will approach you if your products are a good fit for the Zalando product range.

With PlentyONE, you can use the following types of order processing:

  • Own logistics; Zalando calls this Partner Fulfillment (own logistics)

  • Shipping by Zalando, i.e. Zalando Fulfillment Solutions (ZFS)

Which countries you can sell in with Zalando depends on your contract with Zalando. You can import orders from the following countries into PlentyONE:

Countries available for Zalando

  • Austria

  • Belgium

  • Croatia

  • Czech Republic

  • Denmark

  • Estonia

  • Finland

  • France

  • Germany

  • Hungary

  • Ireland

  • Italy

  • Latvia

  • Lithuania

  • Luxembourg

  • Netherlands

  • Norway

  • Portugal

  • Romania

  • Slovakia

  • Slovenia

  • Spain

  • Switzerland

  • United Kingdom

1. Frequency of data exchange

Connecting to this market allows for the following automatic functions to take place:

Data Interval

Item export

Once a day

Stock synchronisation

Every 15 minutes, asynchronous
Note: Usually, stock for a maximum of 1,000 variations can be updated per minute. If the API limit set by Zalando is reached, the remaining stock details are sent once the API is unlocked after one minute.

Price synchronisation

Every 15 minutes

Order import

Every 5 minutes

2. Necessary steps for initial setup or switching to the new Zalando integration

Depending on whether you have already used the old Zalando integration in PlentyONE or whether you want to start selling on Zalando via PlentyONE for the first time, you will need to carry out different settings.

2.1. Option 1: I am not yet selling on Zalando via PlentyONE and want to set up the sales channel.

If you are not yet selling on Zalando via PlentyONE, you have to carry out the following settings to set up the sales channel in PlentyONE:

  1. Go through the assistant Account settings - Zalando for the first time to create a Zalando account.

  2. Contact the PlentyONE support to have your Zalando account linked to your zDirect account.
    Important: This is only possible after you have completed the assistant for the first time.

  3. Go through the assistant Account settings - Zalando again to carry out the remaining settings.

  4. Activate the order referrer for Zalando.

  5. Set the variation availability for Zalando.

  6. Create catalogues for Zalando. You have to create product and offer catalogues for Zalando.

  7. Create properties to provide detailed descriptions of your items on Zalando.

  8. Create listings to offer your items on Zalando.

  9. Automate the order processing.

  10. Activate your Zalando account in the assistant to start exchanging data with Zalando.

2.2. Option 2: I already sell on Zalando via PlentyONE and would like to use the new integration.

  1. Link your Zalando account in the assistant Account settings - Zalando.

  2. Create catalogues for Zalando. You have to create product and offer catalogues for Zalando.

  3. Create properties to provide detailed descriptions of your items on Zalando.

  4. Create listings to offer your items on Zalando.

Selling in additional countries

You have already set up the new Zalando integration and would now like to offer your items in another country? Then carry out the settings for an additional country. You can find an overview of the steps required to add a new sales channel for Zalando here.

3. Setting up Zalando in PlentyONE

Now set up the sales channel in your PlentyONE system.

3.1. Creating an account

First, create an account for Zalando. You can either create an account for Zalando in the Setup » Assistants » Omni-Channel menu using the assistant Account settings - Zalando or in the Sales Channels » Accounts menu.
PlentyONE recommends to create the account in the assistant. If you create the account using the assistant, then the account will also be linked with the correct configuration.

  • Creating and linking the account using the assistant (recommended)

  • Creating the account in the Sales Channels » Accounts menu

You can find a description how to do this in the chapter Going through the assistant for the first time.

Note: If you create the Zalando account in the Sales Channels » Accounts menu, then you will have to link the account in the Zalando assistant afterwards.

Creating an account:

  1. Open the Sales Channels » Accounts menu.

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

  3. Select Zalando 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 Zalando is created.

3.2. Going through the assistant for the first time

For Zalando, you carry out the basic settings in the assistant. First, complete the assistant Account settings - Zalando. To do so, go to Setup » Assistants » Omni-Channel.
You have to go through the assistant twice to complete the setup of Zalando in PlentyONE. First, you create an account for Zalando.

Going through the assistant for the first time:

  1. Go to Setup » Assistants » Omni-Channel.

  2. Open the assistant Account settings - Zalando.

  3. Click on New configuration (add).
    → A new configuration for the Zalando account opens.

  4. Go through the assistant for the first time.
    Tip: If you need additional information about one of the options, expand the info box below this description ().

  5. Important: You will see This account cannot be activated. That’s normal and as it should be. Next, contact the PlentyONE support so that your account can be linked to a zDirect account and activated, allowing you to continue with the setup.

  6. In the step Summary, check your settings to make sure they are correct.

  7. If everything is as it should be, click on Finalise.
    → The settings are saved.

Note: The account is added to the menu Setup » Assistants » Omni-Channel » Assistant: Account settings - Zalando after you have completed the assistant. The accountID that you need in the next step is also shown in this menu.

Step Link account

In this step, you create a Zalando account and link it to the configuration that you create with the assistant. This means that you carry out the settings for this Zalando account in the assistant.
In this step, you can either:

  • Create a new Zalando account and link it to this configuration.

    • To do so, select the option Create and link new account.

or

  • Link an existing Zalando account to this configuration.

Step Account activation

In this step, activate your Zalando account.
Important: When you go through the assistant for the first time, you will see This account cannot be activated. That’s normal and as it should be. Next, contact the PlentyONE support via Service Desk so that your account can be linked to a zDirect account and activated, allowing you to continue with the setup.

You have completed the assistant for the first time. Now, request activation of your Zalando account:

To do so, create a ticket in Service Desk. Select the category Technical Support and ask the PlentyONE support to activate your Zalando account.

Provide the following details:

  • The company/brand name you used to register with Zalando

  • Your plenty ID

  • The ID of the Zalando account (accountId) in PlentyONE that you want to activate for the Zalando interface
    Tip: Go to Setup » Assistants » Omni-Channel » Assistant: Account settings - Zalando to find the accountID.

3.4. Going through the assistant for the second time

Once your Zalando account has been linked to a zDirect account, you can go through the assistant Account settings - Zalando a second time. Now, carry out the account and channel settings.

Going through the assistant for the second time:

  1. Go to Setup » Assistants » Omni-Channel.

  2. Open the assistant Account settings - Zalando.

  3. Open the configuration that you created in the first step.

  4. Go through the assistant for the second time.
    Tip: If you need additional information about one of the options, expand the info box below this description ().

  5. In the step Summary, check your settings to make sure they are correct.

  6. If everything is as it should be, click on Finalise.
    → The settings are saved.

Step Link account

In this step, you create a Zalando account and link it to the configuration that you create with the assistant. You have already completed this step when you first went through the assistant.

Step Select client

In this step, you select the client (shop) which the Zalando orders should be assigned to.

Step Reasons for return
Setting Explanation

Map PlentyONE reasons for return to

From the drop-down list, select a Zalando return reason for each return reason saved in PlentyONE. The return reasons are only transmitted for the order type Return and if they are saved in the order items of the return.

Tip: You can save return reasons in the menu Setup » Orders » Order types » Return.

Zalando currently has the following reasons for return:

  • Unknown reason

  • Do not like the item

  • Too big

  • Too small

  • Bad value for money

  • Not delivered on time

  • Item not as expected

  • Wrong item sent

  • Item defective

Note: Sending reasons of return to Zalando is optional. However, Zalando recommends that you send a reason.
Step Own shipping (ZSS/ZRS): warehouse mapping

In this step, you assign Zalando warehouses to your warehouses in PlentyONE that you use to ship items to Zalando. For each PlentyONE warehouse, select a Zalando outbound warehouse from the drop-down list.

Step Set up Zalando Fulfillment Solutions (ZFS)
Setting Explanation

Do you want to use Zalando Fulfillment Solutions?

Activate the toggle button to use Zalando Fulfillment Solutions.
Note: You need to have a contract for Zalando Fulfillment Solutions in order to use this service.

Background: Zalando Fulfillment Solutions is a service in which Zalando ships the orders to your customers. You send your items to Zalando and Zalando takes care of the storage and the shipment to your customers.

Match warehouses
(only if
Use Zalando Fulfillment Solutions)

Now, assign PlentyONE warehouses to the different Zalando locations (countries).

There is a Zalando Fulfillment warehouse your items can be stored in each country that you can select here. Assign PlentyONE warehouses to these Zalando warehouses. This provides an overview of the Zalando locations your items are stored in. The stock from the Zalando locations is transferred to your PlentyONE warehouses.

To map Zalando ZFS stock in PlentyONE, you need one or more repair warehouses.

Recommendation: Create new warehouses for Zalando Fulfilment Solutions.

You can either specify a default warehouse only or a default warehouse and additional warehouses for each Zalando sales channel.

Possibility 1: Only specify a default warehouse

  1. For the setting Default warehouse for Zalando ZFS, select a PlentyONE repair warehouse from the drop-down list.
    → Stock data for all Zalando ZFS warehouses is imported to this repair warehouse.
    Important: If you do not assign any other warehouses, the stock data from all Zalando locations will be imported to this PlentyONE warehouse.

Possibility 2: Specify a default warehouse and additional warehouses for each Zalando sales channel

  1. For the setting Default warehouse for Zalando ZFS, select a PlentyONE repair warehouse from the drop-down list.

  2. At the bottom right, click on (add) to assign further warehouses.

  3. From the Zalando drop-down list, select a country.

  4. From the drop-down list PlentyONE warehouse, select a repair warehouse.
    → Stock data from this country are imported to the selected warehouse.
    Note: You can only assign one PlentyONE warehouse to each Zalando location.

  5. If necessary, click on (add) at the bottom right again to map additional warehouses.
    → Stock data for Zalando locations that are not mapped to a PlentyONE warehouse are imported to the default warehouse.
    Example: Create a warehouse Zalando Germany. To this warehouse, map the Zalando location Deutschland. This allows you to check the stock that Zalando holds for you in Germany at any time.
Step Settings for the sales channel

Each country has a separate Zalando sales channel. Zalando activates you for the sales channels that you agreed upon in your contract. In the assistant, a separate step Settings for the sales channel is added for each country. The settings are the same for all countries.

You don’t see any steps for the sales channel settings? Then your account has not been linked to the zDirect account yet. (What do I need to do?)
Is a country missing? The countries are updated once a day. So when Zalando activates a new country for you, it can take up to 24 hours before that country is available in PlentyONE.

Setting Explanation

Settings for self-fulfilled orders

Import self-fulfilled orders

Activate to automatically import self-fulfilled orders every five minutes.
Note: You need to activate this option to export item data and stock information to Zalando.

Start date of self-fulfilled order import

Select a date (optional). Only orders updated on or after this date are imported.

Import reservations

If this option is activated, reservations will be imported into PlentyONE with the status [3] Waiting for payment.
If Zalando confirms the payment of the order and it changes to the status approved on Zalando, the order changes to status [5] Cleared for shipping in PlentyONE. As soon as an order is moved into status [5], it can be shipped.
Note: Orders can only be shipped in status [5] Cleared for shipping. An order which is still in status [3] Waiting for payment must not be shipped.

What are reservations?

Items are considered reserved if a customer has placed an order which has either not been paid for or has not been released for shipping by Zalando.

Status for cancelled reservations

Decide which status cancelled reservations should be moved to. Select a status [8.X] or higher. If the customer or Zalando cancels, reservations are moved to this status. Any orders that customers cancel before the import of reservations is started are not imported.
Note: Select a status that does not trigger an event procedure for Zalando as a result of the status change.

Reuse package numbers for returns

Activate this option if you generate Hermes shipping labels that also serve as return labels. The package numbers stay the same.

Settings for ZFS orders (shipment by Zalando)

Import ZFS orders

Activate to automatically import ZFS orders. ZFS orders are then imported once per hour.
Important: Only orders that Zalando has shipped are imported. Any orders that were cancelled before shipment are not imported.

Start date of ZFS order import

Select a date (optional). Only orders updated on or after this date are imported.

Initial status of ZFS orders

What order status do you want to assign to ZFS orders on import?

Import ZFS returns

Activate to automatically import ZFS returns. ZFS returns are then imported once per hour.

Initial status of ZFS returns

What order status do you want to assign to ZFS returns on import?

Stock settings

Export stock

Activate option to export your stock to Zalando every 15 minutes.

Select sales warehouse

Select one or more sales warehouses. The totalled net stock of these sales warehouses is exported.
Tip: You can specify a Stock buffer further down in the menu. The totalled net stock of the sales warehouses you selected is then reduced by the quantity you entered as the stock buffer.

Maximum stock to export

If a variation has a higher stock, the value you entered in the Maximum stock field will be exported instead.

Stock buffer

A stock buffer is the amount of an item that should not be sold, but kept as a buffer. The quantity you enter in the * Stock buffer*field is deducted from the net stock of each variation before export.

Stock for variations without positive net stock and without stock limitation

Enter the stock to be exported for variations that have no positive net stock. Variations that have no positive net stock are variations with the setting Section: Availability and visibility, Setting: Stock limitation, Option: None that have no positive net stock.

Stock for variations without stock administration

Enter the stock to be exported for variations without stock administration. Variations for which no stock is administered are variations with the setting Section: Availability and visibility, Setting: Stock limitation, Option: Do not administer stock for this variation. The entered value is exported for these variations.

Price settings

Export prices

Activate option to export your prices to Zalando every 15 minutes.
Tip: The price reports contain information on the status of price updates.

How to download price reports

Ignore warnings of Zalando on price updates

During price updates, Zalando checks the plausibility of your prices based on specific criteria. For example, Zalando compares the prices of the same variations on different platforms and compares the regular price with the reduced price. If any significant differences are detected, Zalando triggers a warning. Select if such warnings should be ignored when prices are updated.

  • = The new prices are published even if Zalando sends a warning.

  • (default setting) = Zalando rejects new prices if they do not pass the plausibility checks.
    Tip: Check the Data » Log menu and the price reports for warnings.

Regular price

Select the sales price from the drop-down list that you want to export to Zalando as the regular price. You can select from sales prices of the types Default or RRP for which the referrer Zalando, the country and the currency of the country are activated.
Note: If you specify a reduced price for a variation, the regular price is exported to Zalando as the strikethrough price.

Reduced price

Select the sales price from the drop-down list that you want to export to Zalando as the reduced price. You can select from sales prices of the types Offer price or Default for which the referrer Zalando, the country and the currency of the country are activated.
Note: If you specify a reduced price for a variation, the regular price is exported to Zalando as the strikethrough price.

Scheduled prices

Planned price 1
to
Planned price 3

Use scheduled prices to announce any temporary or permanent price changes to Zalando ahead of time.

Define up to three scheduled prices. Scheduled prices ensure that Zalando really changes your prices at the specified time. To export scheduled prices to Zalando, you need at least a sales price for the regular price and a property that contains the start date and start time for the new price. The start date for scheduled prices must be in the future. You can also select a property for an end date for a scheduled price.

  • Regular price = Select the sales price from the drop-down list that you want to export to Zalando as the Scheduled price.

  • Reduced price = Select the sales price from the drop-down list that you want to export to Zalando as the reduced price for the planned price.
    Note: If you specify a reduced price for a variation, the regular price is exported to Zalando as the strikethrough price.

  • Property for start date = Select the property from the drop-down list that you use to manage the start time for your variations. You can only select properties of the types Date or Text.
    Note: The start times of more than one scheduled prices must be separated by at least 60 minutes.

  • Property for end date (optional) = Select the property from the drop-down list that you use to manage the end time for your variations. You can only select properties of the types Date or Text.
Step Account activation
Setting Explanation

In which interface environment do you want to exchange data with Zalando?

Interface environment

Select if real or test data is to be exchanged with Zalando.

  • Sandbox = Test data is exchanged with Zalando.

  • Productive = Real data is exchanged with Zalando.

Would you like to activate your Zalando account now?

Activating the Zalando account

You have not completed the setup.
As such, do not activate the Zalando account yet.

3.5. Account overview

The Sales Channels » Accounts menu provides an overview of the account.

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

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

Note: At present, the Zalando account cannot be activated via the account’s tile in the Sales Channels » Accounts menu. You can only activate the account in the assistant Account settings - Zalando.

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.

3.6. 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 Zalando.

  3. Open the settings Account settings tab.

  4. Enter the name.

  5. Save () the settings.

3.7. Activating an order referrer

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 Zalando:

  1. Go to Setup » Orders » Order referrer.

  2. Click Search (search).

  3. In the list, navigate to the Zalando referrer, for example Zalando DE.

  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.

List of referrer IDs

118 = Zalando
118.01 = Zalando DE
118.02 = Zalando NL
118.03 = Zalando FR
118.04 = Zalando IT
118.05 = Zalando UK
118.06 = Zalando AT
118.07 = Zalando CH
118.08 = Zalando PL
118.09 = Zalando BE
118.1 = Zalando SE
118.11 = Zalando FI
118.12 = Zalando DK
118.13 = Zalando ES
118.14 = Zalando NO
118.15 = Zalando CZ
118.16 = Zalando IE
118.17 = Zalando PT
118.18 = Zalando SK
118.19 = Zalando SI
118.2 = Zalando LT
118.21 = Zalando LV
118.22 = Zalando EE
118.23 = Zalando HR
118.24 = Zalando HU
118.25 = Zalando RO
118.26 = Zalando LU

Order referrers for Zalando ZFS:

172 = Zalando ZFS
172.01 = Zalando ZFS DE
172.02 = Zalando ZFS NL
172.03 = Zalando ZFS FR
172.04 = Zalando ZFS IT
172.05 = Zalando ZFS UK
172.06 = Zalando ZFS AT
172.07 = Zalando ZFS CH
172.08 = Zalando ZFS PL
172.09 = Zalando ZFS BE
172.1 = Zalando ZFS SE
172.11 = Zalando ZFS FI
172.12 = Zalando ZFS DK
172.13 = Zalando ZFS ES
172.14 = Zalando ZFS NO
172.15 = Zalando ZFS CZ
172.16 = Zalando ZFS IE
172.17 = Zalando ZFS PT
172.18 = Zalando ZFS SK
172.19 = Zalando ZFS SI
172.2 = Zalando ZFS LT
172.21 = Zalando ZFS LV
172.22 = Zalando ZFS EE
172.23 = Zalando ZFS HR
172.24 = Zalando ZFS HU
172.25 = Zalando ZFS RO
172.26 = Zalando ZFS LU

3.8. Setting the variation availability

You need to activate the variations that you want to sell on Zalando. This is done in the Availability and visibility section of a variation within the Item » Items » [Open item] » [Open variation] menu.

  • For one variation

  • Using variation group function

  • Using batch processing

Making a variation available for Zalando:

  1. Go to Item » Items » [Open item] » [Open variation].
    Tip: To sell all variations of an item on Zalando, carry out the settings for the item’s main variation. If the inheritance function is active for the variations, then this activates the availability of all variations of the item.

  2. In the Availability and visibility section, activate the option Active.

  3. In the Sales channels section, click Add sales channels (add).
    → The window Add sales channels opens.

  4. In the drop-down list Sales channels, select the option Zalando.
    Important: Select the sales channel Zalando. The other sales channels (Zalando DE, Zalando NL etc.) will be ignored.

  5. Click Apply.
    → The sales channel is added.

  6. Save () the settings.
    → The variation is available for Zalando.

Use the variation group function to edit multiple variations at once. You select the variations that you want to edit.

Making several variations available for Zalando using the variation group function:

  1. Go to Item » Items.

  2. Set search filters as needed and start the search.

  3. Select () the variations to be edited.

  4. In the toolbar, click on layers » layers Variation group function.
    → The Variation group function window opens.

  5. Select the action Sales channels from the drop-down list Actions.
    → The action is added to the lower part of the window.

  6. In the drop-down list Sales channels, select the option Zalando.
    Important: Select the sales channel Zalando. The other sales channels (Zalando DE, Zalando NL etc.) will be ignored.

  7. Select the action Active from the drop-down list Actions.
    → The action is added to the lower part of the window.

  8. Activate the option Active.

  9. Navigate to the area Availability.

  10. Click Execute to apply the settings.

Batch processing allows you to edit several variations at once. You use filters to limit which variations are edited.

Making several variations available for Zalando using batch processing:

  1. Go to Item » Batch processing.

  2. Click on the tab Variations in the upper left corner.

  3. Use the filters on the left to specify which variations should be processed.

  4. Navigate to the area Market availability.

  5. Activate the checkbox to the left of the option Zalando.

  6. Activate the checkbox to the right of the option Zalando.
    Important: Activate the availability Zalando. The availabilities for each Zalando platform (Zalando DE, Zalando NL etc.) will be ignored.

  7. Navigate to the area Availability.

  8. Activate the checkbox to the left of the option Active.

  9. Activate the checkbox to the right of the option Active.

  10. Click on Apply to apply the settings to the variations.

4. Creating catalogues

Item and offer data is exported to Zalando using catalogues. Go to Data » Catalogues to create catalogues for Zalando. Afterwards, link the Zalando data fields with item data saved in Zalando in the catalogue.
After you activate the catalogue, the catalogue data is automatically exported to Zalando in regular intervals.

There are two types of catalogues for Zalando:

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.

4.1. Creating a product catalogue

Item data is exported to Zalando using catalogues. To export your items to Zalando, create a product catalogue in the Data » Catalogues menu. Afterwards, link the Zalando data fields with item data saved in Zalando in the catalogue. After you activate the product catalogue, the catalogue data is automatically exported to Zalando within 24 hours.

Use Channel maps

To simplify the creation of new catalogues, you can now create Channel maps for Zalando. With Channel maps, you can create cross-category mappings for a marketplace and apply them to catalogues afterwards. All linked catalogues automatically inherit the mapping from the Channel map. This will save you a lot of time as you don’t need to carry out the mappings for each catalogue.
You can find more information on how to create Channel maps in the Channel maps section.

Note: There is a separate catalogue format for each Zalando product category. Different item data is exported in each format, depending on which information Zalando requires for a product category.

Creating a catalogue:

  1. Go to Data » Catalogues.

  2. Click Create catalogue (add).

  3. Enter a name for the catalogue.

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

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

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

  7. In the drop-down list Category, select the Zalando category.

  8. Save () the settings.
    → The catalogue is created.
    → The catalogue is opened for editing.

Other catalogue settings

Other catalogue settings are optional. Once you carried out the settings described on this page, your catalogue is automatically exported to Zalando. That means you can ignore the catalogue settings for Format settings, Export settings and Download settings.

The Format settings, Export settings, and Download settings allow you to create a file with the variation data contained in the catalogue. However, this file does not contain information about whether the data export to Zalando was successful.

Do not change the format in the catalogue’s Format settings. To ensure that the export to the sales channel works, all required settings are already configured when you create a catalogue. If you change the settings, errors might occur during the export.

4.1.1. Mapping data fields in the product catalogue

After you have created a catalogue, map the market’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 Zalando.

  • 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.

4.1.2. Particularities for mapping data fields in the product catalogue

Every market structures item data differently. As such, there are some particularities for each market when mapping data fields. This chapter contains mapping information for important data fields for Zalando.

4.1.2.1. Exporting the material composition

If textile fibres make up at least 80% of the weight of a product, you need to specify the material composition.
Zalando product catalogues contain several mandatory fields in which you must specify the material composition. For example:

  • material - Top part material

  • material - Lining

  • material - Filling

The material composition is exported to Zalando with a property of the type Text. Therefore, you have to create a separate property for every Zalando data field that specifies the material. Link the properties with the item’s main variation and specify all components of a material mix in this property. Use the following format:

  • materialtype1:percentage;materialtype2:percentage;materialtype3:percentage
    Example: Cotton:80;polyester:20

Step 1: Creating a property of the type text

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

  2. Click on add Create property.

  3. In the drop-down list Section, select the option Items.

  4. In the drop-down list Type, select the option Text.

  5. Enter a name for the property.

  6. Select where the property is to be displayed.

  7. Carry out additional settings as necessary.

  8. Save (save) the settings.

Step 2: Linking the property with a variation

  1. Open the variation in the Item » Items » [Open variation] menu.

  2. Open the Properties tab in the navigation bar on the left-hand side.

  3. Click Add properties (add).
    → The window Add properties opens.
    Tip: Use the search to search for the property.

  4. Place a check mark next to the desired property.

  5. Click APPLY.

  6. Enter the material composition in the following format:

    • materialtype1:percentage;materialtype2:percentage;materialtype3:percentage
      Example: Cotton:80;polyester:20

  7. Save () the settings.

Note:

  • Specify the individual materials in descending order based on the percentage value. As such, the first material is the one with the highest percentage value, the last one that with the lowest percentage value.

  • The sum of all percentages must be 100.

  • If the variations of the same item have different material mixes, deactivate the inheritance function for properties and save the material mixes separately for each variation. Note that deactivating the inheritance affects all properties of the item. As such, you also need to manually manage all other properties for each variation.

4.1.3. Activating the catalogue export

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

Activating the catalogue export to Zalando:

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

  2. Scroll to the Zalando catalogue.

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

4.2. Creating an offer catalogue

Offer data is exported to Zalando using catalogues. To export your items to Zalando, create an offer catalogue in the Data » Catalogue menu. Afterwards, link the Amazon data fields with item data saved in PlentyONE in the catalogue.
After you activate the offer catalogue, the catalogue data is automatically exported to Zalando within 15 minutes.

Use Channel maps

To simplify the creation of new catalogues, you can now create Channel maps for Zalando. With Channel maps, you can create cross-category mappings for a marketplace and apply them to catalogues afterwards. All linked catalogues automatically inherit the mapping from the channel map. This will save you a lot of time as you don’t need to carry out the mappings for each catalogue.
You can find more information on how to create Channel maps in the Channel maps section.

Creating a catalogue:

  1. Go to Data » Catalogues.

  2. Click Create catalogue (add).

  3. Enter a name for the catalogue.

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

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

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

  7. In the drop-down list Category, select Offer data.

  8. Save () the settings.
    → The catalogue is created.
    → The catalogue is opened for editing.

Other catalogue settings

Other catalogue settings are optional. Once you carried out the settings described on this page, your catalogue is automatically exported to Zalando. That means you can ignore the catalogue settings for Format settings, Export settings and Download settings.

The Format settings, Export settings, and Download settings allow you to create a file with the variation data contained in the catalogue. However, this file does not contain information about whether the data export to Zalando was successful.

Do not change the format in the catalogue’s Format settings. To ensure that the export to the sales channel works, all required settings are already configured when you create a catalogue. If you change the settings, errors might occur during the export.

4.2.1. Mapping data fields in the offer catalogue

After you have created a catalogue, map the market’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 Zalando.

  • 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

4.3.1. Activating the catalogue export

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

Activating the catalogue export to Zalando:

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

  2. Scroll to the Zalando catalogue.

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

5. Creating properties

Characteristics cannot be used for the catalogue export. Therefore, you must create properties for all characteristics that you use to describe your items in more detail on Zalando.
For further information, refer to the Properties and characteristics page.

Creating a 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.

5.1. Requirements for exporting properties to Zalando

In order for a property to be transferred to Zalando, it must be linked to the desired variation and assigned in the offer or product catalogue for Zalando.

Step 1: Linking a property with a variation

  1. Open the variation in the Item » Items » [Open variation] menu.

  2. Open the Properties tab in the navigation bar on the left-hand side.

  3. Click Add properties (add).
    → The window Add properties opens.
    Tip: Use the search to search for the property.

  4. Place a check mark next to the desired property.

  5. Click APPLY.

  6. Enter additional information depending on the property type. If the property is a selection property, for example, you must also select a suitable value from the drop-down list.

  7. Save () the settings.

Step 2: Mapping a property in a Zalando catalogue

  1. Go to Data » Catalogues.

  2. Open the Zalando catalogue for which the property is to be used.

  3. Assign the property to the desired Zalando data field.

  4. Save () the settings.

6. Managing listings

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

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

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

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

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

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

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

6.3. Creating listings

You create and manage offers on Zalando via listings. Carry out the following steps to create listings for Zalando.

At Zalando, an offer listing must always be created in addition to a product listing.
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.

6.3.1. Create offer listing

Note: For offers, select the template Offer data.

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 Zalando.
    → The Offer listings menu opens.

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

  4. Select the platform Zalando.

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

  6. Select the sales channel on which the listing should be offered.

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

  8. Optional: Activate Automatically activate listings after creation, if listing data should be automatically transferred to Zalando after the listing is created.

  9. 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 Zalando 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.

6.3.2. Activating offer listings

After you have created the offer listings, you have to activate the listings so that they can be transferred to Zalando.
To do so, activate the individual listings and the listing group. The listing can only be transferred to the sales channel if both the listing and the listing group are activated.

Note: You can also activate listings immediately after creation by activating the option Automatically activate listings after creation. If you activate the option to automatically activate listings after creation, you still have to activate the data exchange for the listing group.

Activating offer listings:

  1. Open the menu Sales Channels » Accounts » [Open Zalando account].
    → The tab Channel settings opens.

  2. Open the Offer listings tab.

  3. In the line of the offer listing you want to activate, click more_vert.

  4. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple offer listings at once, place a check mark next to the desired offer listings and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing is activated. The listing can only be transferred to the sales channel if the listing group is also activated.

Activating a listing group:

  1. Open the menu Sales Channels » Accounts » [Open Zalando account].
    → The tab Channel settings opens.

  2. Open the Offer listings tab.

  3. Open the listing group view (folder).

  4. In the line of the listing group you want to activate, click more_vert.

  5. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple listing groups at once, place a check mark next to the desired listing groups and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing group is activated.

6.3.3. Creating product listings

Note: For products, select the respective product category as template.

If you want to offer a new item on Zalando, you must always create an offer listing in addition to the product listing so that the item can be listed on Zalando.

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 Zalando.
    → 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 the platform Zalando.

  1. Select the template for the catalogue.
    Tip: Only templates that are available for the platform Zalando 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 Zalando 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 Zalando 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.

6.3.4. Activating product listings

After you have created the product listings, you have to activate the listings so that they can be transferred to Zalando.
To do so, activate the individual listings and the listing group. The listing can only be transferred to the sales channel if both the listing and the listing group are activated.

Note: You can also activate listings immediately after creation by activating the option Automatically activate listings after creation. If you activate the option to automatically activate listings after creation, you still have to activate the data exchange for the listing group.

Activating product listings:

  1. Open the menu Sales Channels » Accounts » [Open Zalando account].
    → The tab Channel settings opens.

  2. Open the Product listings tab.

  3. In the line of the product listing you want to activate, click more_vert.

  4. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple product listings at once, place a check mark next to the desired product listings and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing is activated. The listing can only be transferred to the sales channel if the listing group is also activated.

Activating a listing group:

  1. Open the menu Sales Channels » Accounts » [Open Zalando account].
    → The tab Channel settings opens.

  2. Open the Product listings tab.

  3. Open the listing group view (folder).

  4. In the line of the listing group you want to activate, click more_vert.

  5. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple listing groups at once, place a check mark next to the desired listing groups and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing group is activated.

6.4. Viewing listing errors

The Errors tab of the Sales Channels » Accounts » [Open account] » Offer listings / Product listings menu provides an overview of all errors that occurred in PlentyONE when exporting your product and offer listings.
Tip: The overview of listing errors is only displayed if at least one error has occurred when exporting the listings.

Here you can see:

  • the affected listings

  • error details

For each error, you can download a CSV file containing the affected listings by clicking the download button. You can correct the errors directly in the CSV file. You can then re-import the corrected CSV file.

Table 6 contains an overview of listing errors.

Table 6. Listing errors of offer listing and product listings
Column Explanation

keyboard_arrow_down [Information about the error]

Information about the error is provided here. It contains the affected field of the data record, a brief description of the error and the number of listings for which this error has occurred.
Example: "Field: gtin Error: Given data is not a string. (1)"
→ The error occurred in the gtin field of the data record.
→ The error occurred because no character string was entered as a value in the gtin field.
→ The error has occurred for one listing.

download Download data as CSV

The CSV file with the data records is downloaded.

Listing name

The name of the listing.

Parent SKU

The parent SKU of the main variation.

SKU

The SKU of the sub-variation.

Variation ID

The ID of the variation.

Channel

The sales channel to which the listing is exported.

Export activity

Shows whether the variation is being exported.

  • Active (circle) = The variation is exported with the listing.

  • Not active (circle) = The variation is not exported with the listing.

Status

The listing’s status on the sales channel.

Possible statuses 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

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.

7. Adding additional sales channels

If you already sell on Zalando and would now like to offer your items in another country, you have to carry out the following settings:

Note: Zalando must approve the additional sales channel before you can offer your items there.

  • Go through the assistant Account settings - Zalando again to carry out the settings for the new Zalando sales channel. This is done in the step Settings for the sales channel.

  • Activate the order referrer for the new sales channel in the Setup » Orders » Order referrer menu.

  • If necessary, create a sales price for the new sales channel in the Setup » Item » Sales prices menu or activate the referrer Zalando in an existing sales price.

  • In the offer catalogue for Zalando, map the data fields for prices for the new sales channel.

  • Make the offer listings that you want to offer on the new sales channel available for the sales channel. To do so, open the offer listing view in the Sales Channels » Accounts » [Open account] menu and activate the new sales channel in the column List on of an offer listing. To do this, activate the editing mode via the pencil icon (edit) and make sure to save the changes.

Zalando add sales channel en
Figure 1. Adding an additional sales channel to an offer listing

8. Automating order processing

The following event procedures are available for automating order processing:

  • Automatically send shipping confirmations (How?)

  • Automatically sending cancellations (How?)

  • Automatically sending returns (How?)

8.1. Automatically sending shipping confirmations

A shipping confirmation can only be sent if an order meets the following conditions:

  • A package number must be saved for the order.
    Note: Only one package number can be exported per order. If more than one package number is associated with an order, only the first package number is exported.

  • The tracking ID of the return label must be saved for the order.

Tip: How to save the tracking ID

You can save the tracking ID in several different ways:

Set up an event procedure to automatically send shipping confirmations to Zalando when the outgoing items are booked.

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

  5. Save () the settings.

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

  7. Select the setting Active ().

  8. Save () the settings.

Table 7. Event procedure for automatically sending shipping confirmations to Zalando
Setting Option Selection

Event

Order change: Outgoing items booked
Note: You can select a different event. However, ensure that the selected event is only triggered once the order contains all information necessary to send a shipping confirmation.

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

Zalando

Action

Plugins > Send shipping confirmation to Zalando

8.2. Automatically sending cancellations

Set up an event procedure to automatically inform Zalando of cancellations. Note that orders marked as shipped can no longer be cancelled.

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

  5. Save () the settings.

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

  7. Select the setting Active ().

  8. Save () the settings.

Table 8. Event procedure for automatically sending cancellations to Zalando
Setting Option Selection

Event

Order change: Status change
Note: You can select a different event. However, ensure that the selected event is not triggered for orders that are flagged as shipped or that are cancelled by customers.

Select a status, for example [8.0] Cancelled

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

Zalando

Action

Plugins > Send cancellation to Zalando

8.3. Automatically sending returns

Set up an event procedure to automatically inform Zalando about returns. Note that the order must be flagged as shipped.

Return reasons will only be transmitted if the event procedure is used in combination with a return order and if the return reasons were mapped in the assistant.
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 9.

  5. Save () the settings.

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

  7. Select the setting Active ().

  8. Save () the settings.

Table 9. Event procedure for automatically sending returns to Zalando
Setting Option Selection

Event

Order generation: New return
Note: You can select a different event. However, if you also want to communicate the return reason to Zalando, ensure that the return reasons are saved for the return.

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

Zalando

Action

Plugins > Send return to Zalando

9. Activating the account

After you have saved the settings for Zalando, activate your Zalando account in the assistant Account settings - Zalando. To open the assistant, go to Setup » Assistants » Omni-Channel.

Note: At present, the Zalando account cannot be activated via the account’s tile in the Sales Channels » Accounts menu. You can only activate the account in the assistant Account settings - Zalando.

Activating the account:

  1. Go to Setup » Assistants » Omni-Channel.

  2. Complete the assistant Account settings - Zalando.

  3. Open the desired configuration for Zalando.

  4. Open the step Account activation.

  5. Activate the toggle button Activate Zalando account.
    → The account is activated and data can be exchanged with Zalando.

10. No longer offering items on Zalando

If you no longer wish to offer a variation on Zalando, you can either remove the availability for the desired Zalando sales channel from the offer listing or you can deactivate the offer listing or the listing group.
Depending on whether you no longer want to offer the listing on Zalando at all or only want to remove it from a specific Zalando sales channel, you have to carry out different settings.

Note: Items cannot be deleted on Zalando. If you remove the availability for a sales channel, your variation will not be deleted on Zalando. It will only be displayed as not in stock.

10.1. Possibility 1: Stop offering a listing on a specific sales channel

If you no longer wish to offer the listing on a specific Zalando sales channel, then remove the availability for this sales channel from the offer listing.

Removing the availability for a sales channel:

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

  2. In the List on column, click on the pencil icon (edit).
    → The editing mode for this column is activated.

  3. In the row of the listing that you no longer wish to offer on the sales channel, expand the drop-down list in the List on column.

  4. Remove the check mark from the Zalando sales channel on which the listing should no longer be offered.

  5. Save () the settings.
    → The listing data will no longer be exported to this Zalando sales channel.

10.2. Possibility 2: No longer offer the listing on Zalando at all

If you no longer wish to offer the listing on Zalando, activate either the offer listing or the listing group.

  • Deactivating an offer listing

  • Deactivating a listing group

Deactivating a listing:

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

  2. For the listing that you no longer wish to offer on Zalando, click on more_vert and then on toggle_off Pause data sync.
    → The listing data will no longer be exported to Zalando.

Note: Note that all listings in the group will be deactivated if you deactivate the listing group.

Deactivating a listing group:

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

  2. Open the listing group view (folder).

  3. Click on more_vert in the respective listing group and then on toggle_off Pause data sync.
    → The listing data within this group will no longer be exported to Zalando.

11. Download reports

There are a number of reports available for Zalando. Go to the Setup » Markets » Zalando » Settings » Tab: processing reports menu to download the following reports:

Report Explanation

Reports

Product status reports

Zalando generates the product status reports are generated once daily during the night. These reports only contain information regarding variations that were successfully exported to Zalando.

ProductErrorReport.csv

Contains variations that cannot be sold on Zalando since the last export. The report is generated once every night.

ProductLiveReport.csv

Contains variations that can be sold on Zalando since the last export as well as stock and price of each variation on the different Zalando channels (DE, FR, etc.) at the time that the file was generated. The report is generated once every night.

How to download product status reports

Price reports

Zalando generates a price report for each active channel once daily during the night. These reports contain information on the processing status of all price updates that Zalando received in the last seven days.

How to download price reports

11.1. Downloading product status reports

Product status reports contain information regarding the items that were exported to Zalando. These reports are generated by Zalando. As such, these reports only contain information regarding variations that were successfully exported to Zalando. The following reports are available:

  • ProductErrorReport.csv: Contains variations that cannot be sold on Zalando since the last export. The report also contains the first five error codes and an error description. The report is generated once every night. Click on Update file () before downloading the file to get current data from Zalando.

  • ProductLiveReport.csv: Contains variations that can be sold on Zalando since the last export. The report also contains information on the stock and price of the variations on the different Zalando channels (DE, FR, etc.) at the time the file was generated. The report is generated once every night. Click on Update file () before downloading the file to get current data from Zalando.

Downloading a product status report:

  1. Go to Setup » Markets » Zalando » Settings.

  2. Click on the Processing reports tab.
    → The following files can be downloaded in the Product status reports - Account ID area:

    • ProductErrorReport.csv contains the variations that cannot be sold on Zalando since the last export.

    • ProductLiveReport.csv contains the variations that can be sold on Zalando since the last export.

  3. Optional: By default, the file is updated once every night. To get current data from Zalando before downloading the file, go to the Product status-reports - Account ID area and click on Update file ().

  4. Go to the Product status reports - Account ID area. In the row of a processing report click on Download file ().
    → The CSV file is generated.

  5. Save the CSV file on your computer.

11.2. Downloading price reports

Zalando generates a price report for each active channel once daily during the night. These reports contain information on the processing status of all price updates that Zalando received in the last seven days. As such, the reports may contain several entries for the same EAN.

Downloading price reports:

  1. Go to Setup » Markets » Zalando » Settings.

  2. Click on the Processing reports tab.
    → In the area Price reports, files are available for all active channels.

  3. Optional: By default, the file is updated once every night. In the column Actions, click on Update file () to get current data from Zalando before downloading the file.

  4. Go to the Price reports area. In the row of a processing report, click on Download file ().
    → The CSV file is generated.

  5. Save the CSV file on your computer.

What information do the price reports contain?

Timestamp

Corresponds to the latest timestamp from the columns Status History and Scheduled Price (1-3) - Status History.

EAN

The EAN of the variation whose price has been updated.

Ignore Warnings?

Corresponds to the setting Ignore Warnings in the Setup » Assistants » Omni-Channel » Zalando account settings » [Open account] » Step: Prices for [target country] menu at the time the update was transferred.

Regular Price

Transferred value of the regular price.

Regular Price Currency

Transferred currency of the regular price.

Promotional Price

Transferred value of the reduced price.

Promotional Price Currency

Transferred currency of the reduced price.

Status

Status of the processing. Possible statuses:

RECEIVED

The price has been received.

ACCEPTED

The price has been accepted and forwarded for further validation.

REJECTED

The price has not passed validation. See the status messages in Status History for more information.

FAILED

An unexpected error occurred during the price update. See the status messages in Status History for more information.

SCHEDULED

The price has been successfully validated and is awaiting submission.

SUBMITTED

The price has been submitted and will be shown in the shop shortly.

AWAITING_ONBOARDING

The price has been accepted but the item has not yet been activated. The price will be applied once onboarding is complete.

Status History

Status change history. For each change, the cell contains a paragraph with the following pattern (placeholders in square brackets):

  • [timestamp]: FROM [original status] TO [new status] - code: [code] [severity] [message]

Scheduled Price (1-3) - Start

Start date of the scheduled price.

Scheduled Price (1-3) - End

End date of the scheduled price.

Scheduled Price (1-3) - Regular Price

Transferred value of the regular price for the scheduled price.

Scheduled Price (1-3) - Regular Price Currency

Transferred currency of the regular price.

Scheduled Price (1-3) - Promotional Price

Transferred value of the reduced price.

Scheduled Price (1-3) - Promotional Price Currency

Transferred currency of the reduced price.

Scheduled Price (1-3) - Status

Status of the processing of the scheduled price. Possible statuses:

RECEIVED

The price has been received.

ACCEPTED

The price has been accepted and forwarded for further validation.

REJECTED

The price has not passed validation. See the status messages in Scheduled Price (1-3) - Status History for more information.

FAILED

An unexpected error occurred during the price update. See the status messages in Scheduled Price (1-3) - Status History for more information.

SCHEDULED

The price has been successfully validated and is awaiting submission.

OVERRIDDEN

The price was scheduled but overwritten by a new price update before it could be submitted.

SUBMITTED

The price has been submitted and will be shown in the shop shortly.

AWAITING_ONBOARDING

The price has been accepted but the item has not yet been activated. The price will be applied once onboarding is complete.

Scheduled Price (1-3) - Status History

History of the status change of the scheduled price. For each change, the cell contains a paragraph with the following pattern (placeholders in square brackets):

  • [Timestamp] from [Original Status] to [New Status] - Code [code] Severity [severity] Message [message]

12. Viewing the data log

The Data » Log menu contains a history of processes that run via the Zalando interface. Note that integrations and identifiers are only shown in the drop-down lists as filters after the process has run at least once.

For Zalando, the following filters are recommended:

  • Identifier » Zalando

Filtering and checking log entries

  1. Go to Data » Log.

  2. In the toolbar, click on tune.

  3. Select appropriate filters from the drop-down lists.

  4. Optional: Select filters for dates and/or times to only show entries from a specific period.
    Tip: For information about the filters, refer to the Data log page of the manual.

  5. Click on Search ().
    → The results are shown.

  6. Check all entries for the levels warning and error.
    Tip: Click on the entry to see details.

Use any filters listed in Table 10 to limit the search results.

Table 10. Filters
Log entries Recommended filters Explanation

Price updates

  • Identifier » Zalando

  • Level: Error

  • References:

    • Reference type » action
      Reference value » PriceUpdate

    • Reference type » ean
      Reference value » EAN of variation

While the price reports are generated, an error log is also written for all entries that have been in the REJECTED, FAILED or OVERRIDDEN status since the file was last generated (minus one hour as a buffer).

Price reports

  • Identifier » Zalando

  • References:

    • Reference type » action
      Reference value » PriceReporting

Log entries for errors during generation of price reports

Stock synchronisation

  • Identifier » Zalando

  • References:

    • Reference type » action
      Reference value » StockUpdate

    • Reference type » variationId

    • Reference type » ean

    • Reference type » accountId

    • Reference type » salesChannel

    • Reference type » jobUniqueId

Log entries for errors during stock updates