Zalando

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.

You can use the following fulfilment types with PlentyONE:

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

  • Germany

  • Belgium

  • Estonia

  • Finland

  • France

  • Ireland

  • Latvia

  • Lithuania

  • Netherlands

  • Austria

  • Portugal

  • Slovakia

  • Slovenia

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
PlentyONE generates an XML file with the item data once daily during the night. This file is called artikel.xml. Zalando usually retrieves this XML once per day.

Stock synchronisation

Every 15 minutes, asynchronous
Stock for 1,000 variations is 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. Overview of the necessary steps

There are two ways to proceed. This depends on if you set up Zalando for the first time or already sell on Zalando and want to sell on another Zalando platform.

  • Steps after registration

  • Steps for adding more sales channels

You have signed a contract with Zalando. Great. What happens now?

This is a list of the steps you are going to take.

Step 1

Step 2

Step 3

  • Enter your user credentials in the CSV file.

  • Send this form to your Zalando contact person.

Step 4

Complete the assistant Account settings - Zalando for the first time.
Important: When you complete the assistant for the first time, you cannot carry out all the settings of the assistant.

Step 5

Ask our supporters to link your account with your zDirect account.
Important: This is only possible after you have completed the assistant for the first time.

Step 6

Step 7

Step 8

Step 9

Step 10

Step 11

You already sell on Zalando and now want to offer your products on another country platform? No problem.

As soon as you signed a contract with Zalando for the additional sales channels, the process continues with the following steps:

Step 1

In the PlentyONE forum, request the API route for the new sales channel.
Important: User and password are the same for all Zalando sales channels. As such, Zalando only needs the API route.

Step 2

Send the new API route to your Zalando contact with the additional information that all other data is to be sourced from the first sales channel.
→ Zalando activates the new sales channel.

Step 3

Go to Setup » Orders » Order referrer and activate the order referrer for the new country.

Step 4

Create a new sales price. Remember to correctly save the currency and the country.
Or: Activate the referrer Zalando in an existing sales price for the country.
Important: Activate the referrer Zalando. The sub-referrers for each Zalando platform (Zalando DE, Zalando NL etc.) will be ignored.

Step 5

Prepare the order documents for the country.

Step 6

Activate the sales price for the variations.
Important: In the variation settings, the sub-referrers for each Zalando platform (Zalando DE, Zalando NL etc.) will be ignored. That is why you do not change the availability settings.

Step 7

3. Account settings

As soon as Zalando has accepted you into their partner programme, you will receive a user guide from Zalando which helps you setting up the interface. In PlentyONE, carry out the basic settings described here.

3.1. Creating a user account

Create a user account.

Creating a user account:

  1. Open the menu Setup » Account management » Accounts.

  2. Click on New account (add).

  3. Enter the Username.

  4. Enter the real name under Name.

  5. Enter a Password.

  6. Repeat the password.

  7. Save (save) the settings.
    → The account is created.
    Note: he user name must not contain any spaces and must have at least 5 characters.
    Tip: You do not need to grant any rights for this account. It is enough that the account exists in the system.

3.2. Carrying out the basic settings

Carrying out the basic settings:

  1. Go to Setup » Markets » Zalando » Settings.
    → The Settings tab opens.

  2. Carry out the settings as described in Table 1.

  3. Save () the settings.

Table 1. Basic settings for the market Zalando
Setting Explanation

Basic configuration

User

Select the API account that you created for Zalando.

Item name

Select Name 1, Name 2, or Name 3. The name you select will be exported to Zalando.

Advanced options

Standard tax rate

Select 19% or 7%.

Reduced tax rate

Select 19% or 7%.

3.3. Request the CSV form for matching items/silhouettes

Now, request the FTP credentials and API data in the PlentyONE forum. Zalando needs this data to set up a sales channel for you.

  1. Contact our support team in the forum thread Request CSV form for matching items and silhouettes.
    → Our support team will provide you with a CSV file that contains a form. This file contains the following information:

    • Routes for items

    • Login details for the PlentyONE FTP server for silhouettes
      Tip: Zalando sends your silhouettes to this FTP server for import into your system. PlentyONE imports these silhouettes every Wednesday.

  2. In row 5 of the file, enter the user name that you selected in the menu Setup » Markets » Zalando » Settings.

  3. In row 6 of the file, enter the password that you set in the menu Setup » Markets » Zalando » Settings.

  4. Forward the completed form to your Zalando contact.
    → Zalando activates the sales channel for you.

3.4. Assistant part 1: account settings

Now, open the assistant Account settings - Zalando to continue setting up your account.

Important: You need to complete the assistant three times in total. This describes part 1.

Carrying out settings in the assistant:

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

  2. Click on the assistant Account settings - Zalando.
    → The step Account activation is shown.
    Important: You will see This account cannot be activated. That’s normal and as it should be.

  3. Click on Next.
    → The step Summary is shown.

  4. Click on Complete.
    → The assistant is completed.
    → The account is added to the menu Setup » Assistants » Omni-Channel » Assistant: Account settings - Zalando. The accountID that you need in the next step is also shown in this menu.
    Tip: You can run through the assistant again at any time to create additional accounts.

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

In the forum post, provide the following information:

  • 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.6. Assistant part 2: Account and channel settings

The PlentyONE support linked your account to your zDirect account? Great. Then you are ready for the next step: You run through the assistant Account settings - Zalando for the second time.

Carrying out settings in the assistant:

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

  2. Click on the assistant Account settings - Zalando.

  3. Follow the instructions on the screen. If you need additional information about one of the options, expand the info boxes below this description ().

  4. In the Summary step, check your settings to make sure they are correct.
    Tip: In the Summary step, click on the arrow () to show the settings.
    Important: You have not completed the setup. Therefore, in the step Account activation, do not activate the Zalando account yet.

  5. If everything is as it should be, click on Finalise.
    → The settings are saved.
    Tip: You can run through the assistant again at any time to update settings. Tip: You can run through the assistant again at any time to update settings.

Step General settings
Setting Explanation

Client

Select a client (store). Zalando orders will be assigned to this client.

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: Name of the return reason as it is saved 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 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 show 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 channel.

Possibility 1: Only specify a default warehouse

  1. For the setting Default warehouse for Zalando ZFS, select a PlentyONE repair warehouse form the drop-down list.
    → Stock data for all Zalando ZFS warehouses are 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 warehouse.

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

  1. For the setting Default warehouse for Zalando ZFS, select a PlentyONE repair warehouse.

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

Steps Channel settings

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

Don’t see any steps for the 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

Activate self-fulfilled order import

Activate to automatically import 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.

Activate ZFS order import

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?

Imported 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?

Activate stock export

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

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 Tab: Settings, Setting: 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 Tab: Settings, Dropdown list: Limitation, Option: Do not administer stock for this variation. The entered value is exported for these variations.

Activate price update

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

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

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?

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

4. Continuing the setup

4.1. Linking categories

Link your PlentyONE categories to the Zalando categories in order to display your variations in these categories.

Linking categories:

  1. Go to Setup » Markets » Zalando » Category link.
    → A list of your categories is shown in the column Category.
    → In the column Zalando category, you can link a Zalando category to each of your PlentyONE categories.

  2. In the column Zalando category, select a Zalando category from the drop-down list for all categories that you need.

  3. Save () the settings.
    → The categories are linked to the selected Zalando categories.
    → New variations that you create for the PlentyONE category are also assigned to the linked Zalando category.

4.2. 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 platforms, 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

4.3. Defining a sales price

To sell variations on Zalando, you need a sales price in which the order referrer Zalando is activated. The price that you save for this sales price is the price that will be shown on Zalando.

What is a sales price?

Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel. For example, you can sell your items at a lower price in your webshop than on Amazon. Or you can sell products cheaper to B2B customers than to B2C customers.

Two default sales prices are already configured in your PlentyONE system. However, you can also create new sales prices and edit them individually. In addition to default sales prices, you can also create RRPs, special offers, and set prices.

Defining a sales price for Zalando:

  1. Go to Setup » Item » Sales prices » [Open sales price].
    Tip: No sales prices? Then create a sales price first.

  2. Open the Settings tab.

  3. Activate the referrer Zalando.
    Important: Activate the referrer Zalando. The sub-referrers for each Zalando platform (Zalando DE, Zalando NL etc.) will be ignored.

  4. Save () the settings.

4.4. Linking attributes to Zalando

If you have created attributes in your PlentyONE system, you need to link these attributes with Zalando. The following example describes how you can link the attribute “colour” with Zalando. Link further attributes in the same way.

Link at least the following attributes to export your variations to Zalando:

  • Größe (size register)

and/or

  • A colour for the 1st Farbcode (colour code)/Herstellerfarbe (manufacturer colour)

and/or

  • Länge (length register) for length information (e.g. skirt length)

You can only link one size register or one length register to each attribute.

Linking attribute "Colour":

  1. Go to Setup » Item » Attributes.
    → An overview of all existing attributes opens.

  2. Open the attribute Colour.

  3. Click on the Attribute link tab.

  4. From the list of markets, select the option Zalando.
    → The area for linking attributes is shown.

  5. From the drop-down list Categories, select the attribute Colour.

  6. From the drop-down list Market attributes, select a market value for each attribute value.
    Example: For the colour Purple, from the first drop-down list select the option dark purple and from the second drop-down list select the option Purple.

  7. Save () the settings.

  8. Repeat this process for the remaining attributes.

4.5. Converting silhouettes to characteristics

Zalando groups products into "silhouettes". Zalando also calls these silhouettes "article types". For example, "skirts", "dresses", and "trousers" are all silhouettes. In the Setup » Markets » Zalando » Settings » Tab: Silhouettes menu, you convert Zalando silhouettes to item characteristics. Silhouettes are imported into PlentyONE when Zalando is first set up. When Zalando publishes new silhouettes, PlentyONE updates these silhouettes on the following Wednesday. After that, you can convert new silhouettes into characteristics if necessary.

Converting silhouettes to characteristics:

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

  2. Click on the Silhouettes tab.

  3. Select the Groups for the characteristics that you want to convert.
    Note: No groups? Either Zalando has not provided the silhouettes or you have not sent the FTP credentials to Zalando (see Requesting the CSV form for matching items/silhouettes).

  4. Save () the settings.
    → Characteristics are created in your PlentyONE system based on the silhouettes.

5. Preparing variations

Continue with preparing your variations.

5.1. 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. Select WEB API.

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

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

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

  9. Activate the option Active.

  10. Navigate to the area Availability.

  11. 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. Activate the checkbox to the left of the option Web API.

  8. Activate the checkbox to the right of the option Web API.

  9. Navigate to the area Availability.

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

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

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

5.2. Optional: Saving SKU

SKU are generated automatically when your variations are exported. However, you can also save market specific SKU for variations that you want to sell on this market instead.

  • Manually adding an SKU

  • Importing SKU

  1. Go to Item » Items » [Open item] » [Open variation].

  2. Expand the SKU section (keyboard_arrow_down).

  3. Click Add SKU (add).
    → The Add SKU window opens.

  4. Select the referrer Zalando from the drop-down list.

  5. Click Apply.

  6. Enter the SKU.

  7. Enter the Parent SKU, if necessary.

  8. Save () the settings.

Only the most important settings for the import are described here. Is this your first time working with the import tool? Then get familiar with how data imports work in PlentyONE first.
  • Create a CSV file with at least the columns described in Table 2.

  • Create an import with the following settings:

    • Select the type Item.

    • Select the matching field Variation ID.

    • Map the PlentyONE data fields as described in Table 2.

Table 2. Recommended columns of the import file
Column in CSV file Explanation PlentyONE data field for mapping

Variation ID

Enter the variation ID in this column.

Variation ID

Marketplace ID

Enter the referrer ID 118 in this column.

SKU > Marketplace ID

Account ID

This market does not require a marketplace account. As such, enter the number 0 in this column.

SKU > Account ID

SKU

Enter the SKU that you want to save for the variation for this market in this column.

SKU > SKU

5.3. Linking characteristics to items

Link the Zalando characteristics with the items that you want to sell on Zalando.

Link at least the following mandatory characteristics to export your variations to Zalando:

  • 1. Farbcode (colour code)

  • Altersgruppe(n) (age group(s))

  • Form of address (Geschlecht)

  • Größenregister (size list)

  • Hersteller-Code (manufacturer code)

  • Manufacturer colour

  • Jahreszeiten-Code (Seasonal code)

  • Silhouetten-Typ (silhouette type)

Tip: Exporting a file with Zalando item characteristics

Several hundred characteristics are created in PlentyONE when you convert the Zalando silhouettes to characteristics. To make it easier to work with these characteristics, you can export the characteristics to a file. This gives you quick access to the IDs of your Zalando characteristics. This gives you easy access to the IDs of the Zalando characteristics. For example, this will help you to link the characteristics to your items using the import tool.

Exporting Zalando item characteristics:

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

  2. Click on the Silhouettes tab.

  3. Click on Export Zalando item characteristics.
    → A file that contains the Zalando characteristics is exported.

  4. Save the file on your computer. Tip: Table 3 explains the file’s columns. For more information about characteristics, refer to the Characteristics and properties page of the manual.

Table 3. Zalando characteristics
Column Explanation

Group name

Names of the characteristic groups

Silhouette

Values of all silhouettes

Characteristic ID

IDs of the characteristics, see also Setup » Items » Characteristics

Characteristics type

Characteristic type

  • empty = No type

  • text = Text

  • int = Whole number

  • selection = Selection ID

Mandatory entry

0 = The characteristic is optional.
1 = The characteristic must be exported. Items that are not linked to this characteristic cannot be exported to Zalando.
Note: Characteristics may also contain the value 1 because links to other selected characteristics exist. Observe the documentation provided by Zalando.

Language

The language of the characteristic. Currently, only German is available.

Linking a characteristic to an item:

  1. Go to Item » Edit item.

  2. Open the item.

  3. Click on the Characteristics tab.

  4. Activate the characteristic in the Activate further characteristics area.

  5. Save () the settings.
    → The characteristics are displayed in the Characteristics area.

  6. Optional: Carry out additional settings. Pay attention to the explanations regarding characteristics.

  7. Save () the settings.

5.4. Check list for exporting variations

Zalando expects some mandatory product information. As a result, variations can only be exported to the market if this mandatory information is saved for the variation. The information listed in Table 4 must be saved for all variations that you want to export to Zalando.

Table 4. Mandatory fields for the variation
Mandatory data Explanation

EAN

An EAN must be saved for the variation.

  • In the Setup » Item » Barcode menu, an EAN must be created and linked to the referrer Zalando.

  • The EAN must be added to the Settings tab of the variation in the Barcode area and a barcode code must be entered.

Technical data

Technical data must be saved for the item.

  • In the Texts tab of the item, text must be saved in the Technical data field.

Images

An image must be saved for the variation.

  • in the Images tab of the item, the option Zalando must be selected from the drop-down list Availability.

Price

A price must be saved for the variation.

  • The sales price must be activated for the referrer Zalando in the Setup » Item » Sales prices.

  • The sales price must be added in the Settings tab in the Sales price area of the variation.

  • A price must be saved for the sales price.

Supplier SKU

An supplier SKU must be saved for each variation. Save this supplier SKU in the Model field of your variations.

Properties

As a minimum, the following mandatory characteristics need to be linked to an item:

  • 1. Farbcode (colour code)

  • Altersgruppe(n) (age group(s))

  • Form of address (Geschlecht)

  • Größenregister (size list)

  • Hersteller-Code (manufacturer code)

  • Manufacturer colour

  • Jahreszeiten-Code (Seasonal code)

  • Silhouetten-Typ (silhouette type)

Attributes

As a minimum, the following attributes must be linked to the variation:

  • Größe (size register)

and/or

  • A colour for the 1st Farbcode (colour code)/Herstellerfarbe (manufacturer colour)

and/or

  • Länge (length register) for length information (e.g. skirt length)

You can only link one size register or one length register to each attribute.

6. Providing information on product safety, manufacturer and EU-responsible person (GPSR)

The General Product Safety Regulation of the EU (GPSR) requires manufacturers and sellers to ensure the product safety of certain goods and to provide certain information for this purpose. This includes details about the manufacturer and the responsible person in the EU, product warnings and hazardous materials information. The GPSR regulation ensures that products are safe and comply with consumer protection requirements before being placed on the market.

In this chapter, you will learn how to set product safety information, hazardous material details, and manufacturer data in PlentyONE to comply with GPSR regulations.

6.1. Providing information on manufacturer and EU-responsible person

On Zalando, you submit the information on manufacturer and EU-responsible person at partner/brand level.

To submit this information, add the required contact details for each brand directly in your Zalando zDirect account. Zalando provides a step-by-step guide on how to do this:

6.2. Providing information on product safety

On Zalando, you submit information and documents on product safety as attributes at article level.

You have two options to submit attributes at article level:

Information and documents on product safety vary depending on the product category and include the following at Zalando:

Information Required format

Warnings and safety information

Text

Instructions for use

PDF
Note: Instructions for use must be provided in all available languages.

Energy efficiency label

PDF

Energy efficiency class

Selection
Allowed values: None, A, B, C, D, E, F, G

Product/item information sheet

PDF

UPF (Ultraviolet Protection Filter) rating

Selection
Allowed values: Not Applicable, 15, 20, 25, 30, 35, 40, 45, 50, 50+

Filter type, lens type

Text
Note: The text must be provided in English.

Filter/tint category

Text

Product description

JPG, PNG or PDF

Product and packaging artwork

JPG, PNG or PDF

Risk assessment

PDF

Bill of material/parts list

PDF

Test reports

PDF

EU Declaration of Conformity

PDF

Zalando provides a complete overview of the required information and documents, the allowed formats and a list of the relevant product categories in this spreadsheet.

6.2.1. Option 1: Direct upload via your Zalando zDirect account

If you create your items manually at Zalando, you can upload product safety information and documents directly via your Zalando zDirect account. Zalando provides a step-by-step guide on how to do this:

6.2.2. Option 2: Upload via characteristics in PlentyONE

In PlentyONE, you can upload product safety information and documents to Zalando via characteristics.

This option only works for new items

Only apply the following steps to items that have not yet been uploaded to Zalando. Updating characteristics on items that are already listed on Zalando will not affect them. For existing items, Zalando will disregard any updates to item data when it’s resubmitted.

Uploading product safety information and documents to Zalando via characteristics:

  1. Convert the silhouettes for which you want to upload product safety information and documents to characteristics.

  2. Link the new characteristics to your items.

  3. Enter the data for the new characteristics at item level.
    → Pay attention to the required formats for the characteristics.

7. No longer offering items on Zalando

Variations cannot be sold on Zalando if they do not have stock in PlentyONE. As stock data is transferred to Zalando every 15 minutes, variations without stock are deleted automatically. If a variation has stock again in PlentyONE, it is offered again on Zalando with the next stock export.

If you do not want to sell a variation which is in stock in PlentyONE on Zalando, then you have to delete the availability for the market and update the timestamp for market exports.

Note: Items cannot be deleted on Zalando. Thus, if you remove the availability and update the timestamp for market exports, your variation will not be deleted on Zalando. It will only be displayed as not in stock.

Deleting the availability:

  1. Go to Item » Edit item » [Open item] » [Open variation] » Variation tab: Availability.

  2. Delete () the availability Zalando.

  3. Save () the settings.

After you removed the availability, you have to Update the timestamp for market exports using the Item group function. This ensures that a stock of 0 is transferred to Zalando.

Updating the timestamp for market exports:

  1. Go to Item » Edit item » Tab: Item group function.

  2. Place a check mark next to Update timestamp for market exports.

  3. Click on Execute.
    → A stock of 0 is transferred to Zalando.
    → The variation is displayed as not in stock on Zalando and cannot be bought any longer.

8. Preparing order documents

For each country, you need the following order documents for Zalando orders:

  • Delivery notes

  • Invoices

  • Return slips

  • Return flyer

If you did not create separate order documents for a country, then the order documents are created using the template for the payment method Zalando DE.

The payment method you select in the template settings determines the country the template is used for. Here, we show you how to prepare documents for the sales channel Zalando DE. This information is structured like this:

This information is accurate as of 1st of March 2022. Consult the documentation for Zalando Partners to find out if the requirements have changed. Current templates for order documents for all Zalando platforms are available on Zalando’s Google Drive.

You can use a separate PDF template for each payment method and order document. However, for each client and document type, the settings for the document templates need to be configured globally. As such, all delivery notes for one client have the same layout. If you sell on different markets with strict requirements, you might want to consider creating a separate client for Zalando.

8.1. Preparing delivery notes for Zalando DE

Delivery notes for Zalando orders must contain the following information:

  • Zalando Partner logo

  • External order number

  • External customer number

  • Payment note required by Zalando

  • Footer with company details, payment information and external order number

Layout: This is what a delivery note for Zalando DE should look like (as of 01/03/2022)
zalando DE delivery note

Consult the documentation for Zalando Partners to find out more about the requirements for order documents.

Creating layout templates for order documents in PlentyONE is described in the Orders area of the manual. On this page, we only describe how to upload the PDF template and set up the delivery note document for the specific requirements of the market:

8.1.1. Personalising the PDF template for Zalando DE delivery notes

Zalando delivery notes need to show the Zalando Partner logo. Zalando provides a DOCX template for delivery notes. On this DOCX template, you need to add your company data to the footer before you upload it to PlentyONE as a PDF.

Personalising the DOCX template for delivery notes:

  1. Save the DOCX template for delivery notes to your computer:

  2. Open the template in an editor.

  3. Insert your logo into the file.

  4. At the bottom left of the footer, insert the following company data:
    [Partner name]
    [Shop name on Zalando]
    Geschäftsführer, Vertreter: [specify persons responsible]
    Amtsgericht [your court of first instance], Str.-Nr. [your VAT number]

  5. At the bottom right, change the text Verwendungszweck: Bestellnummer to Verwendungszweck:. In other words, delete the word "Bestellnummer".
    Tip: In PlentyONE. the external order number is then inserted using the option Customer reference. Find out how in the description below.

  6. Save the template as a PDF file.

zalando DE delivery note footer

8.1.2. Uploading personalised PDF template for Zalando DE delivery notes

Proceed as described below to upload the personalised PDF template for delivery notes to PlentyONE. The PDF file can be up to 150 kB.

Uploading personalised PDF template for delivery notes:

  1. Go to Setup » Client » Select client » Locations » Location: Germany » Documents » Delivery note.

  2. Click on the tab PDF template.

  3. Click on Add template.
    → The editing window Upload new PDF template opens.

  4. From the drop-down list Payment method, select the option Zalando DE.

  5. In the drop-down list Language, select the option de.

  6. In the line Template, click on Choose template file.

  7. Select the PDF template for Zalando DE delivery notes.

  8. Click on Upload template ().
    → The template is uploaded.

8.1.3. Showing external customer number and order number on Zalando DE delivery notes

The Zalando customer number and the Zalando order number must be shown on all Zalando delivery notes. Also, the footer of the document must contain the external order number as the reason for payment. To achieve this, adjust the template settings for delivery notes.

Showing customer number and order number on delivery notes:

  1. Go to Setup » Client » Standard » Locations » Germany » Documents » Invoice » Tab: Template.

  2. Scroll down to the area Optional elements below stock unit table.

  3. For the setting External customer number, select the option Yes from the drop-down list.

  4. For the setting External customer number, select the option Yes from the drop-down list.

  5. Scroll to the option Customer reference. This option allows you to insert the external order number into the footer. Customers must specify this external order number as the designated use when making their payment.

  6. Select the coordinates for the option Customer reference so that the number is positioned after the text Verwendungszweck:.

  7. Save () the settings.
    Tip: Also add the payment note in this menu now.

8.1.4. Entering payment instructions for Zalando DE delivery notes

Zalando specifies a text containing return instructions that needs to be shown on all Zalando delivery notes. Proceed as described below to enter these payment instructions for Zalando delivery notes.

Entering payment instructions for delivery notes:

  1. Expand the info box "Text: Payment instructions for Zalando DE delivery notes" below this description.

  2. Copy the text to the clipboard.

  3. Go to Setup » Client » Standard » Locations » Germany » Documents » Invoice » Tab: Template.

  4. Navigate to the area Optional elements below stock unit table, to the setting Payment instruction.

  5. Find a field that does not contain any payment instructions.

  6. From the drop-down list Payment method of this field, select the option Zalando DE.

  7. Paste the Zalando payment instructions into the input field.

  8. Save () the settings.

Text: Payment instructions for Zalando DE delivery notes

Note: Solltest du die Zahlart Rechnung gewählt haben, ist dir von Zalando bereits die Bestellbestätigung mit dem Verweis auf den zu zahlenden Gesamtbetrag per E-Mail zugestellt worden.

Hast du noch Fragen zu deiner Bestellung? Besuche unsere Hilfeseiten unter www.zalando.de/faq - darüber kannst du uns auch kontaktieren.

Bitte behandle die Ware sorgsam, da diese bei Nichtgefallen nur ungetragen und unbeschädigt retourniert werden kann.

8.2. Preparing invoices for Zalando DE

Invoices for Zalando orders must contain the following information:

  • Your logo

  • Zalando Partner logo

  • External order number

  • Payment note required by Zalando

  • Footer with company details, payment information and external order number

Layout: This is what an invoice for Zalando DE should look like (as of 01/03/2022)
zalando DE invoice

Consult the documentation for Zalando Partners to find out more about the requirements for order documents.

Creating layout templates for order documents in PlentyONE is described in the Orders area of the manual. On this page, we only describe how to upload the PDF template and set up the delivery note document for the specific requirements of the market:

8.2.1. Personalising the PDF template for Zalando DE invoices

Zalando invoices must conform to the requirements set by Zalando. Zalando provides a DOCX template for invoices. Personalise this template before you upload this file in PlentyONE as a PDF.

Personalising DOCX template for invoices:

  1. Save the DOCX template for invoices to your computer:

  2. Open the template in an editor.

  3. Insert your logo into the file.

  4. At the bottom left of the footer, insert the following company data:
    [Partner name]
    [Shop name on Zalando]
    [Managing director, registration court, registration number, VAT ID number]

  5. At the bottom right, change the text Verwendungszweck: Bestellnummer to Verwendungszweck:. In other words, delete the word “Bestellnummer”.
    Tip: In PlentyONE. the external order number is then inserted using the option Customer reference. Find out how in the description below.

  6. Save the template as a PDF file.

zalando DE invoice footer

8.2.2. Uploading personalised PDF template for Zalando DE invoices

Proceed as described below to upload the personalised PDF template for invoices to PlentyONE. The PDF file can be up to 150 kB.

Uploading personalised PDF template for invoices:

  1. Go to Setup » Client » Select client » Locations » Location: Germany » Documents » Invoice.

  2. Click on the tab PDF template.

  3. Click on Add template.
    → The editing window Upload new PDF template opens.

  4. From the drop-down list Payment method, select the option Zalando DE.

  5. In the drop-down list Language, select the option de.

  6. In the line Template, click on Choose template file.

  7. Select the PDF template for Zalando DE invoices.

  8. Click on Upload template ().
    → The template is uploaded.

8.2.3. Showing external customer number and order number on Zalando DE invoices

The Zalando customer number and the Zalando order number must be shown on all Zalando invoices. Also, the footer of the document must contain the external order number as the reason for payment. To achieve this, adjust the template for invoices.

Showing Zalando customer number and order number on invoices:

  1. Go to Setup » Client » Standard » Locations » Germany » Documents » Invoice » Tab: Template.

  2. Scroll down to the area Optional elements below stock unit table.

  3. For the setting External customer number, select the option Yes from the drop-down list.

  4. For the setting External customer number, select the option Yes from the drop-down list.

  5. Scroll to the option Customer reference. This option allows you to insert the external order number into the footer. Customers must specify this external order number as the designated use when making their payment.

  6. Select the coordinates for the option Customer reference so that the number is positioned after the text Verwendungszweck:.

  7. Save () the settings.
    Tip: Also add the payment note in this menu now.

8.2.4. Entering payment instructions for Zalando DE invoices

Zalando specifies a text containing payment instructions that needs to be shown on all Zalando invoices. Proceed as described below to enter these payment instructions for Zalando invoices.

Entering payment instructions for invoices:

  1. Expand the info box "Text: Payment instructions for Zalando DE invoices" below this description.

  2. Copy the text to the clipboard.

  3. Go to Setup » Client » Standard » Locations » Germany » Documents » Invoice » Tab: Template.

  4. Navigate to the area Optional elements below stock unit table, to the setting Payment instruction.

  5. Find a field that does not contain any payment instructions.

  6. From the drop-down list Payment method of this field, select the option Zalando DE.

  7. Paste the Zalando payment instructions into the input field.

  8. Save () the settings.

Text: Payment instructions for Zalando DE invoices

Note: Solltest du die Zahlart Rechnung gewählt haben, ist dir von Zalando bereits die Bestellbestätigung mit dem Verweis auf den zu zahlenden Gesamtbetrag per E-Mail zugestellt worden.

Hast du noch Fragen zu deiner Bestellung? Besuche unsere Hilfeseiten unter www.zalando.de/faq - darüber kannst du uns auch kontaktieren.

Bitte überweise ausstehende Beträge ausschließlich an Zalando.

8.3. Preparing return slips for Zalando DE

Return slips for Zalando orders must contain the following information:

  • Your logo

  • Zalando Partner logo

  • External order number

  • External customer number

  • Return note required by Zalando

Layout: This is what a return slip for Zalando DE should look like (as of 01/03/2022)
  • You only need the information regarding the return of cosmetics if you sell such items.

zalando DE return note

Consult the documentation for Zalando Partners to find out more about the requirements for order documents.

Creating layout templates for order documents in PlentyONE is described in the Orders area of the manual. On this page, we only describe how to upload the PDF template and set up the delivery note document for the specific requirements of the market:

8.3.1. Personalising a PDF template for return slips

Zalando return slips must conform to the requirements set by Zalando. Zalando provides a DOCX template for return slips. Personalise this template before you upload this file in PlentyONE as a PDF.

Personalising a DOCX template for return slips:

  1. Save the DOCX template for Zalando return slips to your computer:

  2. Open the template in an editor.

  3. Insert your logo into the file.

  4. Delete those parts of the documents that are inserted automatically when a return slip is generated.
    Tip: To comply with Zalando’s layout requirements, we recommend that you leave the return instructions in the PDF template. Delete the instructions for returning cosmetics if you do not sell such items.

  5. Save the template as a PDF file.

8.3.2. Uploading personalised PDF template for return slips

Proceed as described below to upload the personalised PDF template for return slips to PlentyONE. The PDF file can be up to 150 kB.

Uploading personalised PDF template for return slips:

  1. Go to Setup » Client » Select client » Locations » Location: Germany » Documents » Return slip.

  2. Click on the tab PDF template.

  3. Click on Add template.
    → The editing window Upload new PDF template opens.

  4. From the drop-down list Payment method, select the option Zalando DE.

  5. In the drop-down list Language, select the option de.

  6. In the line Template, click on Choose template file.

  7. Select the PDF template for Zalando return slips.

  8. Click on Upload template ().
    → The template is uploaded.

8.3.3. Showing customer number and order number on return slips

The Zalando customer number and the Zalando order number must be shown on all Zalando return slips. To achieve this, adjust the template for return slips.

Showing Zalando customer number and order number on return slips:

  1. Go to Setup » Client » Standard » Locations » Germany » Documents » Return slip » Tab: Template.

  2. Scroll down to the area Optional elements below stock unit table.

  3. For the setting External customer number, select the option Yes from the drop-down list.

  4. For the setting External customer number, select the option Yes from the drop-down list.

  5. Save () the settings.

8.4. Preparing return flyers

In addition to return slips, orders must also contain a return flyer. The return flyer is a standard PDF document which you yourself do not need to change. As such, note the following recommendations:

  • Download the PDF templates for Zalando return slips here.
    Tip: Select the PDF template that corresponds to your shipping service provider.

  • Upload the PDF template to PlentyONE as described for the other order documents. Select a PlentyONE document type that you do not need for any of the markets and sales channels for this client. For example, select the document type Pick-up/delivery note.

  • In the tab Template of the document type, remove all optional fields. For mandatory fields, specify coordinates outside of the visible document area.

8.5. Special case: Preparing order documents for Austria, Belgium and/or Switzerland

You can only specify one order document for each combination of payment method and language in PlentyONE. However, Zalando requires separate mandatory details for order documents for each country. For example, there are different bank details and links to FAQs for each country. This leads to problems when the same language is spoken in several countries or when several languages are spoken in the same country.

As such, you need separate payment methods for the following countries:

  • Austria (AT)

  • Belgium (BE)

  • Switzerland (CH)

Separate payment method allow you to create separate templates for order documents for these countries.

Note the following points:

  • The payment methods for Austria, Belgium and Switzerland only become visible in the document menu after Zalando activates the platform for your Zalando account.
    Important: For technical reasons, it can take up to 24 hours after activation before the payment method becomes available in the PlentyONE back end.

  • The payment method is only saved for incoming orders if you have created a template for this payment method. It does not matter for which client, language or document a template is saved. If a template is saved for any document for a payment method, this payment method is assigned to incoming orders from that country.

9. 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?)

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

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

  5. Save () the settings.

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

  7. Select the setting Active ().

  8. Save () the settings.

The data is not transferred in real time when this event procedure is triggered. Instead, the data is registered in a queue. If there are several jobs in the queue, it can take several minutes for the data to be transferred. The advantage? If the target server is unavailable or throttled, several attempts are made to transfer the data.

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

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

  5. Save () the settings.

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

  7. Select the setting Active ().

  8. Save () the settings.

The data is not transferred in real time when this event procedure is triggered. Instead, the data is registered in a queue. If there are several jobs in the queue, it can take several minutes for the data to be transferred. The advantage? If the target server is unavailable or throttled, several attempts are made to transfer the data.

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

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

  5. Save () the settings.

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

  7. Select the setting Active ().

  8. Save () the settings.

The data is not transferred in real time when this event procedure is triggered. Instead, the data is registered in a queue. If there are several jobs in the queue, it can take several minutes for the data to be transferred. The advantage? If the target server is unavailable or throttled, several attempts are made to transfer the data.

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

10. Starting data exchange: Activating the Zalando account

Have you completed all the settings? Great. Then you are ready for the next step. Activate your Zalando account in the assistant Account settings - Zalando to start exchanging data with Zalando.

What to do if "This account cannot be activated."

Data is not exchanged with Zalando. To activate Zalando’s zDirect API interface, your Zalando account must be linked to the PlentyONE developer account. This link is established automatically during the integration. However, PlentyONE also needs to generate additional credentials for the API and then save these credentials in your system. We cannot give you access to these credentials. As such, PlentyONE is not allowed to give you access to these credentials. Ask our support staff to activate your account in this thread of the PlentyONE forum.

In the forum post, provide the following information:

  • 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
    Note: Only one account can be linked in PlentyONE for each Zalando seller account.

Activating the Zalando account:

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

  2. Click on the assistant Account settings - Zalando.

  3. Navigate to the step Account activation.

  4. Activate the option Activate user account.

  5. Complete the assistant.
    → The data exchange with Zalando is activated.

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

Export-Log

zalandoArticleExportLog.txt

The export log zalandoArticleExportLog.txt contains log entries for variations. The export log is generated once every night. The file contains entries for variations that were exported successfully and for variations that could not be exported to Zalando.

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.

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.

11.1. Downloading the export log

The export log contains PlentyONE log entries. The file contains entries for variations that were exported successfully and for variations that could not be exported to Zalando.

Downloading the export log:

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

  2. Click on the Processing reports tab.

  3. In the Export log area, click on Download file ().
    → The CSV file is generated.

  4. Save the CSV file on your computer.

  5. Filter the entries to only see the status error.

  6. Check the entries. Correct any variation data in the PlentyONE back end.
    Tip: You can ignore any entries with the status warning.

Table 8. Error messages in the export log (zalandoArticleExportLog.txt)
Setting Explanation

specialDescriptions

Technical data

brand

Characteristic Zalando » Hersteller-Code (manufacturer code)

season

Characteristic Zalando » Jahreszeiten-Code (season code)

genders

Characteristic Zalando » Geschlecht (gender)

ageGroups

Characteristic Zalando » Altersgruppe(n) (age groups)

sizeRegister

Characteristic Zalando » Größen-Register (size register)

mainColorCode

From the Characteristic Zalando » 1. Farbcode (Zalando » 1st colour code)
Exception: The variation has a colour attribute. In that case, attribute links are used to manage colours.

supplierColor

Characteristic Zalando » Hersteller-Farbe (Zalando » Manufacturer colour) or an optional 2nd attribute link

images

The variation must have at least one image.

ean

The variation needs a GTIN 13.

lengthRegister

Characteristic Zalando » Längen-Register (length register)

Keywords

Meta keywords (item tab: Texts)

11.2. 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.3. 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 9 to limit the search results.

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

13. FAQ

13.1. Integration

How can I join the Zalando partner program?

Contact Zalando directly to join the Zalando partner program.

What are the next steps after I have registered for the Zalando partner program?

Contact us in the PlentyONE forum. Our support team will provide you with a CSV file. This file contains the following information:

  • Routes for items

  • User name and password

  • Login details for the PlentyONE FTP server for silhouettes Note: Zalando sends your silhouettes to this FTP server so that they can be imported into your PlentyONE system. PlentyONE imports these silhouettes every Wednesday.

Forward the completed form to your Zalando contact.
Complete the assistant Account settings - Zalando in your PlentyONE system.
Set up the interface to Zalando in your PlentyONE system.
Activate your Zalando account in the assistant. (How?)

Where can I get the CSV file for Zalando?

We will provide the file for you in the PlentyONE forum via PM. Write us a message in this forum thread. Please also provide your PID if it differs from the PID in your forum user account.

My Zalando account has not been activated yet.

To activate Zalando’s zDirect API interface, your Zalando account must be linked to the PlentyONE developer account. This link is established automatically during the integration. However, PlentyONE also needs to generate additional credentials for the API and then save these credentials in your PlentyONE system. As such, PlentyONE is not allowed to give you access to these credentials.
Ask our support staff to activate your account in this thread in the PlentyONE forum.

13.2. Item data export

Which settings do I have to carry out for an item to be exported to Zalando?

You have to carry out the following settings so that an item can be exported to Zalando:

  • The availabilities Zalando and WEB API must be activated in the Availability tab of a variation. (How?)

  • The variation must be activated.

  • The variation has a sales price for Zalando. (How?)

  • The items are linked to all mandatory characteristics. (Which ones?)

Why are my items not exported to Zalando?

Either you did not carry out the basic settings for the market or the mandatory fields are not filled.
The mandatory fields for Zalando are listed below:

  • 1 Farbcode (colour code)

  • Altersgruppe(n) (age group(s))

  • Geschlecht (gender)

  • Größenregister (size register)

  • Hersteller-Code (manufacturer code)

  • Herstellerfarbe (manufacturer colour)

  • Jahreszeiten-Code (seasonal code)

  • Silhouetten-Typ (silhouette type)

To check whether there are errors for your variations, you can take a look at the reports. Depending on the report, you can check your variations for errors.

Why are my items not updated?

For Zalando, changes to item data, such as text changes, are not automatically imported afterwards. In this case it is necessary to contact Zalando directly.

13.3. Reports and error messages

13.3.1. Reports

Where can I access the reports for Zalando?

Open the Setup » Markets » Zalando » Settings » Tab: Processing reports menu to download the reports.

Export log zalandoArticleExportLog.txt

The export log zalandoArticleExportLog.txt contains log entries for variations. The export log is generated once every night. The file contains entries for variations that were exported successfully and for variations that could not be exported to Zalando. Here’s how to download the export log.

Product status reports ProductErrorReport.csv and ProductLiveReport.csv

Zalando generates the product status reports once during the night. These reports only contain information regarding variations that were successfully exported to Zalando. Here’s how to download the product status reports.

  • ProductErrorReport.csv contains variations that could not be sold on Zalando since the last export. The report is generated once every night.

  • ProductLiveReport.csv contains variations that could 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.

13.3.2. Error messages in the report zalandoArticleExportLog.txt

errors (1234567) (ValueId:12345): silhouetteId

The characteristic Zalando » Silhouettenname (silhouette name) for the variation ID (=ValueID) is missing.

errors (1234567) (ValueId:12345): brand

The characteristic Zalando » Hersteller-Code (manufacturer code) for the variation ID (=ValueID) is missing.

errors (1234567) (ValueId:12345): ageGroups

The characteristic Zalando » Altersgruppe (age group) for the variation ID (=ValueID) is missing.

errors (1234567) (ValueId:12345): sizeRegister

The characteristic Zalando » Größen-Register (size register) is missing or was not created correctly.
Note: This only applies if you do not use attributes to indicate sizes.

  • *Scenario 1: The characteristic is missing.
    The characteristic has to be added and linked to the appropriate size register.

  • *Scenario 2: The characteristic was created.
    Keep in mind to comply with the format provided by Zalando. Check if the size register is correct.

Note: Size registers that were created manually cannot be used for Zalando.

errors (1234567) (ValueId:12345): mainColorCode

The characteristic Zalando » 1. Farbcode (colour code) for the variation ID (=ValueID) is missing.
Exception: The variation has a colour attribute. In that case, attribute links are used to manage colours.

errors (1234567) (ValueId:12345): supplierColor

The characteristic Zalando » Hersteller-Farbe (Zalando » Manufacturer colour) or the second attribute link is missing or not properly saved for the variation ID (=ValueID).

errors (1234567) (ValueId:12345): genders

The characteristic Zalando » Geschlecht (gender) for the variation ID (=ValueID) is missing.

errors (1234567) (ValueId:12345): season

The characteristic Zalando » Jahreszeiten-Code (seasonal code) for the variation ID (=ValueID) is missing.

errors (1234567) (ValueId:12345): size

The characteristic Zalando » Größe (size) for the variation ID (ValueID) is missing or the attribute was not linked with the characteristic. +] Note: You can use item attributes to indicate sizes. It is mandatory to link the attributes in the size register.
Here’s how to link attributes to characteristics.

errors (1234567) (ValueId:12345): ean

A GTIN 13 with the referrer Zalando must be saved for the variation in the variation’s Settings » Barcode tab.
You can check the settings for the referrer in the Setup » Item » Barcode menu.

errors (1234567) (ValueId:12345): image

At least one image with the referrer Zalando must be saved for the variation.

13.3.3. Error messages in the report ProductErrorReport.csv

ZANOS_01 - Please send stock for this article to push it back online.
ZABLO_15 - Article blocked due to old season. Please delete the article from the feed or reach out to the Operations team to adjust the season.

If you can offer this item also in the new season, then you can map the characteristic Jahreszeiten-Code (seasonal code) with the new season. If the new season is not displayed, then contact Zalando. The new silhouettes have to be updated at Zalando afterwards.
Also take a look at The silhouettes were not updated/imported in plentymarkets.

PSERR_133 - Submitted size isn’t an allowed value for the size chart being submitted by the partner. Or the submitted size isn’t an allowed value for the partner article’s already existing size chart.

You want to transfer a size from a size register which is not enabled for you. For example, Zalando assigned the sizes S-L to you, but you tried to list an item in XL. Contact Zalando and have the sizes in your size registers adjusted.
Also take a look at The silhouettes were not updated/imported in plentymarkets.

PSERR_118 - EAN rejected because the sum of the material composition is not 100%. Please review the sum of material composition within the attribute.

Characteristics are used to save information about the item’s material. Use a characteristic of the type Text to specify the item’s material composition in %.

Note: The sum must always add up to 100%. However, the material information has to be indicated in 100,00% for the export to work. Thus, if the item consists of 80% polyester and 20% cotton, you have to enter the following values:

  • polyester: “8000”

  • cotton: “2000”

For 100% cotton, the value would be “10000”.

13.4. Price synchronisation

How can I check whether prices were exported?

For an overview of the price updates within the last 7 days and the corresponding processing statuses, you can download reports within the Setup » Markets » Zalando » Settings » Tab: Processing reports » Tab: Price reports menu. Note that Zalando only receives prices when they are in the status Submitted. You can update the report anytime. However, the time span is fixed.
If you notice that some prices were not updated or if you think that the values which were exported are not correct, you can also check this in the log. Go to Data » Log.
Use the following filters:

  • Integration: Plenty\Modules\Zalando\Prices\Services\PriceUpdateService

  • Identifier: Zalando

Enter the variation ID or the EAN as Reference type. To do so, enter variationID or ean as reference type and use the corresponding value as Reference value.
Afterwards, open the log entry and click on Expand all to look at the request.
Whether Zalando accepted this message can be checked in the response. The response is contained in a separate log. The following screenshot contains a jobId:

jobid

Open the Data » Log menu and filter for the jobID.

jobid filter

There will be messages like these:

search results

Open the log entry shown in the screenshot above:

log entry details

The response is contained within the Description.

How can I update the prices again for one or more variations?

Adjust the variation’s sales price for Zalando. To do so, slightly change the price, for example change the price by + 0.01 EUR and back (- 0.01 EUR). Afterwards, the price will be exported to Zalando within 15 minutes.
You can check the export of prices in the log.
The sales price which is used as standard sales price for Zalando was defined in the assistant Account settings - Zalando.

How can I update the prices again for all variations?

To export all prices to Zalando again, the price synchronisation must be triggered. For example, this can be done in the assistant Account settings - Zalando in the Setup » Assistants » Omni-Channel menu. You only have to make a change in the Prices for Germany and/or Prices for Austria section. It does not matter which change you make. You can revert the change afterwards. All prices will be exported to Zalando within 15 minutes afterwards.
You can check the export of prices in the log.
Note that the export may be delayed if you transfer a lot of variations to different sales channels. This is due to the limitation of API calls set by Zalando. It can happen that data is exported in several packages, and therefore the export takes longer. Variations of one and the same item might also be exported in different packages. Each package contains up to 1000 variations, which make up one request. 20 requests can be sent per minute. Different packages can be distinguished by the jobId in the Data » Log menu.

13.5. Stock correction import

How can I check whether stock was exported?

Go to Data » Log.
Use the following filters:

  • Integration: Plenty\Modules\Zalando\Stock\Services\StockUpdateService

  • Identifier: Zalando

Enter the variation ID or the EAN as reference type. To do so, enter variationID or ean as reference type and use the corresponding value as reference value.
Afterwards, open the log entry and click on Expand all to look at the request.
The stock which was exported is shown as quantity.
Whether Zalando accepted this message can be checked in the response. The response is contained in a separate log. The following screenshot contains a jobId:

zalando faq stock job id

Filter for it in the log again.
Check both the marked info message as well as possible error messages.
Why the stock was not exported to Zalando can be seen in the description.
The error message „Request contains duplicate combinations of stock quantities.“ is usually issued if individual variations were exported twice. To check whether one variation was exported twice, check if one and the same EAN was used multiple times. If this is the case, stock cannot be exported.

How can I update the stock again for one or a few variations?

To update the stock again, you have to adjust the stock of the desired variation. For example, you can change the stock from - 1 piece to + 1 piece. Afterwards, the stock will be exported to Zalando within 15 minutes.
You can check the export of prices in the log. Also see How can I check stock updates?. Settings for stock export are carried out when first setting up Zalando with the assistant Account settings - Zalando.

How can I update the stock again for all variations?

To export stock again to Zalando, the stock synchronisation must be triggered. You can use the assistant Account settings - Zalando to do so. You only have to make a change in the Stock for Germany and/or Stock for Austria section. It does not matter which change you make. You can revert the change afterwards. The stock will be exported to Zalando within 15 minutes afterwards.
You can check the export of prices in the log.
Note that the export may be delayed if you transfer a lot of variations to different sales channels. This is due to the limitation of API calls set by Zalando. It can happen that data is exported in several packages, and therefore the export takes longer. Variations of one and the same item might also be exported in different packages. Each package contains up to 1000 variations, which make up one request. 20 requests can be sent per minute. Different packages can be distinguished by the jobId.

13.6. Order processing

In some cases, errors can occur during order processing. Possible causes and frequent errors are described here.

To check whether an order was processed, you can use the following filters in the Data » Log menu.

  • Identifier: Zalando

  • Reference type: orderId / externalOrderId

  • Reference value: your order ID / your external order ID

Shipping confirmations are missing or were not reported to Zalando. Where can I find corresponding error messages in the log?

If shipping confirmations were not reported to Zalando, open the Data » Log menu.
Use the following filters:

  • Integration: Plenty\Modules\Zalando\Orders\Procedures\OrderShippingProcedure

  • Identifier: Zalando

  • Level: error

You can also additionally use the order ID or the external order ID as filter, if required:

*Reference type*: orderId / externalOrderId
*Reference value*: your order ID / your external order ID
Orders from other countries/other Zalando channels are imported with the payment method "Zalando DE". Why?

You probably did not create a template for order documents for the country in which the order originated. If you did not create separate order documents for a country, then the order documents are created using the template for the payment method Zalando DE.

Solution:

13.6.1. Error messages concerning order processing

No return number found.

There may be different reasons for this:

  • First: The order has a package number but no return tracking number (return label).
    Analysis: Go to Orders » Shipping centre to check this. Return labels are shown in the Return labels tab of the order.
    Solution: If no label exists, a label must be created and a new shipping confirmation must be sent.

  • Second: The order has a return label.
    Analysis: Check when the return label was created and when the shipping confirmation was reported to Zalando. If the return label already exists, it may only have been created after the shipping confirmation was reported to Zalando.
    Solution: Trigger the shipping confirmation again by starting the event procedure again. Depending on the event in the event procedure, you should take different actions. If it is not possible to trigger the appropriate event, you can also create a new event procedure with another status.

13.7. General questions

The silhouettes were not updated or imported into PlentyONE.

Zalando sends (new) silhouettes to the PlentyONE FTP server so that they can be imported into your PlentyONE system. New silhouettes are updated every Wednesday by PlentyONE and can be converted into characteristics afterwards.
To do so, use the Converting silhouettes to characteristics function. If you try to convert silhouettes to characteristics for the first time and the backend looks like this:

zalando faq silhouettes

Then the reason might be that

  • Either Zalando has not yet sent any silhouettes for you or

  • PlentyONE has not yet imported your silhouettes.

If you already have silhouettes in your PlentyONE system and you want to convert them into characteristics, the backend looks like this:

zalando faq converting silhouettes

Select the desired groups and click on convert to characteristics.
Tip: Only select the groups which you want to sell items in to keep the number of characteristics at a minimum.
Also see Converting silhouettes to characteristics.

Where can I find the order documents requested by Zalando?

Any documents requested by Zalando have to be configured according to Zalando’s requirements. The PDF templates are provided by Zalando.
Note: As Zalando has specific requirements and you can only configure the documents globally, you should create an additional client which you only use for Zalando. This prevents your present settings from being overwritten. You can individually set up the documents afterwards.
You can book an additional client in the START (PlentyONE logo) » My account » Contracts menu.
How to set up you documents is described on the Setting up documents page.

When is the master data exported?

Note: The master data contains your size registers and the silhouettes that you want to use.
As in the case of silhouettes, size registers are imported every Wednesday.