Technical integration

Exported product feed & API

 

Overview

Which software interfaces does idealo offer?

To use idealo’s price comparison services on idealo, please send your product and offer data to idealo either via an exported data feed (e.g. in CSV format) or alternatively via idealo’s API for product data (i.e. in Real-Time API).

Selling internationally: in Germany, you can also sell your products via idealo’s Direct Checkout, where the entire purchase takes place on the idealo platform. You can retrieve your idealo Direct Checkout orders via the API for order data (aka. idealo REST Order API). This interface is also used to send idealo notifications about order dispatches or any cancellations.

Overview of idealo’s interfaces:

  • For idealo’s price comparison services on idealo – an exported product feed (e.g. a CSV file) or the API for product data (i.e. in realtime)
  • For selling internationally – idealo’s API for order data (aka. idealo REST Order API)

Sending your product and offer to idealo:

Sending your product information to idealo is done via an exported feed (in CSV, TXT or XML format) or via idealo’s API for product data.

Exported feeds (CSV, TXT or XML format) are usually updated every 30 minutes from idealo’s side.
Via the API for product data method, you can update your prices and availability information in real time.

Many eCommerce systems already come with an integrated solution that you can use to help set yourself up on idealo’s price comparison service. Alternatively, you can easily implement this function via an additional module.

Option 1 – Exported feed (CSV, TXT or XML format)

You can provide an exported feed, created via your eCommerce system, onto a FTP or web server (HTTP).

To keep loading times and costs down, you may transfer your exported feeds in compressed ZIP or gZIP format. We also support password-protected directories.

How often should I update my exported feed?

Please update the feed several times a day. This is the only way to ensure that idealo’s users will see your up-to-date prices and availability information. This also helps prevent any overselling, or customer disappointment if the prices in your webshop differ from the information seen on idealo.

Option 2 – API for product data

idealo can provide you with a web service that allows you to update your product and offer data in near real-time. The web service is addressed via HTTPS and uses JSON as the exchange format. The documentation of the REST API for offer data (idealo PWS 2.0) can be found here:

Selling internationally: Managing your idealo Direct Checkout orders for Germany:

The following information only applies to you if you are looking to sell your products in Germany via idealo’s Direct Checkout feature (where the entire purchase takes place on the idealo platform):

Required: You can use your exported product feed or the API for product data to specify which of your products you would like to set up on idealo’s Direct Checkout, and to send idealo stock quantities and special delivery options (e.g. delivery by freight forwarder) for these products. If these fields / values are missing from all of your products, your entire inventory will be set up on idealo’s Direct Checkout.

You can retrieve your idealo Direct Checkout orders via the API for order data (aka. idealo REST Order API). You can also retrieve the idealo shipping and order status information
via the same interface.

The REST Order API is called up via HTTPS and uses JSON as an interchange format. All operations are implemented in such a way that they can be re-initiated if a call-up is unsuccessful.

Retrieving your idealo Direct Checkout orders:

You can retrieve any new orders via the REST API and confirm receipt of these by returning an order number (as created by your system). It is only possible to retrieve new orders once – a call-up of any other order, including those already received by your eCommerce system, is not currently possible.

For each order, idealo will send the shopping basket details, with the prices valid at the time of purchase. We will also send the invoice and delivery addresses, additional contact details, payment and delivery types, delivery promise information and the customer’s chosen delivery option.

Please ensure that you configure your sales tax rates yourself within your system(s), 
as idealo does not have comprehensive knowledge of your tax duties.

Will the payment status also be sent?

Payment status information is called up via the interfaces of the respective payment service providers, and therefore is not covered by the API for order data. However, the corresponding transaction ID from the payment service provider will be provided via the API, so that your system can allocate payment transactions to an order.


Sending shipping status information to idealo:

Once you have handed a shipment over to the parcel service or freight forwarder, you can use the API for order data to send idealo the shipping information for that order, including the shipping service used and parcel / tracking number.

Sending details of cancellations and returns to idealo:

The API for order data can also be used to inform idealo of any cancellations, partial cancellations or returns.

 

PHP example – Software Development Kit (SDK) for API connection:

To make it easier to connect the idealo Direct Checkout to PHP-based systems, idealo provides a PHP SDK which simplifies the API connection. The SDK contains a library for calling up the aforementioned API functions and a ready-to-run test application, which you can use to test all API operations in your own personal sandbox. Upon request, idealo will send you the sandbox data with the corresponding test orders once you have registered for the idealo Direct Checkout.