Skip to main content

idealo Checkout

On this page, you will find information about the settings you need to carry out in order to set up the market idealo Checkout in plentymarkets. Learn how to set up the interface, how to export items to idealo and how to define sales prices.

1. Registering with idealo

You need to register with idealo before setting up idealo in plentymarkets. Please note that the website is currently only available in German.

2. Setting up idealo in plentymarkets

Carry out the following settings in plentymarkets in order to set up the interface to idealo.

Setting up idealo:

  1. Go to System » Markets » idealo Checkout.

  2. Activate the automatic data exchange.

  3. Enter the API key as received from idealo.

  4. Save the settings.

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

  • hourly order synchronisation

3. Activating an order referrer

In order to link items, properties etc. with idealo you have to activate the order referrer idealo Checkout in the menu System » Orders » Order referrer.

Activating the order referrer for idealo Checkout:

  1. Go to System » Orders » Order referrer.

  2. Place a check mark next to the option idealo Checkout.

  3. Save the settings.

4. Setting the item availability

Items that you want to sell on idealo have to be available for idealo Checkout. This is done in the Availability tab of an item within the Item » Edit item » Open item » Tab: Variation ID menu. Activate the item availability as described below.

Setting the item availability for idealo:

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

  2. Activate the main variation in the Availability section.

  3. Click on the Availability tab.

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

  5. Activate the option idealo.

  6. Activate the option Web API.

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

  8. Save the settings.

The availability for variations can be individually edited in the Item » Edit item » Open item » Tab: Variations » Open variation » Tab: Variation ID » Tab: Availability menu.

5. Defining a sales price

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

Defining a sales price for idealo:

  1. Open the menu System » Item » Sales prices » Open sales price » Tab: Settings.

  2. Place a check mark next to the referrer idealo.

  3. Save the settings.

6. Defining SKU manually

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

Adding SKU:

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

  2. Click on the Availability tab.

  3. Click on Add in the section SKU.
    → The window New SKU is displayed.

  4. Select the referrer idealo.

  5. Enter the SKU.

  6. Click on Add.
    → The SKU is saved and displayed.

7. Setting up a shipping company as shipping method

If the order is carried out by a forwarding company, the customer has to enter his phone number during the order process in order to arrange a delivery date. The shipping method shipping company is transferred as a property to idealo Checkout. Proceed as described below to create the property FulfillmentType.

Creating a property for the shipping method shipping company:

  1. Go to System » Item » Properties » Tab: New property.

  2. Enter the Name (internal).

  3. Select the option Text from the property type drop-down list.

  4. Select the property FulfillmentType for idealo Direktkauf property.

  5. Save the settings.

Next, you have to link the property to the item in the Item » Edit item » Open item » Open variation » Tab: Properties menu. Then set up the item export as described below.

For items which have the shipping method shipping company, it is also possible to transfer the additional services TwoManHandlingPrice and DisposalPrice to idealo Checkout. DisposalPrice can only be used in combination with the TwoManHandlingPrice. That means you have to create the property TwoManHandlingPrice as well as the property DisposalPrice and link them to the item. In both cases, select Text as the property type. Go to Item » Edit item » Open item » Open variation » Tab: Properties and enter the surcharge for the additional service with two decimal places behind the decimal separator. Use a period for the decimal separator (19.99).

8. Setting up the item export

The item export for idealo is carried out by the elastic export. The data format IdealoDE is used for this. Therefore, the plugins ElasticExport and ElasticExportIdealoDE have to be installed. First, create the data format IdealoDE. Then transfer the URL to idealo.

Setting up the item export:

  1. Go to Data » Elastic export.

  2. Click on New export.

  3. Carry out the settings. Pay attention to the information given in table 1.

  4. Carry out further settings for item filters and format settings. Pay attention to the information given in table 5 on the Exporting data page of the manual .

  5. Save the settings.
    → The export format is given an ID and it appears in the overview within the Exports tab.

Table 1. Settings for the item export
Setting Explanation

Settings

Name

Enter a name. The export format is listed by this name in the overview within the Exports tab.

Type

Select the type Item from the drop-down list.

Format

Select the format IdealoDE from the drop-down list.

Limit

Enter a number. If you want to transfer more than 10,000 data records to idealo, then the output file will not be generated again for another 24 hours. This is to save resources.

Provisioning

Select URL.

Token,
URL

If you have selected the option URL under Provisioning, then click on Generate token. The token is entered automatically. The URL is entered automatically if the token was generated under Token. Give this URL to idealo in order to export the items.

9. Activating payment methods

Activate the payment method idealo Checkout. This allows payments to be made for orders on idealo and displayed in your plentymarkets system.

Activating idealo payment methods:

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

  2. Place a check mark next to the setting Also show inactive.

  3. Open the folder DE > idealo Checkout.

  4. Select the idealo payment method idealo Checkout.
    → The Settings tab opens.

  5. Carry out the settings. Pay attention to the information given in table 2.

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

  7. 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 makes it possible to enter values for these options in various languages. The values for a language will be 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 have selected the option Info page (external) 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 configured.

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 has been selected from the Logo drop-down list, then the logo that has been uploaded is displayed here.

Upload logo

If Show upload logo has been selected from the Logo drop-down list, 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 the 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 of the manual.

Permitting the payment method in customer classes

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

For further information, refer to the Payment methods page of the manual.

PayPal payment method

If you offer the PayPal payment method, it is mandatory to create and configure this payment method in your plentymarkets system. This is to ensure that the payment is imported correctly and assigned to the order.

10. Automatically sending order confirmations

Set up an event procedure to automatically send an order confirmation to idealo.

Setting up an event procedure
  1. Go to System » 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.

  6. Carry out the settings. Pay attention to the explanations given in table 3.

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

  8. Save the settings.

Table 3. Event procedure for sending automatic order confirmations to idealo
Setting Option Selection

Event

Order generation: New order

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

idealo

Procedure

Order > Send order confirmation to idealo

11. Automatically sending shipping confirmations

Set up an event procedure to automatically send a shipping confirmation to idealo when the outgoing items have been booked.

Setting up an event procedure
  1. Go to System » 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.

  6. Carry out the settings. Pay attention to the explanations given in table 4.

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

  8. Save the settings.

Table 4. Event procedure for sending automatic shipping confirmations to idealo
Setting Option Selection

Event

Order change: Outgoing items booked

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

idealo

Procedure

Shipping > Send shipping confirmation to idealo

12. Automatically sending returns

Set up an event procedure to automatically inform idealo about returns.

Setting up an event procedure
  1. Go to System » 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.

  6. Carry out the settings. Pay attention to the explanations given in table 5.

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

  8. Save the settings.

Table 5. Event procedure for sending automatic returns to idealo
Setting Option Selection

Event

Order generation: New return

Filter 1

Order > Order type

Return

Filter 2

Order > Referrer

idealo

Procedure

Returns > Send return to idealo

13. Automatically sending cancellations

Set up an event procedure to automatically inform idealo of cancellations.

Setting up an event procedure
  1. Go to System » 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.

  6. Carry out the settings. Pay attention to the information given in table 6.

  7. Select a reason for the cancellation.

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

  9. Save the settings.

Table 6. Event procedure for automatically sending cancellations to idealo
Setting Option Selection

Event

Status change: [8] Cancelled

Filter 1

Order > Order type

Order

Filter 2

Order > Referrer

idealo

Procedure

Order > Send cancellation to idealo

14. Viewing the API log

The menu Data » API log » Tab: API log contains a history of processes that run via the idealo interface. The idealoDirektkauf format is available for idealo.

Viewing the API log:

  1. Go to Data » API log » Tab: API log.

  2. Select the format idealoDirektkauf from the Process drop-down list.

  3. Select a date if you only want to see entries for a specific day.

  4. Select the number of results per page.

  5. Click on Search to display the results.

To top