Search

Message to perform the initial search for hotels.

SOAPAction	OTA Name	Message Structure
search	HotelSearch	OTA_HotelSearchRQ

Request
- Schema
Response
- Schema

Request

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
  <Header xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <authentication xmlns="http://www.concur.com/webservice/auth">
      <userid>user</userid>
      <password>password</password>
    </authentication>
  </Header>
  <Body xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <OTA_HotelSearchRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="test_request_id" Version="4"
                       PrimaryLangID="de" AltLangID="de" MaxResponses="100">
      <POS>
        <Source ISOCurrency="USD">
          <RequestorID Type="1" ID="47777"></RequestorID>
        </Source>
      </POS>
      <Criteria>
        <Criterion>
          <Position Latitude="52.520007" Longitude="13.404954"></Position>
          <RefPoint></RefPoint>
          <HotelRef HotelName="sunshine"></HotelRef>
          <Radius Distance="5" DistanceMax="30" UnitOfMeasureCode="1"></Radius>
          <StayDateRange Start="2018-09-26" End="2018-09-27"></StayDateRange>
        </Criterion>
      </Criteria>
      <TPA_Extensions>
        <CustomFields>
          <CustomField Name="OrgUnit" Value="Travel Agents"></CustomField>
        </CustomFields>
      </TPA_Extensions>
    </OTA_HotelSearchRQ>
  </Body>
</Envelope>

OTA_HotelSearchRQ

Name	Type	Description
`MaxResponses`	`integer`	Required SAP Concur currently supports 100 search results in one (1) message. If more than 100 results are returned SAP Concur drops all results after the 100th entry.
`Criteria`	`complex`	Required Specified hotel search criteria.
`TPA_Extensions`	`complex`	This adds an Org Unit name to the Search request.

Criteria

Name	Type	Description
`Criterion`	`complex`	Required Child elements that identify a single search criterion by criteria type.

Criterion

The criterion is used to define the search criteria. Currently we support only one Criterion.

Name	Type	Description
`Position`	`complex`	Required for Search request only, but optional for Availability request. Used to specify the geographic coordinates of a location, expressed in notation specified by ISO standard 6709.
`HotelRef`	`complex`	Indicates the detail of hotel reference information.
`RefPoint`	`stringLength0to64`	The reference point element allows for a search by proximity to a designated reference point by name.
`Radius`	`complex`	Used to specify the extent of a search area. The extent is relative to an element (`position`, `address`, `hotelRef`, etc.) present in this `ItemSearchCriterionType` that specifies a location.
`StayDateRange`	`complex`	Required Range of dates using ISO 8601.

TPA_Extensions

Name	Type	Description
`CustomFields`	`complex`	This adds Org Unit name.

CustomFields

Name	Type	Description
`CustomField`	-	-
`Name`	`xs:string`	-
`Value`	`xs:string`	-

Position

Name	Type	Description
`Latitude`	`stringLength1to16`	Required The measure of the angular distance on a meridian north or south of the equator.
`Longitude`	`stringLength1to16`	Required The measure of the angular distance on a meridian east or west of the prime meridian.

HotelRef

Name	Type	Description
`HotelName`	`stringLength1to128`	A text field used to communicate the proper name of the hotel.

Radius

The radius element is used along with the Hotel Preference to categorize the search results.

Name	Type	Description
`Distance`	`stringLength1to16`	Required The distance from a reference point.
`DistanceMax`	`stringLength1to16`	Attribute indicating the distance from a reference point or Preferred (Corporate) hotels.
`UnitOfMeasureCode`	`stringLength1to16`	Required The unit of measure in a code format. Refer to OpenTravel Code List of Measure Code (UOM). SAP uses `1` for miles, `2` for kilometers.

StayDateRange

Name	Type	Description
`Start`	`date`, `time`, or `datetime`	Required The starting value of the time span.
`End`	`date`, `time`, or `datetime`	Required The ending value of the time span.

Response

The maximum allowed size of OTA_HotelSearchRS is 1 MB. Any response that exceeds this limit will be dropped.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"/>
  <soap:Body>
    <OTA_HotelSearchRS xmlns="http://www.opentravel.org/OTA/2003/05" AltLangID="EN" PrimaryLangID="EN" Version="4">
      <Success/>
      <Properties>
        <Property ChainCode="AB" ChainName="1111" HotelCode="22222" HotelName="Sunshine Hotel">
          <Position Latitude="52.4567" Longitude="13.5635"/>
          <Address>
            <AddressLine>An der Wuhlheide</AddressLine>
            <CityName>Berlin</CityName>
            <PostalCode>10115</PostalCode>
            <CountryName Code="DE">Federal Republic of Germany</CountryName>
          </Address>
          <ContactNumbers>
            <ContactNumber CountryAccessCode="49" PhoneNumber="56940033" PhoneTechType="1"/>
          </ContactNumbers>
          <Award Rating="4"/>
          <HotelAmenity Code="68"/>
          <TPA_Extensions>
            <HotelPreference>not_preferred</HotelPreference>
            <TPA_HotelPreviewImageURI>
              <URL>url_to_the_picture.jpg</URL>
            </TPA_HotelPreviewImageURI>
          </TPA_Extensions>
        </Property>
      </Properties>
      <TPA_Extensions>
        <SearchSessionToken>5EA6C45E55104704E4</SearchSessionToken>
      </TPA_Extensions>
    </OTA_HotelSearchRS>
  </soap:Body>
</soap:Envelope>

OTA_HotelSearchRS

Name	Type	Description
`Properties`	`complex`	Required A collection of individual property information.
`TPA_Extensions/SearchSessionToken`	`stringLength1to128`	Optional A token that links the Search results to Availability and Reservation requests.

Properties

Name	Type	Description
`Property`	`complex`	Required A property that matches some or all of the search criteria.

Property

Name	Type	Description
`ChainCode`	`stringLength1to32`	2-letter valid GDS chain code. The code that identifies a hotel chain or management group. Must be present to support filtering, preferences or travel rules base on chains
`ChainName`	`stringLength1to32`	The name of the hotel chain. Examples: `Hilton`, `Marriott`, `Hyatt`, `Starwood`
`HotelCode`	`stringLength1to32`	Required The code that uniquely identifies a single hotel property. Used in other OTA messages.
`HotelName`	`stringLength1to32`	Required A text field used to communicate the proper name of the hotel.
`Position`	`complex`	Required Refer to `Position` in the Request.
`Address`	`complex`	Required Public address of the hotel property.
`ContactNumbers`	`complex`	Contact numbers.
`Award`	`complex`	An element that identifies the hotel ratings.
`HotelAmenity`	`complex`	List of hotel amenities.
`TPA_Extensions`	`complex`	SAP Concur-specific extension of OTA spec. This adds support for extra property fields.

Address

Name	Type	Description
`AddressLine`	`stringLength1to255`	The screenname and number. Maximum occurrences: `5`
`CityName`	`stringLength1to64`	Name of the city.
`PostalCode`	`stringLength1to16`	The postal code.
`StateProv`	`complex`	Name of the state.
`CountryName`	`complex`	Country name. Example: `Ireland`

StateProv

Name	Type	Description
`StateCode`	`stringLength0to64`	The standard code or abbreviation for the state, province, or region (note the code may not be available for all states).

CountryName

Name	Type	Description
`Code`	`stringLength0to64`	Required The name or ISO 3166 code of a country.

ContactNumbers

Name	Type	Description
`ContactNumber`	`complex\|Element which contains the` ContactNumber`. SAP Concur only accepts one (first)` ContactNumber` of each supported type.

ContactNumber

Name	Type	Description
`CountryAccessCode`	`stringLength1to32`	The country code.
`PhoneNumber`	`stringLength1to32`	Required The phone number.
`PhoneTechType`	`string`	SAP Concur currently only supports a `PhoneTechType` set to `1` (phone) or `3` (fax). You can omit this field only in case you are providing one contact number. We suggest to fill the type in all cases, it may become mandatory in the future.

Award

Name	Type	Description
`Rating`	`integer`	Required Hotel rating should be an integer number from 0 to 5, representing its star rating.

HotelAmenity

Name	Type	Description
`Code`	`string`	Required Refer to OpenTravel Code List Hotel Amenity Code (HAC).

TPA Extensions

Name	Type	Description
`HotelPreference`	`stringLength1to32`	Required SAP Concur allows customers to override property preference in the system settings. Supported values: `not_preferred`, `less_preferred`, `preferred`, `most_preferred`
`TPA_HotelPreviewImageURI`	`complex`	Required Details for an image of a given category.

TPA_HotelPreviewImageURI

Name	Type	Description
`URL`	`stringLength1to32`	Required URL of the multimedia item for a specific format. SAP Concur supports one image URL in the Search Response. For the ability to display more images refer to Descriptive Info message. The image will be used as a thumbnail and should be limited to 70x70 pixels to prevent image artifacts by scaling.