Setting up real.de
real.de is one of the largest fixed price markets in Germany. You can sell items from various product categories on real.de. Real.de also processes payments for you. In other words, you are neither charged with payment costs nor do you have to worry about debt collection.
How to set up the market real.de in plentymarkets is described in this video tutorial:
1. Registering with real.de
In order to use the real.de interface, you have to register your real.de user account as a seller account. To do so, go to the real.de website and save your VAT number in the Mein Konto (My account) area.
2. Setting up real.de in plentymarkets
Set up real.de in plentymarkets to offer items on real.de. In order to set up real.de in plentymarkets, you need your real.de interface access data. You can set up a real.de account for each plentyShop or client (store).
Setting up the access to real.de:
-
Go to Setup » Markets » real.de » Settings.
-
Open the submenu of the plentyShop that you would like to set up access for.
-
Carry out the settings. Pay attention to the explanations given in Table 1.
-
Save () the settings.
Setting | Explanation |
---|---|
Activate interface to real.de |
|
API data |
|
Client Key |
Enter the client key that you received from real.de. |
Secret Key |
Enter the secret key that you received from real.de. |
Order settings |
|
Book incoming payment |
This setting applies to the order import. Orders are imported either as paid or not paid. Regardless of this setting, items will immediately be cleared for shipping when they have sufficient stock. With the option open, you could also set the order to paid when the actual incoming payment from real.de is received. In this way, real.de can be tested. |
Match shipping service providers |
After the shipment has been confirmed, this option allows real.de to use the package number in order to send the customer an email with the correct tracking link. |
Item settings |
|
Activate item export |
Select whether the item export to real.de should be activated. |
Export only items with flags |
|
Image position of the energy efficiency label |
Enter the position of the energy efficiency label. Every image that should be transferred as an energy efficiency label must have this position. |
Add technical data to the item description |
Select whether the technical data saved in the Texts tab of an item should be added to the item description for real.de. Yes is selected by default. |
Generate item file |
This option creates an item file. This file can be viewed via Item file preview. |
Item file preview |
Display the item file preview. |
Send item file to real.de |
Send the item file to real.de. |
Offer settings |
|
Activate offer update |
|
Generate cache file (Inventory) |
Select Yes or No.
Note: We recommend using the option Yes because bigger stock changes may result in errors. |
Warehouse |
Select the warehouses from which stock should be transferred to real.de. Select one warehouse or Total in all warehouses.
|
Item quantity for items that are not limited to stock |
Items for which no limitation has been selected in the Stock tab of an item are offered on real.de with the quantity entered here. As soon as an item has been sold, the quantity saved here is newly transmitted for sale at the next full hour. |
Minimum price |
Select the minimum price, i.e. the lowest price that the item should be offered for. |
Comments on items |
Set up free text fields for item comments here or assign this function to the Global item comment field. |
Global item comment |
Enter text. The entered text is displayed with every offer. |
Linking shipping profiles |
This option enables you to link the real.de shipping groups to the plentymarkets shipping profiles. If an item has more than one shipping profile, the shipping profile with the lowest category and the highest priority is exported. The category and the priority of a shipping profile are configured within Setup » Orders » Shipping » Settings » Tab: Shipping profiles in the Base tab of each shipping profile. |
Export item availabilities |
Select whether item availabilities should be transferred to real.de. |
Match item availabilities |
Match plentymarkets item availabilities with a minimum and maximum delivery time in working days. |
Generate offer file |
This option creates an offer file. This file can be viewed via Preview offer file. |
Preview offer file |
Display the offer file preview. |
Send offer file to real.de |
Send the offer file to real.de. |
Setting up real.de in plentymarkets allows for the following automatic processes to take place:
-
hourly stock and price synchronisation
-
daily item export (only for items which have been changed within the last 26 hours)
-
hourly order import
-
hourly transfer of the flag Sent to real.de
→ Sent is transferred after the outgoing items have been booked. -
export of surcharges for attribute values (item variations)
-
transfer of the description text saved in the Texts tab
-
transfer of the technical data selected in table 1
-
image export selected in the item’s Images tab
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 real.de. Go to Setup » Orders » Order referrer to activate the order referrer.
Activating the order referrer for real.de:
-
Go to Setup » Orders » Order referrer.
-
Activate the option real.de.
-
Save () the settings.
Do not group real.de orders
During the order import, real.de orders are synchronised by the external order number. However, because the external order number does not exist any longer in a grouped order, grouping orders might result in orders being created anew when they are retrieved again. |
4. Setting the variation availability
You need to activate the variations that you want to sell on real.de. This is done in the Availability tab of a variation within the Item » Edit item » [Open item] » Tab: Variation ID menu.
Making a variation available for real.de:
-
Go to Item » Edit item » [Open item] » Tab: Variation ID » Tab: Settings.
-
Open the variation that you want to sell on real.de.
Tip: To sell all variations of an item on real.de, carry out the settings for the item’s main variation. This activates the availability of all variations of the item. -
In the Availability area, activate the option Active.
-
Click on the Availability tab.
-
In the Markets area, click in the selection field.
→ A list of all available markets is displayed. -
Activate the option real.de.
-
Activate the option Web API.
-
Click on Add ().
→ The market is added. -
Save () the settings.
→ The variation is available for real.de.
The variation group function allows you to edit several variations at once. You select the variations that you want to edit.
Making several variations available for real.de using the variation group function:
-
Go to Item » Edit item.
-
Set the filter Table type to Variations.
-
Choose additional filters on the left if needed and click on Search ().
-
Select () the variations to be edited from the overview on the right.
-
Click on Variation group function.
→ The Variation group function window opens. -
Navigate to the area Market availability.
-
Activate the checkbox to the left of the option real.de.
-
Activate the checkbox to the right of the option real.de.
-
Activate the checkbox to the left of the option Web API.
-
Activate the checkbox to the right of the option Web API.
-
Navigate to the area Availability.
-
Activate the checkbox to the left of the option Active.
-
Activate the checkbox to the right of the option Active.
-
Click on 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 real.de using batch processing:
-
Go to Item » Batch processing.
-
Click on the tab Variations in the upper left corner.
-
Use the filters on the left to specify which variations should be processed.
-
Navigate to the area Market availability.
-
Activate the checkbox to the left of the option real.de.
-
Activate the checkbox to the right of the option real.de.
-
Activate the checkbox to the left of the option Web API.
-
Activate the checkbox to the right of the option Web API.
-
Navigate to the area Availability.
-
Activate the checkbox to the left of the option Active.
-
Activate the checkbox to the right of the option Active.
-
Click on Apply to apply the settings to the variations.
5. 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.
-
Go to Item » Edit item » [Open item] » [Open variation] » Tab: Settings.
-
Click on the Availability tab.
-
In the SKU area, click on Add ().
→ The New SKU window opens. -
Select the referrer real.de.
-
Select the corresponding marketplace account.
-
Enter the SKU.
-
Click on Add ().
→ The SKU is saved and displayed.
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 plentymarkets first. |
Column in CSV file | Explanation | plentymarkets data field for mapping |
---|---|---|
Variation ID |
Enter the variation ID in this column. |
Variation ID |
Market ID |
Enter the referrer ID 102 in this column. |
SKU > Marketplace ID |
Account ID |
Enter the plenty ID of the client in this column. |
SKU > Marketplace ID |
SKU |
Enter the SKU that you want to save for the variation for this market in this column. |
SKU > SKU |
6. Defining a sales price
Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel. That means that to sell variations on real.de, you need a sales price in which the order referrer real.de is activated. The price that you save for this sales price is the price that will be shown on real.de.
Defining a sales price for real.de:
-
Go to Setup » Item » Sales prices » [Open sales price].
Tip: No sales prices? Then create a new sales price first. -
Open the Settings tab.
-
Activate the referrer real.de.
-
Save () the settings.
7. Defining the barcode
Proceed as described below to define a barcode for the order referrer real.de. This barcode is transferred to real.de for the variation.
Defining a barcode for real.de:
-
Go to Setup » Item » Barcode.
-
Open the barcode.
-
Activate the referrer real.de.
-
Save () the settings.
Afterwards, link the barcode with the desired variations if you have not done so.
8. Preparing variations
real.de specifies some mandatory information. That means that a variation only can be exported to the market if this mandatory information is saved for the variation. For a functioning export to real.de, the variation has to conform with the following requirements:
-
A EAN or an ISBN
If the information listed above is not saved, the variation is not exported.
9. Activating characteristics for the market
To use characteristics for real.de, each characteristic must be activated for the market.
Activating characteristic for the market:
-
Go to Setup » Item » Characteristics.
-
Expand the characteristic ().
-
Activate the option real.de.
-
Save () the settings.
-
Repeat this for all characteristics that you need for the market.
9.1. Linking plentymarkets characteristics with real.de attributes
It is possible to overwrite attributes with plentymarkets characteristics or to add real.de attributes.
Important: In order for the plentymarkets characteristics to be correctly assigned during the real.de export, the internal name of the plentymarkets characteristic must be the same as the column header in the real.de Product.csv file.
The real.de attributes EAN, title, description, manufacturer and picture are mandatory entries for the item export. These attributes are transferred by plentymarkets by default. These attributes can only be overwritten by an attribute. Other attributes, such as "material_composition", "clothing_size" or "weight” can be added if a corresponding characteristic is created in plentymarkets.
Mandatory entries for the item export
The real.de attributes ean, title, description, manufacturer and picture are mandatory entries for the item export. |
Creating a characteristic:
-
Go to Setup » Item » Characteristics.
-
Click on the New characteristic tab.
-
Enter the name of the real.de attribute into the Name (internal) field.
→ The entered name is displayed in the item data record when linking characteristics. -
Enter a name in the Webshop field.
→ This name is used in the item overview of the plentyShop. -
Select the Characteristic type.
-
Activate the option real.de.
-
Save () the settings.
For further information about linking characteristics with real.de, refer to the Linking characteristics to attributes best practice page.
10. Linking categories
Link your plentymarkets categories to the real.de categories in order to display your items in these categories. Further items from the linked category are assigned automatically.
Linking categories:
-
Go to Setup » Markets » real.de » Category link.
-
Click on Search ().
→ The Select category window opens. -
Select the real.de category that best matches your plentymarkets category.
-
Click on Apply.
→ The ID and category path of the real.de category are displayed. -
If you already know the ID of the real.de category, enter it directly into the Market category field to link it to your plentymarkets category.
-
Save () the settings.
Subcategories do not have to be linked
In some cases, your subcategories may not match the real.de subcategories. In this case, link your items with real.de’s corresponding main category. real.de automatically assigns your items to a subcategory. You should not transfer items to real.de that have not been assigned to a real.de category. |
11. Activating the payment method
Activate the payment method real.de Payment as described below.
Activating the payment method real.de Payment:
-
Go to Setup » Orders » Payment » Methods.
-
Activate the option Also show inactive.
-
Open the folder DE.
-
Click on real.de Payment.
→ The Settings tab opens. -
Carry out the settings. Pay attention to the information given in [table-payment-method].
-
Place a check mark next to the option Active.
-
Save () the settings.
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 plentyShop. |
Name |
Enter the name that should be displayed in the plentyShop 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. |
Client (store) |
Do not select a client. |
Logo |
Select one of the following options for displaying the logo:
|
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. |
Priority |
Select the priority for displaying the payment method in the plentyShop. |
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. |
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 Managing payment methods page.
12. Editing the invoice
You have to modify the invoices for real.de. Two adjustments have to be made:
-
Enter a note for the payment method real.de Payment.
-
Your bank details must not appear on the invoice.
How to carry out these adjustments is described below.
12.1. Entering a note for the payment method real.de:
The following note must appear on real.de invoices:
Note for real.de invoices
Achtung! Bitte veranlassen Sie keine Zahlungen auf unser Konto. Die Bezahlung erfolgt an die real,- Digital Payment & Technology Services GmbH. Sollten Sie per Klarna bezahlt haben, erhalten Sie eine separate Zahlungsanweisung von Klarna. Für weitere Informationen zu Klarna besuchen Sie link:https://www.klarna.com/de/[www.klarna.de^]{nbsp}icon:external-link[]. |
Entering a note for the payment method real.de:
-
Go to Setup » Client » Standard » Locations » Germany (standard) » Documents » Invoice » Tab: Template.
-
In the Optional elements below stock unit table area, enter the note given above for the Payment instruction option for the payment method real.de Payment.
-
Save () the settings.
→ The note only appears on the invoices for orders with the payment method real.de Payment.
12.2. Hiding bank details on real.de invoices
The payment is processed via real.de. To prevent customers from paying money directly to you, do not enter bank details on invoices for real.de.
If you use a PDF template to display your bank details on an invoice, then create another PDF template for real.de that does not contain bank details. You can also save the real.de logo for this PDF template. To save this PDF template for the payment method real.de Payment, go to Setup » Client » Standard » Locations » Germany (standard) » Documents » Invoice » Tab: PDF template. Your bank details are not displayed on invoices for real.de.

Displaying bank details with payment instructions
If you entered your bank details in the Setup » Client » Standard » Locations » Germany (standard) » Documents » Invoice » Tab: Template menu for the Payment instruction option, then you do not need to carry out any further settings. If you use this method, your bank details are not displayed on real.de invoices. |
13. Automatically creating invoices
Set up an event procedure to automatically create invoices for real.de.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 4.
-
Save () the settings.
-
Carry out the settings according to Table 4.
-
Place a check mark next to the option Active ().
-
Save () the settings.
Note: The data is not transferred in real time when the event procedure is triggered. Instead, the data is registered in a queue. As such, transferring the data can take up to several minutes if a large number of jobs need to processed. On the plus side, this means that several retries will be performed if the target server is throttled or not responding.
Status and filters for the event procedure
The status and filters listed in [creating-invoices-real] only serve as an example for creating an event procedure. Select filters and statuses for the event procedure which best suit your work flow. |
Setting | Option | Selection |
---|---|---|
Event |
Status change: [7] Outgoing items booked |
|
Filter 1 |
Order > Order type |
Order |
Filter 2 |
Order > Referrer |
real.de |
Procedure |
Documents > Generate invoice |
14. Automatically uploading invoices
Set up an event procedure to automatically upload invoices to real.de.
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 5.
-
Save () the settings.
-
Carry out the settings according to Table 5.
-
Place a check mark next to the option Active ().
-
Save () the settings.
Note: The data is not transferred in real time when the event procedure is triggered. Instead, the data is registered in a queue. As such, transferring the data can take up to several minutes if a large number of jobs need to processed. On the plus side, this means that several retries will be performed if the target server is throttled or not responding.
Status and filters for the event procedure
The statuses and filters in Table 5 only serve as an example for creating an event procedure. Select filters and statuses for the event procedure which best suit your work flow. |
Setting | Option | Selection |
---|---|---|
Event |
Select an event, for example Order change: Status change, Order: Invoice generated |
|
Filter |
Order > Referrer |
real.de |
Procedure |
Order > Upload invoice to real.de |
15. Automatically sending cancellations
Set up an event procedure to automatically inform real.de of cancellations. Whenever you are dealing with cancellations, you need to send real.de a reason for the cancellation. Open the Setup » Orders » Status menu and create additional order statuses as needed. The following cancellation reasons can be transferred to real.de:
-
Exchange by customer
-
Cancellation by customer
-
Wrong delivery address
-
Wrong item description
-
Customer did not receive goods
-
Item out of stock
-
Wrong sales price
-
No delivery to this delivery address
-
Other reason
-
Go to Setup » Orders » Events.
-
Click on Add event procedure ().
→ The Create new event procedure window opens. -
Enter a distinct name for the event procedure.
-
Select the event according to Table 6.
-
Save () the settings.
-
Carry out the settings according to Table 6.
-
Place a check mark next to the option Active ().
-
Save () the settings.
Note: The data is not transferred in real time when the event procedure is triggered. Instead, the data is registered in a queue. As such, transferring the data can take up to several minutes if a large number of jobs need to processed. On the plus side, this means that several retries will be performed if the target server is throttled or not responding.
Setting | Option | Selection |
---|---|---|
Event |
Status change: Status [8] Cancelled |
|
Filter 1 |
Order > Order type |
Order |
Filter 2 |
Order > Referrer |
real.de |
Procedure |
Order > Send cancellation to real.de |
Select a reason. |
Returns for real.de
Returns for real.de
Unlike other marketplaces, you cannot send returns to real.de with an event procedure via plentymarkets yet. Process returns for real.de directly in your real.de seller account. |
16. Viewing the log
The Data » Log menu contains a history of processes that run via the real.de interface. For real.de, the following filters are recommended:
-
Identifikator » real.de
Integrations and identifiers are only shown in the drop-down lists after the process has run at least once. |
-
Go to Data » Log.
-
In the column to the left, select appropriate filters from the drop-down lists.
-
Optional: Select filters for dates and/or times to only show entries from a specific period.
Tip: For further information about the filters, refer to the Data log page of the manual. -
Click on Search ().
→ The results are shown. -
Check all entries for the levels warning and error.
Tip: Click on the entry to see details.
Use the reference types and reference values in Table 7 to filter the search results.
Reference type | Explanation | Reference value |
---|---|---|
action |
Filters by events. |
Select a reference type to filter for specific events.
|
orderId |
Filters by the order ID of the order in plentymarkets. |
|
externalOrderId |
Filters by the real.de order number of the order. |
|
externalOrderItemId |
Filters by the ID of the real.de order item. |