Skip to main content

OTTO market

This page provides information about OTTO market, OTTO’s marketplace model.

1. OTTO market

OTTO market is OTTO’s marketplace. You are shown as the seller of your products. You also manage the customer communication yourself.

Connecting to this market with plentymarkets allows for the following automatic processes to take place:

  • Order import every 15 minutes

  • Stock and price update every 15 minutes

  • Item data is updated once a day

2. Setting up an account

The basic settings for OTTO market are carried out in the Setup » Assistants » Omni-Channel menu with the OTTO market basic settings assistant. With this assistant, you set up your OTTO market account in plentymarkets.

In order to open the assistant, go to Setup » Assistants » Omni-Channel and click on the OTTO market Basic settings assistant. The assistant opens and you can start setting up your account.

3. Activating the order referrer

In order to link items, properties etc. with OTTO market, you have to activate the order referrer OTTO market in the Setup » Orders » Order referrer menu.

Activating the order referrer for OTTO market:

  1. Go to Setup » Orders » Order referrer.

  2. Place a check mark next to OTTO market.

  3. Save () the settings.

4. Setting the variation availability

You need to activate all variations that you want to sell on OTTO market. This is done in the Availability tab of a variation within the Item » Edit item » Open item » Tab: Variation ID menu.

Selling all variations of an item on OTTO market

If you want to sell all variations of an item on OTTO market, carry out the settings below for the item’s main variation. All other variations of the item then inherit the settings of the main variation.

Activating the variation availability for OTTO market:

  1. Go to Item » Edit item » Open item » Tab: Variation ID » Tab: Settings.

  2. Open the variation that you want to sell on OTTO market.

  3. In the Availability section, active the option Active.

  4. Click on the Availability tab.

  5. Click in the selection field in the Markets section.
    → A list of all available markets is displayed.

  6. Activate the option OTTO market.

  7. Activate the option Web API.

  8. Click on Add ().
    → The market is added.

  9. Save () the settings.

5. Setting the availability for images

The availability OTTO market has to be saved for an image in the Item » Edit item » Open item » Tab: Images menu so that item images are displayed on OTTO market.

Setting the availability for images:

  1. Go to Item » Edit item » Open item » Tab: Images.

  2. Activate the option OTTO market in the Availability drop-down list.

  3. Save () the settings.
    → The variation image is displayed on OTTO market.

6. Defining a sales price

Proceed as described below to define a sales price for the order referrer OTTO market. The price is displayed on OTTO market.

Defining a sales price for OTTO market:

  1. Go to Setup » Item » Sales prices » Open sales price » Tab: Settings.

  2. Place a check mark next to the referrer OTTO market.

  3. Save () the settings.

7. Setting up the item export

Item data is exported to OTTO market vie catalogue templates. Catalogues are cerated with the OTTO market Creating catalogues assistant in the Setup » Assistants » Omni-Channel menu. For further information about catalogues, refer to the Managing catalogues page.

In catalogues, you link your item data saved in plentymarkets to OTTO market data fields. The mandatory fields for each OTTO category group are already mapped in the assistant. Afterwards, open the catalogue that you created with the assistant to link further optional OTTO market data fields not marked with an asterisk with item data saved in plentymarkets. This way, you can describe your items in more detail. Your items are more likely to be sold with a detailed description. For further information about the plentymarkets data sources that can be linked, refer to the Mapping data sources chapter.

Linking data fields in the catalogue:

  1. Go to Data » Catalogues.

  2. Click on the OTTO market catalogue.
    → The catalogue opens.
    → The market’s data fields are displayed on the left-hand side.
    Tip: Mandatory fields are marked with an asterisk. Mandatory fields were already mapped in the OTTO market Creating catalogues assistant.

  3. Select a plentymarkets data source for the market’s data fields from the drop-down list.

  4. Click on Add source to assign another plentymarkets data source to a data field.
    → A new line is displayed.
    Note: Only one value is exported even if you assign more than one data source to a data field. The data is checked in the order in which you assigned it. This means that if the first data field does not provide a value, the second data field is exported etc.

  5. Link the desired data fields.

  6. Save () the settings.

An example of how to link the data field Stock to data saved in plentymarkets is provided below. The data field Stock defines the warehouse from which stock should be exported to OTTO market.

Linking the data field Stock
  1. Go to Data » Catalogues.

  2. Click on the catalogue.
    → The catalogue opens.

  3. Select a plentymarkets data source for the OTTO market data field from the Source drop-down list. To do so, expand the plentymarkets data source Stock.
    → All warehouses saved in plentymarkets are displayed in the drop-down list.

  4. Select the warehouse which should be used to export stock to OTTO market and click on Select ().
    Tip: If you would like to transfer stock from multiple warehouses to OTTO market, click on Add source () and add more warehouses.

  5. Save () the settings.
    → If you do not link the data field Stock to a warehouse, then the sum of the net stock of all distribution warehouses (data source Virtual warehouse) will be exported to OTTO market.

Link all mandatory fields

The mandatory fields for the templates are marked with an asterisk. To make sure that all necessary item data is provided, link at least the mandatory fields. For OTTO market, mandatory fields are already linked in the OTTO market Creating catalogues assistant.

8. Linking variations with OTTO category groups

After you created a catalogue template for OTTO market with the OTTO market Creating catalogues assistant or manually, the property OTTO category group is created in your plentymarkets system. A new selection value is added to the OTTO category group property for each OTTO category group selected in the Name and category group step of the assistant. In order for your variations to be exported in the appropriate catalogue, they have to be linked to the OTTO category group property in the Properties tab of a variation.

Linking a variation with an OTTO category group:

  1. Go to Item » Edit item » Open item.

  2. Open the Variations tab.

  3. Open the variation that should be linked.

  4. Open the Properties tab.

  5. In the Variation properties section, select the property OTTO category group from the Properties drop-down list and click on Add ().
    → The property is added.

  6. Select the desired category group from the Value drop-down list for the OTTO category group property.
    → The variation will be exported in this catalogue.
    Example: If you select the value Betten (Beds), then the variation will be exported in the in the catalogue for the OTTO category group Betten.

  7. Save () the settings.

9. Setting up event procedures

Set up event procedures to automatically inform OTTO market about order status changes. The following event procedures can be set up for OTTO market:

  • Auftragsbestätigung an OTTO melden (Send order confirmation to OTTO)

  • Versandinformation an OTTO melden (Send shipping confirmation to OTTO)

  • Auftragsstornierung an OTTO melden (Send order cancellation to OTTO)

  • Retoure an OTTO melden (Send return to OTTO)

  • Ablehnung der Retoure an OTTO melden (Send rejection of return to OTTO)

How to set up the event procedures in plentymarkets is described in the following chapters.

9.1. Generating a DHL return label

When OTTO market orders are imported into your plentymarkets system, then DHL return labels must be generated for those orders before the shipping confirmation is sent to OTTO market. The procedure Generate DHL return label automatically creates a tracking number for a return (retTrackingNumber) which is saved for the order. This is to ensure that a tracking number exists if customers wish to return an item.

To ensure that the tracking number is sent to OTTO market along with the order confirmation, you have to create two event procedures which are triggered one after the other: 1. Generate DHL Retoure Online label and 2. Auftragsbestätigung an OTTO melden (Send order confirmation to OTTO).

Note: At the moment, the return label can only be generated with DHL. Further shipping service providers will be available soon.

Install DHL Retoure Online plugin

In order to generate a DHL return label, the DHL Retoure Online plugin has to be installed, activated and set up in your plentymarkets system. The plugin is available in the plentyMarketplace.

How to set up the event procedure to create a DHL return label is described below.

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

  4. Select the event listed in Table 1.

  5. Save () the settings.
    → The event is created.

  6. Carry out further settings as described in Table 1.

  7. Place a check mark next to the option Active.

  8. Save () the settings.
    → The event procedure is saved.

Table 1. Event procedure to create a DHL return label
Setting Option Selection

Event

New order

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

OTTO market

Procedure

Plugins > Generate DHL Retoure Online label

9.2. Sending an order confirmation to OTTO

The event procedure for sending an order confirmation to OTTO has to be triggered after a DHL return label was generated. How to set up the event procedure for sending an order confirmation to OTTO is described below.

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

  4. Select the event listed in Table 2.

  5. Save () the settings.
    → The event is created.

  6. Carry out further settings as described in Table 2.

  7. Place a check mark next to the option Active.

  8. Save () the settings.
    → The event procedure is saved.

Table 2. Event procedure to send an order confirmation to OTTO market
Setting Option Selection

Event

Status change: select a status before shipping as needed

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

OTTO market

Procedure

Plugins > Auftragsbestätigung an OTTO melden (Send order confirmation to OTTO)

9.3. Sending a shipping confirmation to OTTO

Set up an event procedure to inform OTTO market that an item has been shipped.

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

  4. Select the event listed in Table 3.

  5. Save () the settings.
    → The event is created.

  6. Carry out further settings as described in Table 3.

  7. Place a check mark next to the option Active.

  8. Save () the settings.
    → The event procedure is saved.

Table 3. Event procedure to send a shipping confirmation to OTTO market
Setting Option Selection

Event

Status change: e.g. status [7] Shipped

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

OTTO market

Procedure

Plugins > Versandinformation an OTTO melden (Send shipping confirmation to OTTO)

9.4. Sending an order cancellation to OTTO

Set up an event procedure to inform OTTO market about the cancellation of an order. It might be required to cancel orders because of different reasons. For example, if you as seller cancel an order, select Status [8] Cancelled]. If the customer cancels an order, select Status [8.1] Cancelled by customer.

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

  4. Select the event listed in Table 4.

  5. Save () the settings.
    → The event is created.

  6. Carry out further settings as described in Table 4.

  7. Place a check mark next to the option Active.

  8. Save () the settings.
    → The event procedure is saved.

Table 4. Event procedure to send an order cancellation to OTTO market
Setting Option Selection

Event

Order change: Status change

[8] Cancelled or [8.1] Cancelled by customer

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

OTTO market

Procedure

Plugins > Auftragsstornierung an OTTO melden (Send order cancellation to OTTO)

9.5. Sending a return to OTTO

Set up an event procedure to inform OTTO market about returns.

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

  4. Select the event listed in Table 5.

  5. Save () the settings.
    → The event is created.

  6. Carry out further settings as described in Table 5.

  7. Place a check mark next to the option Active.

  8. Save () the settings.
    → The event procedure is saved.

Table 5. Event procedure to send returns to OTTO market
Setting Option Selection

Event

Order generation: New return

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

OTTO market

Procedure

Plugins > Retoure an OTTO melden (Send return to OTTO)

9.6. Sending rejection of return to OTTO

Set up an event procedure to inform OTTO market about the rejection of a return.

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

  4. Select the event listed in Table 6.

  5. Save () the settings.
    → The event is created.

  6. Carry out further settings as described in Table 6.

  7. Place a check mark next to the option Active.

  8. Save () the settings.
    → The event procedure is saved.

Table 6. Event procedure to send the rejection of a return to OTTO market
Setting Option Selection

Event

Select an event, e.g. Order change: Status change
Note: Select a status that suits your workflow. For example, you can create the status [8.2] Reject OTTO return.

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

OTTO market

Procedure

Plugins > Ablehnung der Retoure an OTTO melden (Send rejection of return to OTTO)

To top