Welcome to the Kelkoo Group Customer Service

Feeds

Introduction to Kelkoo feeds

Kelkoo feeds are designed to provide you with Kelkoo’s merchant offer base as easily and quickly as possible. As a Kelkoo partner you can integrate these offers into your internal systems and serve them to your users.

Feed information

Delivery Pull Files will be made available on our servers for you to download and process.
Protocol FTP Once Kelkoo feeds are set up you will be emailed the FTP details and credentials.
Structure By category OR by merchant Choose between one offer feed file per category or one per merchant.
Frequency Daily We’ll make updated feeds available to you every morning.

Formats

All feed files are available in either XML or CSV formats. Please specify the format required with your account manager.

XML Feeds are UTF-8 encoded.

CSV data is delimited by semicolon “;”. Fields with multiple values, for example deliveryCountries in the merchant feed file, values are delimited with a tab eg “UK           FR            DE       SE       BR”.

 

Folder structure

The FTP directories are structured in the following way:

/[FEED_TYPE]/[COUNTRY]/

Along with the feed files, status & md5 files are also included:

/[FEED_TYPE]/[COUNTRY]/status.txt

/[FEED_TYPE]/[COUNTRY]/feeds.md5

 

 

Structure

 

Feeds relationships

globalDiagram

Feed types

OfferAndMerchantFeedsDiagram

 

CatalogFeedDiagram

MerchantDiagram

CategoryFeedDiagram

Non-feed files

The status file

The status file tells you when your feeds are available for downloading and processing but also very importantly, when they are being updated.

A sample of status.txt can be found here. The file is laid out in 3 columns, date & time, timestamp, status.

When Kelkoo begin updating your feeds for the day the status file will show the status STARTED. Once all actions are completed the status will be again updated to COMPLETE.

During the FTP busy period (between STARTED and COMPLETED) we will also delete all old feed files.

MD5

The md5 file which can be found in each feed folder lists the filename and the checksum of each feed file. Once you have downloaded your feed files then you can compare the checksum of your downloaded files against those in the md5 file.

Best Practices

–        Check the gz files against the md5 file once you’ve downloaded the files to ensure the checksum is correct, if it’s not re-download as a non-match implies corruption.

 

–        It is not advisable to modify URL data from the feed, either offer URLs or image URLs unless specified by Kelkoo.

 

–        In order to ensure that you have the freshest data available it is required that you purge all old offers and files from your systems daily with the arrival of new feed files.