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. However, communication with customers is managed by OTTO.

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

  • Order import every 15 minutes

  • Stock synchronisation every 15 minutes
    Note: If stock for a variation drops to 0, this variation is deactivated automatically after 15 days. This is done to protect the product’s ranking on OTTO Market. If new stock is booked for such a variation, the variation is reactivated during the nightly item export.

  • Update of item data including price synchronisation once every night

  • Import of return announcements by customers once per hour

  • Update of category groups/catalogue templates twice a week

  • Update of the brands list every three hours

2. Setting up an account

Use the assistant Base settings - OTTO Market in the Setup » Assistants » Omni-Channel menu to quickly and conveniently set up OTTO Market in plentymarkets. Moreover, you set up the data transfer to OTTO Market. Keep the API access data at hand that you received from OTTO Market.

Carrying out the base settings with the assistant:

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

  2. Click on the assistant Base settings - OTTO Market.

  3. Follow the instructions on the screen.
    Tip: If you need additional information about one of the options, expand the info box below ().

  4. Check the summary for any errors.

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

Options in the assistant
Setting Explanation

Step Settings

Select the client that should be used to sell your items.

From the drop-down list Client, select a client. This client is used to generate the item URL in the catalogue and OTTO Market orders are assigned to this client.

Would you like to activate your OTTO market user account?

Not activated = The settings are saved but the data exchange with OTTO Market is not started.
Activated = Data exchange with OTTO Market is started once the assistant is completed.
Recommendation: Check all settings before activating the user account.

Step API access data

Enter the API access data.

  • API user (mandatory input) = Enter the user name for the API interface that you received from OTTO Market.

  • Password (mandatory input) = Enter the password for the API interface that you received from OTTO Market.

Step Data exchange

Would you like to import OTTO market orders into plentymarkets?

Activate to import orders every 15 minutes automatically.
Note: You need to activate this option to export item data and stock information.

Which data would you like to transfer to OTTO market?
(only shown if you activated Import orders)

Select the data to be exported.
Note: You need to automatically import orders to export item data and stock information.

  • Item data = Item data is synchronised once a day during the night.

  • Stock information = Stock is synchronised every 15 minutes.
    Note: If stock for a variation drops to 0, this variation is deactivated automatically after 15 days. This is done to protect the product’s ranking on OTTO Market. If new stock is booked for such a variation, the variation is reactivated during the nightly item export.

Would you like to import return announcements from OTTO market into plentymarkets?

Activate to import returns that customers create on OTTO Market once per hour. Each returned order item is shown as a separate return in the Orders tab of an order.

Select the order status for newly imported return announcements.
(only shown if you activated Import return announcements)

From the drop-down list, select the status to be assigned to return announcements during import.
Note: A return announcement does not guarantee that the customer actually sends the product back to you. As such, select a status that does not trigger any unwanted event procedures, e.g. event procedures for creating credit notes.

Would you like to replace the stock amount for variations with no stock limitation?

Activate to enter a stock amount.

Stock amount
(only shown if you activated Limit stock)

Enter the stock amount. This stock amount is sent if the setting Limit of a variation is set to None or Do not administer stock for this variation and stock is less than or equal to 0.

Step Shipping service provider

Link plentymarkets shipping service provider DHL with:

OTTO Market shipping service provider (drop-down list)

Step Summary

Summary

Shows a summary of your settings. Expand () and check your settings.

3. Activating the order referrer

An order referrer tags an order with the sales channel on which the order was generated. You also need to activate the order referrer in order to link items, characteristics etc. with OTTO Market. Go to Setup » Orders » Order referrer to activate the order referrer.

Activating the order referrer for OTTO Market:

  1. Go to Setup » Orders » Order referrer.

  2. Activate the option 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.

Use group function or batch processing

You can edit the availability of several variations at once by using either the variation group function or batch processing.

Setting 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.
    Tip: To sell all variations of an item on OTTO Market, carry out the settings for the item’s main variation. This activates the availability of all variations of the item.

  3. In the Availability area, activate the option Active.

  4. Click on the Availability tab.

  5. In the Markets area, click in the selection field.
    → A list of all available markets is displayed.

  6. Activate the option OTTO Market.

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

  8. Save () the settings.
    → The variation is available for OTTO Market.

If you deactivate the market availability for OTTO Market of a variation in the Item » Edit item » Open item » Tab: Variation ID» Tab: Availability, the variation is deactivated on OTTO Market within 15 minutes. If you reactivate the availability of such a variation, the variation is only reactivated on OTTO Market during the nightly item export.

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. This 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. Activate the referrer OTTO Market.

  3. Save () the settings.

7. Activating the payment method

Activate the payment method Otto Payment as described below.

Activating the payment method Otto Payment:

  1. Go to Setup » Orders » Payment » Methods.

  2. Activate the option Also show inactive.

  3. Open the folder International.

  4. Click on Otto Payment.
    → The Settings tab opens.

  5. Carry out the settings. Pay attention to the information given in [table-payment-method].

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

  7. Save () the settings.

Table 1. Settings for the payment method
Setting Explanation

Language

The following options are saved for the language selected: Name, Info page, Info page (internal), Logo, and Upload logo. This enables you to enter values for these options in various languages. The values for a language are activated as soon as a buyer selects the language in the online store.

Name

Enter the name that should be displayed in the online store and on invoices etc.

Info page

Select a category page of the type content or enter the URL of a website to provide information about the payment method.

Info page (external)

If you selected the Info page (external) option under Info page, then enter the URL of the info page here.

Countries of delivery

Do not select a country of delivery.
You cannot use the payment method in your online store. Therefore, this payment method is only activated in plentymarkets. It is not completely set up.

Logo

Select one of the following options for displaying the logo:

  • Show standard logo = The logo that is saved in plentymarkets for this payment method is displayed.

  • Do not show a logo = The logo that is saved in plentymarkets for this payment method is not displayed.

  • Show upload logo = The options Logo view and Upload logo are displayed.

Logo view

If Show upload logo was selected from the Logo drop-down list, then the logo that was uploaded is displayed here.

Upload logo

If Show upload logo was selected from the Logo drop-down list, then upload an external logo here.
Click on Upload files and select the logo that you want to upload for the payment method. Permitted data formats: GIF, PNG, and JPG.

Priority

Select the priority for displaying the payment method in the online store.

Costs: Flat rate or percentage

If the payment method results in additional costs, enter the percentage value or flat rate value. The selection depends on the conditions of your contract.
Important: Do not enter a value into both fields.
For further information, refer to the Statistics page of the manual.
For an example of flat rate and percentage costs, refer to the Managing payment methods page.

Permitting the payment method in customer classes

Go to Setup » CRM » Classes to activate or deactivate permitted payment methods.
For further information, refer to the Permitting the payment method in a customer class chapter.

For further information, refer to the Managing payment methods page.

8. Setting up the item export

Item data is exported to OTTO Market via catalogue templates. Use the assistant Create catalogues - OTTO Market to create one catalogue for every OTTO category group. Is this your first time working with catalogues? Then read up on the basic principle of catalogues first. For further information about the plentymarkets data sources that can be linked, refer to the Mapping data sources chapter.

Items cannot be deleted at OTTO Market

An item cannot be deleted at OTTO Market, neither by plentymarkets nor by OTTO. It is only possible to mark the item as not available at OTTO Market. Therefore, make extra sure that the correct sources are mapped in the catalogue prior to transferring your items.

8.1. Creating a catalogue in the assistant

Creating a catalogue in the assistant:

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

  2. Click on the assistant Create catalogues - OTTO Market.

  3. Follow the instructions on the screen.
    Tip: If you need additional information about one of the options, expand the info box below ().

  4. Check the summary for any errors.

  5. If everything is as it should be, click on Finalise.
    → The catalogue is created.

  6. Open the catalogue in the Data » Catalogues menu to map additional data fields.
    Note: You need a separate catalogue for each OTTO category group.

Step Name and category group
Setting Explanation

Enter a name for the catalogue.

Enter a name for the catalogue.

Select the OTTO category group that should be added to the catalogue.

Select an OTTO category group from the drop-down list.
Note: You need a separate catalogue for each OTTO category group.

Step Required fields

In this step of the assistant, you decide which variation data saved in plentymarkets you want to send to the market. To do so, you are going to map each mandatory field of the market with the source in plentymarkets that contains the data that you want to export to the market. Each market specifies their own mandatory fields. Instead of mapping an existing data source, you can also create a new data source for some fields.


Parent SKU = From the drop-down list, select the data field in plentymarkets that contains the parent SKU.


SKU = From the drop-down list, select the data field in plentymarkets that contains the SKU.


Select data source = A data source that already exists in plentymarkets will be exported to OTTO Market. Select the data source from the drop-down list Data source.
Note: The mappings you create will not be checked in terms of logic. As such, check your mappings carefully before starting the export.


Create property = Creates a property and maps this property to the data field. This automatically created property will be saved in the Setup » Settings » Properties » Configuration menu.

The property is created with the following settings:

  • Area = Item

  • Property type = depending on the market’s requirements

  • Language = German

  • Name = Field of the OTTO category group

  • Group = OTTO Market


Creating a sales price = Creates a sales price and maps this sales price to the data field. You can check and edit this sales price in the Setup » Item » Sales prices menu.

The sales price is created with the following settings:

  • Subscription interval = None

  • Internal name = OTTO Market

  • External name = OTTO Market

  • Minimum quantity = 1

  • Live conversion = No

  • Currency = Euro

  • Display = Always display for new items

  • Client = ALL

  • Class = ALL

  • Country = Germany


Create barcode = Creates the barcode OTTO Market and maps this barcode with the data field. If a barcode with the name OTTO Market already exists in the system, that barcode is mapped instead. You can check and edit this barcode in the Setup » Item » Barcodes menu.

Step Summary
Setting Explanation

Summary

Shows a summary of the catalogue settings. Expand () and check your settings.

8.2. Mapping additional data fields in the catalogue (not in assistant)

You have already mapped important mandatory fields for the OTTO category group in the assistant. However, after you have completed the assistant, you need to map additional data fields to send more information regarding your products to OTTO Market.

Link at least the data fields Brand, Delivery type and Category with a plentymarkets data source.

Mapping additional data fields:

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

  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.
    → On the right are the fields in plentymarkets that you can select as a data source.

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

  4. Optional: 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. Map the desired data fields.

  6. Save () the settings.

8.3. Example: Mapping the data field "Stock"

An example of how to map the data field Stock to item data saved in plentymarkets is provided below. Use the data field Stock to select from which warehouse stock is to be exported to OTTO Market.

Mapping 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 from which you want to export the stock to OTTO Market.

  5. Click on Select ().
    Optional: To transfer stock from multiple warehouses to OTTO Market, click on Add source () and add more warehouses. Note: If you do not map 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.

  6. Save () the settings.

9. Linking sources created in the assistant with variations

If you selected the options Create sales price, Create barcode and/or Create property in the assistant, these prices, barcodes and/or properties are created automatically. You need to link these newly created sources with the variations that you want to export to OTTO Market. This is described on the Item pages of the manual:

  • Learn how to link sales prices to variations in the Linking sales prices chapter.

  • Learn how to link barcodes to variations in the Linking barcodes chapter.

  • Learn how to link properties to variations in the Linking properties and saving a value chapter.
    Tip: Properties created in the assistant are automatically added to the property group OTTO Market of the Setup » Settings » Properties » Groups menu. Open this group to see what new properties need to be mapped.

10. 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. Click on the Variations tab.

  3. Open the variation that should be linked.

  4. Open the Properties tab.

  5. In the Variation properties area, 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 catalogue for the OTTO category group Betten.

  7. Save () the settings.

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

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

Sequence of event procedures

Note that event procedures for OTTO market must be triggered in a specific sequence. First, the event procedure Generate return label must be triggered and afterwards the event procedure Send shipping confirmation to OTTO. If no return label was created, the shipping confirmation cannot be sent to OTTO Market.

11.1. Generating return labels

When OTTO Market orders are imported into your plentymarkets system, return labels must be generated for those orders before the shipping confirmation is sent to OTTO Market. An event procedure for creating a 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 a return label. Return labels can be created with the shipping service provider plugins DHL Retoure Online, GLS Shipping, and Hermes.

Note: At the moment, return labels can be created with DHL, Hermes, and GLS Shipping.

Install plugins

In order to generate return labels, the plugins DHL Retoure Online, Hermes, or GLS Shipping must be installed, activated and set up in your plentymarkets system, depending on which shipping service provider you want to use. You can download the plugins in the plentyMarketplace .

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

In order to create a return label with GLS Shipping, select the procedure Plugins > GLSShipping: Register return label instead. For further information, refer to the GLS Shipping plugin user guide.

With Hermes, return labels cannot be created via event procedures. Before the shipping label for OTTO Market is created, the return label for Hermes must be created via the shipping centre or via a procedure in a process. For further information, refer to the Hermes plugin user guide.

Setting up an event procedure
  1. Go to Setup » Orders » Events.

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

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 2.

  5. Save () the settings.

  6. Carry out the settings according to Table 2 vor.

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

  8. Save () the settings.

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

11.2. Sending shipping confirmations to OTTO

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

Save sender address

Shipping confirmations will only be sent to OTTO Market if the seller’s sender address was saved. You can save the address in the settings of a warehouse under Setup » Stock » Warehouse » Select warehouse » Settings. You have to save the address for the warehouse that is used in the respective order.

Setting up an event procedure
  1. Go to Setup » Orders » Events.

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

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 3.

  5. Save () the settings.

  6. Carry out the settings according to Table 3 vor.

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

  8. Save () the settings.

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)

11.3. Sending order cancellations 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 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 window Create new event procedure opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 4.

  5. Save () the settings.

  6. Carry out the settings according to Table 4 vor.

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

  8. Save () the settings.

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)

11.4. Sending returns to OTTO

In order that OTTO Market accepts the return, you have to create an order of the type Credit note. Set up an event procedure for that.

otto market return credit note
Figure 1. Event procedure to create an order of the type Credit note
Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The window Create new event procedure 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 settings according to Table 5 vor.

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

  8. Save () the settings.

Table 5. Event procedure to create an order of the type Credit note
Setting Option Selection

Event

Select an event, for example Order change: Status change
Note: Select a status that suits your workflow. Select the status [9.11] Send return to OTTO, for example.

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

OTTO Market

Procedure

Order > Create credit note (order)

Set up another event procedure to inform OTTO Market about a return.

otto market accept return
Figure 2. Event procedure to send returns to OTTO Market
Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The window Create new event procedure 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 settings according to Table 6 vor.

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

  8. Save () the settings.

Table 6. Event procedure to send returns to OTTO Market
Setting Option Selection

Event

Select an event, for example Order generation: New credit note.

Filter 1

Order > Order type

Credit note

Filter 2

Order > Referrer

OTTO Market

Procedure

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

Note: The procedure Send return to OTTO triggers a credit note and the buyer receives a refund. The credit note document created by OTTO is automatically attached to the order of the type Credit note.

11.5. Sending return rejections 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 window Create new event procedure 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 settings according to Table 7 vor.

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

  8. Save () the settings.

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

Event

Select an event, for example Order change: Status change
Note: Select a status that suits your workflow. For example, you can create the status [9.12] 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)

12. OTTO Market order management

This chapter informs you how orders are processed at OTTO Market.

12.1. Order import

OTTO Market orders are imported into plentymarkets with status [3] Waiting for payment. After an order was confirmed by OTTO Market, the order changes to status [5] Shipment process started. A payment is created for the order in plentymarkets and the order is marked as paid. If customers paid an OTTO Market order per bank transfer, it might take longer to confirm the order than for other payment methods. In plentymarkets, the payment method is always OTTO Payment.

If customers do not pay for an order, the order will be cancelled by OTTO Market after some time. A cancellation will be sent to plentymarkets. In plentymarkets, the unpaid order automatically changes to status [8] Cancelled.

12.2. Invoice import

Invoices for OTTO Market orders are generated by OTTO Market and automatically imported into plentymarkets after you sent a shipping confirmation to OTTO Market. Shipping confirmations are sent with the event procedure Send shipping confirmation to OTTO. The invoice documents can be accessed in the Receipts tab of the main order after the shipping confirmation was sent. This means that you cannot create invoices for OTTO Market in plentymarkets.

OTTO Market creates invoices as soon as an item was shipped. Therefore, invoices are also created for partial deliveries.

12.3. Credit note import

Credit notes and partial credit notes for OTTO Market orders are generated by OTTO Market and automatically imported into plentymarkets after you sent a returns confirmation to OTTO Market. This returns confirmation is sent with the event procedure Send return to OTTO. Once the return has been confirmed, the credit note documents are available in the Receipts tab of the order.

Because OTTO Markets creates credit notes when the return of an item is confirmed, credit notes are also generated for partial returns.

13. FAQ

  1. Which product title is shown at OTTO Market?

    The product title which is displayed on OTTO Market is composed of the following OTTO Market fields that can be mapped in the catalogue: Brand + Model + Specific characteristics \+ all fields that have the information Namenbildend indicated in parentheses.

  2. Why aren’t my items being exported to OTTO Market?

    You can find out why some of your items are not exported to OTTO Market and therefore are not available on the online market by looking at the following logs.

    1. In the Log, enter Otto itemexport into the Integration drop-down list and select Plenty\\Modules\\Otto\\Item\\Services\\ItemExportService.

    2. In the Level drop-down list, enter both warning and error one after the other.

    3. Open the logs containing the message Variation invalid.
      → In the log, you will receive the variation ID and the reason for the rejection or the missing characteristic.
      Tip: This example shows variation ID 30170 and the missing productDescription.brand. This means that the manufacturer or the brand is missing.

    4. Next, search for the variation listed in the log to make sure that you will find the correct item.
      Tip: The manufacturer can be found in the Global tab of a variation.

    5. In the Audio » Radios catalogue, the brand AudioAffairs is not mapped. This leads to the item being rejected and causes the error message.

    6. Click on Add brand () to add the brand AudioAffairs.

      Table 8. Search terms for OTTO Market in the log
      Search terms OTTO market logs
      Log level
      Variation ID
  3. How can I assign a return package to the correct order in my plentymarkets system?

    An example of a DHL return label is provided below. The label contains all necessary data.

    DHL return label
    Figure 3. DHL return label
  4. How do I find OTTO Market orders in my plentymarkets system?

    As this question frequently arises in the plentymarkets forum, a short explanation is provided below.

    The PositionID (example: 715e9369-01e3-4d09-ae91-8688dfa139b2) and the SalesOrderID (example: 4245eac7-4647-4f76-8c48-261afb19aa96) are frequently mentioned in the plentymarkets forum. However, these IDs are not relevant for you as seller. You cannot see these IDs. They serve to identify an order and the order positions in the plentymarkets database.

    Orders with the order referrer OTTO Market receive the usual order ID from your plentymarkets system. However, to identify the order, an external order number is saved for the order. With this number, the order can be clearly assigned.

    Screenshots illustrating how OTTO Market orders are created in plentymarkets and in the Mein Konto (My account) area at OTTO Market are provided below.

    OTTO market order number
    Figure 4. "Mein Konto” (My account) area at OTTO Market

    The order number is saved as external order number at the order in plentymarkets.

    Find a screenshot of the menu for searching the order with the external order number below:

    Search external order number
    Figure 5. Searching for the external order number

    The external order number can be found in the Settings tab of an order (Ext. order number).

    If customers have further questions concerning an order, you can find an order by searching for the external order number.

    Additionally, you can use the Referrer filter to filter OTTO Market orders.

  5. The log shows an error. How can I solve this error?

    • Duplicate entry. Combination of the fields variationId, marketId and accountId must be unique.

      This error is also indicated as “SKU 1234 not generated” in the log.

      How SKUs should be generated is defined in the catalogue. There is a distinction between the Parent SKU and the Variation SKU. The source selected here should be a data record which exists only once. Hence, it is not possible to use the same SKU for different items. For example, you could use the Item ID and the Variation ID. Both IDs are generated when the item is created in plentymarkets and only exist once. However, it might happen that the item export is carried out with errors because of missing information in the catalogue. The SKU is created anyway and can now be found in the Availability tab of a variation. During the next export, your plentymarkets system will try again to create an SKU from the sources selected in the catalogue. However, as this SKU already exists, the error “Duplicate entry. Combination of the fields variationId, marketId and accountId must be unique." / “SKU 1234 not generated.” occurs.

      Therefore it is necessary to add a fallback solution in the catalogue. The solution looks like this:

      Add source
      Figure 6. Add source
      Add source

      When adding another source, it is mandatory to use the Add source button () on the right-hand side of the catalogue. Do not use the + Additional source button () because in this case, your SKUs would be created twice and the error could not be solved.

      A second source is added. During the next export, the first source will be retrieved first. As the SKU is already included in this source, the second source will be ignored. If the first source does not contain an SKU, then a new SKU will be generated using the second source.

    • Code: 200009 - ATTRIBUTE_CHANGE_DENIED or title: Der Wert dieses Feldes kann nicht geändert werden. (title: The value of this field cannot be changed.)

      These errors indicate that you changed an OTTO item attribute. However, OTTO does not accept the change and it is not possible the change the attribute for this item. The indicated attribute can relate to a variation attribute or a title attribute. Other OTTO attributes are important here, too.

      Items cannot be deleted at OTTO Market

      An item cannot be deleted at OTTO Market, neither by plentymarkets nor by OTTO. It is only possible to mark the item as not available at OTTO Market. Therefore, you should always make sure that the correct sources are mapped in the catalogue prior to transferring your items.

    • productDescription.brand

      This error indicates that the variation’s brand that should be exported has not been mapped in the catalogue. The brand can be linked to the variation in two different ways:

    • via the Manufacturer setting in an item’s Global tab

    • via property

      Make sure that a source is saved for the brand in the catalogue and that the source is linked to the item.

    • mediaAssets.IMAGE

      This error indicates that either you did not select an image source in the catalogue or that none of your item images is linked to the referrer OTTO Market. To do so, open an item’s Images tab and activate the referrer OTTO market as described in the Setting the availability for images chapter.

    • delivery.type

      This error indicates that the shipping method is not linked. The shipping method can be defined via two different sources:

    • via a shipping profile

    • via property

      Make sure that the source saved in the catalogue is linked to the item. For the shipping profile, activate the shipping profile in the item’s Global tab. For the property, activate the property for the desired variation.

    • productDescription.category

      This error indicates that the category mapping in the catalogue is missing. In the catalogue, check whether at least one category of the desired variation is linked to an OTTO Market category.

    • Error messages concerning order processing: Carrier ID (X) not mapped in OTTO market config.

      Check whether shipping service providers were linked to OTTO Market. This is done in the Shipping service provider step of the OTTO Market Basic settings assistant in the Setup » Assistants » Omni-Channel menu.

To top