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:

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

  • Bulgaria

  • Croatia

  • Czech Republic

  • Denmark

  • Estonia

  • Finland

  • France

  • Germany

  • Greece

  • Hungary

  • Ireland

  • Italy

  • Latvia

  • Lithuania

  • Luxembourg

  • Netherlands

  • Norway

  • Poland

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

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:

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 to use Zalando Fulfillment Solutions (ZFS).
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.

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

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 & Plugins » Heading: Documents » 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 General 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 General settings tab, you can edit the account name and enable or disable data exchange with the relevant sales channel. In the following chapters, these functions will be further explained.

3.6.1. Renaming the sales channel

You can rename the sales channel anytime. To do so, proceed as follows.

Renaming the sales channel:

  1. Open the Sales channels » Accounts menu.

  2. Open the account for Zalando.
    → The menu Channel settings opens.

  3. Open the menu General settings.

  4. Enter a name for the sales channel.

  5. Save () the settings.

3.6.2. (De)Activating the data exchange

You can fully activate or deactivate data exchange between a sales channel and its corresponding online marketplace at any time using a button in the general settings. To delete multiple mappings, proceed as follows:

(De)activating the data exchange:

  1. Go to Sales channels » Accounts.

  2. Open the account for Zalando.
    → The menu Channel settings opens.

  3. Open the menu General settings.

  4. Activate the toggle Data sync enabled to activate the data exchange with the respective market.
    OR: Deactivate the toggle Data sync enabled to deactivate the data exchange with the respective market.

  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 Edit (edit).
    → The window Edit referrer opens.

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

  6. Click 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 you want to sell on Zalando and enable them for the relevant sales channel. This is done in the Items & Stock » All items » [Open variation] menu.

  • For one variation

  • Using variation group function

  • Using batch processing

Making a variation available for Zalando:

  1. Go to Items & Stock » All items » [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, enable the option Active (toggle_on).

  3. Click the Sales channels tab.

  4. In the Sales channels section, activate the sales channel Zalando in the Status column (toggle_on).
    Tip: You can activate multiple sales channels at once. To do so, activate the checkboxes to the left of the desired sales channels. Then activate the toggle above the checkbox column (toggle_on). Click ACTIVATE to confirm the activation.
    Important: Activate the sales channel Zalando. The other sales channels (Zalando DE, Zalando NL etc.) will be ignored.

  5. Save (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 Items & Stock » All 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. Select (check_box) the option Zalando from the drop-down list Sales channels.
    → The sales channel is added below the drop-down list Sales channels.
    Important: Select the sales channel Zalando. The other sales channels (Zalando DE, Zalando NL etc.) will be ignored.

  7. Activate (toggle_on) the toggles to the left of the sales channels.

  8. Click EXECUTE & CLOSE 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. Navigate to the area Market availability.

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

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

  4. Navigate to the area Availability.

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

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

  7. 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 & Plugins » 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 & Plugins » 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.

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 & Plugins » 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 Listing.