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:

Setting up real.de in plentymarkets

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 online store or client (store).

Setting up the access to real.de:

Go to Setup » Markets » real.de » Settings.
Open the submenu of the online store 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.

Table 1. Settings for the market real.de
Setting	Explanation
Activate interface to real.de	Yes = Activate the interface to real.de. No = Do not activate the 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. *Important:* You have to assign each of your service providers to one of the service providers from the drop-down list.
Item settings
Activate item export	Select whether the item export to real.de should be activated.
Export only items with flags	All items = All items are exported. All items with flag 1 or 2 = Only items with this flag are exported. All items without flag 1 or 2 = Only items without this flag are exported. Select one particular flag = Only items with this flag are exported. This setting applies to item data and order data.
Image position of the energy efficiency label	Enter the position. 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. *Note:* If you have not fully set up the interface to real.de but want to take a look at the item file preview, then you have to activate the interface temporarily. Otherwise, the item file preview will be empty. In order to view the item file preview when the interface is not active, activate the interface and click on Item file preview (). Deactivate the interface immediately afterwards by selecting the option No for the Activate interface to real.de setting and saving the setting. This way, you can prevent items from being transferred too soon.
Send item file to real.de	Send the item file to real.de.
Offer settings
Activate offer update	Yes (default setting) = Offers are updated once per hour and once per day at real.de. Only if both this option and the option Activate interface to real.de are activated, the daily complete offer update and the hourly update for offers that were changed is executed. No = The offer update is deactivated.
Generate cache file (Inventory)	Select Yes or No. Yes = Stock is saved in the cache on a daily basis. No = Stock is not saved in the cache. *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. Total in all warehouses = The stock from all distribution warehouses is added up and transferred.
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. A minimum price must be saved for the item for the selected price. The minimum price must be released for the referrer real.de. *Important:* The minimum price does not apply to item variations which have surcharges for attributes. In this case, deactivate this option. If you would like to use the minimum price, then create each variation as a separate item with a defined minimum price.
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. *Important:* If the shipping groups are changed on real.de, you can update them by clicking on Update shipping groups.
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. Enter the minimum and maximum delivery time in working days into the Minimum delivery time (in working days) and Maximum delivery time (in working days) fields that match the plentymarkets item availability. *Note:* real specifies Monday to Friday as working days. The plentymarkets availability IDs 1-10 correspond to the item availabilities defined in the Setup » Item » Availability menu.
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 all 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.

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

5. Defining SKU manually

Add SKUs manually for specific referrers in the Item » Edit item » Open item » Tab: Variation ID » Tab: Availability menu if needed.

Adding SKU:

Go to Item » Edit item » Open item » Tab: Variation ID » 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.

6. Defining a sales price

Proceed as described below to define a sales price for the order referrer real.de. This price is displayed on real.de.

Defining a sales price for real.de:

Go to Setup » Item » Sales prices » Open sales price » Tab: Settings.
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 online store.
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 online store 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 online store 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 online store 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.

Table 2. 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. We recommend using the name Payment via real.de because this name appears on the invoice.
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.
Client (store)	Do not select a client. 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 choice 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.

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 data 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 data on real.de invoices

The payment is processed via real.de. To prevent customers from paying money directly to you, do not enter bank data on invoices for real.de.

If you use a PDF template to display your bank data on an invoice, then create another PDF template for real.de that does not contain bank data. 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 data is not displayed on invoices for real.de.

Figure 1. real.de logo

Displaying bank data with payment instructions

If you entered your bank data 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 data is not displayed on real.de invoices.

13. Automatically creating invoices

Set up an event procedure to automatically create invoices for real.de.

Setting up an event procedure

Go to Setup » Orders » Events.
Click on Add event procedure ().
→ The window Create new event procedure opens.
Enter a distinct name for the event procedure.
Select the event according to Table 3.
Save () the settings.
Carry out the settings according to Table 3 vor.
Place a check mark next to the option Active ().
Save () the settings.

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.

Table 3. Event procedure for automatically creating invoices for real.de
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.

Setting up an event procedure

Go to Setup » Orders » Events.
Click on Add event procedure ().
→ The window Create new event procedure 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 vor.
Place a check mark next to the option Active ().
Save () the settings.

Status and filters for the event procedure

The statuses and filters in Table 4 only serve as an example for creating an event procedure. Select filters and statuses for the event procedure which best suit your work flow.

Table 4. Event procedure for automatically uploading invoices to real.de
Setting	Option	Selection
Event	Select an event, for example Order change: Status change, Documents: Invoice generated
Filter	Order > Referrer	real.de
Procedure	Documents > 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

Setting up an event procedure

Go to Setup » Orders » Events.
Click on Add event procedure ().
→ The window Create new event procedure 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 vor.
Place a check mark next to the option Active ().
Save () the settings.

Table 5. Event procedure for automatically sending cancellations to real.de
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

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, you can filter by the identifier real.de.

Viewing the log:

Go to Data » Log.
From the drop-down list Identifier, select the option real.de.
Optional: Select a date if you only want to see entries for a specific day.
Click on Search ().
→ The results are shown.

Use the following reference types and reference values to filter the search results.

Table 6. Reference types and reference values for real.de
Reference type	Explanation	Reference value
action	Filters by events.	Select a reference type to filter for specific events. CancelOrder = Log entries for the event action Send cancellation to real.de
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.