Property contact details are always contained in a ContactInfos element with one or more ContactInfo children. This page describes the elements and attributes in the ContactInfos descendants tree.
- OTA_HotelDescriptiveContentNotif – Set a property's contact details.
- OTA_HotelDescriptiveInfo – Retrieve a property's contact details.
The sample below is an excerpt and not a valid XML document.
<ContactInfos>
<ContactInfo ContactProfileType="PhysicalLocation">
<Addresses>
<Address>
<AddressLine>Herengracht 567</AddressLine>
<CityName>Amsterdam</CityName>
<PostalCode>1017 CE</PostalCode>
<CountryName>NL</CountryName>
</Address>
</Addresses>
</ContactInfo>
<ContactInfo ContactProfileType="availability" Index="1">
<Names>
<Name Language="en" Gender="male">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="1" />
</Phones>
</ContactInfo>
<ContactInfo ContactProfileType="general" Index="2">
<Names>
<Name Language="en" Gender="male">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="1" />
</Phones>
</ContactInfo>
<ContactInfo ContactProfileType="contract" Index="3">
<Names>
<Name Language="en" Gender="male">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="1" />
</Phones>
</ContactInfo>
<ContactInfo ContactProfileType="reservations" Index="4">
<Names>
<Name Language="en" Gender="male">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="1" />
</Phones>
</ContactInfo>
<ContactInfo ContactProfileType="invoices" Index="5">
<Names>
<Name Language="en" Gender="male">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Addresses>
<Address>
<AddressLine>Herengracht 594</AddressLine>
<CityName>Amsterdam</CityName>
<CountryName>NL</CountryName>
<PostalCode>1017 CE</PostalCode>
</Address>
</Addresses>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="1" />
</Phones>
</ContactInfo>
<ContactInfo ContactProfileType="site_content" Index="6">
<Names>
<Name Language="en" Gender="male">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="1" />
</Phones>
</ContactInfo>
<ContactInfo ContactProfileType="parity" Index="7">
<Names>
<Name Language="en" Gender="male">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="1" />
</Phones>
</ContactInfo>
<ContactInfo ContactProfileType="requests" Index="8">
<Names>
<Name Language="en" Gender="male">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="1" />
</Phones>
</ContactInfo>
<ContactInfo ContactProfileType="central_reservations" Index="9">
<Names>
<Name Language="en" Gender="male">
<GivenName>Sam</GivenName>
<Surname>Xu</Surname>
</Name>
</Names>
<Emails>
<Email>noreply@booking.com</Email>
</Emails>
<Phones>
<Phone PhoneNumber="+31666666666" PhoneTechType="1" />
</Phones>
</ContactInfo>
</ContactInfos>Contains names, addresses, and other types of contact details. Child of ContactInfos.
| Field | Description | Type | Required | Notes |
|---|---|---|---|---|
ContactInfo[@ContactProfileType] | Indicates the type of contact. | enum | Required | Accepts: general, contract, reservations, invoices, availability, site_content, parity, requests, central_reservations, PhysicalLocation. See @ContactProfileType for details. |
Addresses | - | array of Address | Optional | - |
Emails | - | array of Email | Optional | - |
Names | - | array of Name | Optional | Max. occurrences of Name per ContactInfo element: 1 |
Phones | - | array of Phone | Optional | - |
The ContactInfo attribute @ContactProfileType accepts the following values. Each value corresponds with a similarly named heading on the Contacts page in our extranet.
| Value | Description | Required |
|---|---|---|
general | Primary point of contact for the property. | Required |
contract | Contact for contract matters. | Optional |
reservations | Contact for reservations. | Optional |
invoices | Contact for accounts payable. | Required |
availability | Contact for questions about availability. | Optional |
site_content | Contact for photos, descriptions, and other website content. | Optional |
parity | Contact for pricing and rate matters. | Optional |
requests | Contact for special requests. | Optional |
central_reservations | Contact for central reservations. Applies to properties that manage reservations from another location. | Optional |
PhysicalLocation | Address details for the property's physical location. | Required |
Contains address details. Child of Addresses (see ContactInfo).
| Field | Description | Type | Required | Notes |
|---|---|---|---|---|
Address[@Language] | The language in which the address details are provided. | enum | Optional | Accepts the values listed under BCL. Default: en |
AddressLine | The full street name and number. | string | Required | Should not contain abbreviations (such as "Rd." for "Road"). |
HotelName | The name of the property. | string | Optional | Required when Address[@Language] is not en. Default: empty |
CityName | The name of the city, town, or village. | string | Required | - |
PostalCode | The postal or zip code. | string | Required | - |
StateProv | - | object | Optional | - |
StateProv[@StateCode] | Specifies the code for the state or province. | string | Optional | Follow the ISO 3166-2 standard to specify the state, province, or other subdivision. |
CountryName | The two-letter code for the country, as defined in our list of country codes. | countrycode | Required | For accepted values, see countries (B.XML) |
Contains a contact person's name details. Child of Names (see ContactInfo).
| Field | Description | Type | Required | Notes |
|---|---|---|---|---|
Name[@Language] | The contact's spoken language. | enum | Required | Accepts the values listed under BCL. |
Name[@Gender] | The contact's gender. | enum | Optional | Accepts these values: male, female, non-binary, undisclosed. Default: empty. NOTE: To set the contact's gender as empty, omit the entire attribute (rather than setting its value as ""). |
GivenName | The contact's given (first) name. | string | Optional | Required if Surname is not provided. |
Surname | The contact's last name or family name. | string | Optional | Required if GivenName is not provided. |
JobTitle | The contact's job title. | enum | Optional | Accepts the values listed under BCJT. |
Contains an email address. Child of Emails (see ContactInfo). This element has no child elements or attributes—see Sample XML for an example.
Contains phone line details. Child of Phones (see ContactInfo).
| Field | Description | Type | Required | Notes |
|---|---|---|---|---|
Phone[@PhoneNumber] | The international phone number that must be dialled to reach the phone. | string | Required | Must begin with +, followed by all digits required to dial internationally. No whitespace, hyphens, or other characters allowed. |
Phone[@PhoneTechType] | The type of phone line or device, expressed as a PTT code. | enum | Optional | See PTT codes for accepted values. |
Phone[@Extension] | The extension number that must be dialled in addition to the main phone number. | integer | Optional | Only allowed when @PhoneTechType is 1. |