OTA2012B Documentation

Car
Hire
with a
smile
MicronNexus
GmbH
Alipiev, Emil
(MicronNexus
GmbH)
OTA 2012B DOCUMENTATION

Introduction and explanation on the Car Hire platform OTA2012B interface
1 Index
1
INDEX....................................................................................................................................................... 2
HISTORY OF DOCUMENT .......................................................................................................................... 5
INTRODUCTION........................................................................................................................................ 6
TERMS AND DEFINITIONS ........................................................................................................................ 7
SYSTEM INFORMATION ......................................................................................................................... 14

5.1
SEARCH GEOGRAPHIC ................................................................................................................................ 14
5.1.1 Search by Airport ............................................................................................................................. 14
5.1.2 Search by City .................................................................................................................................. 14
5.1.3 Search by Location........................................................................................................................... 14
5.1.4 Search by Hotel-Code ...................................................................................................................... 14
5.2
DEEP LINKING .......................................................................................................................................... 14
5.2.1 Deep link by Reference Number ...................................................................................................... 15
5.2.2 Deep linking by individual Parameters ............................................................................................ 16
5.3
SYSTEM ACCESS ....................................................................................................................................... 17
5.4
OTA-SOAP MESSAGE-FORMAT ................................................................................................................. 17
5.4.1 Endpoints ......................................................................................................................................... 19
5.4.2 Which endpoint should we use? What are the exact differences? .................................................. 21
5.5
XML SAMPLE OUTPUT TOOL ...................................................................................................................... 22
SOAP Client ................................................................................................................................................... 22
5.6
DATA DUMPS .......................................................................................................................................... 22
5.7
WEBSERVICE TO RETRIEVE GEO-DATA.......................................................................................................... 22
5.7.1 GetAirports ...................................................................................................................................... 23
5.7.2 GetCities .......................................................................................................................................... 23
5.7.3 GetCountries .................................................................................................................................... 23
5.7.4 GetRegions ...................................................................................................................................... 23
5.8
WEBSERVICE TO RETRIEVE AUTOCOMPLETED-DATA ........................................................................................ 24
5.8.1 Service Returning XML ..................................................................................................................... 24
5.8.2 Service Returning Json ..................................................................................................................... 24
TESTING TOOL ........................................................................................................................................ 25

6.1
OVERVIEW .............................................................................................................................................. 25
6.2
DESCRIPTION ........................................................................................................................................... 25
6.2.1 Get Available Vehicle To check on the offers request and response ............................................ 25
6.2.2 RateRule To check on the equipments and other additional offers .............................................. 25
6.2.3 Reservation To attempt to book a car with details added ........................................................... 25
6.2.4 Reservation Retrieval To retrieve bookings and to see the details of the reservation ................. 25
6.2.5 Reservation Cancellation To cancel a reservation ........................................................................ 25
QUOTE ................................................................................................................................................... 26
7.1
REQUEST................................................................................................................................................. 27
7.2
RESPONSE ............................................................................................................................................... 28
7.3
SAMPLE REQUESTS .................................................................................................................................... 31
7.3.1 By Airport ID or City ID: ................................................................................................................... 31
7.3.2 By IATA code: ................................................................................................................................... 31
7.3.3 Using VehPrefs Filter ....................................................................................................................... 31
CarHire-Solutions - Interface
Page 2
7.3.4 Direct Supplier sample ..................................................................................................................... 32

7.4
SAMPLE RESPONSE .................................................................................................................................... 32
7.5
HANDLING MULTIPLE LOCATIONS OF A SUPPLIER ............................................................................................. 35
7.6
REQUESTING WITH COUNTRY OF ORIGION (SOURCE COUNTRY) AND LANGUAGE ................................................... 35
8
RATERULES ............................................................................................................................................ 36
8.1
8.2
SAMPLE REQUEST: .................................................................................................................................... 37

SAMPLE RESPONSE: ................................................................................................................................... 37
RESERVATION ........................................................................................................................................ 39
9.1
REQUEST................................................................................................................................................. 39
9.1.1 Payment .......................................................................................................................................... 40
9.1.2 Equipment ....................................................................................................................................... 41
9.2
RESPONSE ............................................................................................................................................... 41
9.3
SAMPLE REQUEST ..................................................................................................................................... 42
9.4
SAMPLE RESPONSE .................................................................................................................................... 43
10
CANCELLATION ...................................................................................................................................... 46
10.1
10.2
10.3
11
RETRIEVE RESERVATION ........................................................................................................................ 48

11.1
11.2
11.3
11.4
12
REQUEST................................................................................................................................................. 49
RESPONSE ............................................................................................................................................... 49
SAMPLE-REQUEST .................................................................................................................................... 49
SAMPLE-RESPONSE ................................................................................................................................... 50
MODIFY ................................................................................................................................................. 52
12.1
12.2
12.3
12.4
13
RESPONSE ............................................................................................................................................... 47
SAMPLE REQUEST ..................................................................................................................................... 47
SAMPLE RESPONSE .................................................................................................................................... 48
REQUEST................................................................................................................................................. 54
RESPONSE ............................................................................................................................................... 54
SAMPLE REQUEST ..................................................................................................................................... 54
SAMPLE RESPONSE .................................................................................................................................... 55
LOCATION .............................................................................................................................................. 56
13.1
LIST OF LOCATIONS ................................................................................................................................... 56
13.1.1
Request ....................................................................................................................................... 56
13.1.2
Response ..................................................................................................................................... 57
13.1.3
Sample-Request .......................................................................................................................... 57
13.1.4
Sample-Response ........................................................................................................................ 58
13.2
LOCATION DETAILS ................................................................................................................................... 58
13.2.1
Request ....................................................................................................................................... 58
13.2.2
Response ..................................................................................................................................... 59
13.2.3
Sample request ........................................................................................................................... 59
13.2.4
Sample response ......................................................................................................................... 60
14
APPENDIX .............................................................................................................................................. 61
14.1
14.2
14.3
LANGUAGE TABLE ..................................................................................................................................... 61

REGION TABLE.......................................................................................................................................... 62
AIRPORT TABLE ........................................................................................................................................ 62
Page 3
14.4
14.5
14.6
14.7
14.8
14.9
14.10
14.11
14.12
14.13
14.14
14.15
15
CITY TABLE .............................................................................................................................................. 63

RESERVATION STATUS TABLE ....................................................................................................................... 63
LOCATION TYPE TABLE ............................................................................................................................... 64
SUPPLIER TABLE ........................................................................................................................................ 64
CREDIT CARD TABLE................................................................................................................................... 68
ERROR TYPES ........................................................................................................................................... 69
PERIOD TABLE ...................................................................................................................................... 71
FUEL TYPE TABLE .................................................................................................................................. 71
VEHICLE CATEGORY TABLE ...................................................................................................................... 71
DESTINATION TYPE TABLE ....................................................................................................................... 72
PRICEDCOVERAGETYPES ........................................................................................................................ 72
OTA DEFINITIONS AND ERROR CODES ....................................................................................................... 73
CONTENT-INDEX .................................................................................................................................... 74
15.1
ILLUSTRATIONS ......................................................................................................................................... 74
Page 4
2 History of document
Version
1.0
1.0
Date
25.09.2013
22.05.2014
Author
Emil Alipiev
Emil Alipiev
Changes
First Release
Revised
Page 5
3 Introduction
This document displays and supports with advisable information of web-based reservation interface
(OTA2012B.carhire-solutions.com) of the MicronNexus car hire platform and designed affiliates using
extensible mark-up language (xml) as well as using this platform as Computerized Reservation System
(CRS) also known as Global Distribution System (GDS).
All mentioned terms, abbreviations, etc. in this document are based on the Open Travel Alliance
2007A Specifications. Please find all information regarding the OTA specifications under
www.opentravel.org.
One may download to recent version of this documentation from http://www.carhiresolutions.com/OTA2012b_documentation.pdf.
The intent of this document is to supply CarHire-Solutions affiliates with information for the
customers demand that support:
Availability of vehicles
Reservation of vehicles
Requesting and reserving equipment and options
Locations
Opening hours
Retrieve a reservation request
Cancel reservation
Amendment (changing a reservation)
Page 6
4 Terms and definitions

Interface
Interface generally refers to an abstraction that an entity provides of itself to the outside. This
separates the methods of external communication from internal operation, and allows it to be
internally modified without affecting the way outside entities interact with it, as well as provide
multiple abstractions of it.
Interface in Practice - A piece of software provides access to computer resources (such as memory,
CPU, storage, etc.) by its underlying computer system; the availability of these resources to other
software can have major ramifications for its functionality and stability. A key principle of design is to
prohibit access to all resources by default, allowing access only through well-defined entry points, i.e.
interfaces.
Web Application Programming Interfaces (Web APIs)

When used in the context of web development, an API is typically a defined set of Hypertext Transfer
Protocol (HTTP) request messages along with a definition of the structure of response messages,
usually expressed in an Extensible Mark-up Language (XML) or JavaScript Object Notation (JSON)
format.
Web APIs allow the combination of multiple services into new applications known as mashups.
SOAP
SOAP, originally defined as Simple Object Access Protocol, is a protocol specification for exchanging
structured information in the implementation of Web Services in computer networks. It relies on
Extensible Markup Language (XML) as its message format, and usually relies on other Application
Layer protocols (most notably Remote Procedure Call (RPC) and HTTP) for message negotiation and
transmission. SOAP can form the foundation layer of a web services protocol stack, providing a basic
messaging framework upon which web services can be built.
Supplier
A supplier is someone whose business is to supply a particular service or commodity, in this
particular case the car rental service.
Broker
A broker is a party that mediates between the car rental companys and customers.
Page 7
Brokers are getting their fleet from several car rental companies and selling under their own
brand, e.g. holidayautos. Brokers havent got their own fleet or locations.
Car Rental Company
A car rental company offers its own fleet at its own locations. Car rental companies are
getting their fleet from the car manufacturer directly and selling under their own brand, e.g.
Hertz.
Affiliate
An affiliate is a partner hosting any kind of website, either B2B (business to business) or B2C
(business 2 customer), for providing rental car offers. This can be a travel web portal, a touristic
service provider or any kind of tour operator.
Tour Operator
A tour operator typically combines tour and travel components to create a holiday. The most
common example of a tour operator's product would be a flight on a charter airline, a transfer from
the airport to a hotel, services to offer car rentals and the services of a local representative, e.g. TUI.
Travel Agency
A travel agency (or travel shop) is the retail unit of a tour operator where customers can book their
holidays and car hire, together with an agency agent (or shop agent).
Net Price
Net price is the defined purchase price given from the car hire supplier to the tour operator. The tour
operator creates a markup on top of the net price in order to end up with a final selling price. This
markup can also be done on behalf of MicronNexus in their database.
Gross Price
Gross price is the predefined selling price by the car hire supplier. The tour operator receives a fixed
percentage of commission.
Prepaid
Page 8
Prepaid refers to services paid for in advance in this case:
Prepaid to Tour-Operator
Prepaid to Supplier
Prepaid to CarHire-Solutions
Postpaid
Postpaid can be referred as to use and pay (pay at time of pick up at counter), in this case:
Postpaid to Supplier
Commission
Commission is a form of payment by supplier to the tour operator. Commission can also be paid by
supplier to MicronNexus. In this case MicronNexus pays a subcommission (its amount is negotiated
between the tour operator and MicronNexus) to the tour operator. The amount is calculated by a
certain percentage to the selling price and will be applicable only in the gross price section.
Margin
The margin defines the result of purchase price less selling price and will be applicable only in the net
price section.
Samples of payment
Postpaid to supplier using gross rates
When pick-up the car at the rental station the customer does pay the price defined by the
supplier.
Page 9
Supplier
Provision
Defined price by
Supplier
Affiliate
Customer
Figure 1 Portpaid to Supplier
Prepaid to affiliate using net rates

The customer does pay at the reservation the price offered for the car by the tour operator.
Supplier
Net-price
Defined price by
Affiliate
Affiliate
Customer
Figure 2 Prepaid to Affiliate Net Rate
Prepaid to supplier using gross rates

When making the reservation the customer does pay the price offered by supplier to the
supplier. This model is mostly used by car rental brokers.
Supplier
Provision
Affiliate
Offered price by
Supplier
Customer
Figure 3 Prepaid to Supplier Gross Rate
Page 10
Airport Coding
By IATA Code
IATA airport codes are trigram letter designations for airports.
By Airport-ID
Airport-ID is defined by MicronNexus.
Sample
IATA
LHR
CDG
MUC
Airport_ID
974
2640
1407
Name
London Heathrow Airport
Paris Charles De Gaulle Airport
Munich Franz Josef Strauss Airport
Please find a selection of IATA airport codes and airport-ID in appendix (Ch. 14).
City-Coding
By IATA-Code
IATA city codes are trigram letter designations for cities.
By City_ID
City ID is defined by MicronNexus, as well as airport ID.
Sample
IATA
SHA
MLB
DXB
City_ID
4411
1026
2453
Name
Shanghai
Melbourne
Dubai
Find a selection of IATA city codes and city ID in the appendix (Ch. 14).
Location coding
Supplier GDS code+ location code
The location code is a supplier specific code defining its location.
Supplier GDS code is the unique two digit code of the supplier.
Page 11
Sample
Location_Code
X6Y
TRST71
Supplier_Code
Hertz
Alamo
162464
Autocandia
Name
Calais Downtown
TRIESTE - RONCHI
DE'LEGIONARI APT
Athen Office
Find a selection of locations in appendix (Ch. 14).

Location
A location, also known as rental station can be found at airports or in cities.
Locations in cities (multiple locations per supplier possible)
City locations are understood as downtown locations, not located at the airport. When
speaking of multiple locations a single supplier is having more than one downtown location
in that city.
Locations at airports (single location per supplier)
Airport locations are understood as locations with a counter in the arrival hall, meet & greet
representative or shuttle bus to the car hire area within the airport compound. Any offer at
the airport is in 99% of the cases unique to a specific location.
Page 12
Location(s)
CONTINENTS
COUNTRIES
REGIONS
CITIES
AIRPORTS
Multiple
location
Single
location
LOCATION(S)
Figure 4 Location
Page 13
5 System information
The main function of the car platform is to provide all necessary and/or required information within
a short limited time period.
5.1 Search Geographic

5.1.1 Search by Airport
A search by airport can be carried out by using the airport IATA-Code or airport ID.
Search will return offers of multiple suppliers located at the airport.
5.1.2 Search by City

A search by city can be carried out by using the city IATA-Code or city ID.
Search will return offers of multiple suppliers located within the city (downtown). If a supplier is only
located at the airport offers will not be returned for city search.
5.1.3 Search by Location

A search by location can be carried out by using
location code and GDS code (queries only one supplier)
Location is always unique to a single supplier and therefore a search will not return offers from
multiple suppliers.
To request for a specific location of a supplier it is always recommended to request with GDS Code
+ location code!
5.1.4 Search by Hotel-Code

When searching by hotel-code only offers allowing hotel delivery are being returned. Multiple
suppliers are possible.
5.2 Deep linking

Page 14
CarHire Solutions provides capabilities to refer to a particular offer or an offer list at any
MicronNexus supplied website using deep linking. A VehAvailRate response contains a deep link URL
which can be used to invoke the MicronNexus website for continuing the booking process after a
vehicle offer (or a list of offers) has been generated.
There are two modes of using deep links:
Deep link by reference number, and

Deep link by parameter
Please note: using deep linking is only an optional feature for OTA2012B interface users which only
supports offer requests. OTA2012B on the other hand provides the entire spectrum of OTA specific
booking operations. If you plan to use all or at least most of them you may skip this subchapter and
use the operations directly.
5.2.1 Deep link by Reference Number

This mode of deep linking uses the reference number which is generated for each offer to have a
unique ID. Deep link by reference number requires that a car hire offer list has already been
generated and the customer has selected one of these offers.
The deep link URL can be obtained from the response (VehAvailRateRS) of the vehicle offer request,
as indicated below:
<VehVendorAvails>
<VehVendorAvail>
<VehAvails>
<VehAvail>
<VehAvailCore Status="Available">
<Reference
URL="http://www.carhiremarket.com/upsell_parameter.aspx?reference_number=00519926283730596537A
984476228&live=true" Type="16" ID_Context="005199262812739844762281344"/>
</VehAvail>
</VehAvails>
</VehVendorAvail>
</VehVendorAvails>
Please refer to Ch. 7.4 for more details concerning the response of a quotation.
An alternative approach is to generate a custom URL using the reference number which is
transmitted in the XML attribute ID_Context.
The destination website (in the example above: www.carhiremarket.com) may be agreed with
MicronNexus. The language to be chosen at the destination website is identical to the language
specified at quotation.
Using the reference number, the availability of the offer is checked when navigating to the deep
linked site. If the offer is not available, then alternative offers are returned.
Page 15
5.2.2 Deep linking by individual Parameters

Deep linking with parameters is most suitable if the customer has not selected a vehicle to hire, but
should be prompted with matching car hire offers according to data (destination, time span) which
has been already entered.
If the parameter ShowOffer is set to false, then the customer will be forwarded to the extended
search page and the drop down control elements on this page will be filled with the parameters
passed.
URL (staging):
http://www.carhiremarket.com/Parameters.aspx?PIATA=AMS&DIATA=AMS&PDAY=03&PMONTHYE
AR=03.2008&PTIME=13:00&DDAY=10&DMONTHYEAR=03.2008&DTIME=13:00&CAT=9&LANGUAGE=
2&Affiliate_ID=10&Agentcode=2&ShowOffer=false
If the parameter ShowOffer is set true, the customer will be forwarded to offer page and offers will
be shown according to the passed parameters. If parameter ShowOffer is not supplied then true is
assumed.
Example 1: Airport request
Using IATA:
http://www.carhiremarket.com/Parameters.aspx?PIATA=PMI&DIATA=PMI&PDAY=03&PMONTHYEA
R=03.2010&PTIME=13:00&DDAY=10&DMONTHYEAR=03.2010&DTIME=13:00&CAT=9&LANGUAGE=2
&Affiliate_ID=212&Agentcode=dealchecker
Using ID:
http://www.carhiremarket.com/Parameters.aspx?PIATA=1931&DIATA=1931&PDAY=03&PMONTHYE
AR=03.2010&PTIME=13:00&DDAY=10&DMONTHYEAR=03.2010&DTIME=13:00&CAT=9&LANGUAGE=
2&Affiliate_ID=212&Agentcode=dealchecker
Info FTP URL:
See http://www.carhire-solutions.com/export/export_airports.csv for a complete list of airport IDs.
Example 2: City downtown request
Using IATA:
http://www.carhiremarket.com/Parameters.aspx?PCITY=PMI&DCITY=PMI&PDAY=03&PMONTHYEAR
=03.2010&PTIME=13:00&DDAY=10&DMONTHYEAR=03.2010&DTIME=13:00&CAT=9&LANGUAGE=2
&Affiliate_ID=212&Agentcode=dealchecker
Using ID:
Page 16
http://www.carhiremarket.com/Parameters.aspx?PCITY=51&DCITY=51I&PDAY=03&PMONTHYEAR=0
3.2010&PTIME=13:00&DDAY=10&DMONTHYEAR=03.2010&DTIME=13:00&CAT=9&LANGUAGE=2&Af
filiate_ID=212&Agentcode=dealchecker
Info FTP URL:
See http://www.carhire-solutions.com/export/export_cities.csv for a complete list of city IDs.
The full parameter list is shown in the attached document.
Note that the URL must be built on your own. The destination web site needs to be agreed with
MicronNexus.
5.3 System Access

Partners implementing access of the OTA2012B interface need to test their implementation first
before setting their software productive. For testing there are special URLs available:
Staging webservice URL: https://ota2012b.micronnexus-staging.com/carhireservice.svc
A new Testing Tool is now accessible further info in chapter 6.
Unless qualification, all tests need to be performed using the staging URL given above. This applies to
all message types, availrate, reservation, cancellation, retrieve and modification.
Once testing is completed, the affiliate should send samples of the inbound and outbound XML
message (for each message set they intend to support) to the individual account manager dedicated
to the affiliate.
After the samples have been reviewed and certified, a URL address will be provided and codes will be
activated for the production environment.
5.4 OTA-SOAP Message-Format

Each request for the OTA interface contains two parts, the SOAP-Header and the SOAP-Body. Both
the OTA Request and the OTA Response messages are transmitted inside the SOAP body.
Page 17
Figure 5 SOAP-OTA Message Format
SOAP-Webservice: Staging
https://ota2012b.micronnexus-staging.com/carhireservice.svc
Poduction https://ota2012b.carhire-solutions.com/carhireservice.svc
WDSL Location:
Staging https://ota2012b.micronnexus-staging.com/CarhireService.svc?wsdl
Poduction https://ota2012b.micronnexus-staging.com/CarhireService.svc?wsdl
targetNamespace:
http://www.opentravel.org/OTA/2003/05
SOAP Action URL:

http://tempuri.org/IOta2012BService/getVehAvailRate
Availability
http://tempuri.org/IOta2012BService/getVehReservation
Reservation
http://tempuri.org/IOta2012BService/getVehRetReservation
Retrive Reservation
http://tempuri.org/IOta2012BService/getVehCancelReservation
Cancel Reservation
http://tempuri.org/IOta2012BService/getVehRateRule
Rate info
http://tempuri.org/IOta2012BService/getVehModify
Modify reservation
Page 18
5.4.1 Endpoints
Micronnexus web service supports 3 different endpoints.
1) Basic Http Endpoint: Represents a binding that a Windows Communication Foundation
(WCF) service can use to configure and expose endpoints that are able to communicate with
ASMX-based Web services and clients and other services that conform to the WS-I Basic
Profile 1.1.
Endpoint description in the WSDL and target address:

<wsdl:port name="ota2012bBasicHttpEndpoint" binding="tns:ota2012bBasicHttpEndpoint">
<soap:address location="https://ota2012b.carhire-solutions.com/CarhireService.svc"/>
</wsdl:port>
An example of a valid request is given below

Request SOAP Header:
POST https://ota2012b.micronnexus-staging.com/CarhireService.svc HTTP/1.1
Accept-Encoding: gzip,deflate
Content-Type: text/xml;charset=UTF-8
SOAPAction: "http://tempuri.org/IOta2012BService/getVehAvailRate"
Content-Length: 862
Host: ota2012b.micronnexus-staging.com
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)
Request SOAP Body:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<OTA_PingRQ Target="Test" Version="1.000" PrimaryLangID="EN">
<EchoData>test</EchoData>
</OTA_PingRQ>
</soap:Body>
</soap:Envelope>
2) WS http endpoint: An interoperable binding suitable for connecting to endpoints that

conform to the WS-* protocols. It is based on soap1.2 standards and requires WS-header.

<wsdl:port name="ota2012bWSHttpEndpoint" binding="tns:ota2012bWSHttpEndpoint">
<soap12:address location="https://ota2012b.carhire-solutions.com/CarhireService.svc/ws"/>
<wsa10:EndpointReference>
<wsa10:Address>
https://ota2012b.carhire-solutions.com/CarhireService.svc/ws
</wsa10:Address>
</wsa10:EndpointReference>
Page 19

POST https://ota2012b.micronnexus-staging.com/CarhireService.svc/ws HTTP/1.1
Content-Type:
application/soap+xml;charset=UTF8;action="http://tempuri.org/IOta2012BService/getVehAvailRate"
Content-Length: 1602
Request SOAP Body:

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
xmlns="http://www.opentravel.org/OTA/2003/05">
<soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing">
<wsa:Action>http://tempuri.org/IOta2012BService/getVehAvailRateString</wsa:Action>
</soap:Header>
<soap:Body>
<OTA_PingRQ Target="Test" Version="1.000" SequenceNmbr="1" PrimaryLangID="EN">
</OTA_PingRQ>
</soap:Body>
</soap:Envelope>
3) Soap1.2 endpoint: It is the custom end point based on soap1.2 standard accepting requests
without WS-Addressing in the header.

<wsdl:port name="ota2012bSoap12Endpoint" binding="tns:ota2012bSoap12Endpoint">
<soap12:address location="https://ota2012b.carhire-solutions.com/CarhireService.svc/soap12"/>
</wsdl:port>

POST https://ota2012b.micronnexus-staging.com/CarhireService.svc/soap12 HTTP/1.1
Content-Type: application/soap+xml;charset=UTF8;action="http://tempuri.org/IOta2012BService/getVehAvailRate"
Content-Length: 1305
Request SOAP Body:

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
xmlns="http://www.opentravel.org/OTA/2003/05"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soap:Header></soap:Header>
<soap:Body>
<OTA_PingRQ Target="Test" Version="1.000" SequenceNmbr="1" PrimaryLangID="EN">
</OTA_PingRQ>
</soap:Body>
</soap:Envelope>
Page 20
5.4.2 Which endpoint should we use? What are the exact differences?
Below is the comparison table between basic http and wshttp endpoints. Soap1.2 is the
custom binding uses also soap1.2 standard as wshttp binding but doesnt require ws
addressing.
Criteria
BasicHttpBinding
WsHttpBinding
Security
support
This supports the old ASMX style, i.e.,

WS-BasicProfile 1.1.
This exposes web services using WS-*

specifications.
Compatibility
This is aimed for clients who do not have

.NET 3.0 installed and it supports wider
ranges of clients. Many of the clients like
Windows 2000 still do not run .NET 3.0.
So an older version of .NET can consume
this service.
As it is built using WS-* specifications, it

does not support wider ranges of clients
and it cannot be consumed by older .NET
versions less than 3 version.
SOAP version
SOAP 1.1
SOAP 1.2 and WS-Addressing

specification.
Reliable
messaging
Not supported. In other words, if a client

fires two or three calls you really do not
know if they will return back in the same
order.
Supported as it supports WS-*

specifications.
Default
security
options
By default, there is no security provided

for messages when the client calls
happen. In other words, data is sent as
plain text.
As WsHttBinding supports WS-*, it has

WS-Security enabled by default. So the
data is not sent in plain text.
None
Windows default authentication
Basic
Certificate
None
Transport
Message
Transport with message credentials
Security
options
Page 21
5.5 XML Sample Output Tool

There are websites with sample implementations of the OTA-Interface. These websites provide
capabilities to create valid sample XML requests and to analyze input and output XML messages.
Intention of these sites is to help developers in testing and verifying their own request and response
messages. There are two testing websites which differ in the type of their setup.
You may also refer to chapter 6.
SOAP Client
The SOAP client is a web tool for testing SOAP compliancy and can be found at
http://www.soapclient.com/ and http://www.soapclient.com/soaptest.html, respectively.
5.6 Data Dumps

CarHire Solutions related data can be downloaded to your own system. The download URL is
http://www.carhire-solutions.com/export/.
The data is assembled once per week and supplied as CSV-Files. The data repository contains
Airports: List of all Airports supported by MicronNexus for car rental

Cities: List of all Cities supported by MicronNexus for car rental
Countries: List of all Countries supported by MicronNexus for car rental
Currencies: List of all Currencies supported by MicronNexus for car rental
Locations: List of all Locations supported by MicronNexus for car rental
Regions: List of all Regions supported by MicronNexus for car rental
Suppliers: List of all Suppliers supported by MicronNexus for car rental
5.7 Webservice to retrieve GEO-Data

Service-URL: http://OTA2012B.micronnexus-staging.com/destination.asmx
Possible Steps
I. Option A preferred
Call getRegions without Country Parameter

Call getAirport or getCity with selected Region_ID
II. Option B
Call getCountries
Call getRegions with selected Country_ID
Call getAirport or getCity with selected Region_ID
Page 22
III. Option C
Call getCountries
Call getAirport or getCity with selected Country_ID
5.7.1 GetAirports
Description
Diplays an array of Airports. One Optional parameter has to be selected
Parameters:
Region_ID (optional)
Language_Code
City_ID (optional)
Country_ID (optional)
5.7.2 GetCities
Description
Diplays an array of Cities. One Optional parameter has to be selected
Parameters:
Region_ID (optional)
Country_ID (optional)
CountryISO (optional)
Language_Code
5.7.3 GetCountries
Description
Diplays an array of Countries.
Parameters:
Language_Code
5.7.4 GetRegions
Description
Diplays an array of Regions.
Parameters:
Language_Code
CountryISO (optional)
Page 23
5.8 Webservice to retrieve AutoCompleted-Data

5.8.1 Service Returning XML
Service-URL: http://OTA2012B.micronnexus-staging.com/destinationautocomplete.asmx
Description
Service is to return a list of Elements (limit) based on Language_ID and QueryName.
Parameters:
Destinationtype_ID: (2, 3, 4, 5)
Displayname: Hamburg Airport (HAM) or Hamburg Downtown
Destination_ID: Is the Country_ID, Region_ID, City_ID or Airport_ID
5.8.2 Service Returning Json

Service-URL: http://OTA2012B.carhire-solutions.com/ajax.aspx?Language_ID=2&q=KUL&limit=10
Description:
As this service runs under a specific URL the Browser (Client) accessing a website under a different
URL is not permitted to access this service (cross domain denied). Therefore you are required to run
your own local service connecting to this webservice and acting as a primary service to the browser.
Parameters:
Language_ID=1..28 (2- would be English)

q= is the three or more letter to query our destinations
limit= max number of offers to be returned
Page 24
6 Testing Tool
6.1 Overview
Micronnexus Soap Interface can be simply tested with SoapUI and Fiddler. You can simply see the
requirements and sample requests and responses especially using SoapUI.
6.2 Description
6.2.1 Get Available Vehicle To check on the offers request and response
To search and see what cars and options are available based on the input and selection of
parameters.
6.2.2 RateRule To check on the equipments and other additional offers

Using the Content ID, you may check on the kind of ancillary or secondary options that you can get
with a car.
6.2.3 Reservation To attempt to book a car with details added

This allows you to test the details / information that you input to ensure that a car can be booked.
6.2.4 Reservation Retrieval To retrieve bookings and to see the details of the
reservation
After making a successful booking, you will get a reference number that can be checked here. This
will display the information of your reservation.
6.2.5 Reservation Cancellation To cancel a reservation

You may test the cancelation with this function.
Page 25
7 Quote
All information provided in this chapter is specified in OTA2012B as the Vehicle Available Rate
Request and Response
VehAvailRateRQ
VehAvailRateRS
The following section gives an overview of how partner can accomplish the search. The search is
carried out by all suppliers supporting the platform.
VehAvailRateRQ has two different ways of working:
1) Live Search
Multi Supplier live search by providing neither City or Airport information nor NO Supplier Code.
It is recommended to fulfill price verification (vehRateRuleRQ) and offer the customer alternative
locations for city pickup.
2) Direct Supplier Connection Live Prices using a single Supplier
This method is suitable if there is a specific supplier chosen and if it is the aim to receive just this
suppliers prices at a specific location. The price verification is not necessary for this booking path.
Querying for a single location can be done by using the parameters listed below.
Figure 6 Diagram of the Search Process
Page 26
7.1 Request
The following table lists the parameter, their types and a short description for the request function.
Parameter
Type
MaxResponses
Integer
ReqRespVersion
String
EchoToken
PrimaryLangID
ISOCountry
ISOCurrency
RequestorID Type
RequestorID ID_Context
String
String
String
String
String
String
PickUpLocation /
ReturnLocation
Integer
CodeContext
VehRentalCore
PickUpDateTime
VehRentalCore
ReturnDateTime
Integer
Integer
PickUpLocation LocationCode
Integer
ReturnLocation LocationCode
Integer
Description
Defines the maximum number of offers to be
returned for each ACRISS-Code category
Requested version of the response message
large: return vehicles including information about
extras. (it causes response time to be increased)
medium: return vehicles without information
about bookable extras.
small: only availability and prices for rates are
returned
Additional message identification
Defines the language of the response
Defines the source market (of the affiliate)
Defines the currency of the response (not in Use)
Defines the username (affiliate name)
Defines the password
Defines the rate query parameter type
cityid: Micronnexus City ID
aipid: Micronnexus Airport ID
loccode: Supplier location
code + Supplier GDS code (s: 14.7 supplier table)
cityiata: IATA code
aipiata : IATA code
Defines date and time the customer will pick up his
car
Defines date and time the customer will drop off
his car
Defines the location the customer will pick up his
car (can be IATA code, location Code dependent on
CodeContext)
Defines the location the customer will return his
car (can be IATA code , location Code dependent
on CodeContext)
Please note: the currency of the vehicle prices cannot be configured dynamically using the request
message. The currency to be returned need to be agreed with MicronNexus when setting up the
affiliate.
Page 27
7.2 Response
Parameter
AdvanceBooking
/RulesApplyInd
ID_Context
Type
Description
Boolean
Always true, just for backward compatibility
String
VehAvailCore/ Status
Vehicle /AirConditionInd
String
Boolean
Vehicle /TransmissionType
Vehicle /FuelType
Vehicle /DriveType
Vehicle /PassengerQuantity
Vehicle /BaggageQuantity
Vehicle /VendorCarType
Vehicle Code
Vehicle /VehicleType
/VehicleCategory
String
String
String
Integer
Integer
String
String
Integer
Vehicle VehicleType/DoorCount
Vehicle Size
Integer
Integer
Vehicle /VehMakeModel/
Name
Vehicle /VehMakeModel/Code
RentalRate RateDistance
Unlimited
RentalRate /RateDistance
DistUnitName
RentalRate /VehicleCharge
CurrencyCode
/Amount
RentalRate/ VehicleCharge
/TaxInclusive
/Purpose
String
It is the unique number (offer reference) to be

used for reservation VehResRQ and
VehRateRuleRQ request.
Specifies if the vehicle is available
Flag indicating whether the vehicle has air
condition or not
E.g. manual or automatic
E.g. Petrol or Diesel, s. Appendix
4WD, AWD or Unspecified
Max. number of passengers
Estimated max. number of pieces of luggage
Supplier specific code of car type
Supplier specific fleet name
Corresponds to the category of the vehicle, e.g.
Mini, Economy or Compact or Premium, as
indicated by the appendix
Number of doors of the vehicle
Corresponds to the size of the vehicle, e.g. Mini,
Economy or Compact or Premium, as indicated
by the appendix
Supplier specific name of the fleet
/RatecodeIndicator
TotalCharge
EstimatedTotalAmount
RateQualifier RateCategory/
RateQualifier/ RatePeriod/
Boolean
String
Boolean
String
String
Decimal
Boolean
String
Decimal
ACRISS code of the vehicle

Flag indicating whether there is a mileage
limitation or not
Indicator of the distance unit (only if
Unlimited=false), can be either km or m (miles)
Two letter code of the currency the rental price is
referring to
Rental price of the vehicle standalone
Flag indicating whether the local tax is included or
not
Indicating if the rental price refers to the original
price or the discounted one. The discounted price
(preferred) is the valid rental price. Can be either
preferred,original and baserate
Flag to indicate if the rental price has been
converted between different currencies
Estimated total amount of the vehicle
Respectively defines; category of the rate (see ota
code table), name of the rate, validation period
Page 28
VendorRateID
RateQualifier /RateComment
PricedEquips
PricedEquip /Equipment
/EquipType
Integer
PricedEquip/ Charge
PricedEquip /Charge
/IncludedInEstTotalInd
Decimal
Boolean
PricedEquip /Charge/ MinMax/

MaxCharge
PricedEquip /Charge/
Calculation / UnitCharge
Calculation / UnitName
Calculation / Quantity
Fees
Fee /IncludedInRate
Boolean
Fee /IncludedInEstTotalInd
Boolean
PricedCoverage
PaymentRule
String
PaymentType
Integer
Vendorlocation/dropofflocation String
value
and ID for this rate.

Defines the type of the rate for advertising
purpose. E.g. GoldPackage, BronzPackage
Element containing several equipment available
for this offer
Identifies the specific type of special equipment.
Refer to OpenTravel Code List Equipment Type
(EQP).
Amount of charge for the equipment.
Flag indicating if the equipment prices have been
already included into the estimated total rate. If
false then the equipment is optional.
Max. Price for the selected equipment. For
example, if value for it is 60 euro, It means that
customer will pay only 60. E.g. If customers
booking is 13 days, normally it costs 13x5= 65 euro
but customer pays only 60 euro in this case.
Price amount for the equipment
Indicates the period of the price amount. Refer to
Period table (see 14-appendix)
Piece amount for the equipment which is related
to the price amount.
Element containing several fees for this offer
Flag indicating if the fee has been already included
in rental price
Flag indicating if the fee has been already included
in EstimatedTotalAmount
Element containing all services (e.g. insurances)
included in this offer
Defines payment model of offer (refer to
OTA2012B payment code table). It contains the
PaymentType element which indicates the
payment mode.
Index to indicate the modes of payment, e.g. if the
offer is prepaid during reservation or postpaid at
the rental station.
E.g. if PaymentType is 5 - Credit Card then the
reservation for that offer requires credit card
information.
PaymentType can be either 3, 4, 5 or 32
3: payment at reservation to MicronNexus. Credit
card data required
4: payment before pickup to affiliate. Credit card
data required
5: payment at reservation to supplier. Credit card
data required
32: payment at pickup
Denotes whether offer is valid for multiple
locations within chosen destination or not. If value
Page 29
LocationCode
String
is Multiple than it indicates the offer has

alternative locations beside the returned
preferred location. In order to get that entire list
for all available locations, VehLocationSearchRQ
has to be sent by using offer reference (see
samples section 11.1.3). If preferred location is
changed, (location info send in VehAvailRateRS),
another VehAvailRateRQ must be sent by using
location code which will be "direct supplier"
request. If the same offer is also available for that
location, one can proceed to the reservation.
Micronnexus location code
CodeContext
String
Micronnexus supplier location code
String
DestinationID (airportID or CityID based on the

request) GDS code of the supplier(first 2
digits)+location code supplier
Name
String
Full location name
VehicleCharge/ Purpose
String
VehicleCharge/RateConvertInd
String
TPA_Extensions
TermsConditions url
Warning Code
Warning
String
Original: price to be paid in currency of the

request.
Preferred: price in currency preferred in request.
Indicates whether the original price was converted
or not. Pay attention: currency exchangerate is
applied at time of reservation. It may differ at
time of pick up.
URL to retrieve the supplier specific Terms &
Conditions from
Unique ID of the warning message
Descriptive text of the warning message
ExtendedLocaitoncode:
Integer
String
Page 30
7.3 Sample requests

Samples bellows are pure Ota requests for soap body. Please refer to 5.4.1 for soap header and soap
body samples for different endpoints.
7.3.1 By Airport ID or City ID:

Request below returns offers for PMI (Palma) airport.
<OTA_VehAvailRateRQ xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_VehAvailRateRQ.xsd"
Target="Test" Version="1.000" SequenceNmbr="1" PrimaryLangID="EN" ReqRespVersion="small"
<POS>
<Source ISOCountry="DE" ISOCurrency="EUR">
<RequestorID Type="username" ID_Context="password" />
</Source>
</POS>
<VehAvailRQCore>
<VehRentalCore PickUpDateTime="2013-10-20T12:00:00" ReturnDateTime="2013-10-27T12:00:00">
<PickUpLocation LocationCode="1931" CodeContext="aipid" />
<ReturnLocation LocationCode="1931" CodeContext="aipid" />
</VehRentalCore>
</VehAvailRQCore>
</OTA_VehAvailRateRQ>
7.3.2 By IATA code:

Request below returns offers for 1931(Palma) airport.
<OTA_VehAvailRateRQ xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_VehAvailRateRQ.xsd"
Target="Test" Version="1.000" SequenceNmbr="1" PrimaryLangID="EN" ReqRespVersion="small"
<POS>
<Source ISOCountry="ES">
</Source>
</POS>
<VehAvailRQCore>
<PickUpLocation LocationCode="PMI" CodeContext="aipiata" />
<ReturnLocation LocationCode="PMI" CodeContext="aipiata" />
</VehRentalCore>
</VehAvailRQCore>
7.3.3 Using VehPrefs Filter

Request below returns offers only for Size 3 =Economy (ref. OTA code table) and Passenger quantity
4 in 1931(Palma) airport.
<OTA_VehAvailRateRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" EchoToken="1.0" Version="1" PrimaryLangID="EN"
ReqRespVersion="large" xmlns="http://www.opentravel.org/OTA/2003/05/common">
<POS>
</Source>
</POS>
Page 31
<VehAvailRQCore>
<PickUpLocation LocationCode="1931" CodeContext="aipid" />
<ReturnLocation LocationCode="1931" CodeContext="aipid" />
</VehRentalCore>
<VehPrefs>
<VehPref>
<VehType />
<VehClass Size="3" />
</VehPref>
</VehPrefs>
</VehAvailRQCore>
<VehAvailRQInfo PassengerQty="4" />
7.3.4 Direct Supplier sample

Request below returns offers only for supplier Centauro (CE) in PMI airport.
<OTA_VehAvailRateRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" EchoToken="1.0" Version="1" ReqRespVersion="large"
xmlns="http://www.opentravel.org/OTA/2003/05/common">
<POS>
</Source>
</POS>
<VehAvailRQCore>
</VehRentalCore>
<VendorPrefs>
<VendorPref Code="CE" />
</VendorPrefs>
</VehAvailRQCore>
7.4 Sample response

<?xml version="1.0" encoding="utf-8"?>
<VehAvailRateRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" EchoToken="4.6727726;4.844697" TimeStamp="2013-0930T18:43:07" Target="Test" Version="3" xmlns="http://www.opentravel.org/OTA/2003/05/common">
<VehAvailRSCore>
<VehRentalCore PickUpDateTime="2013-10-20T12:00:00" ReturnDateTime="2013-10-27T12:00:00"
Quantity="4">
<PickUpLocation LocationCode="1931" />
<ReturnLocation LocationCode="1931" />
</VehRentalCore>
<VehVendorAvails>
<VehVendorAvail>
<VehAvails>
<VehAvail>
<VehAvailCore Status="Available">
<Vehicle AirConditionInd="true" TransmissionType="Manual" FuelType="Petrol"
DriveType="Unspecified" PassengerQuantity="4" BaggageQuantity="1" VendorCarType="A" Code="Ford Ka A/C "
CodeContext="">
<VehType VehicleCategory="1" DoorCount="2" />
<VehMakeModel Name="Ford Ka A/C " Code="MBMR" />
<PictureURL>http://ota2012b.carhire-solutions.com/images/car/centauro/small/MBMRA.jpg</PictureURL>
</Vehicle>
<RentalRate>
<RateDistance Unlimited="true" DistUnitName="Km" VehiclePeriodUnitName="RentalPeriod"
/>
Page 32
<VehicleCharges>
<VehicleCharge Amount="62.84" CurrencyCode="EUR" TaxInclusive="true"
Purpose="original" />
<VehicleCharge Amount="62.84" CurrencyCode="EUR" TaxInclusive="true"
RateConvertInd="true" Purpose="preferred" />
</VehicleCharges>
<RateQualifier VendorRateID="Centauro">
<RateComments>
<RateComment Name="BronzePackage" />
</RateComments>
</RateQualifier>
<RateRestrictions MinimumAge="25" MaximumAge="80" />
</RentalRate>
<TotalCharge CurrencyCode="EUR" EstimatedTotalAmount="62.84" RateConvertInd="false" />
<Fees>
<Fee Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="Location service
charge(LSC)" IncludedInRate="true" IncludedInEstTotalInd="true" />
<Fee Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="VAT(TAX)"
IncludedInRate="true" IncludedInEstTotalInd="true" />
</Fees>
<Reference
URL="http://www.carhiremarket.com/upsell_parameter.aspx?reference_number=05712228956631596135A116572486
7&live=true" Type="16" ID_Context="0571222895764811657248676570" />
<Vendor TravelSector="Car Rental" Code="CE" CodeContext="59">Centauro</Vendor>
<VendorLocation LocationCode="PMIT081" CodeContext="10" ExtendedLocationCode="1931-CE10"
CounterLocation="14" Name="Palma de Majorca">Palma de Majorca</VendorLocation>
<DropOffLocation LocationCode="PMIT081" CodeContext="10" ExtendedLocationCode="1931-CE10"
CounterLocation="14" Name="Palma de Majorca" />
</VehAvailCore>
<VehAvailInfo>
<PricedCoverages>
<PricedCoverage>
<Coverage CoverageType="Location service charge" Code="LSC">
<Details CoverageTextType="Supplement" />
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="An
additional service charge applies at some airports, railway stations and ports- In this offer it is
included." GuaranteedInd="true" IncludedInRate="true" IncludedInEstTotalInd="true" />
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="Collision damage waiver" Code="CDW">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="Maximum
excess of 400 EUR to be paid in the case of damage. Please note that comprehensive insurance does not
cover damage to wheels, tires, mirrors and underbody" GuaranteedInd="true" IncludedInRate="true"
IncludedInEstTotalInd="true" />
</PricedCoverage>
<PricedCoverage>
<Coverage Code="SLI">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="Legally
required, insurance for damages on the adversarial vehicle, persons and objects- In this offer it is
included." GuaranteedInd="true" IncludedInRate="true" IncludedInEstTotalInd="true" />
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="Personal accident insurance" Code="PAI">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="Increases
the liability amount of cover at damages for persons." GuaranteedInd="true" IncludedInRate="true"
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="Theft protection" Code="TP">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="In case of
theft, there is an excess of 400 EUR. Please note: this does not cover loss of personal items."
GuaranteedInd="true" IncludedInRate="true" IncludedInEstTotalInd="true" />
</PricedCoverage>
<PricedCoverage>
Page 33
<Coverage CoverageType="Unlimited Mileage" Code="UNL">

</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="No further
costs apply for extra miles driven" GuaranteedInd="true" IncludedInRate="true"
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="Airport Service Charge" Code="ASC">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="Some
airports charge a service fee- In this offer it is included." GuaranteedInd="true"
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="One way rental" Code="Oneway">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="possible
from 3 day on with additional charges" GuaranteedInd="true" IncludedInRate="true"
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="PetrolOption" Code="F2E">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="Full-toempty: the vehicle will be delivered with a full tank and should be returned with an empty tank. The
amount for the full tank will be charged at pick up time (plus possible charges which may arise).
Please note the cost of the full tank varies between supplier and location. No refund for unused fuel
except for rentals of less than 3 days duration where a part refund of unused fuel is possible."
GuaranteedInd="true" IncludedInRate="false" IncludedInEstTotalInd="true" />
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="Cancellation" Code="Cancellation">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true"
Description="Cancellation free of charge" GuaranteedInd="true" IncludedInRate="false"
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="Excess" Code="Excessprice">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" Description="With excess" />
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="VAT" Code="TAX">
</Coverage>
<Charge Amount="0.00" CurrencyCode="EUR" TaxInclusive="true" Description="The rate
corresponds with the VAT-rate of the particular country." GuaranteedInd="true" IncludedInRate="true"
</PricedCoverage>
</PricedCoverages>
<PaymentRules>
<PaymentRule PaymentType="4">Full payment due with reservation. Extras to be paid
locally in the local currency. Please note that for local pick up of your car a credit card is required
and that the card holder and driver must be the same person. Prepaid or debit cards, such as Maestro or
Visa electron, are not accepted for pick-up.</PaymentRule>
</PaymentRules>
<TPA_Extensions>
<TermsConditions url="http://createpdf.carhiresolutions.com/termscondition.aspx?reference=0571222895764811657248676570" xmlns="" />
</TPA_Extensions>
</VehAvailInfo>
<AdvanceBooking RulesApplyInd="true" />
</VehAvail>
</VehAvails>
</VehVendorAvail>
</VehVendorAvails>
Page 34
</VehAvailRSCore>
</VehAvailRateRS>
7.5 Handling multiple locations of a supplier

If a supplier has more than one location, a special schema is employed to reflect the multiplicity of
locations.
First of all, the Vendorlocation element of VehAvailRateRS does not contain the location
name then but is set to Multiple in this particular case.
The offer reference number which is returned using the XML element ID_Context can then
be used to request further locations of the destination using VehLocSearch.
For a different location, one has to select one of the returned location ID and to query
vehicles again (VehAvailRate) for that location using the RateQueryParameterType 1.
7.6 Requesting with Country of Origion (Source Country) and

Language
As shown in the sample below POS element has child element ISOCountry. That element can be
used as source country. According to the sample below rates for Canadian source market in English
language are returned as response.
Sample Canada-English:
<VehAvailRateRQ EchoToken="1.0" Version="1" ReqRespVersion="large" PrimaryLangID="EN"
<POS>
<Source ISOCountry="CA">
</Source>
</POS>
<VehAvailRQCore>
</VehRentalCore>
</VehAvailRQCore>
</VehAvailRateRQ>
Page 35
8 RateRules
The Raterules Request permits to retrieve further information of a particular car offer. The most
important are rental terms as well as terms and conditions which are transmitted either as text or as
an URL.
The following parameters can be requested in a Raterule Request/Response:
Parameter
ID_Context
Type
String
Integer
Description
Unique number (offer reference) to be used for
identifying a particular offer for the raterule
request, as obtained from the offer list (response,
VehAvailRateRS).
Text or URL of the rental terms or terms and
conditions.
Always 2 (indicates description)
VendorMessage Subsection
Paragraph Text
VendorMessage InfoType
Age
Minimum Age
Maximum Age
TotalCharge CurrencyCode
PaymentRules
PaymentRule PaymentType
String
Integer
Integer
Describes the minimum age of the driver

Describes the maximum age of the driver
Integer
Describes the way of payment of the car rental

offer
Equipment
Equipment EquipType
Charge CurrencyCode
Integer
String
IncludedInEstTotalInd
String
Calculation UnitCharge
String
Describes the type of equipment

Describes the currency in which the equipment has
to be paid
Describes if the price for the equipment is included
in the rate
Describes on which base the equipment has to be
paid
PricedCoverages
Coverage CoverageType
String
Charge Amount
IncludedInRate
String
Boolean
ChargeCurrencyCode
String
Tax Inclusive
GuaranteedInd
Location Details
LcoationDetails AtAirport
LocationDetails AtCity
Name
Code Context
Extended Location Code
Address Type
Address Line
Boolean
Boolean
String
String
Integer
String
String
String
Describes the different coverages belonging to the

offer
Describes the price of the coverage
Describes if the coverage is included in the rate or
not
Describes the currency in which the coverage has
to be paid
Describes if the tax is inclusive or not
Describes if the location is at an airport or not

Describes if the location is in a city or not
Describes the name of the airport or city
Describes the street name

Page 36
CityName
PostalCode
CountryName Code
Additional Info
ParkLocation Location
String
String
String
String
String
Operation Time
String
Describes the name of the city and the city_id

Describes the postal code of the location
Describes the country_code
Describes additional information of the location
Gives further instruction to the customer where to
pick-up the car exactly
Describes the opening hours of the rental location
Please refer to AvailrateRS for the description of the XML elements not mentioned above.
VehRateRuleRS and VehAvailRateRS shares most of the response elements.
8.1 Sample request:

< OTA_VehRateRuleRQ xmlns="http://www.opentravel.org/OTA/2003/05"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Target="Test" Version="1.000"
PrimaryLangID="EN">
<POS>
</Source>
</POS>
<Reference Type="16" ID_Context="014094581755361298461385357" />
</VehRateRuleRQ>
8.2 Sample response:

<VehRateRuleRS xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" TimeStamp="2011-04-19T19:05:32"
Version="3">
<VehRentalCore CompanyShortName="Hertz" TravelSector="CarRental" Code="ZE" CodeContext="8"/>
DriveType="Unspecified" PassengerQuantity="4" BaggageQuantity="3" VendorCarType="ECMR"
Code="FORD FIESTA TREND" CodeContext="">
<VehType VehicleCategory="1" />
<VehMakeModel Name="FORD FIESTA TREND" Code="ECMR" />
<PictureURL>http://ota2012b.carhiresolutions.com/images/car/hertz/small/ZEESEC999.jpg</PictureURL>
</Vehicle>
<RentalRate>
<RateDistance Unlimited="true" DistUnitName="Km" />
<VehicleCharges>
<VehicleCharge CurrencyCode="GBP" Amount="128.15" TaxInclusive="true" Purpose="original"
/>
<VehicleCharge CurrencyCode="EUR" Amount="146.41" TaxInclusive="true"
Purpose="preferred" RateConvertInd="true" />
</VehicleCharges>
</RentalRate>
<TotalCharge CurrencyCode="GBP" EstimatedTotalAmount="128.15" />
<RateRules>
<PaymentRules>
<PaymentRule PaymentType="4">Full payment will be deducted from your credit card upon
completed reservation. The credit card owner and driver must be the same person.</PaymentRule>
<PaymentRule PaymentType="5">Credit Card is required</PaymentRule>
</PaymentRules>
</RateRules>
<PricedEquips>
<PricedEquip>
Page 37
<Equipment EquipType="7">
<Description>Infant Child Seat</Description>
</Equipment>
<Charge CurrencyCode="EUR" Amount="60.00" Description="BookingCurrencyPrice"
IncludedInEstTotalInd="false">
<Calculation UnitCharge="60.00" UnitName="2-per Rental" Quantity="1" />
</Charge>
</PricedEquip>
<PricedEquip>
<Equipment EquipType="8">
<Description>Child toddler seat</Description>
</Equipment>
<Charge CurrencyCode="EUR" Amount="60.00" Description="BookingCurrencyPrice"
IncludedInEstTotalInd="false">
<Calculation UnitCharge="60.00" UnitName="2-per Rental" Quantity="1" />
</Charge>
</PricedEquip>

</PricedEquips>
<Fees>
<Fee CurrencyCode="EUR" Amount="0.00" TaxInclusive="true" Description="Location service
charge(LSC)" IncludedInRate="true" IncludedInEstTotalInd="true" />
<Fee CurrencyCode="EUR" Amount="0.00" TaxInclusive="true" Description="Vehicle Licence Fee
/ Road fund license(VLF)" IncludedInRate="true" IncludedInEstTotalInd="true" />
<Fee CurrencyCode="EUR" Amount="0.00" TaxInclusive="true" Description="TAX(TAX)"
</Fees>
<PricedCoverages>
<PricedCoverage>
<Details>
<Charge Amount="0.00" IncludedInRate="true" />
</Details>
</Coverage>
<Charge CurrencyCode="EUR" Amount="0.00" TaxInclusive="true" GuaranteedInd="true"
</PricedCoverage>
<PricedCoverage>
<Details>
<Charge />
</Details>
</Coverage>
<Charge Description="With excess" />
</PricedCoverage>

</PricedCoverages>
<LocationDetails AtAirport="true" Code="28593" Name="PALMA DE MALLORCA AP" CodeContext="PMI"
ExtendedLocationCode="1931-ZEPMI">
<Address Type="3">
<StreetNmbr>PALMA DE MALLORCA AP</StreetNmbr>
<AddressLine />
<CityName>51-PALMA DE MALL (BL)</CityName>
<PostalCode>07611</PostalCode>
<CountryName Code="ES">Spain</CountryName>
</Address>
<Telephone PhoneTechType="1" PhoneNumber="971 789670" />
<Telephone PhoneTechType="2" PhoneNumber="0034971789671" />
<AdditionalInfo>
<OperationSchedules>
<OperationSchedule>
<OperationTimes />
</OperationSchedule>
</OperationSchedules>
</AdditionalInfo>
</LocationDetails>
<LocationDetails AtAirport="true" Code="28593" Name="PALMA DE MALLORCA AP" CodeContext="PMI"
ExtendedLocationCode="1931-ZEPMI">
<Address Type="3">
<StreetNmbr>PALMA DE MALLORCA AP</StreetNmbr>
<AddressLine />
Page 38
<CityName>51-PALMA DE MALL (BL)</CityName>

<CountryName Code="ES">Spain</CountryName>
</Address>
<Telephone PhoneTechType="1" PhoneNumber="971 789670" />
<AdditionalInfo>
<OperationSchedule>
<OperationTimes />
</AdditionalInfo>
</LocationDetails>
<VendorMessages>
<VendorMessage Title="terms and conditions of" InfoType="2">
<SubSection>
<Paragraph>
<Text>http://www.carhire-solutions.com/terms/129846138.pdf</Text>
</Paragraph>
</SubSection>
</VendorMessage>
<VendorMessage Title="rental terms of" InfoType="2">
<SubSection>
<Paragraph>
<Text>http://createpdf.carhire-solutions.com/termscondition.aspx?reference=
0397767039364510972288120775</Text>
</Paragraph>
</SubSection>
</VendorMessage>
</VendorMessages>
</VehRateRuleRS>
9 Reservation
All the information given here is specified in OTA2012B as the Vehicle Reservation
Request/Response.
VehResRQ
VehResRS
9.1 Request
The following table displays the parameter, types and a short description of these functions.
Parameter
ISOCountry
Source-RequestorID-Type
Source-RequestorIDID_Context
Customer- Primary- Gender
Customer- Primary- BirthDate
Customer- Primary- Language
Customer- PrimaryCarHire-Solutions - Interface
Type
String
String
String
Enumeration
Date
Integer
String
Description
Defines the source market (of the affiliate)
Username
User password
Male or Female
Customers birthday. It is important to verify
driver age allowance
Customers preferred language in order to get
an appropriate voucher
2:Dr.
Page 39
PersonName - NameTitle
Customer- PrimaryPersonName- GivenName
Customer- PrimaryPersonName- Surname
Customer- PrimaryTelephone- PhoneTechType
Customer- PrimaryTelephone- PhoneNumber
Customer- Primary- Email
Customer- Primary- AddressStreetNmbr
Customer- Primary- Address AddressLine
Customer- Primary- Address CityName
Customer- Primary- Address PostalCode
Customer- Primary- Address
StateProv-StateCode
Customer- PrimaryCitizenCountryName- Code
Customer- Additional BirthDate
Customer- Additional PersonName- GivenName
Customer- Additional PersonName- Surname
VehPref - Code
SpecialEquipPref EquipType
SpecialEquipPref Quantity
RentalPaymentPref PaymentCard- CardType
String
String
String
String
String
Integer
String
String
String
String
String
String
String
String
String
Integer
Integer
String
3:Prof.
4: Prof. Dr.
Customers first name
Customers surname
1: phone(required) 2:fax(optional)
Customers phone number or fax number
(country phone code incl.)
Customers email, must be correct in order to
get voucher
Customers address street number
Extra or second address
Customers address city
Customers address zip code
Customers address state- only used for USA
and Canada. Example: FL (Florida), CA
(California)
Customers country code (DE, FR, UK, DK, etc.)
Second drivers birthday. It is necessary to verify
driver age allowance
Second drivers first name
Second drivers surname
Code which is returned after price verification.
(value of ID_Context of VehAvailRateRS)
Equipment type ID as returned in
VehAvailRateRS
Number of equipment of this type to book
VI: Visa
MC: Master
AX: American Express
9.1.1 Payment
If the price of the reservation is prepaid (refer to 4: terms and definitions) then payment
details must be provided by VehResRQ.
If reserved price is postpaid then payment detail is not necessary to be provided.
Page 40
9.1.2 Equipment
Extra equipments can be booked by providing equipment code (refer to OTA2012B equipment table)
and equipment quantity as shown below.
<SpecialEquipPrefs>
<SpecialEquipPref EquipType="7" Quantity="1" />
</SpecialEquipPrefs>
9.2 Response
Parameter
Type
OTA_VehResRS/ Success
VehResRSCore/
VehReservation / Customer
String
VehResRSCore/
VehReservation /
VehSegmentCore / ConfID/
Type
Integer
VehResRSCore/
VehReservation /
VehSegmentCore / ConfID/ ID
VehResRSCore/
VehReservation /
VehSegmentCore /
ArrivalDetails/
TransportationCode
VehResRSCore/
VehReservation /
VehSegmentCore /
ArrivalDetails/ Number
ArrivalDetails
OperationCompany Code
VehResRSCore/
VehReservation /
VehSegmentCore / RentalRate
/ RateQualifier/ RateCategory
VehResRSCore/
VehReservation /
/ RateQualifier/ RateQualifier
VehResRSCore/
VehReservation /
RateQualifier/ ArriveByFlight
Warnings
String
Description
Returned only when response is successful (no
error)
Primary and Additional Customer information
which were given in the OTA_VehResRQ
Defines the reference number information. It is
expected to have 8 (car rental companys
reference), 16 (Affiliates reference if it is present
in the VehResRQ), 43 (Micronnexus reference
number)
Value for the reference numbers which are
denoted by Type attribute
Integer
Indicator of transportation (only for airport pickup,

TransportationCode is then always 14)
Integer
Flight number
String
2 letter code for airline
String
Unique ID of the rate group
String
Unique ID of the rate
Boolean
Flag indicating whether a flight number is

associated to the reservation
Array
These elements should be considered to be more

informative for the customers. For example in the
sample response shown below, warnings denotes
Page 41
that some chosen equipment couldnt be booked

because of non-availability.
9.3 Sample request

Sample with Credit Card Payment Details:
<OTA_VehResRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" Version="0"
<POS>
<Source ISOCountry="DE">
</Source>
</POS>
<VehResRQCore>
<Customer>
<Primary Gender="Male" BirthDate="1980-10-10" Language="DE">
<PersonName>
<GivenName>Test</GivenName>
<Surname>Test</Surname>
</PersonName>
<Email>test@email.com</Email>
<Address>
<StreetNmbr>bucerriusstrasse 2</StreetNmbr>
<AddressLine></AddressLine>
<CityName>Hamburg </CityName>
</Address>
<CitizenCountryName Code="DE" />
</Primary>
</Customer>
<VehPref Code="0573542246606711815445242008" />
<SpecialEquipPrefs />
</VehResRQCore>
<VehResRQInfo>
<RentalPaymentPref>
<PaymentCard CardType="VI" CardCode="123" CardNumber="************1111" ExpireDate="0214">
<CardHolderName>Test Test</CardHolderName>
</PaymentCard>
</RentalPaymentPref>
</VehResRQInfo>
</OTA_VehResRQ>
Example with equipment, transportation code and additional driver:

<OTA_VehResRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" Version="0"
<POS>
<Source ISOCountry="EN">
</Source>
</POS>
<VehResRQCore>
<Customer>
<PersonName>
Page 42
</PersonName>
<Address>
<StreetNmbr>afsa</StreetNmbr>
<AddressLine>sada</AddressLine>
<CityName>afsf</CityName>
</Address>
</Primary>
<Additional BirthDate="1980-10-10">
<PersonName>
<GivenName>NameAD</GivenName>
<Surname>SurnameAD</Surname>
</PersonName>
</Additional>
</Customer>
<VehPref Code="0573553457286011816238477681" />
<SpecialEquipPrefs>
</SpecialEquipPrefs>
</VehResRQCore>
<VehResRQInfo>
<ArrivalDetails TransportationCode="14" Number="LH4711">
<OperatingCompany Code="LH" />
</ArrivalDetails>
</VehResRQInfo>
</OTA_VehResRQ>
9.4 Sample response

<VehResRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" TimeStamp="2013-10-04T17:46:37" Target="Production"
Version="3" xmlns="http://www.opentravel.org/OTA/2003/05/common">
<Warnings>
<Warning Code="3">The chosen equipment is unavailable- code:7</Warning>
<Warning Code="3">The chosen equipment is unavailable- code:8</Warning>
</Warnings>
<VehResRSCore ReservationStatus="Confirmed">
<VehReservation>
<Customer>
<PersonName>
</PersonName>
<Address>
<StreetNmbr>Bucerriusstrasse 2</StreetNmbr>
<CityName>Hamburg</CityName>
</Address>
<PaymentForm>
<Voucher SupplierIdentifier="12345678" Identifier="MN1111111111111"
ValueType="http://createpdf.carhire-solutions.com/Documents/PDF.aspx?ReferenceNumber=
MN1111111111111Affiliate_ID=123" />
</PaymentForm>
</Primary>
<Additional BirthDate="1980-10-10">
<PersonName>
<GivenName>NameAD</GivenName>
<Surname>SurnameAD</Surname>
</PersonName>
Page 43
</Additional>
</Customer>
<VehSegmentCore>
<ConfID Type="8" ID_Context=" 123456789" />
<ConfID Type="43" ID_Context="MN1111111111111" />
<ConfID Type="16" ID_Context="6789010" />
<Vendor CompanyShortName="Avis" TravelSector="Car Rental" Code="ZI">48631651GB5</Vendor>
<PickUpLocation LocationCode="1069174" CodeContext="PMI" ExtendedLocationCode="1931ZIPMI">Palma De Majorca Airport (PMI), Aeropuerto De Palma </PickUpLocation>
<ReturnLocation LocationCode="1069174" CodeContext="PMI" ExtendedLocationCode="1931ZIPMI">Palma De Majorca Airport (PMI), Aeropuerto De Palma </ReturnLocation>
</VehRentalCore>
DriveType="Unspecified" PassengerQuantity="7" BaggageQuantity="1" VendorCarType="ICMR"
CodeContext="Immediate 2/4 Door Car">
<VehType VehicleCategory="C" DoorCount="2" />
<VehMakeModel Name="Volkswagen Touran" Code="ICMR" />
<PictureURL>http://ota2012b.carhiresolutions.com/images/car/Avis/small/ES0_icmr.jpg</PictureURL>
</Vehicle>
<RentalRate>
<RateDistance Unlimited="true" DistUnitName="Km" VehiclePeriodUnitName="RentalPeriod" />
<VehicleCharges>
<VehicleCharge Amount="247.72" CurrencyCode="GBP" TaxInclusive="true" Purpose="original" />
<VehicleCharge Amount="293.89" CurrencyCode="EUR" TaxInclusive="true" RateConvertInd="true"
Purpose="preferred" />
</VehicleCharges>
<RateQualifier RateCategory="M972601" RateQualifier="F8__GB" ArriveByFlight="false" />
</RentalRate>
<PricedEquips>
<PricedEquip>
<Equipment EquipType="222" Quantity="1">
<Description> Additional Driver</Description>
</Equipment>
<Charge Amount="7.08" CurrencyCode="EUR" Description="BookingCurrencyPrice"
IncludedInRate="true" IncludedInEstTotalInd="true">
<Calculation UnitCharge="70.80" UnitName="BookingCurrencyMaxPrice" Quantity="1" />
</Charge>
</PricedEquip>
<PricedEquip>
<Equipment EquipType="222" Quantity="1">
<Description> Additional Driver</Description>
</Equipment>
<Charge Amount="7.08" CurrencyCode="EUR" Description="BookingCurrencyPrice"
IncludedInRate="true" IncludedInEstTotalInd="true">
<Calculation UnitCharge="70.80" UnitName="BookingCurrencyMaxPrice" Quantity="1" />
</Charge>
</PricedEquip>
</PricedEquips>
<Fees>
<Fee Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="VAT(TAX)"
</Fees>
</VehSegmentCore>
<VehSegmentInfo>
<PaymentRules>
<PaymentRule PaymentType="32">Full payment will be deducted from your credit card by the car
rental supplier at time of pickup. Please note that for local pick up of your car a credit card is
required and that the card holder and driver must be the same person. Prepaid or debit cards, such as
Maestro or Visa electron, are not accepted for pick-up.</PaymentRule>
</PaymentRules>
<PricedCoverages>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Maximum excess of
658 EUR to be paid in the case of damage. Please note that comprehensive insurance does not cover
damage to wheels, tires, mirrors and underbody" GuaranteedInd="true" IncludedInRate="true"
Page 44
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Legally required,
insurance for damages on the adversarial vehicle, persons and objects- In this offer it is included."
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="In case of theft,
there is an excess of 658 EUR. Please note: this does not cover loss of personal items."
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="No further costs
apply for extra miles driven" GuaranteedInd="true" IncludedInRate="true" IncludedInEstTotalInd="true"
/>
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Some airports
charge a service fee- In this offer it is included." GuaranteedInd="true" IncludedInRate="true"
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="possible with
additional charges" GuaranteedInd="true" IncludedInRate="true" IncludedInEstTotalInd="true" />
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="PetrolOption" Code="F2F">
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Full to full tank
" GuaranteedInd="true" IncludedInRate="false" IncludedInEstTotalInd="true" />
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Cancellation fees
may apply. Please refer to the Rental Terms. " GuaranteedInd="true" IncludedInRate="false"
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" Description="With excess" />
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="The rate
</PricedCoverage>
</PricedCoverages>
</VehSegmentInfo>
</VehReservation>
</VehResRSCore>
Page 45
<VehResRSInfo>
<TPA_Extensions>
<TermsConditions url="http://www.carhire-solutions.com/terms/1069174.pdf" xmlns="" />
</TPA_Extensions>
</VehResRSInfo>
</VehResRS>
10 Cancellation
All the information given here is specified in OTA2012B as the Vehicle Cancellation
Request/Response.
VehCancelRQ
VehCancelRS
This section describes how to cancel an existing reservation.

A cancellation only can be performed by using the reference number and the customer last name
(must be same as original customer name in vehicle reservation request/VehResRQ) by email or
telephone to customer service.
The cancellation fee will be provided by response of web service (also if cancellation is not charged).
Page 46
Cancellation
Customer
Log-in Reservation with

Reservation-Number and
Last Name
Confirmation
with
Cancellation Fee
Confirmation
without
Cancellation Fee
Abort by
Customer
Cancel the
Reservation
CarHire
Platform
Supplier concerned
Figure 7 Cancellation
Request:
In order to cancel an existing reservation, the reference number which is returned by VehResRS
must be used (ID_Context) in combination with the customers surname which can also be
obtained from VehResRS.
10.1 Response
A cancellation status (refer to 14.5: reservation status table) is responded by vehCancelRS that
identifies either cancellation is successful or not (might be pending, rejected, etc.)
10.2 Sample request

Page 47
<VehCancelResRQ xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd=http://www.w3.org/2001/XMLSchema EchoToken= Version=15
xmlns=http://www.opentravel.org/OTA/2003/05>
<POS>
<Source ISOCountry=ES>
<RequestorID Type=xxxxx ID_Context=yyyyy />
</Source>
</POS>
<VehCancelRQCore CancelType=Book>
<UniqueID ID_Context=MNxxxxxx />
<PersonName>
<Surname>xxxxx</Surname>
</PersonName>
</VehCancelRQCore>
</VehCancelResRQ>
10.3 Sample response

<VehCancelResRS xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd=http://www.w3.org/2001/XMLSchema Version=1.9
<VehCancelRSCore CancelStatus=Cancelled>
<CancelRules>
<CancelRule Amount=0 />
</CancelRules>
<UniqueID ID_Context=3 />
</VehCancelRSCore>
</VehCancelResRS>
11 Retrieve Reservation
All the information given here is specified in OTA2012B as the Vehicle Retrieve Reservation Request.
VehRetResRQ
VehRetResRQ
One of the main purposes of retrieving reservation is to check a reservation which has been set to
status pending or on request whether the reservation status has changed or not. This is because
sometimes it is necessary for the supplier to process a reservation manually (offline) for some reason
(car of the category not available, etc.), then a periodical job may check the reservation status of all
reservations which are recorded as pending on request.
A retrieve can only be performed using the reference number and the customer last name (must be
same as in the original reservation request).
Page 48
Retrieve
Customer

Last Name
Vehicle Reservation
Summary
Retrieve
CarHire
Platform
Supplier concerned
Figure 8 Retrieve Reservation
11.1 Request
In order to retrieve reservation details, the reference number returned within VehResRS must be
used in combination with the customers surname that is also given in the VehResRS.
11.2 Response
By VehRetResRS, customers are able to see the latest status of reservation and a full overview.
11.3 Sample-Request
?xml version="1.0" encoding="utf-8"?>
<OTA_VehRetResRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" EchoToken="1.0" Version="0"
<POS>
<Source>
</Source>
Page 49
</POS>
<VehRetResRQCore>
<UniqueID ID_Context="MN11111111111" />
<PersonName>
<Surname>Surname</Surname>
</PersonName>
</VehRetResRQCore>
</OTA_VehRetResRQ>
11.4 Sample-Response
<VehRetResRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" EchoToken="1.0" TimeStamp="2013-10-08T15:31:33"
Target="Production" Version="3" xmlns="http://www.opentravel.org/OTA/2003/05/common">
<VehRetResRSCore>
<VehReservation ReservationStatus="In process">
<Customer>
<Primary Gender="Male" BirthDate="1980-10-10">
<PersonName>
</PersonName>
<Address>
<StreetNmbr>buseriussStrasse 2</StreetNmbr>
</Address>
</Primary>
</Customer>
<VehSegmentCore>
<ConfID Type="43" ID_Context="MN1111111111111" />
<Vendor CompanyShortName="Avis" TravelSector="Car Rental" Code="ZI">on request</Vendor>
<PickUpLocation LocationCode="1069174" CodeContext="PMI" ExtendedLocationCode="1931ZIPMI">Palma De Majorca Airport (PMI), Aeropuerto De Palma </PickUpLocation>
<ReturnLocation LocationCode="1069174" CodeContext="PMI" ExtendedLocationCode="1931ZIPMI">Palma De Majorca Airport (PMI), Aeropuerto De Palma </ReturnLocation>
</VehRentalCore>
DriveType="Unspecified" PassengerQuantity="5" BaggageQuantity="1" VendorCarType="CCMR"
CodeContext="Compact 2/4 Door Car">
<VehType VehicleCategory="C" DoorCount="2" />
<VehMakeModel Name="Seat Leon" Code="CCMR" />
<PictureURL>http://ota2012b.carhiresolutions.com/images/car/Avis/small/ES0_ccmr.jpg</PictureURL>
</Vehicle>
<RentalRate>
<RateDistance Unlimited="true" DistUnitName="Km" VehiclePeriodUnitName="RentalPeriod" />
<VehicleCharges>
<VehicleCharge Amount="128.91" CurrencyCode="GBP" TaxInclusive="true" Purpose="original" />
<VehicleCharge Amount="152.79" CurrencyCode="EUR" TaxInclusive="true" RateConvertInd="true"
Purpose="preferred" />
</VehicleCharges>
<RateQualifier RateCategory="M972601" RateQualifier="F8__GB" ArriveByFlight="true" />
</RentalRate>
<Fees>
<Fee Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="VAT(TAX)"
</Fees>
</VehSegmentCore>
<VehSegmentInfo>
<PaymentRules>
Page 50
<PaymentRule PaymentType="32">Full payment will be deducted from your credit card by the car
rental supplier at time of pickup. Please note that for local pick up of your car a credit card is
required and that the card holder and driver must be the same person. Prepaid or debit cards, such as
Maestro or Visa electron, are not accepted for pick-up.</PaymentRule>
</PaymentRules>
<PricedCoverages>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Maximum excess of
658 EUR to be paid in the case of damage. Please note that comprehensive insurance does not cover
damage to wheels, tires, mirrors and underbody" GuaranteedInd="true" IncludedInRate="true"
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Legally required,
insurance for damages on the adversarial vehicle, persons and objects- In this offer it is included."
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="In case of theft,
there is an excess of 658 EUR. Please note: this does not cover loss of personal items."
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="No further costs
apply for extra miles driven" GuaranteedInd="true" IncludedInRate="true" IncludedInEstTotalInd="true"
/>
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Some airports
charge a service fee- In this offer it is included." GuaranteedInd="true" IncludedInRate="true"
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="possible with
additional charges" GuaranteedInd="true" IncludedInRate="true" IncludedInEstTotalInd="true" />
</PricedCoverage>
<PricedCoverage>
<Coverage CoverageType="PetrolOption" Code="F2F">
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Full to full tank
" GuaranteedInd="true" IncludedInRate="false" IncludedInEstTotalInd="true" />
</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="Cancellation fees
may apply. Please refer to the Rental Terms. " GuaranteedInd="true" IncludedInRate="false"
</PricedCoverage>
<PricedCoverage>
</Coverage>
Page 51
<Charge Amount="0.00" CurrencyCode="GBP" Description="With excess" />

</PricedCoverage>
<PricedCoverage>
</Coverage>
<Charge Amount="0.00" CurrencyCode="GBP" TaxInclusive="true" Description="The rate
</PricedCoverage>
</PricedCoverages>
</VehSegmentInfo>
</VehReservation>
</VehRetResRSCore>
<VehRetResRSInfo>
<TPA_Extensions>
<TermsConditions url="http://www.carhire-solutions.com/terms/1069174.pdf" xmlns="" />
</TPA_Extensions>
</VehRetResRSInfo>
</VehRetResRS>
12 Modify
All the information given here is specified in OTA2012B as the Vehicle Modify Request VehModRQ.
Modifications (or amendments) can only be performed via Customer-Login by using the
reservation reference number and the customers last name (must be same as original reservation
request customer name).
There are several kinds of modifications the customer can do. Some of the modification might cause
a new reference number and/or extra fee, see the chart below for details.
Page 52
Modify
Customer

Last Name
Modification
CUSTOMER INFO
EQUIPMENT
SEARCH DETAILS
FLEET DETAILS
- Address
- Telephone-Number
- Mobilphone-Number
- Zip-Code
- Add Equipment
- Remove Equipment
- Pick-up/Drop-off Time
- Pick-up/Drop-off Location
- Car Group (Upgrade

fee possibly necessary)
- First Name
- Last Name
Modification of these
two items are not
possible with all
suppliers!
Might cause a new

Reference-Number and
additional fee
CarHire
Platform
Supplier concerned
Figure 9 Amendment
Page 53
12.1 Request
The request for modifications is identical to VehResRQ, but an attribute named ModifyType
inside of VehModifyRQCore must be provided, as well as the previously returned reservation
reference number.
12.2 Response
Identical with VehResRS, with the only difference of having the attribute ModifyStatus
which is returned rather than ReservationStatus.
New reservation reference number might be applied with an additional modification fee.
12.3 Sample request

<VehModifyRQ xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd=http://www.w3.org/2001/XMLSchema Version=0
<POS>
<Source>
<RequestorID Type=Testaffiliate ID_Context=test$$08 />
</Source>
</POS>
<VehModifyRQCore ModifyType=Modify>
<UniqueID ID_Context=MN21573062183 />
<Customer>
<Primary Gender=Male BirthDate=1981-01-01 Language=DE>
<PersonName>
<Surname>Tester</Surname>
</PersonName>
<Telephone PhoneTechType=1 PhoneNumber=494018889888 />
<Address>
<StreetNmbr>2</StreetNmbr>
<AddressLine>Curienstr.</AddressLine>
</Address>
<CitizenCountryName Code=DE />
</Primary>
</Customer>
<VehPref Code=16392241361072997526170712 />
</VehModifyRQCore>
</VehModifyRQ>
Page 54
12.4 Sample response

<?xml version=1.0 encoding=utf-16?>
<VehModifyRS xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd=http://www.w3.org/2001/XMLSchema TimeStamp=2009-08-24T19:50:36.2005141+02:00
Version=20 xmlns=http://www.opentravel.org/OTA/2003/05>
<VehModifyRSCore ModifyStatus=confirmado>
<VehReservation>
<Customer>
<Primary Gender=Male BirthDate=1981-01-01 Language=DE>
<PersonName>
<Surname>Tester</Surname>
</PersonName>
<Address>
<StreetNmbr>2</StreetNmbr>
<AddressLine>Curienstr.</AddressLine>
</Address>
<CitizenCountryName Code=DE />
</Primary>
</Customer>
<VehSegmentCore>
<ConfID Type="43" ID_Context=" MN21573062183" />
<Vendor CompanyShortName=Testsupplier Code=TS>MN21573748860</Vendor>
<VehRentalCore PickUpDateTime=2009-09-25T12:00:00 ReturnDateTime=2009-0930T12:00:00>
<PickUpLocation LocationCode=236110 CodeContext=POA1>TEST Airport (TTT), SALGADO
FILHO AIRPORT, AV SEVERO DULLIUS</PickUpLocation>
<ReturnLocation LocationCode=236110 CodeContext=POA1>TEST Airport (TTT), SALGADO
FILHO AIRPORT, AV SEVERO DULLIUS</ReturnLocation>
</VehRentalCore>
<Vehicle AirConditionInd=true TransmissionType=Manual FuelType=Petrol
PassengerQuantity=5 BaggageQuantity=5 VendorCarType=SVMR CodeContext=>
<VehType VehicleCategory=V DoorCount=2 />
<VehClass Size=7 />
<VehMakeModel Name=Ford Focus C-Max A/C Code=SVMR />
<PictureURL>http://ota2007a.mietwagenmarkt.de/images/car/centauro/small/fordFocusCMAX.jpg</Pic
tureURL>
</Vehicle>
<RentalRate>
<RateDistance Unlimited=true />
<VehicleCharges>
<VehicleCharge CurrencyCode=EUR Amount=156.41 TaxInclusive=true
Purpose=original />
<VehicleCharge CurrencyCode=EUR Amount=156.41 TaxInclusive=true
Purpose=preferred />
</VehicleCharges>
<RateQualifier RateCategory=Special Test RateQualifier=Test Special
ArriveByFlight=true />
</RentalRate>
<Fees>
<Fee Amount=0 Description=Location service charge(LSC) IncludedInRate=true />
<Fee Amount=0 Description=TAX(TAX) IncludedInRate=true />
</Fees>
<TotalCharge CurrencyCode=EUR EstimatedTotalAmount=156.41 />
</VehSegmentCore>
</VehReservation>
</VehModifyRSCore>
</VehModifyRS>
Page 55
13 Location
13.1 List of Locations
All the information given here is specified in OTA2012B as the Vehicle Location Request/Response.
VehLocRQ
VehLocRS
It is possible to query the locations based on the following geographical filters (s. Ch. 14 for more on
codes and IDs)
City: Using the Name, ID or IATA

Airport: Using the Name, ID or IATA
Offer: Using the reference number of a given offer
The following table illustrates the parameter combinations permitted for location requests.
Query-Level
City
Airport
Offer
ISO-Code
Yes
Yes
No
Region-ID
No
No
No
RefPointType
Yes
Yes
Yes
CityName
Yes
Yes
Yes
It is possible to reduce the returned results for a single supplier by defining the Vendor attribute.
Note that any information given by an ID can be encoded using the tables in 14 (appendix).
13.1.1 Request
Parameter
RefPoint CountryCode
RefPoint StateProv
RefPoint RefPointType
Type
String
Integer
Integer
Req
Y
N
N
RefPoint CityName
Vendor
String
String
N
N
Description
ISO code of the country
ID of the region
Defines the query type:
1. City_ID
2. City_IATA
3. City_Name
4. Airport_ID
5. Airport_IATA
6. ReferenceNumber (pickup)
7. ReferenceNumber (dropoff)
Defines the source market
Defines the supplier leave it empty to return all
Page 56
13.1.2 Response
Parameter
LocationDetail AtAirport
LocationDetail Code
LocationDetail Name
Type
Boolean
String
String
LocationDetail CodeContext
String
LocationDetail Extended
Location Code
String
Description
Flag indication if location is an airport location
Code used to identify the location
Full name of the location
Specifier of the list the location code has been obtained
from (e.g. IATA, OAG, international company code)
Extended OAG code
13.1.3 Sample-Request
Using CityName all suppliers:
<VehLocationSearchRQ>
<POS xmlns="http://www.opentravel.org/OTA/2003/05">
<Source ISOCountry="DE">
</Source>
</POS>
<VehLocSearchCriterion xmlns="http://www.opentravel.org/OTA/2003/05">
<RefPoint CountryCode="DE" RefPointType="3" CityName="Hamburg">Hamburg</RefPoint>
<CodeRef LocationCode="Hamburg" />
<Radius Distance="0" DistanceMeasure="km" DistanceMax="50" />
</VehLocSearchCriterion>
</VehLocationSearchRQ>
Using CityName filtered by single supplier:

<Request xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd=http://www.w3.org/2001/XMLSchema EchoToken=1.0 Version=0
<POS>
<Source>
<RequestorID Type=xxxxx ID_Context=yyyyy />
</Source>
</POS>
<VehLocSearchCriterion>
<RefPoint StateProv=1 CountryCode=DE RefPointType=3 CityName=Hamburg />
<Vendor>ZE</Vendor>
</Request>
Using offer reference for multiple locations

<Request xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd=http://www.w3.org/2001/XMLSchema EchoToken=1.0 Version=0
<POS>
<Source>
<RequestorID Type="xxxxx" ID_Context="xxxxx" />
</Source>
</POS>
<RefPoint RefPointType="7">000618699443153906553783246</RefPoint>
</Request>
Page 57
13.1.4 Sample-Response
<VehLocationSearchRS TimeStamp="2011-04-20T14:51:12" Version="3">
<VehMatchedLocs xmlns="http://www.opentravel.org/OTA/2003/05">
<VehMatchedLoc>
<LocationDetail AtAirport="false" Code="776401" Name="AHRENSBURGER STR 138 148"
CodeContext="25392" ExtendedLocationCode="47-AE25392">
<Address>
<StreetNmbr />
<AddressLine />
<CityName>47-HAMBURG</CityName>
<CountryName Code="DE">Deutschland</CountryName>
</Address>
<Telephone RPH="" />
</LocationDetail>
<Position Latitude="0" Longitude="0" />
</VehMatchedLoc>
</VehMatchedLocs>
</VehLocationSearchRS>
13.2 Location Details

This section displays details of desired location.
VehLocDetailRQ
VehLocDetailRS
Main purpose of VehLocDetailRQ is to obtain address data and opening hours of a particular location.
13.2.1 Request
Parameter
Type
Location CodeContext
Integer
Location LocationCode
Location Text
Vendor
Integer
String
String
Req
Y
N
N
N
Description
Defines the query type
1. Location_ID
2. GDSCode+LocationCode
3. LocationName
ID of Region
Defines the source market
Defines the Supplier leave empty to return all
Page 58
13.2.2 Response
Parameter
OperationTime Mon, Tue, Wed,
Thu, Fri, Sat, Sun
OperationTime Start
OperationTime End
Type
Boolean
Time
Time
Description
Flag indicating if the location is opened on Mondays,
Tuesdays,
Time when location opens
Time when location closes
Note that each weekday might appear up to three times. Note too that displaying 12 oclock PM has
an exceptional value: 23:59.
13.2.3 Sample request

Using Location_ID (CodeContext = 1):

< VehLocDetailRQ xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd=http://www.w3.org/2001/XMLSchema xmlns=http://www.opentravel.org/OTA/2003/05>
<POS>
<RequestorID Type= xxxxx ID_Context= yyyyy />
</Source>
</POS>
<Location CodeContext=1 LocationCode= 1216521> </Location>
</ VehLocDetailRQ>
Using GDSCode+LocationCode (CodeContext = 2):

< VehLocDetailRQ xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd=http://www.w3.org/2001/XMLSchema xmlns=http://www.opentravel.org/OTA/2003/05>
<POS>
<RequestorID Type= xxxxx ID_Context= yyyyy />
</Source>
</POS>
<Location CodeContext=2 ExtendedLocationCode=ZEARN />
</ VehLocDetailRQ>
Page 59
13.2.4 Sample response

<VehLocDetailRS xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xmlns:xsd=http://www.w3.org/2001/XMLSchema Version=2.0
<LocationDetail AtAirport=true Code=1091515 Name=Mallorca CodeContext=PMI
ExtendedLocationCode=1931-DFPMI>
<Address Type=3>
<StreetNmbr>Aeropuerto De Palma</StreetNmbr>
<AddressLine />
<CityName>Palma De Mallorca</CityName>
<CountryName Code=ES />
</Address>
<AdditionalInfo>
<OperationSchedule>
<OperationTimes>
<OperationTime Mon=true Start=07:30 End=23:59 />
</OperationTimes>
</AdditionalInfo>
</LocationDetail>
</VehLocDetailRS>
Page 60
14 Appendix
The appendix contains some example tables of possible values of OTA parameters. For a complete
overview to the parameter values see the export files inside of http://www.carhiresolutions.com/export/. This folder contains several files with comma separated values (CSV) which
are updated in regular intervals.
14.1 Language table

These are the given languages with the corresponding language ID and codes.
Language ID
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
Language_Code
DE
EN
FR
IT
HU
PL
SK
CZ
ES
RU
CN
SE
BG
NL
TR
DK
FI
RO
NO
FL
HE
PT
TH
MY
JP
KR
AR
HI
Language_Code2
de-DE
en-GB
fr-FR
it-IT
hu-HU
pl-PL
sk-SK
cs-CZ
es-ES
ru-RU
zh-CN
sv-SE
bg-BG
nl-NL
tr-TR
da-DK
fi-FI
ro-RO
nb-NO
nl-BE
he-IL
pt-PT
th-TH
ms-MY
ja-JP
ko-KR
ar-AE
hi-IN
Language_Description
German
English
French
Italian
Hungarian
Polish
Slovakian
Czech
Spanish
Russian
Chinese
Swedish
Bulgarian
Dutch
Turkish
Danish
Finnish
Rumanian
Norwegian
Flemish
Hebrew
Portuguese
Thai
Malay
Japanese
Korean
Arabian
Hindi
Page 61
14.2 Region table

These are some sample countries with the corresponding international country codes. The complete
list of countries can be obtained from http://www.carhiresolutions.com/export/Export_Countries.csv.
Country_ID
1
2
3
6
7
8
9
10
11
12
13
Country_Name_EN
Germany
Switzerland
Spain
Austria
France
United States of America
Greece
Turkey
Denmark
Italy
Portugal
Country_ISO
DE
CH
ES
AT
FR
US
GR
TR
DK
IT
PT
Country_ISO2
DEU
CHE
ESP
AUT
FRA
USA
GCE
TUR
DNK
ITL
PRT
Country_ISO3
276
756
724
40
250
840
300
792
208
380
620
14.3 Airport table

These are some sample airports with the corresponding internal Airport-ID and Airport
IATA-Code. The complete list can be found at http://www.carhiresolutions.com/export/Export_Airports.csv.
Airport_ID
6
10
14
15
17
18
21
22
23
24
26
27
29
31
32
33
Airport_IATA
AAL
AAR
ABE
ABI
ABQ
ABR
ABX
ABY
ABZ
ACA
ACC
ACE
ACK
ACT
ACV
ACY
Airport_Name_EN
Aalborg Airport
Aarhus Airport
Allentown Lehigh Valley International Airport
Abilene Municipal Airport
Albuquerque International Airport
Aberdeen Municipal Airport
Albury Airport
Albany Dougherty County Airport
Aberdeen Dyce Airport
Acapulco General Juan N. Alvarez International Airport
Accra Kotoka Airport
Arrecife Lanzarote Airport
Nantucket, Nantucket Memorial Airport
Waco Municipal Airport
Arcata Airport
Atlantic City International Airport
Page 62
14.4 City table

These are some sample cities with the corresponding internal City-ID and City-IATA codes. Note that
not all cities have an IATA code. The complete list can be found at http://www.carhiresolutions.com/export/Export_Cities.csv.
City_ID
389
59
12239
9547
390
60
1278
2182
2183
8648
11235
391
11209
14075
City_Name_EN
Aabenraa
Aachen
Aakirkeby
Aal
Aalborg
Aalen
Aalesund
Aalst
Aandalsnes
Aarau
Aardalstangen
Aarhus
Aarup
Aas
City_IATA
AAH
AAL
AES
AAR
AAP
14.5 Reservation status table

ID
1
2
3
4
5
7
8
9
13
15
20
21
23
24
25
26
27
29
Reservation Status
on request
confirmed
cancelled by customer
open
cancelled by supplier
confirmed - Voucher in process
cancellation pending
cancellation ignored
Amend pending
No Show
Amended - No valid reservation
! Attention: Not booked
Rebooked
Failed - not Rebooked
Test Reservation
Waiting for feedback from client
Shop - failed closed
Reservation ignored
Page 63
30
31
32
35
36
37
38
43
44
45
46
47
Reminder
Double Booking
Cancelled by Shop
Car was picked up
Ignored
Ended Current
Ended Previous
Cancelled-free of charge (goodwill)
Supplier confirmation goes to affiliate
Cancellation from Affiliate to Supplier
Confirmed Supplier payment rule changed
Fake Booking
14.6 Location type table

LocationType_ID
1
2
3
4
5
6
7
8
9
10
11
LocationType_Name
Location
Train station
Airport
Airport/Train station
Ferry/Seaport
Delivery Only
City/Downtown
Railway/Bus Station
Garage/Hotel
Unmanned
Chauffeur
14.7 Supplier table

The most recent list of car rental suppliers is available at http://www.carhiresolutions.com/export/Export_Suppliers.csv.
Supplier_ID
8
10
11
19
20
22
30
31
34
36
Supplier_DisplayName
Hertz
Avis
Sixt
holidayautos
Sunnycars
Sol Mar
Europcar
AutoEurope
Goldcar rental
Alamo
Supplier_GDSCode
ZE
ZI
SX
HA
SC
SM
EP
ZU
GR
AL
Page 64
37
38
40
41
44
46
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
76
77
78
80
81
82
83
84
85
86
87
88
Fox Autorent
Sixt holidayCars
Unirent
driveFTI
CarDelMar
Hawk rent a car
m-broker
Klees
Dollar Germany
eMietwagen
Special Offer
Record rent a car
Locauto
AurigaCrown
Budget
easycar
Centauro
Autocandia
Enterprise
National
Hiper Rent a Car
Dollar
Auto Rent
Hertz Bulgaria
Top Rent a Car
Avis Spain
SAY Rent a Car
Bravacar
Guerin
Hertz Canaries
Thrifty Car Rental
Helle Hollis Car Rental
Niza Cars
Europcar France
Europcar Kanaren
First Car Rental South Africa
holiday-autos
296 Rent-a-car
Special Deal
Hertz Balearics
Sixt Italy
Budget Israel
BerElek
GetYourCar
FR
SH
UN
DF
CM
HW
MB
KL
DG
TR
SO
RC
LA
AG
ZD
EC
CE
AU
ET
ZL
HP
ZR
AR
HB
IC
RR
SR
BC
GN
HC
ZT
HH
NC
EF
SZ
FS
HU
AZ
SD
HD
SF
BS
BR
GY
Page 65
89
90
92
93
94
95
96
99
100
101
102
103
104
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
136
137
138
139
140
141
142
Thrifty Australia
Buchbinder
Cicar
Auto Jardim
Pops Car
TUI Cars
TUI Portugal rent a car
Thai Cars
ATESA National Renting
AVIA CAR
Sixt Cyprus
Special Deal
Sixt Greece
Hertz Greece
Jumbo Car Runion
Jumbo Car Guadeloupe
Avis Marocco
Pop's Car Martinique
TargaRent
Budget New Zealand
Avis Corsica
Avis Malta
Avis Slovenia
Avis Malaysia
Avis Italy ex Si Sa
Avis France
Gozo
Avis Croatia
Z&X Cyprus
Sixt Croatia
Thrifty India
353 car rental
SamiCar
First-Car
Locationauto
Thrifty Libanon
Dollar Rentacar
Thrifty Niederlande
Thrifty New Zealand
Thrifty Griechenland
Thrifty Sdafrika/Namibia
Thrifty UK
Thrifty Morocco
Thrifty Karibik & Lateinamerika
TA
BO
CX
AJ
PC
TC
TP
HX
AT
AV
SY
LO
SG
HG
HN
HO
AM
PM
BI
BZ
AK
AA
AP
AY
AI
AF
GO
AC
ZX
SA
DI
CR
SI
FC
LC
TL
DA
TN
HZ
TG
DZ
TU
TM
TK
Page 66
143
144
145
146
147
148
149
150
151
161
162
163
164
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
196
197
198
Thrifty gypten
Thrifty Oman
Thrifty VAE
Thrifty Jordanien
Thrifty Kuwait
Thrifty Lybien
Thrifty Qatar
Thrifty Trkei
Thrifty Irland
Thrifty
Croatia/Slovenia/Bosnia/Serbien
Thrifty Zypern
Thrifty Bulgarien
Sixt Serbien
SR Rent a Car
Victoria Rent a Car
Budget Romania
Amigos do Auto
Thrifty Italy by Car
Sixt Malta
touRent Crete
Traffic
National Greece
Season Cars
Thrifty Malta
First Car Mauritius
Sixt Montenegro
Thrifty Tschechien
BalatonCar
Prima Rent
Alamo_
Thrifty Russia
Sixt Mauritius
Europcar Corsica
Extraspecial
DerTour
Atlasoption
AutoEscape
mietwagen.com
Woodford
Limo Cyprus Car Hire
SurPrice Car Rentals
Firefly Car Rental
PepeCar
TE
TO
TV
TJ
TW
YL
TQ
TT
TI
TH
TZ
TB
SS
SE
VI
BA
AQ
IB
XM
CT
TF
NG
CS
TY
MA
XN
YT
BL
PR
AL_
RT
SJ
CO
ES
DE
AO
AE
MW
WO
LI
SU
FF
PE
Page 67
200
203
204
206
207
208
209
211
212
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
230
229
231
236
234
237
238
239
STARCAR
EuroRent
Indian Ocean
Hertz Romania
Fox Rent-a-car
Express S.A.
Procar Rental
addCar rental
Easirent
Autos Valls
Caro Autovermietung
Lagorent Rent-a-Car
Bravo Rent a Car
AirCar
Sicily By Car
Hertz Portugal
Orlando Rent A Car
Budget VAE
Budget Rhodos
Payless Car
Sicily Rent a Car
BK Rent a Car
Unidas
movida rent a car
Foco aluguel de carros
E-Z Rent-A-Car
Thrifty Seychelles
Ideal Car Hire
Fleet Rent a car
ACO Rent a Car
Thrifty Mexico
Drive On Holidays
ST
ER
IO
EO
FX
EE
PO
AH
EI
VA
CA
LR
BV
AN
SBC
HEP
ORL
BUA
BD
PAC
SL
BKR
UI
MV
EZ
TS
FT
AO
14.8 Credit card table

Credit card code
VI
MC
AX
Credit card name

VISA
Mastercard
American Express
Page 68
14.9 Error types

ErrorType_ID
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
35
38
40
41
42
43
44
45
46
ErrorType_Name_EN
A general error has occurred
The interface of the supplier is not responding
The interface of the supplier has produced a general error
The chosen rental period contains a logical error
The pickup station is closed in the chosen period
The drop off station is closed in the chosen period
No vehicles are available for the chosen period and
criteria. Please change your parameters.
The latest booking period for this offer has expired
Unknown Rental Station
Unknown access
Credit card couldnt be verified
Credit card seems to be invalid
No location found to start query
Session has expired
The desired car type is not available
Login Failure
The reservation has already been transferred
The offer for the desired vehicle is not active anymore.
Please make a new search.
Please check your entered data
The chosen equipment is unavailable
The Pickup specified could not be found in the system
The Dropoff specified could not be found in the system
Unfortunately this oneway rental is not permitted
The rental station is not open this day
Invalid Pickup Station
Incorrect XML-Request
Travel between these stations is not permitted
Reservation already cancelled
The reservation couldn't be found in the system of the
supplier.
Invalid Parameters
Reference is missing for offer
Customer Information is missing
Name on credit card must match client name.
Reservation price lower than agency price
Stop Sale
Booking of an allocated vehicle
Planning Problems, booking cannot be done
Internal error of cancellation of booking. Please try again
Internal error of amendment of booking. Please try again
Customer can only cancel by phone
Location ID incorrect
Over or Underpayment on CC
ErrorType_OTA_Code
197, 448
723
724
145
227
214
221
425
190
242
242
425
302
297
308
229
233
224
227
229
224
95
97
113
322
193
210
290
Page 69
ErrorType_ID
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
66
67
68
69
70
71
72
73
74
77
78
79
80
81
82
83
84
85
86
87
88
90
91
ErrorType_Name_EN
Account / contract not setup for invoicing
Driver age incorrect
Equipment quantity too high
Flightnumber missing and been needed
Longtime car hire, under request
The hire is too close to pickup / too far in the future
Weekend must be included
ABTA number is missing
Query type is missing
Pickup time is invalid
Drop off is invalid
Supplier parameter missing
Location couldn't be found in the system
Requested vehicle is not supported
Reference for Reservation is missing
Rental duration cannot exceed 360 days
After hours service is not available at this time
Please contact the location for a multi-month reservation
No delivery possible at selected location
Rate Not Found
The reservation data is inconsistent
Pickup supplier and Dropoff supplier are not the same
The flight information is incorrect.
The additional driver information is not consistent.
Ota location search - RefPoint is missing
Ota location search - Position is missing
Ota location search - Radius/Ranking is missing
Unfortunately, your requested offer is not available
anymore. Please change the selected conditions.
Invalid Supplier Account
Unfortunately, your requested offer is not available
anymore. Please change the selected conditions.
Cancellation is not possible at the moment. Please try
again later.
Rentalterms aren't available at the moment. Please try
again later.
connection is currently unavailable, please try again later
or select another supplier.
Reservation was already cancelled
State/Province is required in Address
No Location found for given parameters
Payment Gateway Error
The selected station - for example pick-up or drop-off
stations opening hours are outside your selected time
period
that function is no longer supported.
Membder ID not recognised.
Voucher: duration exceeds limit.
ErrorType_OTA_Code
535
236
312
243
253
229
234
315
211
1
233
309
Page 70
ErrorType_ID
92
93
94
95
96
97
98
99
100
ErrorType_Name_EN
Voucher: Amount not correct.
Voucher: rental duration is not correct.
Voucher failure
Reservation already exists
Vehicle will be chauffeur driven.
An equipment is not rated.
Additional fees may apply.
Invalid phone number
Language is missing
ErrorType_OTA_Code
14.10 Period table

Period ID
1
2
3
4
5
6
7
Period Name
per day
per Rental
per week
per km
per mile
per person
per hour
14.11 Fuel type table

ID
1
2
3
4
5
6
7
8
9
10
Fuel type Name

Diesel
Petrol
Natural gas
Hybrid
Electric
Compressed Gas
Hydrogen
Ethanol
Multi Fuel
Unspecified Fuel
14.12 Vehicle category table

ID
1
2
3
4
Category Name
Mini
Economy
Compact
Intermediate
Page 71
5
6
7
8
9
10
Full-Size
Premium / Luxury
Van / Minivan
Convertible
all
Special
14.13 Destination type table

Destionationtype_ID
1
2
3
4
5
6
8
9
Category Name
Continent
Country
Region
City
Airport
Location
Hotel Delivery
Supplier
14.14 PricedCoverageTypes
PricedCoverageType
AD
CDW
LDW
TP
CFC
CPP
GPS
LSC
ASC
CSS
ALI
FPO
F2F
E2E
F2E
SLI
UNL
UMP
YDS
WPI
PEP
Oneway
TAX
PricedCoverageType_Name
Additional Driver
Collision Damage Waiver
Loss Damage Waiver
Theft Protection
Customer Facility Charge
Canellation Protection Insurance
Global Positioning System
Location Service Charge
Airport Service Charge
Child Safety Seat
Additional Liability Insurance
Fuel Petrol Option
Full to full
Empty to empty
Full to empty
Supplementary Liability Insurance / Extended
Protection
Unlimited Mileage
Uninsured ;Motorist Protection)
Young Driver Surcharge
Winterpackage
Personel Effects Protection / Coverage
Oneway fee
tax
Page 72
14.15 OTA definitions and error codes

Please have a look at the Excel sheet attached to this PDF file to obtain a complete overview to the
OTA error codes and element definitions.
Page 73
15 Content-Index
15.1 Illustrations
FIGURE 1 PORTPAID TO SUPPLIER .................................................................................................................................. 10
FIGURE 2 PREPAID TO AFFILIATE NET RATE .................................................................................................................. 10
FIGURE 3 PREPAID TO SUPPLIER GROSS RATE ............................................................................................................... 10
FIGURE 4 LOCATION ................................................................................................................................................... 13
FIGURE 5 SOAP-OTA MESSAGE FORMAT ...................................................................................................................... 18
FIGURE 6 DIAGRAM OF THE SEARCH PROCESS.................................................................................................................. 26
FIGURE 7 CANCELLATION ............................................................................................................................................. 47
FIGURE 8 RETRIEVE RESERVATION ................................................................................................................................. 49
FIGURE 9 AMENDMENT............................................................................................................................................... 53
Page 74

OTA2012B Documentation

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

OTA2012B Documentation

Caricato da

Copyright:

Formati disponibili

Car

OTA 2012B DOCUMENTATION

HISTORY OF DOCUMENT .......................................................................................................................... 5

TERMS AND DEFINITIONS ........................................................................................................................ 7

SYSTEM INFORMATION ......................................................................................................................... 14

TESTING TOOL ........................................................................................................................................ 25

7.3.4 Direct Supplier sample ..................................................................................................................... 32

SAMPLE REQUEST: .................................................................................................................................... 37

RETRIEVE RESERVATION ........................................................................................................................ 48

LANGUAGE TABLE ..................................................................................................................................... 61

CITY TABLE .............................................................................................................................................. 63

4 Terms and definitions

Web Application Programming Interfaces (Web APIs)

Prepaid refers to services paid for in advance in this case:

Figure 1 Portpaid to Supplier

Prepaid to affiliate using net rates

Figure 2 Prepaid to Affiliate Net Rate

Prepaid to supplier using gross rates

Figure 3 Prepaid to Supplier Gross Rate

Find a selection of locations in appendix (Ch. 14).

5.1 Search Geographic

5.1.2 Search by City

5.1.3 Search by Location

location code and GDS code (queries only one supplier)

5.1.4 Search by Hotel-Code

5.2 Deep linking

Deep link by reference number, and

5.2.1 Deep link by Reference Number

5.2.2 Deep linking by individual Parameters

5.3 System Access

5.4 OTA-SOAP Message-Format

Figure 5 SOAP-OTA Message Format

SOAP Action URL:

Endpoint description in the WSDL and target address:

An example of a valid request is given below

Request SOAP Body:

2) WS http endpoint: An interoperable binding suitable for connecting to endpoints that

Endpoint description in the WSDL and target address:

An example of a valid request is given below

Request SOAP Body:

without WS-Addressing in the header.

An example of a valid request is given below

Request SOAP Body:

This supports the old ASMX style, i.e.,

This exposes web services using WS-*

This is aimed for clients who do not have

As it is built using WS-* specifications, it

SOAP 1.2 and WS-Addressing

Not supported. In other words, if a client

Supported as it supports WS-*

By default, there is no security provided

As WsHttBinding supports WS-*, it has

5.5 XML Sample Output Tool

You may also refer to chapter 6.

5.6 Data Dumps

Airports: List of all Airports supported by MicronNexus for car rental

5.7 Webservice to retrieve GEO-Data

Call getRegions without Country Parameter

5.8 Webservice to retrieve AutoCompleted-Data

5.8.2 Service Returning Json

Language_ID=1..28 (2- would be English)

6.2.2 RateRule To check on the equipments and other additional offers

6.2.3 Reservation To attempt to book a car with details added

6.2.5 Reservation Cancellation To cancel a reservation