CATEGORY: CAR HIRE
There are two methods by which Kelkoo.co.uk can retrieve merchant car hire products:
A Live Data Feed
This is our recommended and preferred way of working with merchants as it is a robust technical solution that returns real time availability. It is a stable integration enabling the merchant to provide product availability.
The searching is performed by the merchant and the results are provided to Kelkoo with a list of products that are suitable for each individual car hire request. Kelkoo can format the request it feeds to the merchant to suit each individual merchant integration Outlined below are the search metrics that Kelkoo requires the user searching for a car hire to set. It can be written in an any language e.g. perl, jsp, php.
An example of search by Airport
http://www.companyname.com/search/kelkoo-carHire.pl?pickUpAirport=AAA &dropOffAirport=BBB &pickUDay=CCC &pickUpTime=DDD &dropOffDay=EEE &dropOffTime=FFF &carType=GGG
An example of search by Town/City
http://www.companyname.com/search/kelkoo-carHire.pl?pickUpTown=HHH &dropOffTown=ZZZ &pickUDay=CCC &pickUpTime=DDD &dropOffDay=EEE &dropOffTime=FFF &carType=GGG
Parameter | Explanation | Examples | Mandatory/Optional |
AAA | The airport where the car will be picked up (IATA code) | LGW | Mandatoryi for Airport search |
BBB | The airport where the car will be dropped off (IATA code) | LHR | Mandatory for Airport search |
CCC |
The date the car will be picked up | 2008-03-25 | Mandatory |
DDD |
The time the car will be picked up | 1330 | Mandatory |
EEE |
The date the car will be dropped off | 2008-03-30 | Mandatory |
FFF |
The time the car will be dropped off | 1500 | Mandatory |
GGG | The type of car to be provided, based on ACRISS categories:
| Special | Optional |
HHH | The town where the car will be picked up - we can't provide more specific information than this | Madrid | Mandatory for Town search |
ZZZ | The town where the car will be dropped off - we can't provide more specific information than this | Barcelona | Mandatory for Town search |
The Car Type value can be null or you may chose not to implement it. In either of these cases, assume that this means 'any' car type.
The Data Feed Format
The data feed format describes the way we'd like to receive the results from your script. XML is our prefered format, alternatively each piece of information can be separated by another delimiter (comma, pipe, tab) and each product can be terminated with another delimter or by an end of line character.
An example of one product in our preferred XML format:
This is taken from the Open Travel (OTA2004b_XML)
-
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://www.w3.org/2001/12/soap-envelope">
<SOAP-ENV:Body>
<OTA_VehAvailRateRS EchoToken="XXX1234" SequenceNmbr="1" Target="Production" Version="1.0" xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_VehAvailRateRS">
<Success/>
<VehAvailRSCore>
<VehRentalCore PickUpDateTime="2008-10-01T13:30:00" ReturnDateTime="2008-10-04T15:00:00">
<PickUpLocation CodeContext="IATA" LocationCode="LHR"/>
<ReturnLocation CodeContext="IATA" LocationCode="LHR"/>
</VehRentalCore>
<VehVendorAvails>
<VehVendorAvail>
<Vendor>Kelkoo</Vendor>
<VehAvails>
<VehAvail>
<VehAvailCore Status="Available">
<Vehicle AirConditionInd="false" TransmissionType="Manual">
<VehType VehicleCategory="1"/>
<VehClass Size="2"/>
<VehMakeModel Code="ECMN" Name="Group B - Vauxhall Corsa 1.2 or similar"/>
</Vehicle>
<RentalRate>
<VehicleCharges>
<VehicleCharge Amount="156.30" CurrencyCode="GBP"
Description="" GuaranteedInd="false"
IncludedInRate="true" Purpose="1" TaxInclusive="false">
<TaxAmounts>
<TaxAmount CurrencyCode="GBP"
Description="Taxes and surcharges" Total="53.70"/>
</TaxAmounts>
</VehicleCharge>
<VehicleCharge Amount="5.30" CurrencyCode="GBP" Description="Additional Distance Charge" GuaranteedInd="false" IncludedInRate="false" Purpose="8" TaxInclusive="true"/>
<VehicleCharge Amount="2.55" CurrencyCode="GBP"
Description="Local Tax" GuaranteedInd="false"
IncludedInRate="true" Purpose="7" TaxInclusive="false"/>
<VehicleCharge Amount="1.15" CurrencyCode="GBP"
Description="Vehicle Registration Fee" GuaranteedInd="false"
IncludedInRate="true" Purpose="6" TaxInclusive="false"/>
<VehicleCharge Amount="1.00" CurrencyCode="GBP"
Description="Under Age Surcharge" GuaranteedInd="false"
IncludedInRate="true" Purpose="5" TaxInclusive="true"/>
</VehicleCharges>
<RateQualifier RateQualifier=""/>
</RentalRate>
<TotalCharge CurrencyCode="GBP" EstimatedTotalAmount="169.00" RateTotalAmount="165.30"/>
</VehAvailCore>
<VehAvailInfo>
<PricedCoverages>
<PricedCoverage>
<Coverage Code="ALI" CoverageType="1">
<Details CoverageTextType="Description">Additional Liability Insurance (ALI)</Details>
</Coverage>
<Charge Amount=".00" CurrencyCode="GBP" Description="Coverage costs are quoted per day"
IncludedInRate="true" TaxInclusive="false"/>
</PricedCoverage>
<PricedCoverage>
<Coverage Code="CDW" CoverageType="7">
<Details CoverageTextType="Description">Collision Damage Waiver (CDW)</Details>
</Coverage>
<Charge Amount=".00" CurrencyCode="GBP" Description="Coverage costs are quoted per day"
IncludedInRate="true" TaxInclusive="false"/>
</PricedCoverage>
</PricedCoverages>
</VehAvailInfo>
</VehAvail>
<VehAvail>
</Info>
</VehVendorAvail>
</VehVendorAvails>
</VehAvailRSCore>
</OTA_VehAvailRateRS>
</ns:Response>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
-
<carHire>
<pickUpAirport>LGW</pickUpAirport>
<dropOffAirport>LHR</dropOffAirport>
<pickUpDay>2008-03-30</pickUpDay>
<pickUpTime>13:30</pickUpTime>
<dropOffDay>2008-04-10</dropOffDay>
<dropOffTime>15:00</dropOffTime>
<CarModel>Ford Ka<CarModel>
<carType>ECMN <carType>
<description> Offering
unbeatable value, the perfect stylish vehicle for shorter everyday
journeys. Maximum occupancy: 4. Suitable for 1 small piece of luggage. Optionnal: child Seat, ski rack, luggage rack, snow chain.</description>
<price>50</price>
<currency>GBP</currency>
<moreinfo>www.company.co.uk/linktocarpage</moreinfo>
<pictureUrl>www.company.co.uk/images/image.jpg</pictureUrl>
</carHire>
Where:
Field
Description
Mandatory/Optional
PickUpAirport
The airport where the car will be picked up (IATA code)
Mandatory for Airport searches
DropOffAirport
The airport where the car will be picked off (IATA code)
Mandatory for Airport searches
PickUpDay
The date the car will be picked up
Mandatory
PickUpTime
The time the car will be picked up
Mandatory
DropOffDay
The date the car will be dropped off
Mandatory
DropOffTime
The time the car will be dropped off
Mandatory
CarModel
The car make and model
Mandatory CarType
Type of car, which you are providing. We prefer this to be the car's ACRISS code (we support the extended matrix). However, we can also accept long form names as below:
-
economycompact
intermediatemini standard full Size premium luxury - special
Mandatory Description
A short description, which has a limit of 250 characters
Mandatory
Price
Prices including taxes
Mandatory
Currency
Currency of the price
Mandatory
moreinfo
A link to a page on your site where the product may be purchase. For better conversion, we recommend this is a product page that displays details as well as a 'buy now' button, with all the appropriate details completed (dates and so on)
Mandatory
PictureUrl
A full link to an image for the product
Optional
PickUpTown
The town where the car will be picked up
Mandatory - for Town search
DropOffTown
The town where the car will be dropped off
Mandatory - for Town search
A Spider
Kelkoo builds a spider adapter that crawls the merchant site acting as a web user. Each time a user submits a request on Kelkoo's car hire search form the adapter will launch a search on the merchant site, proceed through the relevant HTML pages to retrieve products that match the users search. On the merchant side, there is very little effort needed in the development of this method of implementation. However, Kelkoo only recommends this method if the Live Feed Option cannot be implemented.
This is because a spider is sensitive to any changes on the merchant site. Therefore any small adaptations on the site could require an upgrade to the spider and result in the merchant missing from our result pages until this upgrade is completed.
-
economycompact