Rent-a-Car Availability Search

This operation is designed to obtain a list of cars available to rent , meeting some client supplied criteria, in a given city, so that they could be attached to a existing or new travel file

Rent-a-car availability search request schema

 

 

Rent-a-car availability search response schema

 

 

Sample requests:


Service availability search tester


 

A simple example

Following is simple example of a rent-a-car availability request. Click the active line numbers to read further details.

 

1 <OTA_RentAvailRQ ReqRespVersion="1" xmlns="http://www.opentravel.org/OTA" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA ../../../html/OTASchemas/OTA_Service.xsd" EchoToken="echo" TimeStamp="2008-02-01T10:51:16Z" Target="Production" Version="1" SequenceNmbr="1" LanguageId="EN">

2 <POS>

3 <Source>

4 <UniqueId URL="" Type="ParsysOperatorCode" Id="db:code:pass"/>

5 </Source>

6 </POS>

7 <BookingSegments>

8 <RentReference CityCode="614"/>

9 </BookingSegments>

10 <StayDateRange StartDate="2008-03-01T21:10:00Z" EndDate="2008-04-01T01:10:00Z"/>

11 <StayTimeRange PickUpTime="21:10" ReturnTime="01:10"/>

12 <Point PickUpPoint="2" ReturnPoint="1"/>

13 <RentStayCandidates>

14 <RentStayCandidate ServiceType="6">

15 </RentStayCandidate>

16 </RentStayCandidates>

17 <TPA_Extensions>

18 <UniqueId URL="" Type="Rent" Id=""/>

19 </TPA_Extensions>

20</OTA_RentAvailRQ>

Line 1: <OTA_RentAvailRQ>

This is the Rent-a-car Availability Requests main tag. Note all the attributes that must be included:

-         TimeStamp : Time in YYYY-MM-DD’T’HH-MM-SS’Z’ format.

-         Target : Always “Production”.

-         ReqRespVersion: By now, “1”.

-         LanguageId=Always ”EN”

-         SequenceNmbr=Always “1"

-         AvailRatesOnly= Always "true"

-         BestOnly= Always "true"

 

Line 2: <POS>

Inside the request header, database, user code and password have to be set. Otherwise the system will return an authentication error.

 

This tag should include a “Source” subtag, and this, another subtag “UniqueURL” containing the following attribute values:

-         URL: Should be set as empty value “”.

-         Type: Should be set as "ParsysOperatorCode"

-         ID: Should be set as “db:usercode:password”

Line 7: <BookingSegments>

Here goes all the information about the Rent-a-Car Availability Request.

Line 8: <RentReference>

Note that in here, we set the attribute “ServiceCityCode” to city ID in database.

Line 10: <StayDateRange>

Must include the attributes “StartDate” for pick-up date and “EndDate” for pick-off. This dates must be in format YYYY-MM-DD’T’HH-MM-SS’Z’

Line 11: <StayTimeRange>

This tag is mandatory and must include the attributes PickUpTime and ReturnTime with pick-up and pick-off times in format HH:MM

Line 12: <Point>

This tag is mandatory and must include the attributes PickUpPoint and ReturnPoint with the values of pickup/off points off codes of database, for example:

 

In database (table rent_dep_arr_points) we have…

Code= 1, Type=2, Point=”AIRPORT” …

Code= 2, Type=1, Point=”AIRPORT” …

…

 

Also, we must know that Type=2 is PICKUPPOINT, and Type=1 is RETURNPOINT.

 

So, if we want to pickup at airport, we should set PickUpPoint=”1”, because what we want is Type=2(Pickup), Point=”Airport”…. so that has Code = 1.

 

If we want to return at airport, we should set ReturnPoint=”2”, because what we want is Type=1(Return), Point=”Airport”, so that has Code=2

 

Line 13: <RentStayCandidates>

These tag and subtags are mandatory and must include the information of car to rent.

 

Must contain another mandatory tag (and only 1), as following:

 

<RentStayCandidate ServiceType="6">

 

Where ServiceType attribute must be set to car ID (in rent_cats) in local database.

Line 17: <TPA_Extensions>

 

Is mandatory and must be always as following in rent-a-car availability request:

 

<TPA_Extensions>

<UniqueId URL="" Type="Rent" Id=""/>

</TPA_Extensions>