# Developer Portal

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Channel Manager</strong></td><td>Learn about Channel Manager and how to get started</td><td></td><td><a href="https://developer.rategain.com/our-products/channel-manager">https://developer.rategain.com/our-products/channel-manager</a></td></tr><tr><td align="center"><strong>Smart Distribution</strong></td><td>Learn about Smart Distribution and how to get started.</td><td></td><td><a href="https://developer.rategain.com/our-products/smart-distribution">https://developer.rategain.com/our-products/smart-distribution</a></td></tr><tr><td align="center"><strong>Content</strong></td><td>Learn about Content and how to get started</td><td></td><td><a href="https://developer.rategain.com/content">https://developer.rategain.com/content</a></td></tr><tr><td align="center"><strong>UltraDirect</strong></td><td>Learn about UltraDirect and how to get started</td><td></td><td><a href="https://developer.rategain.com/ultradirect">https://developer.rategain.com/ultradirect</a></td></tr></tbody></table>


# Channel Manager

Our Channel management solution enables hotels to manage their room inventory, rates, and availability across multiple online distribution channels, such as OTAs (Online Travel Agencies), resellers, wholesellers and direct booking engines—from a single platform. It ensures real-time synchronization, reduces the risk of overbookings, and helps maximize occupancy and revenue.


# Integration and Onboarding Flow

Get a clear view of the integration journey with our platform. This guide outlines the key steps, requirements, and milestones from initial setup to going live, ensuring a smooth and efficient onboarding experience.

**Integration Process**

| Step                                    | Owner                               | Goal                                                                                                           | Output                                                                                       |
| --------------------------------------- | ----------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| 1. Walk-In to RG API Central            | Partner                             | Familiarize with integration requirements, documentation, and process.                                         | Partner is equipped to begin development.                                                    |
| 2. Discovery, NDA & Commercial Sign-Off | Joint Team (RateGain & Partner)     | Align on integration objectives, partner capabilities, and business case. Finalize NDA and commercial terms.   | Signed NDA, commercial agreement, alignment on scope of work (SOW), and target go-live date. |
| 3. Development & Testing                | Partner                             | Develop the integration based on the available specifications on API Central and perform internal QA.          | Functional build ready for certification.                                                    |
| 4. Certification Testing                | Joint Team (via Certification Tool) | Validate the integration against technical and functional requirements. Resolve any gaps or issues.            | Certified and approved integration.                                                          |
| 5. Production Deployment                | RateGain                            | Deploy the certified integration to the production environment.                                                | Live integration ready for real-world use.                                                   |
| 6. Pilot                                | RateGain                            | Soft launch with selected property to assess performance and stability.                                        | Feedback gathered and any identified issues addressed.                                       |
| 7. Go Live                              | RateGain                            | Full-scale launch of the integration, supported by marketing or client enablement initiatives (if applicable). | Integration is fully live and operational across all intended users.                         |

**Onboarding Flow**

| Step                                       | Owner                        | Goal                                                                                                     | Output                                                                                            |
| ------------------------------------------ | ---------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| 1. Channel Extranet Setup                  | Hotel                        | Set up rooms and rates accurately on the OTA extranet.                                                   | Room and rate inventory ready for integration.                                                    |
| 2. Share PRS Form                          | Hotel                        | Provide property-related setup info to RateGain team.                                                    | Completed PRS form submitted.                                                                     |
| 3. Property Shell Creation                 | RateGain                     | Create initial property setup in the system.                                                             | Property shell ready (including differential sheet if standalone).                                |
| 4. Channel Switch Date & OTA Authorization | Hotel                        | Authorize RateGain as channel manager on OTAs for switch-over.                                           | OTA connections aligned with switch-over plan.                                                    |
| 5. Channel Connection & Activation         | RateGain                     | Establish connectivity and activate OTA links.                                                           | OTAs connected and channel activated.                                                             |
| 6. Share Channel Mapping Sheet             | RateGain Implementation Team | Fill and return the UNO (CRS) room & rates corresponding to the OTA room & Rates along with occupancies. | Mapping sheet sent to hotel for completion. (Hotel PMS setup must be completed before this step.) |
| 7. Hotel Mapping Input                     | Hotel                        | Fill and return mapping sheet with rate and room IDs.                                                    | Accurate data shared with RateGain.                                                               |
| 8. Mapping Update                          | RateGain                     | Input hotel’s mapping data into system.                                                                  | Mapping finalized.                                                                                |
| 9. ARI + RD Testing                        | Joint (Hotel + RateGain)     | Verify availability, rates, and inventory updates and reservation delivery.                              | Successful sync confirmed.                                                                        |
| 10. Extranet Auditing                      | Hotel                        | Perform spot-checks to verify OTA data consistency.                                                      | Discrepancies, if any, flagged and resolved.                                                      |
| 11. Sign-Off                               | Hotel                        | Confirm that the setup is complete and functioning.                                                      | Official go-live email sent to RateGain.                                                          |


# RG Bridge - Supply (Push)

**RG Bridge** integrates RateGain's channel management solution with a Central Reservation System (CRS) or Property Management System (PMS).


# Integration Overview

## **Purpose**

### Overview

This document outlines the integration process between a Central Reservation System (CRS) or Property Management System (PMS) and RateGain's channel management solution, known as RG Bridge. Throughout this document, CRS/PMS service providers are referred to as partners or third-party systems. The following sections detail the necessary steps and associated processes for a successful integration.

## **Objective**

The goal of the integration is to seamlessly send reservations from various inventory distribution channels to a hotel’s PMS system.

There are two main integration scenarios:

1. **RG Bridge integration with a CRS**: The CRS then sends the data to the PMS.
2. **RG Bridge integration directly with a PMS**: Reservations go straight to the PMS.

In both cases, the final destination for reservations is always the hotel’s PMS system. The two versions are illustrated below.

### RG Bridge integration with CRS    <a href="#objectiveofintegration-rgbridgeintegrationwithcrs" id="objectiveofintegration-rgbridgeintegrationwithcrs"></a>

### &#x20;                                                 <a href="#objectiveofintegration" id="objectiveofintegration"></a>

<figure><img src="/files/D8IewG4KEbqwhKXO1aUW" alt=""><figcaption></figcaption></figure>

### RG Bridge integration with PMS <a href="#objectiveofintegration-rgbridgeintegrationwithpms" id="objectiveofintegration-rgbridgeintegrationwithpms"></a>

&#x20;                                                                  &#x20;

<figure><img src="/files/NogShzTCTkW8CcetHlal" alt=""><figcaption></figcaption></figure>

<br>

&#x20;                                                                   &#x20;

<br>


# Vision of Integration

The first step is to establish a clear vision for the integration. This includes:

* **Business Case**:
  * Determine the potential number of hotels likely to use the integration.
  * Prepare a list of launch customers in advance.
  * Define the pricing model and the overall business case early in the process.
* **Channels**:
  * Identify and agree on the list of channels or OTAs (Online Travel Agents) to be managed through the integration right from the start.


# Commercial value and business case

The commercial value and business case for the integration must be finalized between RateGain and the CRS/PMS third party before starting the technical development.


# Information Data flow

At the start of the integration, it’s important to determine whether it will be a one-way or two-way integration. The direction of data flow must also be decided upfront.

The available integration options with RG Bridge are outlined in the following sections, and the CRS/PMS partner can choose any of these options for their integration.


# One way integration

This option is for unidirectional integration with RG Bridge.

## Availability Rates & Inventory (ARI) broadcast one-way integration

<figure><img src="/files/EyZ5z448Is7GvkBKmmWp" alt=""><figcaption></figcaption></figure>

ARI is sent from the CRS/PMS to RG Bridge which then broadcasts it to the entire universe of OTAs.

## Reservations receive from OTAs – one way integration

<figure><img src="/files/qQ3uYlKBqE9RSi6OC1kW" alt=""><figcaption></figcaption></figure>


# Two Way integration – ARI Broadcast and Reservation fetch

<figure><img src="/files/YWR3jRQeDL9FRuVx9LcN" alt=""><figcaption></figcaption></figure>

## Hotel information flow for two way integration

<figure><img src="/files/8dcRXn3v9LH3zsjdr8Gz" alt=""><figcaption></figcaption></figure>


# Information delivery mechanism

**Push Delivery**\
The integration will primarily operate on a PUSH mechanism:

* **ARI Updates**: The PMS/CRS will PUSH ARI (Availability, Rates, and Inventory) data to RG Bridge, which will then distribute it to all OTAs.
* **Reservations**: RG Bridge will receive reservations from OTAs and PUSH them to the CRS/PMS.

**Real-Time vs. Batch Processing**\
RG Bridge processes all data in real-time, and the partner is expected to handle data in real time as well.

* If real-time processing is not feasible due to technical or business constraints, batch updates can be provided. However, this will incur additional costs.


# Technical feasibility of integration

The technical feasibility of the integration must be confirmed before proceeding with detailed development and testing.

RG Bridge is available as a web services and follows the HTNG Web Services Framework. Consuming and exposing RG web services requires an advanced working knowledge of web services and REST.


# Test property setup

To verify technical viability, you may request a test property to be set up in RateGain’s test environment. Additionally, you will need to create a test property on your end to connect with RG Bridge.

The credentials for the test properties (user ID, password, and URLs) should be exchanged between RateGain and the partner.

Both RateGain and the partner’s test properties should have web front-ends/user interfaces to allow independent testing by both parties and to ensure that the test properties are connected and functioning as expected.


# Sample reservation data

RateGain needs the CRS/PMS partner to provide the current reservation data format, including samples of reservation emails, faxes, and XML messages used in the hotel’s PMS system.


# RG Bridge Setup

For a seamless integration of RG Bridge with third parties, some essential customer information is required.

**Property Requirements Specifications (PRS)**:

* It's essential to fill out the PRS form with details about the property and its intended users.
* This form must be submitted to RateGain before the property goes live in production.

**RG Bridge with User Interface**:

* The RG Bridge includes a user interface for integrated properties, offering several benefits:
  * Monitor the accurate sending/receiving of data to/from the CRS/PMS.
  * Monitor the accurate sending/receiving of data to/from the OTA/channels.
  * Quickly troubleshoot failure points in case of errors.
  * Use an online web interface to check the status of your requests.


# Contract

Before commencing any development work, it's crucial to establish a legal contract that outlines the commercial and legal terms. This ensures that all parties are aligned on their responsibilities and obligations, providing a clear framework for the collaboration. Establishing this contract early on helps avoid potential disputes and sets the foundation for a successful partnership.


# Project Plan

The project plan will be divided into four distinct phases:

1. **Initiation**: This phase sets the groundwork for the project, establishing key objectives and requirements.
2. **Development**: The main phase where the actual creation and coding of the project take place.
3. **Certification**: This stage involves rigorous testing and validation to ensure the project meets all specified standards and requirements.
4. **Production Pilot**: The final phase where the project is implemented in a real-world environment with a select group of alpha customers.

**Alpha customers** need to be identified at the start of the project for the production pilot. Both RateGain and the partner will collaborate with these customers to align expectations and optimally meet their requirements.


# Certification

RateGain will certify its partner integration through a series of quality assurance (QA) tests. The testing procedures and test cases will be published in advance, allowing the partner to verify integration quality on their end. The RG team will assess the following key aspects:

* **Reliability**
* **Security**
* **Availability**
* **Stability**
* **Error handling**


# Monitoring and after sales support

After successfully rolling out the integration to customers, managing them involves two key aspects:

#### Monitoring

* **Technical Oversight**: Ensure high customer satisfaction through SLA monitoring.
* **Regular Reporting**: Conduct regular monitoring and reporting of various technical aspects of the integration.
* **Integration with Ticketing Systems**: RG Bridge will be integrated with existing ticketing systems (IMS/OTRS).
* **Report Formats**: The formats for Channel Availability Reports (CAR), Channel Health Reports (CHR), and other reports will be decided and published by RateGain.
* **Service Levels**: Agreed service levels will be implemented by RateGain and monitored for third-party compliance.

#### After Sales Support

* **Personal Attention**: Provide dedicated attention and training to customers after RG Bridge implementation.
* **Account Management**: Handled by RateGain’s account management team to ensure continuous support and satisfaction.


# Integration checklist

The integration process for RG Bridge with third-party software (CRS/PMS/others) typically involves a number of critical steps. This checklist is not for integration of new channels on RG but exclusively for integration with CRS, PMS & other third-party software that the hotel wishes to integrate RG with. Use the checklist as a general guide to find out what the process involves & track where you are in the integration process.

<table data-header-hidden><thead><tr><th width="100"></th><th></th></tr></thead><tbody><tr><td><strong>Step</strong></td><td><strong>Check-point</strong></td></tr><tr><td>1.</td><td><p><strong>Vision of Integration</strong></p><p> </p><p>Establish and document a high-level vision of the proposed integration including</p><p> </p><p>•       Expected number of customers (Business Case)</p><p>•       Expected list of channels for integration?</p></td></tr><tr><td>2.</td><td><p><strong>Information/Data flow</strong></p><p> </p><p>Document whether this is One-way or two way integration? Reservations into RG or out of RG (And vice versa for ARI)?</p></td></tr><tr><td>3.</td><td><p><strong>Business Requirements</strong></p><p> </p><p>Understand and document business requirements for the RG Integration.</p><p> </p><p>•    Can your application update Property additions, deletions and reactivation?</p><p> </p><p>•    Can your application accept reservations for default rooms and rate types?</p><p> </p><p>•     Do you require credit card information, especially CVV?</p></td></tr><tr><td>4.</td><td><p>Documentation requirements</p><p> </p><p>RateGain would supply the following documents</p><p> </p><p>•       Integration specifications document</p><p>•       Contract terms &#x26;conditions</p><p> </p><p> </p><p>RateGain would need the following documents</p><p> </p><p>•       Technical design document</p><p>•       Contract terms &#x26;conditions</p><p>•       Third party application (CRS/PMS) user manual</p><p>•       Third party application test account details with a functionalities demo</p></td></tr><tr><td>5.</td><td><p><strong>Technical feasibility study</strong></p><p> </p><p><em>Technical Requirements –</em> Obtain a copy of the RG integration specification. Advanced working knowledge of web services and Rest are required to consume RG web services and to expose services.</p><p> </p><p> </p><p><em>Application Architecture</em> – Review and document your own service architecture.</p><p></p><p>Identify the following:</p><p>·         Is your application available online?</p><p>·         Is your application always-on available?</p><p>·         Can your application serve and consume web services?</p><p> </p><p>Update mode – Batch processing versus real-time update generation</p><p> </p><p>Any other technical requirements?</p></td></tr><tr><td>6.</td><td><p><strong>Initiate project</strong></p><p> </p><p>Please email your requests to pmg@rategain.com. Please include a brief profile of your product and organization.</p></td></tr><tr><td>7.</td><td><p><strong>Project Schedule</strong></p><p> </p><p>Determine activities and timeline for the integration. Typical integration projects take about three months from initiation to release.</p></td></tr><tr><td>8.</td><td><p><strong>Contract</strong></p><p> </p><p>Sign contract with RG. Include project schedule, business case, scope of work, list of</p><p>channels and agreed service level agreements (SLAs).</p></td></tr><tr><td>9.</td><td><p>Setup</p><p> </p><p>For RG Bridge, all setup would be done using the RG user interface. This would also</p><p>include automation of PRS (Property Requirement Specifications)</p></td></tr><tr><td>10.</td><td><p>Testing phases &#x26; preparations</p><p> </p><p><strong>Service Account/password</strong> – Obtain a service account and password for each application integrating with RG. The service account will allow you to integrate with</p><p>RezGain in the RG SIT environment.</p><p> </p><p><strong>Test Accounts for SIT</strong> – Obtain one or more test RG accounts for testing your integration in the SIT environment.</p><p></p><p><strong>ServiceAccount/passwordfortheProduction Environment</strong> –Obtain a service account and password for each application integrating with RG. The service account will allow you to integrate with our production version.</p></td></tr><tr><td>11.</td><td><p><strong>Certification by RateGain</strong></p><p></p><p>Obtain a copy of the test cases required for the certification of the integration with RG. The RG team will check the following:</p><p>•       Reliability</p><p>•       Security</p><p>•       Availability</p><p>•       Stability</p><p>•       Error handling</p></td></tr><tr><td>12.</td><td><p>Sales</p><p> </p><p>Price the integrated product. Engage launch customers for alpha &#x26; beta phase.</p></td></tr><tr><td>13.</td><td><p><strong>Monitoring &#x26; After Sales Support</strong></p><p> </p><p>RG Bridge would be integrated with the existing ticketing system (IMS/OTRS)</p><p> </p><p>Format for the Channel Availability Reports(CAR), Channelhealthreports(CHR) and other reports would be decided and published by RateGain. Agreed service levels would be implemented by RateGain and monitored for third-party compliance.</p><p>Additionally, account management and customer training requirements would be</p><p>handled by RateGain account management.</p></td></tr></tbody></table>


# Interface Specifications – Availability and Rates Notification Service

## Overview

**RG Bridge Services for PMS Integration** is a suite of services offered to RateGain partner organizations. These services are designed to integrate Property Management Systems (PMS) into the RateGain Channel Manager.

**RateGain Channel Manager** is a premier channel management system used for distributing Availability, Rates, and Inventory (ARI) to Internet Distribution Systems (OTA) and collecting reservations from them. RG Channel Manager is trusted by many of the world’s renowned hotels and hotel chains.

**Functionality**:

* **PMS to Channel Manager**: As availability and rates change in the PMS, updates are pushed to the Channel Manager. The Channel Manager processes these messages and sends updates to the subscribed OTAs.
* **Channel Manager to PMS**: Reservations retrieved by the Channel Manager are sent to the PMS. Part 2 of this document specifies the interface requirements for the PMS to enable RateGain Channel Manager to push reservations and obtain confirmation numbers.

This document outlines the interfaces provided by the Channel Manager for PMS to push ARI updates. For further details on handling reservations and confirmation numbers, refer to Part 2 of this series.

<br>

<figure><img src="/files/1x6K9m4o2VOTWexVhUzc" alt=""><figcaption></figcaption></figure>


# RG Bridge Integration Process

#### Integration Process for CRS/PMS with Channel Manager

**Phase 1: Initiation**

* **Assessment**: Partners should assess their technical readiness, compatibility with systems, and available resources.
* **Pilot Hotel Selection**: A pilot hotel is usually agreed upon.
* **Test Account Setup**:
  * **Web Service URL**
  * **Username and Password**
  * **Test Hotel Information**:
    * Hotel Code and Hotel Name
    * List of products
    * Room type code
    * Rate type code
    * List of channels subscribed
    * OTA sell code and OTA name

**Phase 2: Development**

* **Development Kick-off**: Begin development with the provided information.
* **Integration Details**: Provide technical descriptions and test results towards the end of this phase.

**Phase 3: Certification**

* **Test Plan**: Receive a test plan and test cases.
* **Certification**: Complete and sign off on the certification process.

**Phase 4: Production Pilot**

* **Pilot Monitoring**: Connect the pilot hotel to RG Bridge and monitor the integration to ensure success.

**Phase 5: Production**

* **Go Live**: Release the integration to production and make it generally available.


# Intended Audience

This interface description is designed for software developers, project managers, and implementers. It presumes the reader has an advanced understanding of web services. Therefore, concepts and standards about web services are not explained or discussed in this document.


# Typographical Conventions

### XML Usage Description

**RG Bridge** utilizes OpenTravel standard XML to facilitate information exchange. The XML usage descriptions employ a pseudo-schema description format to specify the usage of XML elements and attributes as they apply to RG Bridge. The actual schema definitions are provided separately. These schemas adhere to industry standards and accommodate many use cases beyond those required by RG Bridge. Only the elements and attributes described in the XML Usage description are used by RG Bridge. Any other element or attribute passed in the message will be ignored.

#### Sample XML

Sample XML messages are provided throughout this document to aid in understanding message usage. These messages are formatted for clarity and are set inside tables with dashed borders. All OpenTravel messages follow a consistent format, with a single top-level element. The element name starts with "OTA\_".

In the example message in Table A, the top-level element of the rate update request message is OTA\_HotelRateAmountNotifRQ. The attributes of this element are standard.

**Table A: Sample XML**

```xml
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"  
TimeStamp="2005-02-02T12:00:00" 
 
Target="Production" 
Version="1.002"> 
<RateAmountMessages ChainCode="CY" HotelCode="ATLPE"> 
 
 <RateAmountMessage> 
 
 	<StatusApplicationControl  Start="2005-04-01"  
 	End="2005-04-01" 
 
 	RatePlanCode="BARA00" 
 
 	InvCode="STD"/> 
 
 	<Rates> 
 
 	<Rate RateTimeUnit="Day" 
 
 	Start="2005-04-01" 
 
 	End="2005-04-01" 
 
 	CurrencyCode="USD"> 
 
 	<BaseByGuestAmts> 
 
 	<BaseByGuestAmt AmountBeforeTax="100.00"/> 
 
 	</BaseByGuestAmts> 
 
 	</Rate> 
 
 	</Rates> 
 
 </RateAmountMessage> 
 
 </RateAmountMessages> 
 
</OTA_HotelRateAmountNotifRQ> 
```

To emphasize the important parts of the message, the relevant sections have been highlighted with a lime background, such as: `RateAmountMessages`.

* **Green Values**: These values must be set in a specific way because RG Bridge can only process them in that manner. For example, in `RateTimeUnit="Day"`, "Day" is the only value that can be passed to RG Bridge, even though the OTA schema allows other values.
* **Red Values**: These values are significant for the message. For example, in `RatePlanCode="BARA00"`, "BARA00" specifies the rate type and is crucial for the operation. Note that these values are fictitious and used for sample purposes only.

For better readability, the messages have been formatted with additional new lines and tab characters. However, these are not part of the actual XML and should not be used in real messages.

XML style comments in the samples are not part of the schema. They have been added to indicate incomplete sections in the XML, helping focus on important parts and show the general pattern. For example:

\<!-- Content omitted -->.


# Technical Overview

#### Service

ARI (Availability, Rates, and Inventory) changes can be pushed to RG Bridge in real-time. In the push model, information is sent (pushed) by the system where the information originated. In contrast, in the pull model, the system needing the information periodically connects to access it. The push model's advantage for the PMS (Property Management System) is that it doesn't need to track all changes since the last pull.

#### Communication Protocols

The exchange of information between RG Bridge and PMS occurs through REST messages.

<br>

<figure><img src="/files/Z6QpHWdfIBiPdf776Hvp" alt=""><figcaption></figcaption></figure>

<br>

#### General Design

**Availability and Rates Notification Service**:

* **Operations**:
  1. **Updating Inventory, Availability, and Restrictions**:
     * **OTA Messages**:
       * **Request**: `OTA_HotelAvailNotifRQ`
       * **Response**: `OTA_HotelAvailNotifRS`
  2. **Updating Rates (Base by GuestAmount and AdditionalGuestAmount)**:
     * **OTA Messages**:
       * **Request**: `OTA_HotelRateAmountNotifRQ`
       * **Response**: `OTA_HotelRateAmountNotifRS`

#### Authentication

* **Basic Authorization**: All request messages exchanged between the PMS and RG Bridge must use basic authorization.
  * **Credentials**: Username and password need to be passed using basic authentication in HTTP headers.
  * **Authorization Example**:

    ```
    Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
    ```
  * **Content-Type**: `text/xml`

#### Hotel Product Handling

* **Differences in Categorization**: There may be substantial differences in how RG Bridge categorizes hotel products compared to the PMS structure.
* **Understanding Differences**: It's crucial to understand these differences to ensure successful integration.

<br>

<figure><img src="/files/nWmhEjf9H9M5Jmk9JS2Z" alt=""><figcaption></figcaption></figure>

**RG Bridge** defines hotel products as a combination of a room type and a rate type. A hotel can have many room types and rate types.

* **Rate Types Categorization**: PMS systems typically classify rate types into different categories or segments.
* **Translation Requirement**: The PMS must translate updates at the level of rate segments/rate categories into either room type level updates or product level updates before sending them to RG Bridge.

**Example**: If a PMS user updates the availability of the rate segment (Corporate Rate A) by changing the maximum available inventory count from 25 to 15, the PMS must:

1. Determine all room type-rate type combinations affected by this change.
2. Generate separate updates for each combination.

This design minimizes the effort required by the hotel to keep the inventory structure synchronized between the PMS and RG Bridge.

#### Reliability Mechanisms and Constraints

**Single Hotel Specification**:

* Only one hotel can be specified in a request message.

**Multiple Room Types Update**:

* Multiple room types for the same hotel can be updated in one message exchange.

**Rate Type Handling**:

* If a rate type is not specified along with the room type in an update, the update is applied to all products defined for that room type.

**Volume of Messages**:

* Due to the high volume of messages exchanged between RG and the PMS, it is essential to implement the reliability mechanisms and constraints described in Table B.

| **Type**                   | **Mechanism/Constraint**                                                                         | **Description**                                                                                                                                                                                                |
| -------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Retry                      | Retry strategy for communication Failure and in case of specific errors returned in XML response | The Systems and PMS will have a retry mechanism in place for communication errors and business error.                                                                                                          |
| Concurrency                | Simultaneous connections per property <= 1                                                       | PMS RG Interface will establish a single connection per Property at any given time for updating the ARI events, and allows only one Connection per Property at a time for receiving the Booking Notifications. |
| Timeout                    | <p>Time out after 60,000</p><p>milliseconds (1 minute)</p>                                       | <p>Idle connections (no packets sent by either side) for</p><p>more than 1 minute are closed. These should be considered as incomplete and implement are try strategy to re-send data.</p>                     |
| <p>Character</p><p>Set</p> | Support for UTF-8                                                                                | All messages exchanged must have UTF-8 encoding                                                                                                                                                                |
| Hotels                     | Onlydatarelatedtoone hotel can be sent in a single request message                               | <p><br></p>                                                                                                                                                                                                    |
| Room Types                 | <p>Maximum number of</p><p>room types in a single request message must be less than 10</p>       | <p><br></p>                                                                                                                                                                                                    |
| Rate Types                 | Maximum number of rate types in a single request message must be less than 10                    | <p><br></p>                                                                                                                                                                                                    |
| Date Range                 | 366 Days                                                                                         | Maximum number of days that a single request message could update must not exceed 366 days.                                                                                                                    |
| <p>Message</p><p>Size</p>  | 400 KB                                                                                           | Maximum size for a single message must not exceed 400 KB.                                                                                                                                                      |


# Operations


# Availability Notification

This operation enables the PMS to request RG Bridge to update the OTAs with changes in availability status, inventory count, and restrictions for a hotel's inventory.

**Messages Involved**:

1. **OTA\_HotelAvailNotifRQ**:
   * This message is sent by the PMS to the RG Bridge service to notify any change in availability.
2. **OTA\_HotelAvailNotifRS**:
   * In response, the RG Bridge service sends an OTA\_HotelAvailNotifRS message.
   * If a REST level error occurs, a REST fault message is sent instead.

<br>

<figure><img src="/files/F5Q5Ix4gEdcNZLSvd0DX" alt=""><figcaption></figcaption></figure>


# OTA\_HotelAvailNotifRQ

The PMS/CRS partner should use the OTA\_HotelAvailNotifRQ message to send updates for availability, inventory, and restrictions. Here are the key points:

* **Single Hotel Update**: The availability of a single hotel can be updated with one message.
* **Multiple Rooms Update**: Availability of multiple rooms can be included in a single message, following the limitations specified in the Reliability Mechanisms and Constraints.

**Usage**:

* The OTA\_HotelAvailNotifRQ message can be used to send inventory count updates separately from status and restrictions updates.


# Change in Inventory count

When sending an inventory count update, it must be sent on a room type basis. This means the `OTA_HotelAvailNotifRQ` message will only include information about the room type and will not contain any `RatePlan` details.

```xml
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"  
TimeStamp="2004-05-01T06:39:09" 
 
Target="Production" 
 
Version="1.002" EchoToken="25525379hyyds63" 
 
 <AvailStatusMessages HotelCode="ATLPE" HotelName="The Sheraton"> 
 
 <AvailStatusMessage BookingLimit="25" 
 
 	BookingLimitMessageType="SetLimit"> 
 
 	<StatusApplicationControl  Start="2011-12-02"  
 	End="2011-12-05" 
 
 	InvCode="STD"> 
 
 	</StatusApplicationControl> 
 
 	<UniqueID Type="16" ID="1"> 
 
 	</UniqueID> 
 
 </AvailStatusMessage> 
 
</AvailStatusMessages> 
</OTA_HotelAvailNotifRQ> 

```


# Change in availability status and Restrictions

**Requirements**:

* **RoomType and RatePlan Information**: Any change in availability status or restrictions must include both `RoomType` and `RatePlan` information.
* **Availability Updates**: The PMS must send availability updates at the room type level.
* **Availability Status and Restrictions Updates**: These updates should be sent at the product level, which is a combination of `RoomType` and `RatePlan`.

**Handling Multiple Products**:

* If multiple products are associated with a single room type, and the availability notification message does not specify a rate type, the update will be applied to all rate types associated with that room type.

```xml
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"  
TimeStamp="2004-05-01T06:39:09" 
 
Target="Production" 
 
Version="1.002" EchoToken="25525379hyyds63" 
 
 <AvailStatusMessages HotelCode="ATLPE" HotelName="The Sheraton"> 
 
 <AvailStatusMessage> 
 
 	<StatusApplicationControl Start="2011-12-02" End="2011-12-05" 
 
 InvCode="STD" RatePlanCode="BAR"> </StatusApplicationControl> 
 
<RestrictionStatus Status="Open"/> 
 
 	<UniqueID Type="16" ID="1"/> 
 
 </AvailStatusMessage> 
 
 <AvailStatusMessage> 
 
 	<StatusApplicationControl Start="2011-12-02" End="2011-12-05" 
 
 InvCode="STD" RatePlanCode="BAR"> </StatusApplicationControl> 
 
<LengthsOfStay> 
 
<<LengthOfStay MinMaxMessageType="SetMinLOS" 
TimeUnit="Day" Time="1"/></LengthOfStay> 
 	</LengthsOfStay> 
 
 	<UniqueID Type="16" ID="2"/> 
 
 </AvailStatusMessage> 
 
 <AvailStatusMessage> 
 
 	<StatusApplicationControl Start="2011-12-02" End="2011-12-05" 
 
 InvCode="STD" RatePlanCode="BAR"> </StatusApplicationControl> 
 
<LengthsOfStay> 
 
<<LengthOfStay MinMaxMessageType="SetMaxLOS" 
TimeUnit="Day" Time="10"/></LengthOfStay> 
 	</LengthsOfStay> 
 
 	<UniqueID Type="16" ID="3"/> 
 
 </AvailStatusMessage> 
 
</AvailStatusMessages> 
</OTA_HotelAvailNotifRQ> 

```

**Availability request XML sample**

| <p><strong>Element/@Attribute</strong></p><p> </p><p><strong>Parent XPath</strong></p>                                                                                                                                                                                                                 | <p> </p><p><strong>Description</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | **Occurrences**             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| <p>@TimeStamp</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                       | <p> </p><p>Time of the transaction in xml schema date-time format</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                           |
| <p>@EchoToken</p><p>  </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                              | Unique Identifier to track the RQ/RS message                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                           |
| <p>@Target</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                          | <p> </p><p>Always set to “Production”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                           |
| <p>@Version</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                         | <p> </p><p>Always set to “1.0”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                           |
| <p>AvailStatusMessages</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                              | <p> </p><p>Contains list of availability messages (AvailStatusMessage)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| <p>@HotelCode</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages</strong></p>                                                                                                                                                                                                   | <p> </p><p>The code of the property whose availability is being updated</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                           |
| <p>@HotelName</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages</strong></p>                                                                                                                                                                                                   | <p> </p><p>The name of the property whose availability is being updated</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                        |
| <p>AvailStatusMessage</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages</strong></p>                                                                                                                                                                                           | An availability message. One of the BookingLimit or RestrictionStatus or LengthsOfStay must be included                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1..n                        |
| <p>@BookingLimit</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                             | <p> </p><p>The number of rooms available.</p><p>Optional,tobeset atRoom level</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 0…1                         |
| <p>@BookingLimitMessageType</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                  | <p>Always set to “SetLimit”.</p><p>Mandatory if “BookingLimit” is available.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 0…1                         |
| <p> </p><p>StatusApplicationControl</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                          | <p>The date range, room type code and rate code for which this</p><p>notification is sent is specified in this element</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| <p>@Start</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                                   | <p> </p><p>The start date for which the availability update is being set</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                           |
| <p>@End</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                                     | <p> </p><p>The end date for which the availability update is being set</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| <p> </p><p>@InvCode</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                         | <p>Identifies the room type for which the availability is being updated. The room type code + rate code</p><p>identify a unique product for which this update applies.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| @RatePlanCode                                                                                                                                                                                                                                                                                          | <p>Identifies the rate plan for which the availability is being updated.</p><p>Optional, in case of Inventory count (“BookingLimit”) only.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                        |
| <p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                                                                | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p><br></p>                 |
| <p> @Mon<br>@ Tue<br><br>@Weds<br>@Thur<br>@Fri<br>@Sat<br>@Sun<br><br>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/<br>StatusApplicationControl<br><br></p>                                                                                                                         | <p>The day of the week indicators are used to communicate which days of the week the update pertains to.<br>For example, if Mon, Tue and Weds are set to "1", and the other days are set to "0", the availability will<br>only be updated for Mondays, Tuesdays and Wednesdays. Optional.</p><p>If not set, all are assumed to be set to true.<br><br>NOTE: If one is sent they must all be sent.</p>                                                                                                                                                                                                                             | 0..1                        |
| <p>UniqueID<br>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</p>                                                                                                                                                                                                                      | <p> </p><p>Unique identifier for each availability message</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                           |
| <p>LengthsOfStay</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                     | <p>Availability based on length of stay can be set using this.</p><p><br></p><p>Optional</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                        |
| <p>LengthOfStay</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay</strong></p>                                                                                                                        | <p> </p><p>Mandatory if LengthsOfStay present.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                           |
| <p>@Time</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay /LengthOfStay</strong></p>                                                                                                                 | <p> </p><p>Mandatory if LengthOfStay is present. Sets the minimum number of days required for a stay.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                           |
| <p>@TimeUnit</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay /LengthOfStay</strong></p>                                                                                                             | <p> </p><p>Mandatory if LengthOfStay is present. Always set to“Day”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1                           |
| <p> </p><p> </p><p>@MinMaxMessageType</p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay /LengthOfStay</strong></p>            | <p>Mandatory if LengthOfStay is present. Stay control type. Can be any of the options below:</p><p>SetMinLOS : To set minimum length of stay.</p><p>SetMaxLOS: To set maximum length of stay.</p><p>SetForwardMinStay: To set minimum length of stay through.</p><p>SetForwardMaxStay: To set maximum length of stay through.</p>                                                                                                                                                                                                                                                                                                 | 1                           |
| <p>RestrictionStatus</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                 | <p> </p><p>Availability status assigned to the room rate combination.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 0..1                        |
| <p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p>@Status</p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>RestrictionStatus</strong></p> | <p>The restriction status. Mandatory if RestrictionStatus is present. Can be any of the options below:</p><p>Open: The Sale is open.</p><p>Close: The Sale is closed.</p><p>ClosedOnArrival: Arrival is closed.</p><p>ClosedOnDeparture: Departure is closed.</p><p>OpenOnArrival: Arrival is open.</p><p>OpenOnDeparture: Departure is open.</p><p>ClosedOnArrivalDeparture: Both Arrival & Departure is closed.</p><p>MaxAdvancedBookingOffset: Maximum number of days before the arrival date the hotel is bookable.</p><p>MinAdvancedBookingOffset: Minimum number of days before the arrival date the hotel is bookable.</p> | <p>        1</p><p><br></p> |


# OTA\_HotelAvailNotifRS

When RG Bridge processes a `OTA_HotelAvailNotifRQ` message, it responds with a `OTA_HotelAvailNotifRS` message. Here’s a summary of the response handling process:

1. **Normal Response**:
   * **OTA\_HotelAvailNotifRS**: Sent in response to the request, confirming receipt and processing of the availability update.
2. **Exception Handling**:
   * **REST Fault**: If a REST-level fault occurs, a REST fault message is sent.
   * **Application Level Validation**: If RG Bridge cannot validate a message at the application level, it still returns an `OTA_HotelAvailNotifRS`.
3. **Screening for Business Rules**:
   * Messages are screened for conformance to basic business rules.
   * RG Bridge ensures that the message pertains to a hotel that is enabled on RG Bridge.
   * Values are screened to ensure they meet specified business constraints.
4. **Failure Indication**:
   * Response messages indicating failures will contain at least one error element.
   * Multiple error elements may be returned if there are several issues.
5. **Successful Receipt**:
   * If the request is received correctly and screened for consistency, RG Bridge returns an `OTA_HotelAvailNotifRS` a message with a single `Success` element.
   * Note: Receiving a success message does not guarantee that updates will be made on all OTAs. Errors may still occur due to business rules at RG, OTA, or communication failures.

**Table D: Response indicating success**

```xml
<OTA_HotelAvailNotifRS xmlns="
http://www.opentravel.org/OTA/2003/05

"
 
Version="1.100"
EchoToken="879791878"
Target="Production"
TimeStamp="2011-10-01T16:56:20-05:00">


 <Success/>
</OTA_HotelAvailNotifRS>
```

**Table E: Response indicating failure**

```xml
 <OTA_HotelAvailNotifRS xmlns="
http://www.opentravel.org/OTA/2003/05

"
 
Version="1.100"
EchoToken="879791878"
Target="Production"
TimeStamp="2011-10-01T16:56:20-05:00">
 <Errors>
 <Error Type="3"
            Code="320"
            RecordID="A1K">
         Invalid Data in RestrictionStatus Field
 </Error>
 </Errors>
</OTA_HotelAvailNotifRS>
```

Hotels can access the Request logs to view the status of each update received through the RG Bridge interface on the RG user interface. Here are the key points:

* **Request Log**: Displays the overall status of the message.
* **Channel-Level Processing Logs**: It is possible to view detailed logs of the channel-level processing.


# XML Usage Specification

**Availability change response XML usage**

| <p><strong>Element/@Attribute</strong></p><p> </p><p><strong>Parent XPath</strong></p> | <p> </p><p><strong>Description</strong></p>                                                                                                                                                                | <p> </p><p> </p><p><strong>Occurrences</strong></p> |
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| <p>@TimeStamp</p><p> </p><p><strong>/OTA\_HotelAvailNotifRS</strong></p>               | <p> </p><p>Time of the transaction in xml schema date-time format</p>                                                                                                                                      | 1                                                   |
| <p>@EchoToken</p><p>  </p><p><strong>/OTA\_HotelAvailNotifRS</strong></p>              | Unique Identifier to track the RQ/RS message                                                                                                                                                               | 1                                                   |
| <p>@Target</p><p><strong>/OTA\_HotelAvailNotifRS</strong></p>                          | <p> </p><p>Always set to “Production”</p>                                                                                                                                                                  | 1                                                   |
| <p>@Version </p><p><strong>/OTA\_HotelAvailNotifRS</strong></p>                        | <p> </p><p>Always set to “1.0”</p>                                                                                                                                                                         | 1                                                   |
| <p><br></p><p>Success</p><p> </p><p><strong>/OTA\_HotelAvailNotifRS</strong></p>       | <p>If included this element will indicate that the request message was successfully processed.</p><p> </p><p> </p><p>Either a Successelementor Errors/error element(s) are required in every response.</p> | 0..1                                                |
| <p>Errors</p><p><strong>/OTA\_HotelAvailNotifRS</strong></p>                           | Either a Successelementor Errors/error element(s) are required in every response.                                                                                                                          | 0..1                                                |
| <p>Error </p><p><strong>/OTA\_HotelAvailNotifRS/Errors</strong></p>                    | <p>Description of cause for a fatal problem during request message processing.</p><p>\*If an Errors element is included one or more Error elements are required</p>                                        | 1                                                   |
| <p> @Type</p><p><strong>/OTA\_HotelAvailNotifRS/Errors/Error</strong></p>              | This is an enumeration of HTNG approved error types (OTA code list EWT). See appendix for supported values.                                                                                                | 1                                                   |
| <p> @Code</p><p><strong>/OTA\_HotelAvailNotifRS/Errors/Error</strong></p>              | <p>This is an enumeration of</p><p>HTNG approved error codes (OTA code list ERR). See appendix for supported values.</p>                                                                                   | 1                                                   |


# Rate Change Notification

This operation enables the PMS to request RG Bridge to update OTAs with changes in rates. Here's a breakdown of the process:

1. **Triggering Rate Changes**: Rate changes in the PMS can occur through daily rate changes, creation of new rate plans, addition of new inventory to existing rate plans, or due to enabling a hotel for integration, rolling refresh, re-status, etc.
2. **Notification Messages**: In all these scenarios, the PMS should send notification messages for the products and date ranges affected using the `OTA_HotelRateAmountNotifRQ` message.
3. **Message Handling by RG Bridge**:
   * RG Bridge will store the message before sending it to all managed channels.
   * RG Bridge will send a success or failure message back to the PMS interface.
4. **Retry Mechanism**: In case of failures on the RG Bridge side, the PMS interface must retry the message transmission up to 5 times before marking the notification as a failure.
5. **Message Exchange**:
   * **Request**: `OTA_HotelRateAmountNotifRQ`
   * **Response**: `OTA_HotelRateAmountNotifRS`

<figure><img src="/files/XLi6gZ2vtsIHfstd8Fk5" alt=""><figcaption></figcaption></figure>


# OTA\_HotelRateAmountNotifRQ

The PMS should use the `OTA_HotelRateAmountNotifRQ` message to send rate updates. These updates must be sent at the product level, ensuring accurate and comprehensive communication of rate changes.

**Rate change request XML sample for Base Rate (Room price)**

```xml

<OTA_HotelRateAmountNotifRQ xmlns="
http://www.opentravel.org/OTA/2003/05

"
 
TimeStamp="2011-10-01T12:00:00"
Target="Production"
EchoToken="235651837sddge4"
Version="1.002">
 <RateAmountMessages HotelCode="ATLPE">
 <RateAmountMessage>
     <StatusApplicationControl  Start="2011-12-01" 
                                End="2011-12-01"


                                 RatePlanCode="BARA00"


                                 InvCode="STD"/>
       <Rates>


         <Rate CurrencyCode="USD">


           <BaseByGuestAmts>


             <BaseByGuestAmt AmountBeforeTax="100.00"
AmountAfterTax="120.00"/>
           </BaseByGuestAmts>
         </Rate>
       </Rates>
 </RateAmountMessage>
 </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
```

###

**Rate change request XML sample for Occupancy Rate**

```xml
<OTA_HotelRateAmountNotifRQ xmlns="
http://www.opentravel.org/OTA/2003/05

"

TimeStamp="2011-10-01T12:00:00"
EchoToken="235651837sddge4"
Target="Production"
Version="1.002">
 <RateAmountMessages HotelCode="ATLPE">
 <RateAmountMessage>
     <StatusApplicationControl  Start="2011-12-01"
                                End="2011-12-01"
                                RatePlanCode="BARA00"
                                InvCode="STD"/>
      <Rates>
        <Rate CurrencyCode="USD">
          <BaseByGuestAmts>
            <BaseByGuestAmt AgeQualifyingCode="10" NumberOfGuests="1"
AmountBeforeTax="100.00" AmountAfterTax="120.00"/>
<BaseByGuestAmt AgeQualifyingCode="10" NumberOfGuests="2"
AmountBeforeTax="120.00" AmountBeforeTax="144.00"/>
          </BaseByGuestAmts>
<AdditionalGuestAmounts>
<AdditionalGuestAmount  AgeQualifyingCode="10" Amount="80"/>
<AdditionalGuestAmount AgeQualifyingCode="8" Amount="50"/>
</AdditionalGuestAmounts>
       </Rate>
      </Rates>
 </RateAmountMessage>
 </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
```


# XML Usage Description

**Rate change response XML usage**

| <p><strong>Element/@Attribute</strong></p><p><strong>Parent XPath</strong></p>                                                                                                                                         | **Description**                                                                                                                                                                                                                                                                                                                                                                                           | **Occurrences** |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| <p>@TimeStamp</p><p><strong>/OTA\_HotelRateAmountNotifRQ</strong></p>                                                                                                                                                  | <p> </p><p>Time of the transaction in xml schema date-time format</p>                                                                                                                                                                                                                                                                                                                                     | 1               |
| <p>@EchoToken</p><p><strong>/OTA\_HotelRateAmountNotifRQ</strong></p>                                                                                                                                                  | <p> </p><p> </p><p>Unique identifier to track RQ/RS message</p>                                                                                                                                                                                                                                                                                                                                           | 1               |
| <p>@Target </p><p><strong>/OTA\_HotelRateAmountNotifRQ</strong></p>                                                                                                                                                    | <p> </p><p> </p><p>Always set to “Production”</p>                                                                                                                                                                                                                                                                                                                                                         | 1               |
| <p>@Version</p><p> <strong>/OTA\_HotelRateAmountNotifRQ</strong></p>                                                                                                                                                   | <p> </p><p> </p><p>Always set to “1.0”</p>                                                                                                                                                                                                                                                                                                                                                                | 1               |
| <p>RateAmountMessages</p><p> <strong>/OTA\_HotelRateAmountNotifRQ</strong></p>                                                                                                                                         | Contains list of rate changes messages (RateAmountMessage)                                                                                                                                                                                                                                                                                                                                                | 1               |
| <p>@HotelCode</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p>                                                                                                                               | <p> </p><p>Hotel code of the property whose rate is</p><p>being updated</p>                                                                                                                                                                                                                                                                                                                               | 1               |
| <p>RateAmountMessage</p><p> <strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p>                                                                                                                       | <p> </p><p>The rate change to be made</p>                                                                                                                                                                                                                                                                                                                                                                 | 1..n            |
| <p>StatusApplicationControl</p><p> <strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p><strong>/RateAmountMessage</strong></p>                                                                      | The date range, room type code and rate code for which this notification is sent is specified in this element                                                                                                                                                                                                                                                                                             | 1               |
| <p>@Start</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p> </p><p><strong>/RateAmountMessage/StatusApplicationControl</strong></p>                                                        | The start date which the availability update is being set                                                                                                                                                                                                                                                                                                                                                 | 1               |
| <p>@End</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages/</strong></p><p><strong>RateAmountMessage/StatusApplicationControl</strong></p>                                                                  | <p> </p><p>The end date for which the availability update is being set</p>                                                                                                                                                                                                                                                                                                                                | 1               |
| <p>@InvCode</p><p> <strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p><strong>/RateAmountMessage/StatusApplicationControl</strong></p>                                                             | Identifies the room type for which the availability is being updated. The room type code + rate code identify a unique product for which this update applies.                                                                                                                                                                                                                                             | 1               |
| <p>@RatePlanCode</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p><strong>/RateAmountMessage/StatusApplicationControl</strong></p>                                                         | Identifies the rate for which the availability is being updated. If the rate code is not sent, the availability is updated for all the products that have the room type code specified above.                                                                                                                                                                                                             | 1               |
| <p><br></p><p>@Mon @Tue @Weds @Thur @Fri @Sat</p><p>@Sun</p><p> <strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p><strong>/RateAmountMessage/StatusApplicationControl</strong></p>                | <p>The day of the week indicators is used to communicate which days of the week the</p><p>update pertains to. For example, if Mon, Tue and Weds are set to"1", and the other days are set to "0", the availability will only be</p><p>updated for Mondays, Tuesdays and Wednesdays.</p><p>Optional. If not set, all are assumed to be set to true. </p><p>NOTE: If one is sent they must all be sent.</p> | 0..1            |
| <p>Rates</p><p> <strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages/RateAmountMessage/</strong></p>                                                                                                                | <p> </p><p>Contains the rate details</p>                                                                                                                                                                                                                                                                                                                                                                  | 1               |
| <p>Rate</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages/RateAmountMessage/Rates</strong></p>                                                                                                             | <p> </p><p>Thechangedratewhich has necessitated this update</p>                                                                                                                                                                                                                                                                                                                                           | 1..n            |
| <p>@CurrencyCode</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages/RateAmountMessage/Rates/Rate</strong></p>                                                                                               | <p> </p><p>Standard 3-character currency code of the rate eg "USD"</p>                                                                                                                                                                                                                                                                                                                                    | 1               |
| <p>BaseByGuestAmts</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages/RateAmountMessage/ Rates/Rate</strong></p>                                                                                            | Contains information about the rates.                                                                                                                                                                                                                                                                                                                                                                     | 1               |
| <p>BaseByGuestAmt</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p> </p><p><strong>/RateAmountMessage/ Rates/Rate / BaseByGuestAmts</strong></p>                                           | <p> </p><p> </p><p> </p><p>Contains the rate amounts per guest</p>                                                                                                                                                                                                                                                                                                                                        | 1..n            |
| <p>@AmountBeforeTax</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p><strong>/RateAmountMessage/Rates/Rate/BaseByGuestAmts/</strong></p><p><strong>BaseByGuestAmt</strong></p>             | <p> </p><p> </p><p>AmountBeforeTax to be present for rate updates.</p>                                                                                                                                                                                                                                                                                                                                    | 0..1            |
| <p>@AmountAfterTax</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p><strong>/RateAmountMessage/Rates/Rate/BaseByGuestAmts/</strong></p><p><strong>BaseByGuestAmt</strong></p>              | <p> </p><p> </p><p>AmountAfterTax to be present for rate updates.</p>                                                                                                                                                                                                                                                                                                                                     | 0..1            |
| <p> </p><p>@AgeQualifyingCode</p><p> <strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p><strong>/RateAmountMessage/ Rates/Rate/BaseByGuestAmts/</strong></p><p><strong>BaseByGuestAmt</strong></p> | <p>Optional and valid if required that Product rates to be configured per guest count wise:</p><p>“10” for Adult</p><p> “8” for Children</p><p> </p><p>Represent the Guest type to which the rate is applied.</p>                                                                                                                                                                                         | 0..1            |
| <p>@NumberOfGuests</p><p> <strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p><strong>/RateAmountMessage/ Rates/Rate/ BaseByGuestAmts/</strong></p><p><strong>BaseByGuestAmt</strong></p>           | <p> Representtheguestcounttowhichtherate</p><p>is applied.</p>                                                                                                                                                                                                                                                                                                                                            | 1               |
| <p>AdditionalGuestAmounts</p><p> <strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong></p><p><strong>/RateAmountMessage/Rates/Rate</strong></p>                                                             | <p> </p><p>Contains information about the Additional rates.</p>                                                                                                                                                                                                                                                                                                                                           | 0..1            |
| <p>AdditionalGuestAmount</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong> <strong>/RateAmountMessage/Rates/Rate/AdditionalGuestAm ounts</strong></p>                                             | <p> </p><p>Contains the additional rate amounts per guest type.</p>                                                                                                                                                                                                                                                                                                                                       | 1..n            |
| <p>@AgeQualifyingCode</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong> <strong>/RateAmountMessage/Rates/Rate/AdditionalGuestAmounts/ AdditionalGuestAmount</strong></p>                          | <p>Optional and valid if required that Product rates to be configured per guest count wise:</p><p>“10” for Adult</p><p> </p><p>“8” for Children</p><p> </p><p>Represent the Guest type to which the rate is applied.</p>                                                                                                                                                                                  | 1               |
| <p>@Amount</p><p><strong>/OTA\_HotelRateAmountNotifRQ/RateAmountMessages</strong> <strong>/RateAmountMessage/Rates/Rate/AdditionalGuestAm ounts/ AdditionalGuestAmount</strong></p>                                    | Required if AdditionGuestAmount is present. Represent the rate applied to the additional guest.                                                                                                                                                                                                                                                                                                           | 1               |


# OTA\_HotelRateAmountNotifRS

RG will respond to the above request by returning an OTA\_HotelRateAmountNotifRS message.

**Rate change response indicating success**

```xml
<OTA_HotelRateAmountNotifRS xmlns
="http://www.opentravel.org/OTA/2003/05"
 
Version="1.100"
EchoToken="879791878"
Target="Production"
TimeStamp="2011-10-01T16:56:20-05:00">
<Success />
</OTA_HotelAvailNotifRS>
```

**Rate change response indicating failure**

```xml

<OTA_HotelRateAmountNotifRS xmlns
="http://www.opentravel.org/OTA/2003/05"
 
Version="1.100"
EchoToken="879791878"
Target="Production"
TimeStamp="2011-10-01T16:56:20-05:00">
 <Errors>
 <Error Type="3" Code="320" RecordID="A1K"> 
        Invalid Data in RestrictionStatus Field
</Error>
</Errors>
</OTA_HotelAvailNotifRS>
```


# XML Usage Specification

| <p><strong>Element/@Attribute</strong></p><p> </p><p><strong>Parent XPath</strong></p> | <p> </p><p><strong>Description</strong></p>                                                                                                                                                                   | **Occurrences** |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| <p>@TimeStamp </p><p><strong>/OTA\_HotelRateAmountNotifRS</strong></p>                 | <p> </p><p>Time of the transaction in XML schema date-time format</p>                                                                                                                                         | 1               |
| <p>@EchoToken</p><p> <strong>/OTA\_HotelRateAmountNotifRS</strong></p>                 | Unique identifier to track RQ/RS message                                                                                                                                                                      | 1               |
| <p>@Target</p><p><strong>/OTA\_HotelRateAmountNotifRS</strong></p>                     | Always set to “Production”                                                                                                                                                                                    | 1               |
| <p>@Version</p><p> <strong>/OTA\_HotelRateAmountNotifRS</strong></p>                   | <p> </p><p>Always set to “1.0”</p>                                                                                                                                                                            | 1               |
| <p> Success</p><p><strong>/OTA\_HotelRateAmountNotifRS</strong></p>                    | <p>If included this element will indicate that</p><p>the request message was successfully processed.</p><p><br></p><p>Either a Success element or Errors/error element(s) are required in every response.</p> | 0..1            |
| <p>Errors</p><p><strong>/OTA\_HotelRateAmountNotifRS</strong></p>                      | Either a Success element or Errors/error element(s) are required in every response.                                                                                                                           | 0..1            |
| <p>Error</p><p><strong>/OTA\_HotelRateAmountNotifRS /Errors</strong></p>               | <p>Description of cause for a fatal problem during request message processing.</p><p>\*If an Errors element is included one or more Error elements are required</p>                                           | 1               |
| <p> @Type</p><p><strong>/OTA\_HotelRateAmountNotifRS /Errors/Error</strong></p>        | This is an enumeration of HTNG approved error types (OTA code list EWT). See the appendix for supported values.                                                                                               | 1               |
| <p>@Code</p><p><strong>/OTA\_HotelRateAmountNotifRS /Errors/Error</strong></p>         | This is an enumeration of HTNG approved error codes (OTA code list ERR). See appendix for supported values.                                                                                                   | 1               |


# Points to remember

#### OTA\_HotelAvailNotifRQ Operation

**Usage**:

* The `OTA_HotelAvailNotifRQ` operation is used to send both Inventory (BookingLimit) and Restrictions (Arrival/Departure/Master Status/LOS restrictions/AdvPurchase) updates.
* Allocation/InventoryCount/BookingLimit is manageable at the room level only by a CRS/PMS partner.

**Separate Messages for Inventory and Restrictions**:

* If both inventory and restriction need to be updated for the same room type and date, two separate messages must be sent to the RG Bridge ARI service. Partners should implement this use case accordingly.

**Compact ARI Updates**:

* ARI updates for a range of dates should be prepared compactly, covering multiple days using `StartDate` and `EndDate` in a single element (i.e., `AvailStatusMessage` / `RateAmountMessage` block), if the same ARI data needs to be updated for a range of dates.

**Delta Updates Recommendation**:

* Partners should always send delta updates after a full refresh is made initially for a new hotel connected to the interface.
* Example: If a booking/cancellation is made for a particular HotelProduct (RoomType + RatePlan), partners should send updates for the corresponding HotelProduct and specific dates affected by the new booking/cancellation.
* It is not allowed to send updates for all HotelProducts or larger date ranges that are not part of the recent booking/cancellation received for a hotel.


# Interface Specifications – Reservation Notification Service

## Overview

**RG Bridge Services for PMS Integration** is a comprehensive suite of services available to RateGain partner organizations. These services facilitate the integration of Property Management Systems (PMS) with the Channel Manager.

**RateGain's Channel Manager**:

* A premier channel management system for distributing Availability, Rates, and Inventory (ARI) to Internet Booking Agents (OTAs) and collecting reservations from them.
* Trusted by some of the world’s most renowned hotels and hotel chains.

**Functionality**:

* **PMS to Channel Manager**: As availability and rates change in the PMS, updates are pushed to RezGain. RezGain processes these messages and pushes updates to the subscribed OTAs.
* **Reservations to PMS**: Reservations retrieved by the Channel Manager are sent to the PMS.

**Documentation Scope**:

* **Part 1**: Specifies the interface that RateGain's Channel Manager makes available to PMS to push ARI updates.
* **Part 2**: Details the interface that PMS needs to provide to the Channel Manager for pushing reservations and obtaining confirmation numbers.

<br>

<figure><img src="/files/ONW3kKhrAw0x1MaVxiZE" alt=""><figcaption></figcaption></figure>


# RG Bridge integration process

The integration process should be well-planned and can be divided into the following phases:

**Phase 1: Initiation**

* **Technical Readiness Assessment**: Partners should assess their compatibility, resources, and know-how.
* **Pilot Hotel Selection**: A pilot hotel is usually agreed upon.
* **Test Account Setup**: Partners are provided with a test account and sufficient information to facilitate planned integration.
  * **Information Provided**:
    * Hotel Code and Hotel Name
    * List of products
    * Room type code
    * Rate type code
    * List of channels subscribed
    * OTA sell code and OTA name

**Phase 2: Development**

* **Development Kick-off**: Begin development with the provided information.
* **Integration Details**: Partners must provide technical descriptions and test results towards the end of this phase.

**Phase 3: Certification**

* **Test Plan**: Receive a test plan and test cases.
* **Certification**: Complete and sign off on the certification process.

**Phase 4: Production Pilot**

* **Pilot Monitoring**: Connect the pilot hotel to RG Bridge and monitor the integration to ensure success.

**Phase 5: Production**

* **Go Live**: Release the integration to production and make it generally available.


# Intended audience

This interface description is tailored for software developers, project managers, and implementers. It assumes an advanced working knowledge of API services. Therefore, concepts and standards related to API services are not elaborated or discussed in this document.


# Typographical conventions

#### XML Usage Description

**RG Bridge** utilizes OpenTravel standard XML for information exchange. The XML usage descriptions employ a pseudo-schema description format to specify the usage of XML elements and attributes as they apply to RG Bridge. The actual schema definitions are made available separately and adhere to industry standards, accommodating many use cases beyond what is required by RG Bridge.

#### Sample XML

Sample XML messages are provided throughout this document to aid in understanding the message usage. These messages are formatted for clarity. In the example message in Table A, the top-level element of the rate update request message is `OTA_HotelResNotifRQ`. The attributes of this element follow standard conventions.

**Sample XML**

```xml
<OTA_HotelResNotifRQ xmlns="http://www.opentravel.org/OTA/2003/0 " 
 
EchoToken="" 
 
TimeStamp="2011-01-26T10:22:00-05:00" 
 
Target="Production" 
Version="1.003" 
ResStatus="Book"> 
<POS> 
<Source> 
<RequestorID Type="13" ID="473"/> 
<BookingChannel Type="7" Primary="true"> 
<CompanyName>Travel Today</CompanyName> 
</BookingChannel> 
</Source> 
</POS> 
<HotelReservations> 
<HotelReservation> 
<RoomStays> 
<RoomStay> 
<!-- details omitted --> 
</RoomStay> 
</RoomStays> 
<ResGuests> 
<ResGuest> 
<Profiles> 
<ProfileInfo> 
<!-- details omitted --> 
</ProfileInfo> 
</Profiles> 
</ResGuest> 
</ResGuests> 
</HotelReservation> 
</HotelReservations> 
</OTA_HotelResNotifRQ> 
```

#### Message Focus and Formatting

**Identifiers**:

* To highlight the parts of the message being discussed, those parts have an identifier, like this: `OTA_CancelRQ`.

**Green Values**:

* Values shown in green must be set in a specific way because that is the only use of that element/attribute that RG Bridge can process. For example:

  xml

  ```
  <RateTimeUnit>Day</RateTimeUnit>
  ```

  * "Day" is the only value that can be passed to RG Bridge, even though the OTA schema allows other values.

**Red Values**:

* Values shown in red are specific to the message. For example:

  xml

  ```
  <CompanyName>Travel Today</CompanyName>
  ```

  * "Travel Today" specifies the channel name. These values are fictitious and used for sample purposes only.

**Formatting for Readability**:

* Messages have been formatted with additional new lines and tab characters for better readability. However, these are not part of the actual XML and must not be used in actual messages.

**XML Style Comments**:

* XML style comments in the samples are not part of the schema. They have been added to indicate incomplete sections in the XML, helping focus on the important parts and show the general pattern. For example:\<!— Content omitted-->

<br>


# Technical overview

## Service Model

**Connected Model**:

* This interface is designed to be used in a connected model where partner systems should always be available to receive reservations.

**Push-Model Web Service**:

* As part of the integration, CRS/PMS partners should develop a push-model web service that meets the described standards and make it available to RG Bridge.
* In the push model, information is sent (pushed) by the system on which the information originated.

**Pull Model**:

* In contrast, the pull model involves the system that needs the information accessing it by periodically connecting to it.

**Advantages of the Push Model**:

* The push model eliminates the need for partners to periodically access RG Bridge to check for new reservations, ensuring seamless and real-time updates.

### General design

<figure><img src="/files/4aAlQ6jRoMxc3dMN6V1c" alt=""><figcaption></figcaption></figure>

<br>

**Primary Operation**:

* **Reservation Notifications**: RG Bridge will send reservations downloaded from OTAs to PMS using reservation notification request messages.
  * Each reservation notification request will hold a single reservation record.
  * PMS will respond with either:
    * A **success response** with a PMS confirmation code.
    * An **error response** with reasons for failure.

**Message Exchange**:

* **New, Modified, and Canceled Reservations**: All are pushed by sending `OTA_HotelResNotifRQ` messages and receiving `OTA_HotelResNotifRS` messages in response.

This streamlined process minimizes the effort required by the PMS to implement the services, ensuring efficient and accurate handling of reservation notifications.

## Connectivity Mode

**Connectivity**:

* The connectivity supports REST communication mode for exchanging messages between the RG Bridge interface and partner system.

**REST Connectivity**:

* Clients have the option of implementing HTTP Basic Authentication for message exchange.
  * **Service Credential**: Username and password need to be passed using basic authorization in HTTP headers.

Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= &#x20;

The Content-Type used as text/xml.

### Reservation Handling

It's crucial to grasp how RG Bridge processes reservations to ensure a successful integration with your PMS.

#### Split versus Non-Split Reservation Delivery

**Split Mode**:

* Partners opting for split mode configuration will receive split/leg reservation messages per room count booked in a reservation.
* **Example**: If a reservation is booked for 2 rooms, the partner will receive:
  * ResvID#1(1/2)
  * ResvID#1(2/2)
  * Each with different confirmation numbers returned from the partner in response.

**Full Mode**:

* In full mode configuration, only 1 reservation is delivered containing all room information in a single message.
* This reservation will be saved using the same confirmation number in the partner system.

#### Cancellation against Modification

**OTA Handling**:

* OTAs handle reservation modifications in various ways. Many use the “Cancellation against Modification” (CAM) process, where modifications are delivered as a pair of Cancel and New reservations.
* Some OTAs might deliver modifications directly without the CAM process.

**PMS Handling**:

* The PMS should be capable of handling both methods of modification (CAM and direct modifications).

This flexibility ensures that the reservation delivery system can accommodate different scenarios, providing accurate and efficient reservation management

### Reliability mechanisms and constraints.

Given the high volume of messages exchanged between the RG Bridge and the PMS, it is essential to implement the mechanisms and constraints described in Table B to ensure efficient and reliable communication.

**Reliability mechanisms and constraints**

| **Type**                             | **Mechanism/Constraint**                                                                         | **Description**                                                                                                                                                                                                                                                                                          |
| ------------------------------------ | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Retry                                | Retry strategy for communication Failure and in case of specific errors returned in XML response | The Systems and PMS will have a retry mechanism in place for communication errors and business error.                                                                                                                                                                                                    |
| Concurrency                          | Simultaneous connections per property <= 1                                                       | PMS RG Interface will establish a single connection per Property at any given time for updating the ARI events, and allows only one Connection per Property at a time for receiving the Booking Notifications.                                                                                           |
| Timeout                              | Time out after 60,000 milliseconds (1 minute)                                                    | Idle connections (no packets sent by either side) for more than 1 minute are closed. These should be considered as incomplete and implement are try strategy to re-send data.                                                                                                                            |
| Character Set                        | Support for UTF-8                                                                                | All messages exchanged must have UTF-8 encoding                                                                                                                                                                                                                                                          |
| <p>Reservation</p><p>Information</p> | Support reservations accept reservations with minimum information                                | There is great variation in the structure and amount of information available in reservations retrieved from OTAs. The PMS should be able to process reservations with the minimum amount of information.                                                                                                |
| <p>Reservation</p><p>Information</p> | <p>Support reservations delivered to DEFAULTROOM</p><p>and DEFAULTRATE</p>                       | Occasionally, reservations would be retrieved from OTAs which cannot be mapped to any existing room/rate types on RG Bridge. RG Bridge will deliver these reservations with Room type code set to “DEFAULTROOM” and Rate Type code set to “DEFAULTRATE”. PMS should be able to accept such reservations. |
| <p>Payment</p><p>Information</p>     | <p>Support one-time delivery of</p><p>credit card information</p>                                | To comply with PCI standards, many OTAs and consequently RG Bridge, deliver credit card information only once. PMS should be able to accept modifications and cancellations of reservations without credit card information.                                                                             |


# Operations


# Reservation Notification

**Web Service Operation**:

* This operation allows RG Bridge to deliver reservations to the PMS.

**Messages Involved**:

1. **OTA\_HotelResNotifRQ**:
   * Sent by RG Bridge to the PMS service to notify of a new reservation.
2. **OTA\_HotelResNotifRS**:
   * Sent by the PMS in response to confirm the reservation.
   * If a REST level error occurs, a REST fault message should be sent instead.


# OTA\_HotelResNotifRQ

**Reservation Message**:

* RG Bridge will send reservations using the `OTA_HotelResNotifRQ` message.
* Each message will contain only one reservation record.

**PMS Processing**:

* The PMS should process the message synchronously and respond with the confirmation of receipt and PMS confirmation number.

**OpenTravel Hotel Reservation Record**:

* It is a complex data structure with many elements possible as per the schema.
* The PMS Service should be designed to accommodate the maximum amount of data elements, ensuring flexibility and comprehensive handling.
* RG Bridge can include more information where the data is available from the OTA.

**Reservation request; Sample XML**

```xml
<OTA_HotelResNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" 	EchoToken="354" 
TimeStamp="2011-01-26T10:22:00-05:00" Target="Production" Version="1.003" 
ResStatus="Commit"> 
<POS> 
 
<Source> 
 
<RequestorID Type="13" ID="473"/> 
 
<BookingChannel  Type="7"  Primary="true"> 
 
<CompanyName>Travel  Today</CompanyName> 
 
</BookingChannel> 
 
</Source> 
 
</POS> 
 
<HotelReservations> 

<HotelReservation CreateDateTime="2015-12-15T00:00:00" CreatorID="RateGain"
ResStatus="Cancel">
<POS>
<Source>
<RequestorID Type="13" ID="473" />
<BookingChannel  Type="7"  Primary="true">
<CompanyName Code="GHRS" />
</BookingChannel>
</Source>
</POS>
<UniqueID Type="14" ID="THVHSCERT007" />
<BasicPropertyInfo HotelCode="RGBRTEST" />
<RoomStays>
<RoomStay PromotionVendorCode="" RoomStayStatus="Book" WarningRPH="">
<RatePlans>
<RatePlan RatePlanCode="1311" />
</RatePlans>
<RoomRates>
<RoomRate RoomTypeCode="STD" NumberOfUnits="1" RatePlanCode="BAR"
PromotionVendorCode="">
<Rates>
<Rate EffectiveDate="2016-01-10" ExpireDate="2016-01-11"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountAfterTax="110" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2016-01-11" ExpireDate="2016-01-12"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountAfterTax="110" CurrencyCode="EUR" />
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
<TimeSpan Start="2016-01-10" Duration="P2D" End="2016-01-12" />
<Total AmountAfterTax="220" CurrencyCode="EUR" />
<ResGuestRPHs />
<Comments>
<Comment>
<Text>Cab for Airport will be provided</Text>
</Comment>
</Comments>
<Memberships>
<Membership AccountID="" BonusCode="" PointsEarned="" ProgramCode=""
TravelSector="" />
</Memberships>
<SpecialRequests>
<SpecialRequest>
<Text>Non-Smoking Room</Text>
</SpecialRequest>
</SpecialRequests>
</RoomStay>
</RoomStays>
<Services>
<Service>
<ServiceDetails>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<TimeSpan Start="2016-01-10" Duration="P2D" End="2016-01-12" />
<CancelPenalties  />
<Total AmountAfterTax="220" CurrencyCode="EUR" />
<HotelReservationIDs>
<HotelReservationID ResID_Type="16" ResID_Value="THVHSCERT007" />
<HotelReservationID  ResID_Type="13"  ResID_Value="THVHSCERT007#1(1/2)"  />
<HotelReservationID ResID_Type="14" ResID_Value="00060850/001" />
</HotelReservationIDs>
</ResGlobalInfo>
</HotelReservation>
</HotelReservations>
</OTA_HotelResNotifRQ>

```


# XML Usage specification

| <p><strong>Element/@Attribute</strong></p><p><strong>Parent XPath</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | **Occurrences**                   |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| <p>@TimeStamp</p><p><strong>/OTA\_HotelResNotifRQ</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p> </p><p>Time of the transaction in xml schema date-time format</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                                 |
| <p>@Version</p><p><strong>/OTA\_HotelResNotifRQ</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | The OTA schema version. Mandatory. Always set to“1.003”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                 |
| <p><br></p><p>@ResStatus</p><p><strong>/OTA\_HotelResNotifRQ</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>To specify the type of action requested. Will be one of:</p><p>•       <strong>“Commit”</strong> -><strong>New reservation</strong></p><p> </p><p>•       <strong>“Modify” -> Modification</strong></p><p> </p><p>•       <strong>“Cancel” → Cancellation</strong></p>                                                                                                                                                                                                                                                                                                     | <p>1</p><p><br></p><p><br></p>    |
| <p> POS</p><p><strong>/OTA\_HotelResNotifRQ</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>Indicating the channel from which booking is received.</p><p>A simple source record would look like this:</p><p>\<POS><br>\<Source><br>\<BookingChannel></p><p>\<CompanyName Code=”LTA1”> Famous OTA</p><p>\</CompanyName></p><p>\</BookingChannel><br>\</Source></p><p><br></p><p>This indicates that the reservation received from the OTA “Famous OTA” whose RG Bridge code is LTA1.</p>                                                                                                                                                                                | 1                                 |
| <p>Source</p><p><strong>/OTA\_HotelResNotifRQ/POS</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>Provides information on the source</p><p>of a request.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>1</p><p><br></p>               |
| <p>BookingChannel</p><p> <strong>/OTA\_HotelResNotifRQ/POS/Source</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Specifies the booking channel type and whether it is the primary means of connectivity of the source.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>1</p><p><br></p>               |
| <p>CompanyName</p><p><strong>/OTA\_HotelResNotifRQ/POS/Source/</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p> </p><p>Contains the name of the channel</p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p>1</p><p><br></p>               |
| <p>@Code</p><p> <strong>/OTA\_HotelResNotifRQ/POS/Source/</strong></p><p><strong>BookingChannel/CompanyName</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Contain code for the channel from which RezGain receives the booking. A list of OTA channels will be agreed between RG and PMS.                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                 |
| <p>HotelReservations</p><p><strong>/OTA\_HotelResNotifRQ</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Contains 1 or more instance of hotel reservations. RG will only send one reservation in one message.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                 |
| <p>HotelReservation </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p> </p><p>Reservation record</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0…1                               |
| <p> @CreateDateTime</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p> Time of Booking</p><p>Time of the Booking in UTC format</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                 |
| <p>@LastModifiedDateTime</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Last updated time of booking in UTC format                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                              |
| <p>@ResStatus</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>Reservation Status. Since only one reservation record is sent in a message, the ResStatus at the</p><p>message level and at the reservation level will both be same.</p><p><br></p><p>Tospecifythetypeof action requested.</p><p>Will be one of:<br><br>• “Commit” -> New reservation<br><br>• “Modify” -> Modification<br><br>• “Cancel” ->Cancellation</p>                                                                                                                                                                                                               | 1                                 |
| <p>@CreatorID</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | The CreatorID is the identifier of the user or, in its absence, the office that originated the reservation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 0..1                              |
| <p> BasicPropertyInfo</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Property Information for the reservation. An abbreviated short summary of hotel descriptive information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                 |
| <p>@HotelCode</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/BasicPropertyInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p> </p><p>Hotel Code for this reservation. Will be PMS/CRS partner hotel code.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1                                 |
| <p>UniqueID</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p> </p><p>An identifier used to uniquely identify a booking confirmation number</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                 |
| <p> @Type</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/UniqueID</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>Unique ID type</p><p>Always set to 14</p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                 |
| <p>@ID</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/UniqueID</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p> </p><p>Unique Booking created in the source OTA channel</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                 |
| <p>RoomStays</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Contains 1 or more RoomStay elements. Allowed only 1 RoomStay element if the partner is working on split mode reservation delivery.                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1                                 |
| <p>RoomStay</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p> </p><p>A Room stay details.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1..n                              |
| <p>RatePlans</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p> </p><p>Contains ratePlan element associated with this room stay.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                 |
| <p>RatePlan</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RatePlans</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p> </p><p>Details of a particular RatePlan</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                 |
| <p>@RatePlanCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                             | Used to pass OTA/ Channel specific RatePlanCode booked in this RoomStay and not the RatePlanCode configured in CRS/PMS system. You may ignore it, if not required.                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                 |
| <p>RoomRates</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p> </p><p><strong>HotelReservation/RoomStays/RoomStay</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Contains RoomRate elements associated with this room stay.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                 |
| <p>RoomRate</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p> </p><p>A Room Rate element</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                 |
| <p>@RoomTypeCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p> </p><p>Room type code of this room stay in CRS/PMS system.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                 |
| <p>@NumberOfUnits</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p> </p><p>This is the number of rooms booked for the room type listed in the RoomTypeCode attribute</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                 |
| <p>@RatePlanCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p> </p><p> </p><p>Rate type code of this room stay</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                 |
| <p>Rates</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p> </p><p>Contains one or more Rate elements</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                                 |
| <p>Rate</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p> </p><p>Rate details for each of the Stay Dates</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1..n                              |
| <p> </p><p>@EffectiveDate</p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates/Rate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>The EffectiveDate attribute indicates the start of the date range for which this specific rate is applied. A RoomStay could have different rates applied for different stay dates.</p><p>EffectiveDate and ExpireDate of each rate element together define for which dates of the stay that rate is applicable</p>                                                                                                                                                                                                                                                         | 1                                 |
| <p>@ExpireDate</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates/Rate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                    | The ExpireDate attribute indicates the end of the date range for which this specific rate is applied.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                                 |
| <p>@ RateTimeUnit</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates/Rate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p> </p><p> </p><p>Indicates the unit of time. Should always be “Day”.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                 |
| <p>@UnitMultiplier</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates/Rate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                | <p> </p><p>UnitMultiplier indicates how many days the rate is applicable for. Always set to “1”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1                                 |
| <p>Base</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates/Rate</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p> </p><p>The base amount charged for the accommodation or service per unit of time</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                 |
| <p>@CurrencyCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates/Rate/Base</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                             | <p> </p><p> </p><p>Indicates the currency of the rate.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                 |
| <p>@AmountBeforeTax</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates/Rate/Base</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>Base Amount before Tax.</p><p> </p><p>Either AmountBeforeTax or AmountAfterTax must be present</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 0..1                              |
| <p>@AmountAfterTax</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates/Rate/Base</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p>Amount including tax.</p><p> </p><p>Either AmountBeforeTax or AmountAfterTax must be present</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 0..1                              |
| <p>GuestCounts</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p> </p><p>Contains the guest counts of the room stay</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 1                                 |
| <p>GuestCount</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/GuestCounts</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Contains the type and number of guests included in the room stay. Will be repeated for each guest type: Adult and Child                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1..2                              |
| <p>@AgeQualifyingCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/GuestCounts/</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>RG Bridge supports the following values:</p><p><strong>10 = Adult</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                                 |
| <p>@Count</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/GuestCounts/</strong></p><p><strong>GuestCount</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p> </p><p> </p><p>Guest Count</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                 |
| <p>TimeSpan</p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | The Time Span which covers the Room Stay. Used to specify a time window range by specifying an earliest and latest date for the start date and end date.                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                 |
| <p>@Start</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/</strong></p><p><strong>RoomStay/TimeSpan</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p> </p><p> </p><p>Check-in date for this room stay</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                 |
| <p>@End</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/</strong></p><p><strong>RoomStay/TimeSpan</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p> </p><p> </p><p>Check-out date for this room stay</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                 |
| <p>Total </p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p> </p><p> </p><p> </p><p> </p><p>The total amount charged for the Room Stay</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                                 |
| <p>@CurrencyCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p> </p><p>Indicates the currency of the total</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                 |
| <p>@AmountBeforeTax</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>Total amount excluding tax.</p><p> </p><p>Either AmountBeforeTax or AmountAfterTax must be present</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                              |
| <p>@AmountAfterTax</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>Total amount including tax.</p><p> </p><p>Either AmountBeforeTax or AmountAfterTax must be present</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                              |
| <p>Taxes</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p> </p><p>Contains taxes and surcharges information, if any.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p>Tax</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total/Taxes</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p> </p><p>Tax or surcharge information</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 1                                 |
| <p>@Type</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total/Taxes/Tax</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Indicates whether the tax is inclusive, exclusive, or cumulative                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 1                                 |
| <p>@Code</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total/Taxes/Tax</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>Used to indicate the specific tax or fee that is being transferred.</p><p>Code that specifies the type of tax:</p><p><strong>16 = surcharge</strong></p><p> </p><p><strong>17 = Total tax.</strong></p>                                                                                                                                                                                                                                                                                                                                                                    | 1                                 |
| <p>@CurrencyCode</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total/Taxes/Tax</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Currency of the total Amount of Taxes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                                 |
| <p>@ Amount</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total/Taxes/Tax</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Amount of the specific tax/fee transferred                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                 |
| <p>Memberships</p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | A collection of Membership objects. Memberships provides a list of reward programs which may be credited with points accrued from the guest's activity.                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                              |
| <p>Membership</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Memberships</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | The Selected Membership object identifies the frequent customer reward program and (optionally) indicates points awarded for stay activity.                                                                                                                                                                                                                                                                                                                                                                                                                                   | 0..1                              |
| <p><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.Memberships.Membership.AccountID.html">@</a><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.Memberships.Membership.AccountID.html">AccountID</a></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Memberships/</strong></p><p><strong>Membership</strong></p>                                          | The account identification number for this particular member in this particular program.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                              |
| <p><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.Memberships.Membership.PointsEarned.html">@</a><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.Memberships.Membership.PointsEarned.html">PointsEarned</a></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Memberships/</strong></p><p><strong>Membership</strong></p>                                 | The total number of points earned through the selected membership.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                              |
| <p><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.Memberships.Membership.ProgramCode.html"><strong>@</strong></a><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.Memberships.Membership.ProgramCode.html"><strong>ProgramCode</strong></a> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Memberships/</strong></p><p><strong>Membership</strong></p> | The code or name of the membership program    ('Hertz', 'AAdvantage', etc.).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p><br></p><p>0..1</p>            |
| <p><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.Memberships.Membership.TravelSector.html">@</a><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.Memberships.Membership.TravelSector.html">TravelSector</a></p><p><br></p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Memberships/</strong></p><p><strong>Membership</strong></p>                     | <p><br></p><p>Identifies the travel sector. Refer to OpenTravel Code List Travel Sector (TVS).</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>0..1</p><p><br></p>            |
| <p>Comments</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>A collection of comments</p><p><br></p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>0..1</p><p><br></p><p><br></p> |
| <p>Comment</p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Comments</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | A comment which applies to the room stay. A comment can either be guest viewable or not.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>1</p><p><br></p>               |
| <p>@GuestViewable</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Comments/Comment</strong></p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | This indicates that the comment can actually be seen by the guest and is necessary when two different types of comments are passed: one which is guest viewable and one that isn’t.                                                                                                                                                                                                                                                                                                                                                                                           | <p>1</p><p><br></p>               |
| <p> Text</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Comments/Comment</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>Comment text</p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p><br></p><p> 1</p>              |
| <p> SpecialRequests</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Contains SpecialRequest elements. The SpecialRequest object indicates special requests for a particular Room Stay. The collection of all specialrequests associated with any part of the reservation (the reservation in its entirety, one or more guests, or one or more room stays). Which special requests belong to which part is determined by each object's SpecialRequestRPHs collection.                                                                                                                                                                              | 0..1                              |
| <p>SpecialRequest</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/SpecislRequests</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | If SpecialRequests element is present, at least 1 SpecialRequest must be present.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                                 |
| <p> @RequestCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/SpecislRequests/</strong></p><p><strong>SpecialRequest</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>Optional, contains the code of the Special Request. It could be:</p><p>Smoking</p><p>Non-Smoking</p><p> </p><p>If not present, the text of the Special Request to be added to child element \<Text></p>                                                                                                                                                                                                                                                                                                                                                                    | 0..1                              |
| <p>Text</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/SpecislRequests/SpecialRequest</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Optional, contains the text of the Special Request if \<SpecialRequest @RequestCode> is not present.                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                 |
| <p><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.ResGuestRPHs.html">ResGuestRPHs</a></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay</strong></p>                                                                                                                                                                                                                                                                                                                | <p>An integer serving as reference placeholders, and used as an index identifying which guests occupy this</p><p>room</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 1                                 |
| <p><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.ServiceRPHs.html">ServiceRPHs</a></p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay</strong></p>                                                                                                                                                                                                                                                                                                                 | A collection of unsigned integers that reference the RPH (Reference Place holder) attribute in the Service object. The ServiceRPH attribute in the Service object is an indexing attribute that identifies the services attached to this room stay.                                                                                                                                                                                                                                                                                                                           | 0..1                              |
| <p>ResGuests</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Contains guest information elements. Will always contain at least one element with the primary guest information.                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                                 |
| <p> ResGuest</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>At least one guest-information will be sent. May optionally contain additional guest information. Used to pass different guest profile info</p><p>i.e. canbeguest, TravelAgent, COmpamny profile details.</p>                                                                                                                                                                                                                                                                                                                                                              | 1..n                              |
| <p>@AgeQualifyingCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p> RGBridge supports the following values:</p><p>10=Adult 8=Child</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                                 |
| <p> @PrimaryIndicator</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Will be true for primary guest. Only one ResGuest element in the ResGuests container will have the value of primary indicator set to true.                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                 |
| <p>@ArrivalTime</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | This represents the date and time of the guest's arrival at the hotel. For example, this could be used to indicate a late arrival.                                                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                              |
| <p>@DepartureTime</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | This represents the date and time of the guest's arrival at the hotel. For example, this could be used to indicate a latearrival.                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.ResGuests.ResGuest.ResGuestRPH.html">@ResGuestRPH </a></p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest</strong></p>                                                                                                                                                                                                                                                                                                        | This is a reference placeholder, used as an index for this guest in this reservation. It is used by the RoomStay and Service objects to indicate which guests are associated with that room stay or service.                                                                                                                                                                                                                                                                                                                                                                  | 1                                 |
| <p>Profiles</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>Mandatory for the primary guest and optional for other guests.</p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p>1</p><p><br></p>               |
| <p>ProfileInfo</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>Only one ProfileInfo element is allowed for each guest</p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>1</p><p><br></p>               |
| <p>UniqueID</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/ProfileInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>This issued to pass a Unique ID linked to the profile that is being transferred. For a guest profile, it</p><p>could be the customer loyalty number, for a company it could be the corporate ID. For a travel Agency it could be the IATA number.</p>                                                                                                                                                                                                                                                                                                                      | <p>0</p><p><br></p>               |
| <p>@Type </p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/ProfileInfo</strong></p><p><strong>/UniqueID</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p> The Type attribute refers to OpenTravel Alliance code type UIT and the choices recommended by HTNG should be:</p><p><strong>1– Customer4– Company5–Travel Agency</strong></p>                                                                                                                                                                                                                                                                                                                                                                                             | 1                                 |
| <p>@ID</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/ProfileInfo</strong></p><p><strong>/UniqueID</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p> </p><p>The actual ID.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                 |
| <p>@IDContext  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/ProfileInfo</strong></p><p><strong>/UniqueID</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                           | Used to identify the source of the identifier (e.g., IATA, ABTA, Guest loyalty ID, CorprateId).                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 0                                 |
| <p>Profile</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/ProfileInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>Profile information. Used to pass the profile info for the guest, the Company or the Travel agency. For</p><p>the individual guest the code used in ProfileType is the OTA PRT code 1-</p><p>\[Customer], For a company it is PRT Code – 3 \[Corporation]. For a travel agency it is PRT code 4 – \[Travel agent]</p>                                                                                                                                                                                                                                                      | 1                                 |
| <p> @ProfileType</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/ProfileInfo/Profile</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>Code to specify a profile such as Customer, Booker, Tour Operator, Corporation, etc.</p><p>Supported type in RGBridge:</p><p>1: Customer</p><p>3: Corporate / Company profile</p><p>4: TravelAgent</p><p>18: Booker</p>                                                                                                                                                                                                                                                                                                                                                    | <p><br></p>                       |
| <p>Customer</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                | Profile details of a guest. Used to transmit the Customer details. Profile details of a guest. Optional for TravelAgent / Company profile.                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                              |
| <p>PersonName</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Name of guest                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                 |
| <p>NamePrefix</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/PersonName</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                          | This field would be used to pass the guest’s name prefix                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                              |
| <p>GivenName</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/PersonName</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                           | Person name Part of guestname. This field would be used to pass the guest’s first name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                 |
| <p>SurName</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/PersonName</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                             | Surname part of guest name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                 |
| <p>Telephone</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p> <strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p> </p><p>Guest phone number</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p>@PhoneNumber</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                         | The actual phone number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                 |
| <p>@PhoneLocationType</p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                        | <p>The PhoneLocationType attribute referstotheOTAPLT code list and indicates where the phone number is based – the values to be used are:</p><p><strong>6 – Home</strong></p><p> <strong>7 – Office</strong></p><p> <strong>8 – Other (e.g. cell phone)</strong></p>                                                                                                                                                                                                                                                                                                          | 0..1                              |
| <p>@PhoneTechType</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/ ProfileInfo/Profile/Customer/Telephone</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>The PhoneTechType attribute refers to the OTA PTT code list and indicates which type of number is transmitted (phone vs fax). The 2 codes to be used are:</p><p><strong>1 –Voice</strong></p><p><strong>3 –Fax</strong></p>                                                                                                                                                                                                                                                                                                                                                | 1                                 |
| <p>@CountryAccessCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                           | <p>Code assigned by telecommunications authorities for international country access</p><p>identifier.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                              |
| <p>@AreaCityCode</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/ HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                               | Code assigned for telephones in a specific region, city, or area.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p> @FormattedInd</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>Formatted Ind is MANDATORY. If the partner can use Country and Area codes then it should be set to NO.</p><p>If country code and area code are passed then they should not appear again in the PhoneNumber field.</p><p>If the partner cannot use country and area code then entire number is passed in the PhoneNumber field and FormattedIndit should be set to YES if the number needs to be parsed as there is a separation of the different parts or set to NO to indicate that the PhoneNumber field contains the entire phone number without a specific format.</p> | 1                                 |
| <p>@ DefaultInd</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                        | DefaultInd is optional and would indicate whether the phone number is the primary phone number for the profile                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 0..1                              |
| <p>Email</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/ HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p> </p><p> </p><p>Guest Email</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                              |
| <p> @EmailType</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Email</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                              | The Email Type attribute uses the OTA code list EAT and indicates the type of email address provided (personal – code 1 vs business – code 2, in the case of the Guest details) and must be passed if more than one email address is passed. If only one email address is passed this is optional.                                                                                                                                                                                                                                                                            | 1                                 |
| <p>@DefaultInd</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/ HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Email</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                     | DefaultInd is optional and would indicate whether the email is the primary email for the profile                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 0..1                              |
| <p>Address</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                        | Address of the guest                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 0..1                              |
| <p>@Type</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>The Type attribute uses the OTA code list CLT and indicates the type of address provided</p><p><strong>1 - Home</strong></p><p><strong>2 - Business</strong></p><p><strong>3 - Other</strong></p>                                                                                                                                                                                                                                                                                                                                                                          | 0..1                              |
| <p>AddressLine</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                            | Will contain 1 to 3 Address lines. Will contain at least 1 line                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                 |
| <p>CityName</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                              | City Name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                              |
| <p>StateProv</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/ HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p> </p><p> </p><p>State Name</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p>@ StateCode</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address/StateProv</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                  | <p> </p><p> </p><p>State Code</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p>PostalCode</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                             | <p> </p><p>Postal Code</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                              |
| <p>CountryName</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/ HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p> </p><p> </p><p>Country name</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 0..1                              |
| <p>@ Code</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address/CountryName</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                     | <p> </p><p> </p><p>ISO Country code</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                              |
| <p>CompanyInfo</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                             | Company information related to the profile. Detailed information about a company or a travel agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>0..1</p><p>  </p>              |
| <p>CompanyName</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                | <p> </p><p>Detailed name information for the company. Identifies a company by name.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                              |
| <p>TelephoneInfo</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/ HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p> </p><p> </p><p>Company phone number</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 0..1                              |
| <p>@PhoneNumber </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                 | <p> </p><p> </p><p>The actual phone number</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 0..1                              |
| <p>@PhoneLocationType</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                            | <p>The PhoneLocationType attribute</p><p>refers to the OTA PLT code list and indicates where the phone number is based –the values to be used are:</p><p><strong>6 – Home</strong></p><p><strong>7 – Office</strong></p><p><strong>8 – Other (e.g. cell phone)</strong></p>                                                                                                                                                                                                                                                                                                   | 0..1                              |
| <p>@PhoneTechType</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                               | <p>The PhoneTechType attribute refers to the OTA PTT code list and indicates which type of number is transmitted (phone vs fax). The 2 codes to be used are:</p><p><strong>1 –Voice</strong></p><p><strong>3 –Fax</strong></p>                                                                                                                                                                                                                                                                                                                                                | 0..1                              |
| <p>@CountryAccessCode</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                           | Code assigned by telecommunications authorities for international country access identifier                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 0..1                              |
| <p>@AreaCityCode</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                 | Code assigned for telephones in a specific region, city, or area                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 0..1                              |
| <p>@FormattedInd</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                | <p>FormattedInd is MANDATORY. If the partner can use Country and Area codes then it should be set to NO.</p><p>If country code and area code are passed then they should not appear again in the PhoneNumber field.</p><p>If the partner cannot use country and area code then entire number is passed in the PhoneNumber field and FormattedIndit should be set to YES if the number needs to be parsed as there is a separation of the different parts or set to NO to indicate that the PhoneNumber field contains the entire phone number without a specific format.</p>  | 1                                 |
| <p>@ DefaultInd</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/ HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                         | DefaultInd is optional and would indicate whether the phone number is the primary phone number for the profile.                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 0..1                              |
| <p>Email</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                      | This element is used to pass the Company or Travel Agency’s email                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p>AddressInfo</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                 | Address of the guest                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 0..1                              |
| <p>AddressLine</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>Will contain 1 to 3 Address lines.</p><p>Will contain at least 1 line</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 1                                 |
| <p>CityName</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                | <p> </p><p> </p><p>City Name</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 0..1                              |
| <p>StateProv</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                       | <p> </p><p> </p><p>State Name</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p>@ StateCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo/StateProv</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                   | <p> </p><p> </p><p>State Code</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p>PostalCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p> </p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                      | <p> </p><p> </p><p>Postal Code</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                              |
| <p>CountryName</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                             | <p> </p><p>Country name</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 0..1                              |
| <p>@ Code </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo/CountryName</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                             | <p> </p><p> </p><p>ISO Country code</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                              |
| <p> ResGlobalInfo</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | ResGlobalInfo is a container for various information elements that affect the Reservation as a whole. These include global comments, counts, reservation IDs, loyalty programs, and payment methods.                                                                                                                                                                                                                                                                                                                                                                          | 1                                 |
| <p>HotelReservationIDs</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Contains reservation ID elements. For new reservations, this will only contain OTA confirmation number. For modifications and cancellations, original PMS confirmation numbers will be included.                                                                                                                                                                                                                                                                                                                                                                              | 1                                 |
| <p> HotelReservationID</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/HotelReservationIDs</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>The HotelReservationID element can be repeated multiple types to</p><p>transfer:</p><p>•       <strong>The MASTER reservation number in case of multi room bookings</strong></p><p>•       <strong>The OTA and PMSconfirmation numbers assigned to this booking</strong></p>                                                                                                                                                                                                                                                                                               | 2..3                              |
| <p>@ResID\_Type</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/HotelReservationIDs</strong></p><p><strong>/HotelReservationID</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>ResID\_Type is assigned values from the UIT code list.</p><p>16 – “Master” reservation number (when multiple (split) reservations need to be grouped together in case of multi room bookings)<br>14 – for CRS confirmation number<br>13 - for the IDS confirmation number<br><br>If the partner is working on split mode, Type=16 represents per leg of the Room reservation booked.</p>                                                                                                                                                                                   | 1                                 |
| <p>@ResID\_Value</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/HotelReservationIDs</strong></p><p><strong>/HotelReservationID</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                     | ResID\_Value would be the confirmation number of the reservation identified by the ResID\_Type.                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                 |
| <p>Guarantee</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>The guarantee information associated to the Room Stay.</p><p>If do not have any CC details, it may be optional or have blank CC details included.</p>                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                              |
| <p>@GuaranteeType</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>This is the attribute that indicates what guarantee is provided with the reservation.</p><p>The enumerated values can be:</p><p>•        <strong>“None"</strong></p><p>•        <strong>"CC / DC / Voucher"</strong></p>                                                                                                                                                                                                                                                                                                                                                   | 1                                 |
| <p>@GuaranteeCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>This is the guarantee code. Can be either of the options below:</p><p> CreditCard</p><p>NOT GUARANTEED</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                 |
| <p>GuaranteesAccepted</p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | A collection of guarantee elements                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                              |
| <p>GuaranteeAccepted</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                            | Guarantee detail                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 1                                 |
| <p>PaymentCard</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/GuaranteeAccepted/</strong></p><p><strong>PaymentCard</strong></p>                                                                                                                                                                                                                                                                                                                                                                                    | Identification about a specific credit card. Mandatory if @GuaranteeCode=CreditCard                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1                                 |
| <p>@CardType</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/GuaranteeAccepted/</strong></p><p><strong>PaymentCard</strong></p>                                                                                                                                                                                                                                                                                                                                                                                             | <p>This is the code of the card used as guarantee for the booking. CardTypeuses an OTAlist. The only item of the CDT list to be used is number 1 – Credit to indicate we are passing a credit card. Mandatory if @GuaranteeCode=CreditCard</p><p><strong>1=Credit Card</strong></p>                                                                                                                                                                                                                                                                                           | 1                                 |
| <p>@CardCode</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/GuaranteeAccepted/</strong></p><p><strong>PaymentCard</strong></p>                                                                                                                                                                                                                                                                                                                                                                                              | <p>The Card code is the 2 letter code indicative of the card (VI, MC, AX etc)</p><p>Mandatory if @GuaranteeCode=CreditCard</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                                 |
| <p>@CardNumber</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/GuaranteeAccepted/</strong></p><p><strong>PaymentCard</strong></p>                                                                                                                                                                                                                                                                                                                                                                                            | <p>Mandatory if credit card guarantee info is passed. This is actual number of the credit card used as guarantee.</p><p><br></p><p>Mandatory if @GuaranteeCode=CreditCard</p>                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                 |
| <p>@ExpireDate</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/GuaranteeAccepted/</strong></p><p><strong>PaymentCard</strong></p>                                                                                                                                                                                                                                                                                                                                                                                            | <p>Mandatory if credit card guarantee info is passed. This is expiry date of the credit card used as guarantee.</p><p>Format MMYY, e.g.</p><p>ExpireDate="1010"</p><p>Mandatory if @GuaranteeCode=CreditCard</p>                                                                                                                                                                                                                                                                                                                                                              | 1                                 |
| <p><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_AirBookModifyRQ.AirBookModifyRQ.Fulfillment.PaymentDetails.PaymentDetail.PaymentCard.SeriesCode.html">@</a><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_AirBookModifyRQ.AirBookModifyRQ.Fulfillment.PaymentDetails.PaymentDetail.PaymentCard.SeriesCode.html">SeriesCode</a></p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/GuaranteeAccepted/</strong></p><p><strong>PaymentCard</strong></p>        | Optional. This is the CVV (Card Verification Value) or CSN (Card Security No.) of the credit card used.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                              |
| <p>CardHolderName</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/GuaranteeAccepted/</strong></p><p><strong>PaymentCard</strong></p>                                                                                                                                                                                                                                                                                                                                                                                 | <p>Mandatory if @GuaranteeCode=CreditCard.</p><p>This is the name of the card holder. If the system transmitting the info does not hold the cc holder name, will be set by default to NOT AVAILABLE</p>                                                                                                                                                                                                                                                                                                                                                                       | 1                                 |
| <p>GuaranteeDescription</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Optional. This can be used to pass the details of the guarantee if the guarantee used is not cc or deposit.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 0..1                              |
| <p>@Name</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteeDescription</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Used in conjunction with Text element below. Name could be used to indicate Voucher and the Text could be used to indicate the voucher number for instance.                                                                                                                                                                                                                                                                                                                                                                                                                   | 0..1                              |
| <p>Text</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/Guarantee/</strong></p><p><strong>GuaranteeDescription</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                               | The text of the guarantee description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 0..1                              |
| <p> TimeSpan</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | The Time Span which covers the Room Stay. Used to specify a time window range by either specifying an earliest and latest date for the start date and end date or by giving a date with a time period that can be applied before and/or after the start date.                                                                                                                                                                                                                                                                                                                 | 1                                 |
| <p>@Start</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/TimeSpan</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p> </p><p>Check-in date for this room stay</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                 |
| <p>@End</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/ResGlobalInfo/TimeSpan</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p> </p><p>Check-out date for this room stay</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 1                                 |
| <p>Total</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | The total amount charged for the whole Stay                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 1                                 |
| <p>@CurrencyCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p> </p><p>Indicates the currency of the total</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                 |
| <p>@AmountBeforeTax</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Total amount excluding tax. Either AmountBeforeTax or AmountAfterTax must be present.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 0..1                              |
| <p>@AmountAfterTax</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/RoomStays/RoomStay/Total</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>Total amount including tax.</p><p> Either AmountBeforeTax or AmountAfterTax must be present</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                              |
| <p>Services</p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | A collection of Service objects. This is the collection of all services associated with any part of this reservation (the reservation in its entirety, one or more guests, or one or more room stays). Which services are attributable to which part is determined by each object's ServiceRPHs collection.                                                                                                                                                                                                                                                                   | 0..1                              |
| <p>Service</p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | A Service object represents a non-room product provided to guests. Service products may have associated inventory and charges.                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                                 |
| <p> <a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.Services.Service.ServiceRPH.html">@ServiceRPH</a></p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                              | This is a reference placeholder, used as an index for this service in this reservation. It is used by the RoomStay objects to indicate which services are associated with that room stay.                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                              |
| <p>@Inclusive</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>Whetherthepricefor thisservice is included in the room rate.</p><p>Values: False (or No), and True (or Yes).</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 0..1                              |
| <p><a href="http://adriatic.pilotfish-net.com/ota-modelviewer/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.Services.Service.Quantity.html">Quantity</a></p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                    | The number of tickets, rounds of golf, etc. Also serves as the number of persons when pricing class is per person or per person per night.                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                              |
| <p>@RatePlanCode</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | The representation of the rate plan under which this service was booked.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                              |
| <p>@ServiceInventoryCode</p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p> </p><p>The representation of the specific service being reserved.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                              |
| <p>@ServicePricingType</p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>An enumerated type that defines how a service is priced.</p><p>Values:</p><p><strong>Per stay</strong></p><p><strong>Per person</strong></p><p><strong>Per night</strong></p><p><strong>Per person per night</strong></p><p><strong>Per use</strong></p>                                                                                                                                                                                                                                                                                                                   | 0..1                              |
| <p>Price</p><p> </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p> </p><p> </p><p>The selling price of this service</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                              |
| <p>ServiceDetails</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Details on the Service including Guest Counts, Time Span of this Service, pointers to Res Guests.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                              |
| <p>GuestCounts</p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Guest type-wise count of guests for this service. Similar to GuestCounts under RoomStay. Please see above.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                              |
| <p> ResGuestRPHs</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | A collection of ResGuestRPH objects. A collection of unsigned integers serving as reference placeholders, and used as an index identifying which guests avail this service. Similar to ResGuestRPHs under RoomStay. Please see above.                                                                                                                                                                                                                                                                                                                                         | 0..1                              |
| <p>TimeSpan</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p> </p><p>Similar to TimeSpan under RoomStay. Please see above.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 0..1                              |
| <p>Total</p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong></p><p><strong>HotelReservation/Services/Service</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p> </p><p> </p><p>Similar to Total under RoomStay. Please see above.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                              |


# Sample Reservation Messages

**New reservation with Credit card (SINGLE room)**

```xml

<OTA_HotelResNotifRQ EchoToken="f7082733-75d9-4239-afc8-168351c95adc" TimeStamp="2014-
11-04T14:31:38.8328335+05:30" Target="Production" TargetName="Production" Version="1.003"  ResStatus="Cancel"  xmlns=
"

http://www.opentravel.org/OTA/2003/05
"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<POS>
<Source>
<RequestorID Type="13" ID="473"/>
<BookingChannel  Type="7"  Primary="true">
<CompanyName Code="BKNG"/>
</BookingChannel>
</Source>
</POS>
<HotelReservations>
<HotelReservation CreateDateTime="2015-02-04T00:00:00" CreatorID="RateGain"
ResStatus="Cancel">
<UniqueID Type="14" ID="657635191" />
<BasicPropertyInfo HotelCode="RGTestHotel" />
<RoomStays>
<RoomStay RoomStayStatus="Book">
<RatePlans>
<RatePlan RatePlanCode="954294" />
</RatePlans>
<RoomRates>
<RoomRate RoomTypeCode="DBL" NumberOfUnits="1" RatePlanCode="NFR"> <Rates>
<Rate EffectiveDate="2015-04-19" ExpireDate="2015-04-20"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2015-04-20" ExpireDate="2015-04-21"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2015-04-21" ExpireDate="2015-04-22"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2015-04-22" ExpireDate="2015-04-23"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
<TimeSpan Start="2015-04-19" Duration="P4D" End="2015-04-23" />
<Total AmountBeforeTax="272" CurrencyCode="EUR">
<Taxes />
</Total>
<ResGuestRPHs>1</ResGuestRPHs>
<Comments>
<Comment>
<Text>Request: We are two teachers coming from fhjg to visit your
primary school. If thre is a room with sea view available, we would enjoy that view...


Response: The accommodation has told us that it is possible to arrange this. However, 
test Hotel is unable to guarantee it, and would like to specify that the request is 
subject to availability at the time of check in.</Text>
</Comment>
</Comments>
<SpecialRequests>
<SpecialRequest RequestCode="NonSmoking"
CodeContext="http://cgbridge.rategain.com"/>
</SpecialRequests>
</RoomStay>
</RoomStays>
<Services>
<Service>
<ServiceDetails>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
<TimeSpan Start="2015-04-19" Duration="P4D" End="2015-04-23" />
<Total AmountBeforeTax="272" CurrencyCode="EUR" />
</ServiceDetails>
</Service>
</Services>
<ResGuests>
<ResGuest   ResGuestRPH="1"   PrimaryIndicator="true">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>
<GivenName>Guest 1</GivenName>
<Surname>Test</Surname>
</PersonName>
<Telephone PhoneTechType="1" PhoneNumber="+358407384776"
FormattedInd="false"  DefaultInd="true"  />
<Email  DefaultInd="true"  EmailType="1">Test.Guest1@
xyz.com
</Email> <Address>
<AddressLine>gdfh</AddressLine>
<CityName>hfdh</CityName>
<PostalCode>43100</PostalCode>
<CountryName Code="IN">India</CountryName>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest>
<Profiles>
<ProfileInfo>
<Profile  ProfileType="18">
<Customer>
<PersonName>
<GivenName>Guest 1</GivenName>
<Surname>Test</Surname>
</PersonName>
<Telephone PhoneTechType="1" PhoneNumber="+358407384776"
FormattedInd="false"  DefaultInd="true"  />
<Email  DefaultInd="true"  EmailType="1">Test.Guest1@
xyz.com
</Email> <Address>
<AddressLine>fdth</AddressLine>
<CityName>rfh</CityName>


<PostalCode>43100</PostalCode>


<CountryName Code="IN">India</CountryName>


</Address>


<EmployerInfo />


</Customer>


</Profile>


</ProfileInfo>


</Profiles>


</ResGuest>


</ResGuests>


<ResGlobalInfo>


<TimeSpan Start="2015-04-19" Duration="P4D" End="2015-04-23" />


<Guarantee GuaranteeCode="NOT GUARANTEED" GuaranteeType="None"/>


<Total AmountBeforeTax="272" CurrencyCode="EUR" />


<HotelReservationIDs>
<HotelReservationID ResID_Type="16" ResID_Value="657635191" />
<HotelReservationID ResID_Type="13" ResID_Value="657635191" />
<HotelReservationID  ResID_Type="14" ResID_Value="RES8514215R336"  />
</HotelReservationIDs>
</ResGlobalInfo>
</HotelReservation>
</HotelReservations>
</OTA_HotelResNotifRQ>
```

**Modify reservation with Credit card details (SINGLE room)**

```xml
<OTA_HotelResNotifRQ EchoToken="f7082733-75d9-4239-afc8-168351c95adc" TimeStamp="2014-
11-04T14:31:38.8328335+05:30" Target="Production" TargetName="Production" Version="1.003"  ResStatus="Modify"  xmlns=
"

http://www.opentravel.org/OTA/2003/05

"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<POS>
<Source>
<RequestorID Type="13" ID="473"/>
<BookingChannel  Type="7"  Primary="true">
<CompanyName Code="BKNG"/>
</BookingChannel>
</Source>
</POS>
<HotelReservations>
<HotelReservation CreateDateTime="2015-02-04T00:00:00" CreatorID="RateGain"
ResStatus="Modify">
<UniqueID Type="14" ID="657635191" />
<BasicPropertyInfo HotelCode="RGTestHotel" />
<RoomStays>
<RoomStay RoomStayStatus="Book">
<RatePlans>
<RatePlan RatePlanCode="954294" />
</RatePlans>
<RoomRates>
<RoomRate RoomTypeCode="DBL" NumberOfUnits="1" RatePlanCode="NFR">
<Rates>
<Rate EffectiveDate="2015-04-19" ExpireDate="2015-04-20"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2015-04-20" ExpireDate="2015-04-21"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2015-04-21" ExpireDate="2015-04-22"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2015-04-22" ExpireDate="2015-04-23"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
<TimeSpan Start="2015-04-19" Duration="P4D" End="2015-04-23" />
<Total AmountBeforeTax="272" CurrencyCode="EUR">
<Taxes />
</Total>
<ResGuestRPHs>1</ResGuestRPHs>
<Comments>
<Comment>
<Text>Request: We are two teachers coming from fhjg to visit your
primary school. If thre is a room with sea view available, we would enjoy that view...
:)
Response: The accommodation has told us that it is possible to arrange this. However, test Hotel is unable to guarantee it, and would like to specify that the request is subject to availability at the time of check in.</Text>
</Comment>
</Comments>
<SpecialRequests>
<SpecialRequest RequestCode="NonSmoking"
CodeContext=
"

http://cgbridge.rategain.com

"
  />
</SpecialRequests>
</RoomStay>
</RoomStays>
<Services>
<Service>
<ServiceDetails>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
<TimeSpan Start="2015-04-19" Duration="P4D" End="2015-04-23" />
<Total AmountBeforeTax="272" CurrencyCode="EUR" />
</ServiceDetails>
</Service>
</Services>
<ResGuests>
<ResGuest   ResGuestRPH="1"   PrimaryIndicator="true">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>
<GivenName>Guest 1</GivenName>
<Surname>Test</Surname>
</PersonName>
<Telephone PhoneTechType="1" PhoneNumber="+358407384776" FormattedInd="false"  DefaultInd="true"  />
<Email DefaultInd="true" EmailType="1">Test.Guest1@
xyz.com
</Email>
<Address>
<AddressLine>gdfh</AddressLine>
<CityName>hfdh</CityName>
<PostalCode>43100</PostalCode>
<CountryName Code="IN">India</CountryName>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest>
<Profiles>
<ProfileInfo>
<Profile  ProfileType="18">
<Customer>
<PersonName>
<GivenName>Guest 1</GivenName>
<Surname>Test</Surname>
</PersonName>
<Telephone PhoneTechType="1" PhoneNumber="+358407384776" FormattedInd="false"  DefaultInd="true"  />
<Email DefaultInd="true" EmailType="1">Test.Guest1@
xyz.com
</Email>
<Address>
<AddressLine>fdth</AddressLine>
<CityName>rfh</CityName>
<PostalCode>43100</PostalCode>
<CountryName Code="IN">India</CountryName>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<TimeSpan Start="2015-04-19" Duration="P4D" End="2015-04-23" />
<Guarantee  GuaranteeCode="CreditCard"  GuaranteeType="CC/DC/Voucher">
<GuaranteesAccepted>
<GuaranteeAccepted>
<PaymentCard CardType="1" CardCode="VI"
CardNumber="1111111111111111" ExpireDate="1120">
<CardHolderName>Test Test</CardHolderName>
</PaymentCard>
</GuaranteeAccepted>
</GuaranteesAccepted>
</Guarantee>
<Total AmountBeforeTax="272" CurrencyCode="EUR" />
<HotelReservationIDs>
<HotelReservationID ResID_Type="16" ResID_Value="657635191" />
<HotelReservationID ResID_Type="13" ResID_Value="657635191" />
<HotelReservationID ResID_Type="14" ResID_Value="RES8514215R336" />
</HotelReservationIDs>
</ResGlobalInfo>
</HotelReservation>
</HotelReservations>
</OTA_HotelResNotifRQ>
```

\
**Cancel Reservation (SINGLE room)**

```xml
<OTA_HotelResNotifRQ EchoToken="f7082733-75d9-4239-afc8-168351c95adc" TimeStamp="2014-
11-04T14:31:38.8328335+05:30" Target="Production" TargetName="Production" Version="1.003"  ResStatus="Cancel"  xmlns=
"http://www.opentravel.org/OTA/2003/05

"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<POS>
<Source>
<RequestorID Type="13" ID="473"/>
<BookingChannel  Type="7"  Primary="true">
<CompanyName Code="BKNG"/>
</BookingChannel>
</Source>
</POS>
<HotelReservations>
<HotelReservation CreateDateTime="2015-02-04T00:00:00" CreatorID="RateGain"
ResStatus="Cancel">
<UniqueID Type="14" ID="657635191" />
<BasicPropertyInfo HotelCode="RGTestHotel" />
<RoomStays>
<RoomStay RoomStayStatus="Book">
<RatePlans>
<RatePlan RatePlanCode="954294" />
</RatePlans>
<RoomRates>
<RoomRate RoomTypeCode="DBL" NumberOfUnits="1" RatePlanCode="NFR">
<Rates>
<Rate EffectiveDate="2015-04-19" ExpireDate="2015-04-20"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2015-04-20" ExpireDate="2015-04-21"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2015-04-21" ExpireDate="2015-04-22"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
<Rate EffectiveDate="2015-04-22" ExpireDate="2015-04-23"
RateTimeUnit="Day"  UnitMultiplier="1">
<Base AmountBeforeTax="68" CurrencyCode="EUR" />
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
<TimeSpan Start="2015-04-19" Duration="P4D" End="2015-04-23" />
<Total AmountBeforeTax="272" CurrencyCode="EUR">
<Taxes />
</Total>
<ResGuestRPHs>1</ResGuestRPHs>
<Comments>
<Comment>
<Text>Request: We are two teachers coming from fhjg to visit your
primary school. If thre is a room with sea view available, we would enjoy that view...
:)
Response: The accommodation has told us that it is possible to arrange this. However, test Hotel is unable to guarantee it, and would like to specify that the request is subject to availability at the time of check in.</Text>
</Comment>
</Comments>
<SpecialRequests>
<SpecialRequest RequestCode="NonSmoking"
CodeContext=
"

http://cgbridge.rategain.com

"
  />
</SpecialRequests>
</RoomStay>
</RoomStays>
<Services>
<Service>
<ServiceDetails>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
<TimeSpan Start="2015-04-19" Duration="P4D" End="2015-04-23" />
<Total AmountBeforeTax="272" CurrencyCode="EUR" />
</ServiceDetails>
</Service>
</Services>
<ResGuests>
<ResGuest   ResGuestRPH="1"   PrimaryIndicator="true">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>
<GivenName>Guest 1</GivenName>
<Surname>Test</Surname>
</PersonName>
<Telephone PhoneTechType="1" PhoneNumber="+358407384776" FormattedInd="false"  DefaultInd="true"  />
<Email DefaultInd="true" EmailType="1">Test.Guest1@
xyz.com
</Email>
<Address>
<AddressLine>gdfh</AddressLine>
<CityName>hfdh</CityName>
<PostalCode>43100</PostalCode>
<CountryName Code="IN">India</CountryName>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest>
<Profiles>
<ProfileInfo>
<Profile  ProfileType="18">
<Customer>
<PersonName>
<GivenName>Guest 1</GivenName>
<Surname>Test</Surname>
</PersonName>
<Telephone PhoneTechType="1" PhoneNumber="+358407384776" FormattedInd="false"  DefaultInd="true"  />
<Email DefaultInd="true" EmailType="1">Test.Guest1@
xyz.com
</Email>
<Address>
<AddressLine>fdth</AddressLine>
<CityName>rfh</CityName>
<PostalCode>43100</PostalCode>
<CountryName Code="IN">India</CountryName>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<TimeSpan Start="2015-04-19" Duration="P4D" End="2015-04-23" />
<Guarantee  GuaranteeCode="CreditCard"  GuaranteeType="CC/DC/Voucher">
<GuaranteesAccepted>
<GuaranteeAccepted>
<PaymentCard CardType="1" CardCode="VI"
CardNumber="1111111111111111" ExpireDate="1120">
<CardHolderName>Test Test</CardHolderName>
</PaymentCard>
</GuaranteeAccepted>
</GuaranteesAccepted>
</Guarantee>
<Total AmountBeforeTax="272" CurrencyCode="EUR" />
<HotelReservationIDs>
<HotelReservationID ResID_Type="16" ResID_Value="657635191" />
<HotelReservationID ResID_Type="13" ResID_Value="657635191" />
<HotelReservationID ResID_Type="14" ResID_Value="RES8514215R336" />
</HotelReservationIDs>
</ResGlobalInfo>
</HotelReservation>


</HotelReservations>


</OTA_HotelResNotifRQ>
```

<br>

**New reservation with Credit card (MULTIPLE rooms)**

<figure><img src="/files/ghm3XEGeu6Srt0Fkyg1c" alt=""><figcaption></figcaption></figure>

```xml
<RoomRate RoomTypeCode="DLX"
NumberOfUnits="1"  RatePlanCode="BAR">
<Rates>
<Rate EffectiveDate="2016-12- 12" ExpireDate="2016-12-13" RateTimeUnit="Day" UnitMultiplier="1">
<Base AmountBeforeTax="400" AmountAfterTax="500" CurrencyCode="THB" />
</Rate>
<Rate EffectiveDate="2016-12- 13" ExpireDate="2016-12-14" RateTimeUnit="Day" UnitMultiplier="1">
<Base AmountBeforeTax="400" AmountAfterTax="500" CurrencyCode="THB" />
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2"
/>
<GuestCount  AgeQualifyingCode="8"  Count="1"
/>
</GuestCounts>
<TimeSpan Start="2016-12-12" Duration="1"
End="2016-12-14" />
<Total AmountBeforeTax="800" AmountAfterTax="1000"
CurrencyCode="THB" />
<ResGuestRPHs />
<SpecialRequests>
<SpecialRequest RequestCode="text"
CodeContext=
"

http://cgbridge.rategain.com

"
 />
</SpecialRequests>
</RoomStay>

<RoomStay RoomStayStatus="new">
<RatePlans>
<RatePlan RatePlanCode="832927" />
</RatePlans>
<RoomRates>
<RoomRate RoomTypeCode="STD"
NumberOfUnits="1"  RatePlanCode="BAR">
<Rates>
<Rate EffectiveDate="2016-12- 12" ExpireDate="2016-12-13" RateTimeUnit="Day" UnitMultiplier="1">
<Base AmountBeforeTax="200" AmountAfterTax="300" CurrencyCode="THB" />
</Rate>
<Rate EffectiveDate="2016-12- 13" ExpireDate="2016-12-14" RateTimeUnit="Day" UnitMultiplier="1">
<Base AmountBeforeTax="200" AmountAfterTax="300" CurrencyCode="THB" />
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2"
/>
<GuestCount  AgeQualifyingCode="8"  Count="1"
/>
</GuestCounts>
<TimeSpan Start="2016-12-12" Duration="1"
End="2016-12-14" />
<Total AmountBeforeTax="400" AmountAfterTax="600"
CurrencyCode="THB" />
<ResGuestRPHs />

<SpecialRequests>
<SpecialRequest RequestCode="text"
CodeContext=
"

http://cgbridge.rategain.com

"
 />
</SpecialRequests>
</RoomStay>
</RoomStays>
<Services>
<Service>
<ServiceDetails>
<GuestCounts>
<GuestCount AgeQualifyingCode="10"
Count="4" />
<GuestCount AgeQualifyingCode="8"
Count="2" />
</GuestCounts>
<TimeSpan Start="2016-12-12" Duration="1"
End="2016-12-14" />
<Total AmountBeforeTax="1200"
AmountAfterTax="1600" CurrencyCode="THB" />
</ServiceDetails>
</Service>
</Services>
<ResGuests>
<ResGuest  PrimaryIndicator="true">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>
<GivenName>Hugh </GivenName>

<Surname>Jackman</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9871934281" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">Hugh.jackman@
rategain.com
</Email>
<Address>
<AddressLine>Sector 55 Supertech eco village 2 apartment Sydney</AddressLine> <CityName>Sydney</CityName>
<PostalCode>201305</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="Australia"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest   PrimaryIndicator="false">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>

<GivenName>Hugh
</GivenName>
<Surname>Jackman</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9871934281" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">Hugh.jackman@
rategain.com
</Email>
<Address>
<AddressLine>Sector 55 Supertech eco village 2 apartment Sydney</AddressLine> <CityName>Sydney</CityName>
<PostalCode>201305</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="Australia"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest   PrimaryIndicator="false">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">

<Customer>
<PersonName>
<GivenName>David
</GivenName>
<Surname>Guetta</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9876543212" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">david.guetta@
rategain.com
</Email>
<Address>
<AddressLine>
Sector 22 Panchsheel Greens apartment NewYork</AddressLine>
<CityName>NewYork</CityName>
<PostalCode>201309</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="United State"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest>
<Profiles>

<ProfileInfo>
<Profile  ProfileType="18">
<Customer>
<PersonName>
<GivenName>Booker1</GivenName>
<Surname>Booker2</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9871934281" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">Logan.wolverine@
rategain.com
</Email>
<Address>
<AddressLine>Flat
no- C4 606 Panchsheel Greens apartment Greater noida west booker</AddressLine>
<CityName>Noida</CityName>
<PostalCode>201308</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="India"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>

</ResGuests>


<ResGlobalInfo>


<TimeSpan Start="2016-12-12" Duration="1" End="2016-12-14"
/>

<CancelPenalties  />

<Total AmountBeforeTax="1200" AmountAfterTax="1600"
CurrencyCode="THB" />


<HotelReservationIDs>


<HotelReservationID  ResID_Type="16"
ResID_Value="Resv_201" />


<HotelReservationID  ResID_Type="13"
ResID_Value="Resv_201" />


</HotelReservationIDs>


</ResGlobalInfo>


</HotelReservation>


</HotelReservations>


</OTA_HotelResNotifRQ>
```

**Modify reservation with Credit card (MULTIPLE rooms)**

<figure><img src="/files/NyDkzH8q4he1rUBKlan0" alt=""><figcaption></figcaption></figure>

```xml
</Source>
</POS>
<HotelReservations>
<HotelReservation CreateDateTime="2016-10-24T09:18:39"
CreatorID="RateGain" ResStatus="Modify">
<UniqueID Type="14" ID="Resv_201" />
<BasicPropertyInfo HotelCode="RGBRTEST" />
<RoomStays>
<RoomStay   RoomStayStatus="modified">
<RatePlans>
<RatePlan RatePlanCode="832927" />
</RatePlans>
<RoomRates>
<RoomRate RoomTypeCode="DLX"
NumberOfUnits="1"  RatePlanCode="BAR">
<Rates>
<Rate EffectiveDate="2016-12- 12" ExpireDate="2016-12-13" RateTimeUnit="Day" UnitMultiplier="1">
<Base AmountBeforeTax="650" AmountAfterTax="750" CurrencyCode="THB" />
</Rate>
<Rate EffectiveDate="2016-12- 13" ExpireDate="2016-12-14" RateTimeUnit="Day" UnitMultiplier="1">
<Base AmountBeforeTax="650" AmountAfterTax="750" CurrencyCode="THB" />
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2"
/>

<GuestCount  AgeQualifyingCode="8"  Count="1"
/>
</GuestCounts>
<TimeSpan Start="2016-12-12" Duration="1"
End="2016-12-14" />
<Total AmountBeforeTax="1300" AmountAfterTax="1500"
CurrencyCode="THB" />
<ResGuestRPHs />
<Comments>
<Comment>
<Text>Cab for Airport/Metro Station
will be provided</Text>
</Comment>
</Comments>
<SpecialRequests>
<SpecialRequest>
<Text>Smoking Room , Extra
bedding</Text>
</SpecialRequest>
</SpecialRequests>
</RoomStay>
<RoomStay RoomStayStatus="new">
<RatePlans>
<RatePlan RatePlanCode="832927" />
</RatePlans>
<RoomRates>
<RoomRate RoomTypeCode="STD"
NumberOfUnits="1"  RatePlanCode="BAR">
<Rates>
<Rate EffectiveDate="2016-12-
12" ExpireDate="2016-12-13" RateTimeUnit="Day" UnitMultiplier="1">

<Base AmountBeforeTax="250" AmountAfterTax="350" CurrencyCode="THB" />
</Rate>
<Rate EffectiveDate="2016-12- 13" ExpireDate="2016-12-14" RateTimeUnit="Day" UnitMultiplier="1">
<Base AmountBeforeTax="250" AmountAfterTax="350" CurrencyCode="THB" />
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2"
/>
<GuestCount  AgeQualifyingCode="8"  Count="1"
/>
</GuestCounts>
<TimeSpan Start="2016-12-12" Duration="1"
End="2016-12-14" />
<Total AmountBeforeTax="500" AmountAfterTax="700"
CurrencyCode="THB" />
<ResGuestRPHs />
<Comments>
<Comment>
<Text>Cab for Airport/Metro Station
will be provided</Text>
</Comment>
</Comments>
<SpecialRequests>
<SpecialRequest>
<Text>Smoking Room , Extra
bedding</Text>

</SpecialRequest>
</SpecialRequests>
</RoomStay>
</RoomStays>
<Services>
<Service>
<ServiceDetails>
<GuestCounts>
<GuestCount AgeQualifyingCode="10"
Count="4" />
<GuestCount AgeQualifyingCode="8"
Count="2" />
</GuestCounts>
<TimeSpan Start="2016-12-12" Duration="1"
End="2016-12-14" />
<Total AmountBeforeTax="1800"
AmountAfterTax="2200" CurrencyCode="THB" />
</ServiceDetails>
</Service>
</Services>
<ResGuests>
<ResGuest  PrimaryIndicator="true">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>
<GivenName>Justine  </GivenName>
<Surname>Bieber</Surname>

</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9871934281" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">justine.bieber@
rategain.com
</Email>
<Address>
<AddressLine>Sector 55 ATS eco village 2 apartment Sydney</AddressLine>
<CityName>Tokyo</CityName>
<PostalCode>201305</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="Japan"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest   PrimaryIndicator="false">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>
<GivenName>Justine  </GivenName>

<Surname>Bieber</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9871934281" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">justine.bieber@
rategain.com
</Email>
<Address>
<AddressLine>Sector 55 ATS eco village 2 apartment Sydney</AddressLine>
<CityName>Tokyo</CityName>
<PostalCode>201305</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="Japan"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest   PrimaryIndicator="false">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>

<GivenName>Bruce
</GivenName>
<Surname>Wayne</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9876543212" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">Bruce.Wayne@
rategain.com
</Email>
<Address>
<AddressLine>
Sector 22 Panchsheel Greens apartment NewYork</AddressLine>
<CityName>NewYork</CityName>
<PostalCode>201309</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="United State"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest>
<Profiles>
<ProfileInfo>
<Profile  ProfileType="18">

<Customer>
<PersonName>
<GivenName>Booker1</GivenName>
<Surname>Booker2</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9871934281" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">Logan.wolverine@
rategain.com
</Email>
<Address>
<AddressLine>Flat
no- C4 606 Panchsheel Greens apartment Greater noida west booker</AddressLine>
<CityName>Noida</CityName>
<PostalCode>201308</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="India"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>

<TimeSpan Start="2016-12-12" Duration="1" End="2016-12-14"
/>
<CancelPenalties  />


<Total AmountBeforeTax="1800" AmountAfterTax="2200"
CurrencyCode="THB" />


<HotelReservationIDs>


<HotelReservationID  ResID_Type="16"
ResID_Value="Resv_201" />


<HotelReservationID  ResID_Type="13"
ResID_Value="Resv_201" />


<HotelReservationID  ResID_Type="14"
ResID_Value="123593"  />


</HotelReservationIDs>


</ResGlobalInfo>


</HotelReservation>


</HotelReservations>


</OTA_HotelResNotifRQ>
```

**Cancel reservation (MULTIPLE rooms)**

```xml

<OTA_HotelResNotifRQ  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance
"xmlns:xsd="http://www.w3.org/2001/XMLSchema"

 EchoToken="7bab16bf-9801-4975-95f8- ea22c7ef6257" TimeStamp="2016-10-25T07:55:43.9237857+05:30" Target="Production" TargetName="Production" Version="1.003" ResStatus="Cancel">
<POS>
<Source>


<RequestorID Type="13" ID="473" />


<BookingChannel  Type="7"  Primary="true">


<CompanyName Code="BKNG" />


</BookingChannel>


</Source>


</POS>


<HotelReservations>


<HotelReservation CreateDateTime="2016-10-24T09:18:39"
CreatorID="RateGain" ResStatus="Cancel">
<UniqueID Type="14" ID="Resv_201" />


<BasicPropertyInfo HotelCode="RGBRTEST" />


<RoomStays>


<RoomStay   RoomStayStatus="modified">


<RatePlans>


<RatePlan RatePlanCode="832927" />


</RatePlans>


<RoomRates>


<RoomRate RoomTypeCode="DLX"
NumberOfUnits="1"  RatePlanCode="BAR">


<Rates>


<Rate EffectiveDate="2016-12-
12" ExpireDate="2016-12-13" RateTimeUnit="Day" UnitMultiplier="1">

<Base AmountBeforeTax="650" AmountAfterTax="750" CurrencyCode="THB" />
</Rate>
<Rate EffectiveDate="2016-12- 13" ExpireDate="2016-12-14" RateTimeUnit="Day" UnitMultiplier="1">
<Base AmountBeforeTax="650" AmountAfterTax="750" CurrencyCode="THB" />
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2"
/>
<GuestCount  AgeQualifyingCode="8"  Count="1"
/>
</GuestCounts>
<TimeSpan Start="2016-12-12" Duration="1"
End="2016-12-14" />
<Total AmountBeforeTax="1300" AmountAfterTax="1500"
CurrencyCode="THB" />
<ResGuestRPHs />
<Comments>
<Comment>
<Text>Cab for Airport/Metro Station
will be provided</Text>
</Comment>
</Comments>
<SpecialRequests>
<SpecialRequest>
<Text>Smoking Room , Extra
bedding</Text>
```

<figure><img src="/files/lkT2354hB0L61Xop3SyY" alt=""><figcaption></figcaption></figure>

```xml
<Total AmountBeforeTax="500" AmountAfterTax="700"
CurrencyCode="THB" />
<ResGuestRPHs />
<Comments>
<Comment>
<Text>Cab for Airport/Metro Station
will be provided</Text>
</Comment>
</Comments>
<SpecialRequests>
<SpecialRequest>
<Text>Smoking Room , Extra
bedding</Text>
</SpecialRequest>
</SpecialRequests>
</RoomStay>
</RoomStays>
<Services>
<Service>
<ServiceDetails>
<GuestCounts>
<GuestCount AgeQualifyingCode="10"
Count="4" />
<GuestCount AgeQualifyingCode="8"
Count="2" />
</GuestCounts>
<TimeSpan Start="2016-12-12" Duration="1"
End="2016-12-14" />
<Total AmountBeforeTax="1800"
AmountAfterTax="2200" CurrencyCode="THB" />
</ServiceDetails>
</Service>

</Services>
<ResGuests>
<ResGuest  PrimaryIndicator="true">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>
<GivenName>Justine  </GivenName>
<Surname>Bieber</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9871934281" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">justine.bieber@
rategain.com
</Email>
<Address>
<AddressLine>Sector 55 ATS eco village 2 apartment Sydney</AddressLine>
<CityName>Tokyo</CityName>
<PostalCode>201305</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="Japan"/>
</Address>
<EmployerInfo />
</Customer>

</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest   PrimaryIndicator="false">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>
<GivenName>Justine  </GivenName>
<Surname>Bieber</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9871934281" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">justine.bieber@
rategain.com
</Email>
<Address>
<AddressLine>Sector 55 ATS eco village 2 apartment Sydney</AddressLine>
<CityName>Tokyo</CityName>
<PostalCode>201305</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="Japan"/>
</Address>

<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest   PrimaryIndicator="false">
<Profiles>
<ProfileInfo>
<Profile  ProfileType="1">
<Customer>
<PersonName>
<GivenName>Bruce
</GivenName>
<Surname>Wayne</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9876543212" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">Bruce.Wayne@
rategain.com
</Email>
<Address>
<AddressLine>
Sector 22 Panchsheel Greens apartment NewYork</AddressLine>
<CityName>NewYork</CityName>
<PostalCode>201309</PostalCode>
<StateProv
StateCode="Uttar Pradesh" />

<CountryName
Code="United State"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest>
<Profiles>
<ProfileInfo>
<Profile  ProfileType="18">
<Customer>
<PersonName>
<GivenName>Booker1</GivenName>
<Surname>Booker2</Surname>
</PersonName>
<Telephone
PhoneTechType="1" PhoneNumber="+91-9871934281" FormattedInd="false" DefaultInd="true"
/>
<Email DefaultInd="true"
EmailType="1">Logan.wolverine@
rategain.com
</Email>
<Address>
<AddressLine>Flat
no- C4 606 Panchsheel Greens apartment Greater noida west booker</AddressLine>
<CityName>Noida</CityName>
<PostalCode>201308</PostalCode>

<StateProv
StateCode="Uttar Pradesh" />
<CountryName
Code="India"/>
</Address>
<EmployerInfo />
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<TimeSpan Start="2016-12-12" Duration="1" End="2016-12-14"
/>
<CancelPenalties  />
<Total AmountBeforeTax="1800" AmountAfterTax="2200"
CurrencyCode="THB" />
<HotelReservationIDs>
<HotelReservationID  ResID_Type="16"
ResID_Value="Resv_201" />
<HotelReservationID  ResID_Type="13"
ResID_Value="Resv_201" />
<HotelReservationID  ResID_Type="14"
ResID_Value="123593"  />
</HotelReservationIDs>
</ResGlobalInfo>
</HotelReservation>
</HotelReservations>
</OTA_HotelResNotifRQ>
```


# OTA\_HotelResNotifRS

**PMS Response**:

* The PMS should respond to the `OTA_HotelResNotifRQ` message by returning an `OTA_HotelResNotifRS` message.
* **Exception**: If a REST level fault occurs while the PMS processes the request, a REST fault should be generated and returned. This indicates that the message does not meet the web service specifications. RG Bridge can receive and process REST faults.

**Validation**:

* If the PMS is not able to validate a message at the application level, it should still return an `OTA_HotelResNotifRS` message.

**Synchronous Communication**:

* Since synchronous communication mode is used, the PMS should be able to process the message and return either:
  * A confirmation number (success).
  * An error response (failure).

**Error Handling**:

* Response messages indicating failures should contain at least one error element.
* It is possible that more than one error element may be returned.

**Response indicating success**

```xml
<OTA_HotelResNotifRS  TimeStamp="2004-04-14T09:42:26"> 
 
<HotelReservations> 
 
<HotelReservation> 
 
<ResGlobalInfo> 
 
<HotelReservationIDs>  
<HotelReservationID ResID_Type="3" ResID_Value="123456789" /> 
 
<HotelReservationID ResID_Type="14" ResID_Value="chd23242342" 
/> 
 
</HotelReservationIDs> 
 
</ResGlobalInfo> 
 
</HotelReservation> 
 
</HotelReservations> 
 
<Success /> 
 
</OTA_HotelResNotifRS> 

```

**Response indicating failure**

```xml
<OTA_HotelResNotifRS EchoToken="RG1232" TimeStamp="2004-04-14T09:42:26"> 
 
<Errors> 
 
<Error Code="3001" Status="NotProcessed" 
 
ShortText="Invalid Rate" />  
</Errors> 
 
</OTA_HotelResNotifRS> 

```


# XML Usage specification

| <p> </p><p><strong>Element/@Attribute</strong></p>                                                                                                                                                                | <p><strong>Description</strong></p><p><strong>Parent XPath</strong></p>                                                                                                                                                                                  | **Occurrences** |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| <p>@TimeStamp</p><p> <strong>/OTA\_HotelResNotifRS</strong></p>                                                                                                                                                   | <p> </p><p>Response Time Stamp</p>                                                                                                                                                                                                                       | 1               |
| <p>@Version</p><p> <strong>/OTA\_HotelResNotifRS</strong></p>                                                                                                                                                     | <p> </p><p>Mandatory</p>                                                                                                                                                                                                                                 | 1               |
| <p>HotelReservations</p><p><strong>/OTA\_HotelResNotifRS</strong></p>                                                                                                                                             | Must be present in case of Success response                                                                                                                                                                                                              | 1               |
| <p>HotelReservation</p><p> <strong>/OTA\_HotelResNotifRS/ HotelReservations</strong></p>                                                                                                                          | One for each reservation notification received in the request                                                                                                                                                                                            | 1               |
| <p>ResGlobalInfo</p><p><strong>/OTA\_HotelResNotifRS/HotelReservations/HotelReservation</strong></p>                                                                                                              | <p> </p><p>A container for various information that affects the Reservation as a whole</p>                                                                                                                                                               | 1               |
| <p>HotelReservationIDs</p><p><strong>/OTA\_HotelResNotifRS/HotelReservations/HotelReservation/ResGlobalInfo</strong></p>                                                                                          | A Collection of HotelReservationID objects for a given reservation.                                                                                                                                                                                      | 1               |
| <p> </p><p>HotelReservationID</p><p><strong>/OTA\_HotelResNotifRS/HotelReservations/HotelReservation/ResGlobalInfo/</strong></p><p><strong>HotelReservationIDs</strong></p>                                       | The HotelReservationID object contains various unique(ReservationID)  and non-unique (ConfirmationID, CancellationID) identifiers that the trading partners associate with a given reservation. Both the PMS and RG Bridge Booking ID will be returned . | 2..3            |
| <p> @ResID\_Type</p><p> </p><p><strong>/OTA\_HotelResNotifRS/</strong></p><p><strong>HotelReservations/HotelReservation/ResGlobalInfo/</strong></p><p><strong>HotelReservationIDs/HotelReservationID</strong></p> | <p>Defines the type of Reservation ID(e.g. reservation number, cancellation number).</p><p>Refer to Open Travel Code List UniqueID</p><p>Type (UIT) 3 for PMS Confirm ID and 14 for RG BridgeID</p>                                                      | 1               |
| <p>@ResID\_Value</p><p> </p><p><strong>/OTA\_HotelResNotifRS/</strong></p><p><strong>HotelReservations/HotelReservation/ResGlobalInfo/</strong></p><p><strong>HotelReservationIDs/HotelReservationID</strong></p> | Actual value associated with ResID\_Type as generated by the system that is the source of the ResID\_Type                                                                                                                                                | 1               |
| <p>Errors</p><p> </p><p><strong>/OTA\_HotelResNotifRS</strong></p>                                                                                                                                                | Included in response only if there are errors in processing                                                                                                                                                                                              | 0..1            |
| <p>Error</p><p> <strong>/OTA\_HotelResNotifRS/Errors</strong></p>                                                                                                                                                 | Response will include as many errors as required. At least one Error element must be present if the response contains Errors.                                                                                                                            | 1               |
| <p>@Code</p><p> </p><p><strong>/OTA\_HotelResNotifRS/Errors/Error</strong></p>                                                                                                                                    | Error code should be one of the codes listed in Error Codes below.                                                                                                                                                                                       | 1               |
| <p>@ShortText</p><p> </p><p><strong>/OTA\_HotelResNotifRS/Errors/Error</strong></p>                                                                                                                               | <p> </p><p>Free Text</p>                                                                                                                                                                                                                                 | 1               |
| <p>@Status</p><p> </p><p><strong>/OTA\_HotelResNotifRS/Errors/Error</strong></p>                                                                                                                                  | <p> </p><p>Should be set to String “<em>NotProcessed</em>”</p>                                                                                                                                                                                           | 1               |
| <p>Success</p><p> </p><p><strong>/OTA\_HotelResNotifRS</strong></p>                                                                                                                                               | Presence of this element indicates a successful Response and in case of a success Response the Error element should not be present.                                                                                                                      | 0..1            |
| <p>Warnings</p><p> </p><p><strong>/OTA\_HotelResNotifRS</strong></p>                                                                                                                                              | Response may include warnings along with a Success response. Warnings are not allowed with a response that contains errors.                                                                                                                              | 0..1            |
| <p> Warning</p><p> </p><p><strong>/OTA\_HotelResNotifRS/Warnings</strong></p>                                                                                                                                     | Response may include as many warning as required. At least one Warning element must be present in a response that contains warnings.                                                                                                                     | 1               |
| <p>@Code</p><p> </p><p><strong>/OTA\_HotelResNotifRS/Warnings/Warning</strong></p>                                                                                                                                | All Warnings will have the code set as “3000”                                                                                                                                                                                                            | 1               |
| <p>@ShortText</p><p> </p><p><strong>/OTA\_HotelResNotifRS/Warnings/Warning</strong></p>                                                                                                                           | <p> </p><p>Free Text</p>                                                                                                                                                                                                                                 | 1               |
| <p>@Status</p><p> </p><p><strong>/OTA\_HotelResNotifRS/Warnings/Warning</strong></p>                                                                                                                              | <p> </p><p>Should be set to String <em>“Processed</em>”.</p>                                                                                                                                                                                             | 0..1            |


# Points to remember

#### Message Communication and Handling

**REST Connectivity**:

* **Authentication**: Authentication is passed using basic authorization in REST connectivity.
  * If the credentials are found invalid, an error response needs to be returned.

**POS Source Element**:

* The `POS` source element contains `<CompanyName Code="BKNG"/>`, referring to the OTA/Channel code mapped in RateGain's Channel Manager system.
* For a complete list of OTA/Channel codes supported, please contact the RateGain team.

**Comments Handling**:

* Comments can be added either per room or globally for a reservation.
  * **Global Comments**: If any comment applies to the whole booking, it should be included in `ResGlobalInfo`.
  * **Room-specific Comments**: If a comment is required for a specific room, add it to the `RoomStay` section.

**Reservations Without Credit Card Details**:

* For reservations booked without credit card details, the `<Guarantee>` element may or may not be present in `ResGlobalInfo`.
  * If present, it should specify `GuaranteeCode` and `GuaranteeType` as follows:

\<Guarantee GuaranteeType="None" GuaranteeCode="NOT GUARANTEED"/>


# Code Lists

### Error types

| **Error Type** | **Description**        |
| -------------- | ---------------------- |
| 1              | Unknown                |
| 2              | No implementation      |
| 3              | Biz rule               |
| 4              | Authentication         |
| 5              | Authentication timeout |
| 6              | Authorization          |
| 7              | Protocol violation     |
| 8              | Transaction model      |
| 9              | Authentication model   |

### Error Codes

| **Error Codes** | **Description**                         |
| --------------- | --------------------------------------- |
| 15              | Invalid Date                            |
| 135             | Invalid End Date                        |
| 136             | Invalid Start Date                      |
| 187             | System currently unavailable            |
| 249             | Invalid rate code                       |
| 320             | Invalid value                           |
| 321             | Required field missing                  |
| 356             | Invalid Action/Status code              |
| 361             | Invalid hotel                           |
| 400             | Invalid Hotel Code                      |
| 402             | Invalid room type code                  |
| 404             | Invalid start date-end date combination |
| 447             | Unable to update – simultaneous updates |
| 448             | System error                            |
| 450             | Unable to process                       |


# RG Bridge - Reservation Retrieval (Pull)

This document is a part of the RGBridge Integration Deck, which provides comprehensive information on integrating RG Bridge with CRS or PMS systems. Here's an overview:

**RGBridge Integration Deck**:

* **Purpose**: To facilitate the integration of RG Bridge with CRS or PMS systems.
* **Integration**: RGBridge is the integrated version of RateGain's channel-management solution, trusted by the world’s leading hotels.
* **Flagship Product**: RG Channel Manager is the flagship product of RateGain, bringing smart technology to the global hospitality industry.

**Technical Specifications**:

* **Web Service Clients**: This document provides technical specifications for developing web service clients to pull reservations from RGBridge.
* **Supplementary Document**: This document should be read in conjunction with the RGBridge Integration Specification document for a complete understanding.


# Technical overview

### Service

**Pull Model**:

* RGBridge provides a reservation service that PMS can utilize to build a pull model connection.
* **Function**: In the pull model, the system requiring the information periodically connects to the originator to access the information.
* **Advantage**: The PMS does not need to build or deploy a web service that must be available at all times to receive new reservations.

#### **Flow of reservations**

<figure><img src="/files/bkr5oXOVPbnllY9RnHVi" alt=""><figcaption></figcaption></figure>

#### Communication Protocols

**HTNG Web Services Framework 2.1**:

* This interface is developed according to the HTNG Web Services Framework 2.1 specification.
* It operates as a pull-model web service using synchronous workflow.
* **Supported SOAP Versions**: SOAP 1.1 over HTTP.

**Message Exchange**:

* Communication between the Channel Manager and PMS is facilitated through SOAP messages.
* Each message is contained within a SOAP envelope.
* **Headers**: All messages must contain an HTNG specified SOAP Header that complies with WS Security (authentication only) and WS-Addressing standards.

**Web Services Standards**:

* **WS-Addressing August 2004**
* **Web Services Security: SOAP Message Security 1.0 (WS-Security 2004)**
* **Web Services Security UsernameToken Profile 1.0**

#### General Design

**Reservation Delivery Service**:

* Provides two primary operations:
  1. **OTA\_ReadRQ**: PMS sends a message to query RGBridge for any undelivered reservations.
  2. **OTA\_ResRetrieveRS**: RGBridge returns a list of reservations.
* **Processing**: PMS processes the message and sends one or more OTA\_NotifReportRQ messages with reservation confirmation numbers or errors after processing.
* **Acknowledgment**: RGBridge responds with an OTA\_NotifReportRS to acknowledge receipt and mark the messages as delivered.

#### Authentication

**WS-Security**:

* All request messages exchanged between the PMS and RGBridge must be authenticated using the WS-Security mechanism of the SOAP standards.
* Conformance to HTNG Web Services Framework 2.1 specification is required.

#### SOAP Faults

**Error Handling**:

* SOAP Faults are used to handle error conditions.
* A SOAP fault is generated and returned if the message does not meet the web service specifications.
* It is possible to receive this response occasionally due to software malfunction.
* PMS should be able to receive and process SOAP faults.

#### Reliability Mechanisms and Constraints

**Volume of Messages**:

* Due to the high volume of messages exchanged between the Channel Manager and PMS, it is essential to implement the mechanisms and constraints described in Table B.

| **Type**                             | **Mechanism/Constraint**                                                                         | **Description**                                                                                                                                                                                                                                                                                                     |
| ------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Retry                                | Retry strategy for communication failure and in case of specific errors returned in XML response | The Systems and PMS will have a retry mechanism in place for communication errors and business error.                                                                                                                                                                                                               |
| Concurrency                          | Simultaneous connections per property <= 1                                                       | PMS – RGBridge Interface will establish a single connection per Property at any given time for retrieving reservations.                                                                                                                                                                                             |
| Timeout                              | Time out after 60,000 milliseconds (1 minute)                                                    | Idle connections (no packets sent by either side) for more than 1 minute are closed. These should be considered as incomplete and implement a retry strategy to re-send data.                                                                                                                                       |
| Character Set                        | Support for UTF-8                                                                                | All messages exchanged must have UTF-8 encoding                                                                                                                                                                                                                                                                     |
| <p>Reservation</p><p>Information</p> | Support reservations with minimum information                                                    | There is great variation in the structure and amount of information available in reservations retrieved from OTAs. The PMS should be able to process reservations with the minimum amount of information.                                                                                                           |
| <p>Reservation</p><p>Information</p> | <p>Support reservations delivered to</p><p>DEFAULTROOM and DEFAULTRATE</p>                       | <p>Occasionally, reservations would be retrieved from OTAs which cannot be mapped to any existing room/rate types on RGBridge. RGBridge will deliver these reservations with Room type code set to</p><p>“DEFAULTROOM” and Rate Type code set to “DEFAULTRATE”. PMS should be able to accept such reservations.</p> |
| <p>Payment</p><p>Information</p>     | Support one-time delivery of credit card information                                             | To comply with PCI standards, many OTAs and consequently RGBridge, deliver credit card information only once. PMS should be able to accept modifications and cancellations of reservations without credit card information.                                                                                         |

### <br>

<br>


# Operations


# Reservation Retrieval

**Web Service Operation**:

* This operation allows the PMS to download reservations from RG Bridge.

**Messages Involved**:

1. **OTA\_ReadRQ**:
   * Sent by the PMS to the RGBridge Service to request new reservations.
2. **OTA\_ResRetrieveRS**:
   * Sent by RGBridge in response to the PMS request, providing the list of new reservations.
   * **Exception**: If a SOAP level error occurs, a SOAP-fault message will be sent instead.


# OTA\_ReadRQ

PMS will send request for reservations using this message. RGBridge will process the message synchronously and respond with a list of reservations.

**Reservation request; Sample XML**

```xml
<OTA_ReadRQ xmlns="http://www.opentravel.org/OTA/2003/05"  
            EchoToken="354"  
            TimeStamp="2011-01-26T10:22:00-05:00"  
            Target="Production"  
            Version="3.500" > 
  <POS> 
    <Source> 
      <RequestorID Type="22" ID="473"/> 
      <BookingChannel Type="4" Primary="true">         <CompanyName>NewAge PMS</CompanyName> 
      </BookingChannel> 
    </Source> 
  </POS> 
  <ReadRequests>  
    <HotelReadRequest HotelCode="123">  
      <SelectionCriteria SelectionType="Undelivered" />  
    </HotelReadRequest>  
  </ReadRequests>  
</OTA_ReadRQ> 

```

<br>


# XML Usage specification

| <p><strong>Element/@Attribute</strong></p><p><strong>Parent XPath</strong></p>                            | **Description**                                                              |
| --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| <p>@TimeStamp</p><p><strong>/OTA\_ReadRQ</strong></p>                                                     | Time of the transaction in xml schema date-time format                       |
| @Version **/OTA\_ReadRQ**                                                                                 | The OTA schema version. Mandatory. Use “3.500”.                              |
| @Target **/OTA\_ReadRQ**                                                                                  | Set to “Production”.                                                         |
| <p>POS</p><p><strong>/OTA\_ReadRQ</strong></p><p><strong>/OTA\_ReadRQ /POS</strong></p>                   | Element for indicating the source system.                                    |
| <p>RequestorID</p><p><strong>/OTA\_ReadRQ /POS/Source</strong></p>                                        | <p><br></p>                                                                  |
| <p>@Type</p><p><strong>/OTA\_ReadRQ /POS/Source/RequestorID</strong></p>                                  | Type of the ID. Set to “22”. ERSP (Electronic reservation service provider). |
| <p>@ID</p><p><strong>/OTA\_ReadRQ /POS/Source/RequestorID</strong></p>                                    | The id for the PMS.                                                          |
| <p>BookingChannel</p><p><strong>/OTA\_ReadRQ /POS/Source</strong></p>                                     | Requestor Name information                                                   |
| <p>@Type</p><p><strong>/OTA\_ReadRQ /POS/Source/BookingChannel</strong></p>                               | The type of the requestor system. “4” for PMS, “5” for CRS.                  |
| <p>@Primary</p><p><strong>/OTA\_ReadRQ /POS/Source/BookingChannel</strong></p>                            | Set to “true”.                                                               |
| <p>CompanyName</p><p><strong>/OTA\_ReadRQ /POS/Source/BookingChannel</strong></p>                         | Name of the requestor System.                                                |
| <p>@Code</p><p><strong>/OTA\_ReadRQ /POS/Source/BookingChannel</strong></p>                               | The code of the PMS, assigned by RateGain.                                   |
| <p>ReadRequests</p><p><strong>/OTA\_ReadRQ</strong> </p>                                                  | Container for the read request                                               |
| <p>HotelReadRequest</p><p><strong>/OTA\_ReadRQ/ReadRequests</strong></p>                                  | The read request                                                             |
| <p>@HotelCode</p><p><strong>/OTA\_ReadRQ/ReadRequests/HotelReadRequest</strong></p>                       | The hotel code of the hotel for which the reservation is to be downloaded.   |
| <p>SelectionCriteria</p><p><strong>/OTA\_ReadRQ/ReadRequests/ HotelReadRequest</strong></p>               | Contains the selection criteria to filter reservations to be retrieved.      |
| <p>@SelectionType</p><p><strong>/OTA\_ReadRQ/ReadRequests/HotelReadRequest/SelectionCriteria</strong></p> | Set to “Undelivered” to request all previously undelivered reservations.     |


# OTA\_ResRetrieveRS

**Reservation Retrieval:**

* **OTA\_ReadRQ**: PMS sends this message to request new reservations.
* **OTA\_ResRetrieveRS**: RGBridge responds with this message, providing the list of new reservations.
  * **SOAP Fault**: If a SOAP level fault occurs, a SOAP fault message will be sent instead.

**Response Messages**:

* If there are no new reservations, the `OTA_ResRetrieveRS` message will be returned without a `ReservationsList` node.
* If there are reservations waiting to be delivered, the `OTA_ResRetrieveRS` message will include a `ReservationsList` node containing one or more reservation messages.
  * **Configuration Setting**: The maximum number of reservations per message is limited by a configuration setting.
  * **@MoreIndicator Attribute**: If more reservations are waiting, this attribute will be set to true.

**PMS Processing**:

* The PMS should process the reservations downloaded and send an `OTA_NotifReportRQ` message indicating the processing results.
  * Typically, PMS confirmation numbers are returned for each reservation downloaded.
* PMS should process the reservations and send `OTA_NotifReportRQ` messages as required before sending further `OTA_ReadRQ` messages to avoid duplicate retrieval.

**ReservationsList Node**:

* Contains a list of `HotelReservation` nodes.
* The schema of the `HotelReservation` node is the same as described in the push model specification and is not detailed here.
* **Reference**: Please refer to the RGBridge Integration Specification document for additional details.

**Reservation retrieval response; Sample XML**

```xml
<OTA_ResRetrieveRs xmlns="http://www.opentravel.org/OTA/2003/05"  
            EchoToken="354"  
            TimeStamp="2011-01-26T10:22:00-05:00"  
            Target="Production"  
            Version="6.002" 
            MoreIndicator="true" > 
  <Success /> 
  <ReservationsList> 
    <HotelReservation> 
      <!-- details omitted --> 
    </HotelReservation> 
  </ReservationsList> 
</OTA_ReadRQ> 
```


# XML Usage specification

| <p><strong>Element/@Attribute</strong></p><p><strong>Parent XPath</strong></p>      | **Description**                                                                                                                                                                |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <p>@TimeStamp</p><p><strong>/OTA\_ResRetrieveRS</strong></p>                        | Time of the transaction in xml schema date-time format                                                                                                                         |
| <p>@Version</p><p><strong>/OTA\_ResRetrieveRS</strong></p>                          | The OTA schema version. Mandatory. Use “6.002”.                                                                                                                                |
| <p>@Target</p><p><strong>/OTA\_ResRetrieveRS</strong></p>                           | Set to “Production”.                                                                                                                                                           |
| <p>@MoreIndicator</p><p><br></p><p><strong>/OTA\_ResRetrieveRS</strong></p>         | Set to true if there are more reservations to be downloaded. This happens when the number of reservations in a message is limited by configuration setting.                    |
| <p>Errors</p><p><strong>/OTA\_ResRetrieveRS</strong></p>                            | Included in response only if there are errors in processing                                                                                                                    |
| <p>Error</p><p><strong>/OTA\_ResRetrieveRS/Errors</strong></p>                      | <p>Response will include as many Errors as required. At least one Error element must be present if the response contains</p><p>Errors.</p>                                     |
| <p>@Type</p><p><strong>/OTA\_ResRetrieveRS/Errors/Error</strong></p>                | Error type. Should be one of the codes listed in Error Types below.                                                                                                            |
| <p>@Code</p><p><strong>/OTA\_ResRetrieveRS/Errors/Error</strong></p>                | Error code. Should be one of the codes listed in Error Codes below.                                                                                                            |
| <p>@ShortText</p><p><strong>/OTA\_ResRetrieveRS/Errors/Error</strong></p>           | Free Text                                                                                                                                                                      |
| <p>@Status</p><p><strong>/OTA\_ResRetrieveRS/Errors/Error</strong></p>              | Should be set to String “*NotProcessed*”                                                                                                                                       |
| <p>Success</p><p><strong>/OTA\_ResRetrieveRS</strong></p>                           | Presence of this element indicates a successful Response and in case of a Success response the Errors element should not be present.                                           |
| <p>Warnings</p><p><strong>/OTA\_ResRetrieveRS</strong></p>                          | Response may include warnings along with a Success response. Warnings are not allowed with a response that contains Errors.                                                    |
| <p>Warning</p><p><strong>/OTA\_ResRetrieveRS/Warnings</strong></p>                  | Response may include as many warning as required. At least one Warning element must be present in a response that contains Warnings.                                           |
| <p>@Code</p><p><strong>/OTA\_ResRetrieveRS/Warnings/Warning</strong></p>            | The error code.                                                                                                                                                                |
| <p>@ShortText</p><p><strong>/OTA\_ResRetrieveRS/Warnings/Warning</strong></p>       | Free Text                                                                                                                                                                      |
| <p>ReservationsList</p><p><strong>/OTA\_ResRetrieveRS</strong></p>                  | Container for reservations. Not present if the response contains Errors. Also not present if there are no reservations to be delivered.                                        |
| <p>HotelReservation</p><p><strong>/OTA\_ResRetrieveRS/ReservationsList</strong></p> | Reservation record. Please refer to RGBridge Integration specification document for details. The @ResStatus attribute of this node will contain the status of the reservation. |


# Reservation Confirmation

**Web Service Operation**:

* This operation allows the PMS to update RG Bridge with confirmation of reservations retrieved.

**Messages Involved**:

1. **OTA\_NotifReportRQ**:
   * Sent by PMS to the RGBridge service to notify it of reservation confirmation information.
2. **OTA\_NotifReportRS**:
   * Sent by RGBridge in response to confirm receipt of the notification.
   * **Exception**: If a SOAP level error occurs, a SOAP fault message should be sent instead.


# OTA\_NotifReportRQ

PMS will send notification of reservations processing report using this message. RGBridge will process the message synchronously and respond with an OTA\_NotifReportRS message.

**Reservation confirmation request; Sample XML**

```xml
<OTA_NotifReportRQ xmlns="http://www.opentravel.org/OTA/2003/05"  
            EchoToken="354"  
            TimeStamp="2011-01-26T10:22:00-05:00"  
            Target="Production"  
            Version="3.000" > 
  <Success /> 
  <NotifDetails> 
    <HotelNotifReport> 
      <HotelReservations> 
        <HotelReservation> 
          <POS> 
           <Source> 
            <BookingChannel> 
               <CompanyName Code=”LTA1”> Famous OTA</CompanyName> 
            </BookingChannel> 
           </Source> 
          </POS> 
          <ResGlobalInfo> 
            <HotelReservationIDs> 
              <HotelReservationID ResID_Type="3" ResID_Value="123456789" /> 
              <HotelReservationID ResID_Type="14" ResID_Value="chd22342" /> 
            </HotelReservationIDs> 
          </ResGlobalInfo> 
        </HotelReservation> 
      </HotelReservations> 
    </HotelNotifReport> 
  </NotifDetails> 
</OTA_NotifReportRQ> 

```


# XML Usage specification

**Reservation confirmation request; XML Usage**

| <p><strong>Element/@Attribute</strong></p><p><strong>Parent XPath</strong></p>                                                                                                                                                        | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>@TimeStamp</p><p><strong>/OTA\_NotifReportRQ</strong></p>                                                                                                                                                                          | Time of the transaction in xml schema date-time format.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p>@Version</p><p><strong>/OTA\_NotifReportRQ</strong></p>                                                                                                                                                                            | The OTA schema version. Mandatory. Use “3.000”.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p>@Target</p><p><strong>/OTA\_NotifReportRQ</strong></p>                                                                                                                                                                             | Set to “Production”.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p>NotifDetails</p><p><strong>/OTA\_NotifReportRQ</strong></p>                                                                                                                                                                        | Details of the notification.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p>HotelNotifReport</p><p><strong>/OTA\_NotifReportRQ/NotifDetails</strong></p>                                                                                                                                                       | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>HotelReservations</p><p><strong>/OTA\_NotifReportRQ/NotifDetails/HotelNotifReport</strong></p>                                                                                                                                     | Contains the reservations.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p>HotelReservation</p><p><strong>/OTA\_NotifReportRQ/NotifDetails/HotelNotifReport /HotelReservations</strong></p>                                                                                                                   | One for each reservation retrieved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p>POS</p><p> </p><p><strong>/OTA\_NotifReportRQ/NotifDetails/HotelNotifReport</strong></p><p><strong>/HotelReservations/HotelReservation</strong></p>                                                                                | <p>Element for including the channel from which booking had been received. This information was provided in /OTA\_HotelResNotifRQ/POS</p><p><strong>A simple source record would look like this:</strong></p><p>\<POS></p><p>  \<Source></p><p>    \<BookingChannel></p><p>      \<CompanyName Code=”LTA1”> Famous OTA</p><p>      \</CompanyName></p><p>    \</BookingChannel></p><p>\</Source></p><p><br></p><p>This indicates that the reservation was retrieved from the OTA “Famous OTA” whose CG Bridge code is LTA1.</p> |
| <p>ResGlobalInfo</p><p><strong>/OTA\_NotifReportRQ/NotifDetails/HotelNotifReport</strong></p><p><strong>/HotelReservations/HotelReservation</strong></p>                                                                              | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>HotelReservationIDs</p><p><br></p><p><strong>/OTA\_NotifReportRQ/NotifDetails/HotelNotifReport /HotelReservations/HotelReservation/ResGlobalInfo</strong></p>                                                                      | Reservations IDs. Both the PMS and RGBridge Booking IDs should be included.                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>HotelReservationID</p><p><strong>/OTA\_NotifReportRQ/NotifDetails/HotelNotifReport</strong></p><p><strong>/HotelReservations/HotelReservation/ResGlobalInfo/ HotelReservationIDs</strong></p>                                      | Reservations ID element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p>@ResID\_Type</p><p><strong>/OTA\_NotifReportRQ/NotifDetails/HotelNotifReport</strong></p><p><strong>/HotelReservations/HotelReservation/ResGlobalInfo/</strong></p><p><strong>HotelReservationIDs/HotelReservationID</strong></p>  | 3 for PMS Confirm ID and 14 for RGBridge ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>@ResID\_Value</p><p><strong>/OTA\_NotifReportRQ/NotifDetails/HotelNotifReport</strong></p><p><strong>/HotelReservations/HotelReservation/ResGlobalInfo/</strong></p><p><strong>HotelReservationIDs/HotelReservationID</strong></p> | Reservation ID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p>Errors</p><p><strong>/OTA\_NotifReportRQ</strong></p>                                                                                                                                                                              | Included in response only if there are errors in processing. If there are errors in the processing of reservations, it is suggested that an OTA\_NotifReportRQ message is sent for each reservation that could not be processed. The RGBridge reservation ID must also be set in the HotelReservationIDs node under NotifDetails.                                                                                                                                                                                               |
| <p>Error</p><p><strong>/OTA\_NotifReportRQ/Errors</strong></p>                                                                                                                                                                        | Response will include as many Errors as required. At least one Error element must be present if the response contains Errors                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p>@Type</p><p><strong>/OTA\_NotifReportRQ/Errors/Error</strong></p>                                                                                                                                                                  | Error Type. Should be one of the codes listed in Error Types below.                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p>@Code</p><p><strong>/OTA\_NotifReportRQ/Errors/Error</strong></p>                                                                                                                                                                  | Error code. Should be one of the codes listed in Error Codes below.                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p>@ShortText</p><p><strong>/OTA\_NotifReportRQ/Errors/Error</strong></p>                                                                                                                                                             | Free Text                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p>@Status</p><p><strong>/OTA\_NotifReportRQ/Errors/Error</strong></p>                                                                                                                                                                | Should be set to String “*NotProcessed*”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p>Success</p><p><strong>/OTA\_NotifReportRQ</strong></p>                                                                                                                                                                             | Presence of this element indicates a successful Response and in case of a Success Response the Error element should not be present.                                                                                                                                                                                                                                                                                                                                                                                             |
| <p>Warnings</p><p><strong>/OTA\_NotifReportRQ</strong></p>                                                                                                                                                                            | Response may include warnings along with a Success response. Warnings are not allowed with a response that contains Errors.                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p>Warning</p><p><strong>/OTA\_NotifReportRQ/Warnings</strong></p>                                                                                                                                                                    | Response may include as many Warning as required. At least one Warning element must be present in a response that contains Warnings.                                                                                                                                                                                                                                                                                                                                                                                            |
| <p>@Code</p><p><strong>/OTA\_NotifReportRQ/Warnings/Warning</strong></p>                                                                                                                                                              | All Warnings will have the code set as “3000”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p>@ShortText</p><p><strong>/OTA\_NotifReportRQ/Warnings/Warning</strong></p>                                                                                                                                                         | Free Text                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p>@Status</p><p><strong>/OTA\_NotifReportRQ/Warnings/Warning</strong></p>                                                                                                                                                            | Should be set to *“Processed*”.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |


# OTA\_NotifReportRS

#### Reservation Confirmation Acknowledgment

**OTA\_NotifReportRS**:

* This message is used to acknowledge the `OTA_NotifReportRQ` message.
* **Exception**: When a SOAP level fault occurs while RG Bridge processes the request, a SOAP fault message will be returned.

**Processing and Delivery**:

* RG Bridge will mark the reservations included in the `OTA_NotifReportRQ` message as delivered, and they will not be included in future reservation retrievals.
* **Importance**: It is crucial to process all the reservations retrieved earlier and send `OTA_NotifReportRQ` messages for all of them before sending additional `OTA_ReadRQ` messages to retrieve more reservations.

**Reservation confirmation response; Sample XML**

```xml
<OTA_NotifReportRS xmlns="http://www.opentravel.org/OTA/2003/05"  
            EchoToken="354"  
            TimeStamp="2011-01-26T10:22:00-05:00"  
            Target="Production"  
            Version="2.000" > 
  <Success /> 
</OTA_NotifReportRS> 

```


# XML Usage specification

**Reservation confirmation response; XML usage**

| <p><strong>Element/@Attribute</strong></p><p><strong>Parent XPath</strong></p> | **Description**                                                                                                                     |
| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| <p>@TimeStamp</p><p><strong>/OTA\_NotifReportRS</strong></p>                   | Time of the transaction in xml schema date-time format.                                                                             |
| <p>@Version</p><p><strong>/OTA\_NotifReportRS</strong></p>                     | The OTA schema version. Mandatory. Use “2.000”.                                                                                     |
| <p>@Target</p><p><strong>/OTA\_NotifReportRS</strong></p>                      | Set to “Production”.                                                                                                                |
| <p>Success</p><p><strong>/OTA\_NotifReportRS</strong></p>                      | Presence of this element indicates a successful Response and in case of a Success Response the Error element should not be present. |


# Code Lists

### Error types

#### **Supported Error types**

| **Error Type** | **Description**        |
| -------------- | ---------------------- |
| 1              | Unknown                |
| 2              | No implementation      |
| 3              | Biz rule               |
| 4              | Authentication         |
| 5              | Authentication timeout |
| 6              | Authorization          |
| 7              | Protocol violation     |
| 8              | Transaction model      |
| 9              | Authentication model   |

### Error Codes

**Supported Error codes**

| **Error Codes** | **Description**                         |
| --------------- | --------------------------------------- |
| 15              | Invalid Date                            |
| 135             | Invalid End Date                        |
| 136             | Invalid Start Date                      |
| 187             | System currently unavailable            |
| 249             | Invalid rate code                       |
| 320             | Invalid value                           |
| 321             | Required field missing                  |
| 356             | Invalid Action/Status code              |
| 361             | Invalid hotel                           |
| 400             | Invalid Hotel Code                      |
| 402             | Invalid room type code                  |
| 404             | Invalid start date-end date combination |
| 447             | Unable to update – simultaneous updates |
| 448             | System error                            |
| 450             | Unable to process                       |


# Direct Connect - Demand (Push)

RateGain's Channel Manager, a premier channel-management solution used by the world’s leading hotels, is the flagship product of RateGain. This document is divided into three sections:

**Section 1: Overview**

* Provides an overview of how online travel agents (OTA) would integrate with RG Channel Manager using DirectConnect specifications.

**Section 2: Technical Specifications for ARI Exchange**

* Offers technical specifications for developing web services that enable the exchange of Availability, Rates, and Inventory (ARI) information between the Channel Manager and OTA.

**Section 3: Technical Specifications for Reservation Service**

* Provides technical specifications of the reservation service that OTA would use to push reservations to the Channel Manager.


# Introduction

**Purpose and Integration Mechanism**

**RateGain's Channel Manager**:

* A premier channel management system for distributing Availability, Rates, and Inventory (ARI) to Online Distribution Systems (OTAs), and for collecting reservations from them.
* Used by thousands of the world’s most renowned hotels and chains.

**Purpose of this Document**:

* **DirectConnect**: A set of services for integrating OTA systems with RateGain's Channel Manager.
* **Updates and Notifications**:
  * **Hotel Updates**: As availability and rates change, the hotel sends updates using Channel Manager, which processes these messages and sends updates to the subscribed OTAs.
  * **Booking Notifications**: As bookings/reservations are made by consumers, the OTA sends booking notifications to Channel Manager.

**Sections Overview**:

1. **Section 2**: Specifies the interface that OTA needs to develop so that RG Channel Manager can push ARI update messages.
2. **Section 3**: Specifies the interface that RG Channel Manager makes available to OTAs to push reservations.

**Integration Mechanism**:

* **PUSH Mechanism**:
  * **ARI**: RG Channel Manager will push ARI (Availability, Rates, and Inventory) updates to OTA.
  * **Reservations**: OTA will push the reservation information to RG Channel Manager.


# Interface Specifications – ARI Service


# Technical Overview

### Service

The ARI Update Service provides four primary operations:

1. **List of Properties**:
   * **Request**: `HotelPropertyListGetRQ`
   * **Response**: `HotelPropertyListGetRS`
2. **List of Products**:
   * **Request**: `HotelProductListGetRQ`
   * **Response**: `HotelProductListGetRS`
3. **Fetch ARI Information**:
   * **Request**: `HotelARIGetRQ`
   * **Response**: `HotelARIGetRS`
4. **Update ARI Information**:
   * **Request**: `HotelARIUpdateRQ`
   * **Response**: `HotelARIUpdateRS`

#### Communication Protocols

* **Method**: HTTP POST is used for the requested operations.
* **Request and Response Format**: Each operation involves posting the appropriate request XML data, and the OTA returns the desired response XML data.
* **HTTP Content Type**: `text/xml`
  * Example HTTP header:

Content-Type: text/xml; charset=utf-8&#x20;

#### Authentication

* **Implementation**: Authentication and authorization are both implemented using common credentials. See Hotel Authorization below for details.

#### Reliability Mechanisms and Constraints

* **Property List Message**: Only one hotel can be specified in a request or response message, except for the Property List message.
* **Volume of Messages**: Due to the high volume of messages exchanged between DirectConnect and the OTA, the mechanisms and constraints described in Table B must be implemented.

| **Type**                   | **Mechanism/Constraint**                                                                         | **Description**                                                                                                                                 |
| -------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Retry                      | Retry strategy for communication failure and in case of specific errors returned in XML response | The DirectConnect and OTA will have a retry mechanism in place for communication errors and business error.                                     |
| Concurrency                | Simultaneous connections per property Can be multithread                                         | DirectConnect interface will establish multiple connections per Property for different room type at any given time for updating the ARI events. |
| Timeout                    | Time out after 60,000 milliseconds (1 minute)                                                    | Idle connections (no packets sent by either side) for more than 1 minute should be closed.                                                      |
| Character Set              | Support for UTF-8                                                                                | All messages exchanged must have UTF-8 encoding                                                                                                 |
| Date Range                 | 366 days                                                                                         | Maximum number of days that a single request message could update must not exceed 366 days.                                                     |
| <p>Message</p><p>Size </p> | 2 MB                                                                                             | Maximum size for a single message must not exceed 2 MB.                                                                                         |

### Supported Restrictions and Occupancies

| **Channel Manager Attribute** | **Attribute Type**                             | **Data Type** | <p><strong>XML</strong> </p><p><strong>Attribute</strong> </p> | **Description**                                                                               |
| ----------------------------- | ---------------------------------------------- | ------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Allocation                    | Settings                                       | Integer       | TransientAllotment                                             | Number of rooms available to sellable                                                         |
| Available                     | Settings                                       | Boolean       | Master                                                         | Also known as Stopsell, ClosedOut or Availability.  Denotes if Room is open or closed to sell |
| CTA                           | Restrictions                                   | Boolean       | Arrival                                                        | Closed to arrival. Room cannot booked if CTA is ON  for a checking date                       |
| CTD                           | Restrictions                                   | Boolean       | Departure                                                      | Closed to departure. Room cannot booked if CTD is ON for a checkout date                      |
| FreeSale                      | Settings                                       | Boolean       | FreeSale                                                       | Unlimited number of rooms. No restrictions for restrictive units                              |
| MinLOS                        | Restrictions                                   | Integer       | MinLoSOnArrival                                                | Minimum number of nights required to book a room w\.r.t. check-in date                        |
| MinLOSThrough                 | Restrictions                                   | Integer       | MinLoSThrough                                                  | Minimum number of nights required to book a room w\.r.t. complete stay dates                  |
| MaxLOS                        | Restrictions                                   | Integer       | MaxLoSOnArrival                                                | Maximum number of nights required to book a room w\.r.t. check-in date                        |
| MaxLOSThrough                 | Restrictions                                   | Integer       | MaxLoSThrough                                                  | Maximum number of nights required to book a room w\.r.t. complete stay dates                  |
| MinAdvancePurchase            | Restrictions                                   | Integer       | MinAdvancedBookingOffset                                       | Minimum no. of days in advance a room  can be  booked                                         |
| MaxAdvancePurchase            | Restrictions                                   | Integer       | MaxAdvancedBookingOffset                                       | Maximum no. of days in advance a room can be booked.                                          |
| 1Adult                        | <p>Occupancy based Pricing  </p><p>(OPB)  </p> | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A1"  </p>                | Nightly rates of pax=\[1Adult] for given room-rate  combination                               |
| 2Adult                        | <p>Occupancy based Pricing  </p><p>(OPB)  </p> | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A2"  </p>                | Nightly rates of pax=\[2Adult] for given room-rate  combination                               |
| 3Adult                        | <p>Occupancy based Pricing  </p><p>(OPB)  </p> | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A3"  </p>                | Nightly rates of pax=\[3Adult] for given room-rate  combination                               |
| 4Adult                        | <p>Occupancy based Pricing  </p><p>(OPB)  </p> | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A4"  </p>                | Nightly rates of pax=\[4Adult] for given room-rate  combination                               |
| 5Adult                        | <p>Occupancy based Pricing</p><p>(OPB)  </p>   | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A5"  </p>                | Nightly rates of pax=\[5Adult] for given room-rate                                            |
| 6Adult                        | <p>Occupancy based Pricing </p><p>(OPB)  </p>  | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A6"  </p>                | Nightly rates of pax=\[6Adult] for given room-rate  combination                               |
| 7Adult                        | <p>Occupancy based Pricing </p><p>(OPB)  </p>  | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A7"  </p>                | Nightly rates of pax=\[7Adult] for given room-rate  combination                               |
| 8Adult                        | <p>Occupancy based Pricing </p><p>(OPB)  </p>  | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A8"  </p>                | Nightly rates of pax=\[8Adult] for given room-rate  combination                               |
| 9Adult                        | <p>Occupancy based Pricing </p><p>(OPB)  </p>  | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A9"  </p>                | Nightly rates of pax=\[9Adult] for given room-rate  combination                               |
| 10Adult                       | <p>Occupancy based Pricing </p><p>(OPB)  </p>  | Decimal       | <p>Base Amount  </p><p>OccupancyCode="A10"  </p>               | Nightly rates of pax=\[10Adult] for given room-rate  combination                              |
| 1Child                        | <p>Occupancy based Pricing </p><p>(OPB)  </p>  | Decimal       | <p>Base Amount  </p><p>OccupancyCode="C1"  </p>                | Nightly rates of pax=\[1Child] for given room-rate  combination                               |
| 2Child                        | <p>Occupancy based Pricing </p><p>(OPB)  </p>  | Decimal       | <p>Base Amount  </p><p>OccupancyCode="C2"  </p>                | Nightly rates of pax=\[2Child] for given room-rate  combination                               |
| 3Child                        | Occupancy based Pricing  (OPB)                 | Decimal       | <p>Base Amount  </p><p>OccupancyCode="C3"  </p>                | Nightly rates of pax=\[3Child] for given  room-rate  combination                              |
| 4Child                        | <p>Occupancy based Pricing  </p><p>(OPB)  </p> | Decimal       | <p>Base Amount  </p><p>OccupancyCode="C4"  </p>                | Nightly rates of pax=\[4Child] for given room-rate  combination                               |
| 5Child                        | <p>Occupancy based Pricing  </p><p>(OPB)  </p> | Decimal       | <p>Base Amount  </p><p>OccupancyCode="C5"  </p>                | Nightly rates of pax=\[5Child] for given  room-rate  combination                              |
| AdditionalAdult / ExtraAdult  | <p>Occupancy based Pricing  </p><p>(OPB)  </p> | Decimal       | <p>Base Amount  </p><p>OccupancyCode="AA"  </p>                | Nightly rates of pax=\[AdditionalAdult] for given room-rate combination                       |
| AdditionaChild / ExtraChild   | <p>Occupancy based Pricing  </p><p>(OPB)  </p> | Decimal       | <p>Base Amount  </p><p>OccupancyCode="AC"  </p>                | Nightly rates of pax=\[AdditionalAdult] for given room-rate combination                       |
| RoomPrice                     | <p>Occupancy based Pricing  </p><p>(OPB)  </p> | Decimal       | <p>Base Amount  </p><p>OccupancyCode="SR"  </p>                | Nightly rates of complete room  for  given room-rate combination                              |


# Operation: Property List

**Operation Overview**:

* This operation allows DirectConnect to request the OTA to return a list of hotels available on the OTA systems for a given chain account or log-in.

**Customary Setup**:

* OTAs typically set up multiple properties of a hotel chain for a given login. In such cases, the OTA returns a list of all hotels set up for that login.
* If the OTA allows only one hotel per login, that hotel’s details are returned.

**Messages Involved**:

1. **HotelPropertyListGetRQ**:
   * Sent by DirectConnect to the OTA service to request a list of properties.
2. **HotelPropertyListGetRS**:
   * Sent by the OTA service in response, providing the requested list of properties.


# HotelPropertyListGetRQ

**HotelPropertyListGetRQ**:

* DirectConnect sends this message to request a list of properties.
* **Chain Code**: Used to identify the hotel chain in the case of a multi-property account.

**OTA Response**:

* If the OTA does not utilize chain accounts, it can disregard the chain code element and instead return the information based on the details in the Authentication element.

| <p><strong>Element/@Attribute</strong> </p><p><strong>Parent Xpath</strong>  </p>          | <p>  </p><p><strong>Description</strong> </p>                                                                                                                                                                                              | **Mandatory**                                           |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- |
| <p>@TimeStamp </p><p>  <strong>/HotelPropertyListGetRQ</strong>  </p>                      | Time of the transaction in xml schema datetime format.                                                                                                                                                                                     | Y                                                       |
| <p>@Target </p><p>  <strong>/HotelPropertyListGetRQ</strong>  </p>                         | The environment to target this message to. For this version of the specification always set to “Production”.                                                                                                                               | <p>            Y </p><p><br></p><p>  </p>               |
| <p>@Version </p><p><strong>/HotelPropertyListGetRQ</strong>  </p>                          | The version of the message. For this version of the specification set to“1.0”.                                                                                                                                                             | <p>             Y </p><p><br></p>                       |
| <p>Authentication </p><p><strong>/HotelPropertyListGetRQ</strong>  </p>                    | <p>  </p><p>All DirectConnect ARI request messages would include an Authentication element. </p>                                                                                                                                           | Y                                                       |
| <p> @UserName </p><p> <strong>/HotelPropertyListGetRQ/Authentication</strong>  </p>        | <p>The UserName part of the credentials. </p><p>UserName and Password combination (credentials) required to authorize the request sent in these attributes. This is assigned by the OTA. Credentials should be common for all Hotels. </p> | <p>             Y </p><p><br></p><p><br></p><p><br></p> |
| <p>@Password </p><p><strong>/HotelPropertyListGetRQ/Authentication</strong></p>            | The Password part of the credential. Credentials should be common for all hotels.                                                                                                                                                          | Y                                                       |
| <p>HotelPropertyListRequest </p><p><strong>/HotelPropertyListGetRQ</strong>  </p>          | Contains the request element. Only one request element will be sent in one message.                                                                                                                                                        | Y                                                       |
| <p>@ChainCode </p><p><strong>/HotelPropertyListGetRQ/HotelPropertyListRequest</strong></p> | The code for the chain of hotels. Chain code is optional, But if a channel opts for chain code, it will be mandatory for all hotels.                                                                                                       | <p>             N </p><p><br></p>                       |


# HotelPropertyListGetRS

* **HotelPropertyListGetRS**:
  * OTA should respond to the `HotelPropertyListGetRQ` request by returning a `HotelPropertyListGetRS` message.

**Validation and Errors**:

* If the OTA is not able to validate a message at the application level, it should still return a `HotelPropertyListGetRS` message.
* **Failure Response**: Response messages indicating failures must contain at least one error element. More than one error element can be returned if necessary.

**Successful Response**:

* After validating the chain code or login credentials, the OTA should:
  * Return a `HotelPropertyListGetRS` message with a single Success element.
  * Include the list of properties in the Hotels element.
* **Single Property Account**:
  * If the OTA does not use multi-property accounts, it should return information regarding the one hotel identified by the request.

| <p><strong>Element/@Attribute</strong></p><p><strong>Parent Xpath</strong>  </p> | <p>  </p><p><strong>Description</strong> </p>                                                                                                                                                                                                                               | **Mandatory**                                |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| <p>@TimeStamp </p><p> <strong>/HotelPropertyListGetRS</strong>  </p>             | Time of the transaction in XML schema date-time format.                                                                                                                                                                                                                     | Y                                            |
| <p>@Target </p><p> <strong>/HotelPropertyListGetRS</strong>  </p>                | <p>  </p><p>The environment to target this message to. For this version of the specification always set to “Production”. </p>                                                                                                                                               | <p>          Y </p><p><br></p>               |
| <p>@Version </p><p><strong>/HotelPropertyListGetRS</strong>  </p>                | The version of the message. For this version of the specification set to “1.0”.                                                                                                                                                                                             | <p>           Y </p><p><br></p>              |
| <p>Success </p><p><strong>/HotelPropertyListGetRS</strong></p>                   | <p>If included, this element will indicate that the request message was successfully processed. </p><p>If this element is returned, a hotel element must also be returned. Either a Success element or an Errors element is required in every response. </p>                | <p><br></p><p>            Y? </p>            |
| <p>Errors </p><p> <strong>/HotelPropertyListGetRS</strong> </p>                  | <p>If included, this element will indicate that the request message could not be processed. </p><p>Either a Success element or an Errors element is required in every response.</p>                                                                                         | <p>             Y? </p><p><br></p>           |
| <p>Error </p><p><strong>/HotelPropertyListGetRS/Errors</strong> </p>             | <p>Description of cause for a fatal problem during request message processing. </p><p>\*If an Errors element is included, at least one Error element is required. </p>                                                                                                      | <p><br></p><p>             Y </p><p><br></p> |
| <p>@Type </p><p><strong>/HotelPropertyListGetRS/Errors/Error</strong></p>        | <p>  </p><p>This is an enumeration of error types. See Code Lists below for supported values. Code list Error Types. </p>                                                                                                                                                   | Y                                            |
| <p>@Code</p><p><strong>/HotelPropertyListGetRS/Errors/Error</strong></p>         | This is an enumeration of error codes. See Code Lists below for supported values. Code list Error Codes.                                                                                                                                                                    | <p>             Y </p><p><br></p>            |
| <p>Hotels </p><p><strong>/HotelPropertyListGetRS</strong>  </p>                  | This element contains a list of hotels. This element is used to return the list of all hotels that belong to the chain that can be updated using these login credentials.                                                                                                   | Y?                                           |
| <p>@ChainCode </p><p><strong>/HotelPropertyListGetRS/Hotels</strong>  </p>       | <p>The code identifies the hotel chain. All the hotels returned belong to this chain of hotels. This code is assigned by the  OTA. </p><p>If you don’t support this Code then a blank value will be passed in this attribute of the request. </p>                           | N                                            |
| <p>Hotel </p><p><strong>/HotelPropertyListGetRS/Hotels</strong>  </p>            | <p>  </p><p>This element contains information about one hotel. </p>                                                                                                                                                                                                         | Y                                            |
| <p>@HotelCode </p><p><strong>/HotelPropertyListGetRS/Hotels/Hotel</strong></p>   | <p>This element identifies the hotel. The OTA must assign a code that identifies the hotel across all chains of hotels. The chain code is not passed in other transactions. Therefore the code must uniquely identify the hotel independent of the chain code. </p><p> </p> | Y                                            |
| <p>@Name </p><p><strong>/HotelPropertyListGetRS/Hotels/Hotel</strong></p>        | <p>The name of the hotel. </p><p> </p>                                                                                                                                                                                                                                      | Y                                            |


# Test Use Cases

Get the sample XML according to the following test cases:

| **TestCases** | **Title**          | **Description**                                                       |
| ------------- | ------------------ | --------------------------------------------------------------------- |
| TC1           | Invalid Credential | Return error response with the message "Invalid Username or Password" |
| TC2           | Valid Credential   | Return a successful response with a valid list of Hotels              |


# FAQ

**Invalid Username/Password**:

* In case of an invalid Username/Password in `HotelPropertyListGetRQ`:
  * The partner should always return an error response with `ShortText="Invalid Username or Password"`.

**XML Attributes**:

* **Request and Response XML**:
  * Will always contain an attribute `xmlns="http://cgbridge.rategain.com/OTA/2012/05"` at the root element.
* **HotelPropertyListGetRQ**:
  * Will always contain the attribute `ChainCode` with some value (if OTA supports ChainCode) or a blank value (if not supported by OTA).


# Operation: Product List

**Operation Overview**:

* This operation allows DirectConnect to request the OTA to return a list of products available on the OTA system for a given hotel code.

**Messages Involved**:

1. **HotelProductListGetRQ**:
   * Sent by DirectConnect to the OTA service to request a list of products.
2. **HotelProductListGetRS**:
   * Sent by the OTA service in response, providing the requested list of products.


# HotelProductListGetRQ

DirectConnect shall send the property list request using the message.&#x20;

| <p><strong>Element/@Attribute</strong> </p><p><strong>Parent Xpath</strong>  </p>         | <p>  </p><p><strong>Description</strong> </p>                                                                                                                                                       | **Mandatory**        |
| ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
| <p>@TimeStamp  </p><p><strong>/HotelProductListGetRQ</strong>  </p>                       | Time of the transaction in xml schema date time format.                                                                                                                                             | Y                    |
| <p>@Version  </p><p><strong>/HotelProductListGetRQ</strong>  </p>                         | The version of the message. For this version of the specification set to “1.0”.                                                                                                                     | <p>Y </p><p><br></p> |
| <p>Authentication </p><p><strong>/HotelPropertyListGetRQ</strong>  </p>                   | All DirectConnect request messages would include an Authentication element.                                                                                                                         | <p>Y </p><p><br></p> |
| <p>@UserName  </p><p><strong>/HotelPropertyListGetRQ/Authentication</strong>  </p>        | <p>  </p><p>The UserName part of the credentials. UserName and Password combination (credentials) required to authorize the request are sent in these attributes. This is assigned by the OTA. </p> | Y                    |
| <p>@Password  </p><p><strong>/HotelPropertyListGetRQ/Authentication</strong>  </p>        | <p>  </p><p>The Password part of the credential. </p>                                                                                                                                               | Y                    |
| <p>HotelProductListRequest </p><p><strong>/HotelProductListGetRQ</strong>  </p>           | Contains the request element. Only one request element will be sent in one message.                                                                                                                 | Y                    |
| <p>@HotelCode  </p><p><strong>/HotelProductListGetRQ/HotelProductListRequest</strong></p> | <p>  </p><p>The code assigned by OTA for the hotel. </p>                                                                                                                                            | Y                    |


# HotelProductListGetRS

**OTA Response to Product List Request**

**Response Message**:

* **HotelProductListGetRS**:
  * OTA should respond to the `HotelProductListGetRQ` request by returning a `HotelProductListGetRS` message.

**Validation and Errors**:

* If the OTA is not able to validate a message at the application level, it should still return a `HotelProductListGetRS` message.
* **Failure Response**: Response messages indicating failures must contain at least one error element. More than one error element can be returned if necessary.

**Successful Response**:

* After validating the hotel code, the OTA should:
  * Return a `HotelProductListGetRS` message with a single Success element.
  * Include the list of products for the hotel in the `Products` element.
* **Product Identification**:
  * DirectConnect identifies a product by room type and rate type.

| <p><strong>Element/@Attribute</strong> </p><p><strong>Parent XPath</strong>  </p> | <p>  </p><p><strong>Description</strong> </p>                                                                                                                                                                                                                         | **Mandatory**          |
| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| <p>@TimeStamp  </p><p><strong>/HotelProductListGetRS</strong>  </p>               | <p>  </p><p>Time of the transaction in XML schema date-time format. </p>                                                                                                                                                                                              | Y                      |
| <p>@Version </p><p><strong>/HotelProductListGetRQ</strong>  </p>                  | The version of the message. For this version of the specification set to “1.0”.                                                                                                                                                                                       | Y                      |
| <p>Success </p><p><strong>/HotelProductListGetRS</strong>  </p>                   | <p>If included, this element will indicate that the request message was successfully processed. </p><p>If this element is returned, a Product element must also be returned. </p><p>Either a Success element or an Errors element is required in every response. </p> | <p>Y? </p><p><br></p>  |
| <p>Errors </p><p><strong>/HotelProductListGetRS</strong></p>                      | <p>If included, this element will indicate that the request message could not be processed. </p><p>Either a Success element or an Errors element is required in every response.</p>                                                                                   | <p> Y? </p><p><br></p> |

<br>

| <p>Error </p><p><strong>/HotelProductListGetRS/Errors</strong>  </p>                                               | <p>Description of cause for a fatal problem during request message processing. </p><p>\*If an Errors element is included, at least one Error element is required. </p><p><br></p>                                                                                                                     | <p><br></p><p>Y </p>        |
| ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| <p>@Type </p><p><strong>/HotelProductListGetRS/Errors/Error</strong></p>                                           | <p>  </p><p>This is an enumeration of error types. </p><p>See the Code Lists below for supported values. Code list Error Types. </p>                                                                                                                                                                  | Y                           |
| <p>@Code</p><p><strong>/HotelProductListGetRS/Errors/Error</strong></p>                                            | <p>  </p><p>This is an enumeration of error codes. </p><p>See Code Lists below for supported values. Codelist Error Codes. </p>                                                                                                                                                                       | Y                           |
| <p>HotelProducts </p><p><strong>/HotelProductListGetRS</strong> </p>                                               | <p>This element is used to return a list of products of this hotel that are set up for sale on the OTA. RezGain identifies a product as a room type in combination with a rate type. </p><p>For each product listed, OTA should ensure that the ARI information can be updated on a daily basis. </p> | <p>Y </p><p><br></p>        |
| <p>HotelProduct</p><p><strong>/HotelProductListGetRS/HotelProduc ts</strong>  </p>                                 | <p>  The element contains information about one hotel product. The product must be unique in the list. </p><p> </p>                                                                                                                                                                                   | Y                           |
| <p>ProductReference </p><p><strong>/HotelProductListGetRS/HotelProduc ts/HotelProduct</strong>  </p>               | <p>  This element contains the part of the hotel product that is used across requests and uniquely identifies a product. </p><p> </p>                                                                                                                                                                 | Y                           |
| <p>@InvTypeCode </p><p><strong>/HotelProductListGetRS/HotelProducts/HotelProduct/ProductReference</strong>  </p>   | <p>  The room type code. This is assigned by the OTA. </p><p> </p>                                                                                                                                                                                                                                    | Y                           |
| <p>@RatePlanCode </p><p><strong>/HotelProductListGetRS/HotelProduc ts/HotelProduct/ProductReference</strong>  </p> | <p>  </p><p>The rate type code. This is assigned by the OTA. </p><p> </p>                                                                                                                                                                                                                             | Y                           |
| <p>RoomTypeName</p><p><strong>/HotelProductListGetRS/HotelProducts/HotelProduct</strong>  </p>                     | <p>  </p><p>The name of the room type. This is assigned by the OTA. </p><p> </p>                                                                                                                                                                                                                      | <p>  </p><p>  </p><p>Y </p> |


# Test Use Cases

Sample Xml contains the following test cases.&#x20;

| **Test Cases** | **Title**          | **Description**                                                    |
| -------------- | ------------------ | ------------------------------------------------------------------ |
| TC1            | Invalid Credential | Return error response with message "Invalid Username or Password". |
| TC2            | Invalid HotelCode  | Return error response with message "Invalid HotelCode".            |
| TC3            | Valid Request      | Return success response with valid list of Products.               |


# FAQ

**Error Handling and XML Attributes**

**Invalid Username/Password**:

* In case of an invalid Username/Password in `HotelProductListGetRQ`, the partner should always return an error response with `ShortText="Invalid Username or Password"`.

**Invalid HotelCode**:

* In case of an invalid HotelCode in `HotelProductListGetRQ`, the partner should always return an error response with `ShortText="Invalid HotelCode"`.

**XML Attributes**:

* **Request and Response XML**:
  * Will always contain an attribute `xmlns="http://cgbridge.rategain.com/OTA/2012/05"` at the root element.


# Operation: ARI Get

**Operation Overview**:

* This operation allows DirectConnect to query the OTA system for the existing Availability, Rates, and Inventory (ARI) information for a set of products within a specified date range.

**Functionality**:

* RezGain provides users the ability to retrieve and display the currently loaded ARI information on OTAs for their hotel.
* This operation supports that functionality, enabling users to have up-to-date information on ARI details.


# HotelARIGetRQ

DirectConnect would request the currently loaded ARI information from the OTA using this message. The OTA must send this information at the product level.&#x20;

| <p><strong>Element/@Attribute</strong> </p><p><strong>Parent XPath</strong>  </p>                                                  | <p>  </p><p><strong>Description</strong> </p>                                                                                                                          | **Mandatory**                   |
| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| <p>@TimeStamp </p><p><strong>/HotelARIGetRQ</strong>  </p>                                                                         | Time of the transaction in xml schema date- time format                                                                                                                | Y                               |
| <p>@Version                        </p><p><strong>/HotelARIGetRQ</strong>  </p>                                                    | <p>  </p><p>The version of the message schema. For this version of the specification, set to “1.0”</p>                                                                 | <p>Y </p><p><br></p><p><br></p> |
| <p>Authentication   </p><p><strong>/HotelARIGetRQ</strong>  </p>                                                                   | <p>   </p><p>All DirectConnect request messages would include an Authentication element. </p>                                                                          | Y                               |
| <p>@UserName </p><p> <strong>/HotelARIGetRQ/Authentication</strong>  </p>                                                          | <p>  </p><p>The UserName part of the credentials. UserName and Password combination (credentials) required to authorize the request are sent in these attributes. </p> | Y                               |
| <p>@Password </p><p> <strong>/HotelARIGetRQ/Authentication</strong>  </p>                                                          | <p>  </p><p>The Password part of the credential. </p>                                                                                                                  | Y                               |
| <p> HotelARIGetRequests </p><p>  <strong>/HotelARIGetRQ</strong>  </p>                                                             | <p>Container element for fetch requests for a given hotel. </p><p>For this version of the specification, only one HotelARIGetRequest would be sent. </p>               | <p>Y </p><p><br></p>            |
| <p>@HotelCode </p><p> <strong>/HotelARIGetRQ/HotelARIGetRequests</strong>  </p>                                                    | <p>  </p><p>Hotel code of the property whose ARI information is being requested. </p>                                                                                  | <p>Y </p><p><br></p>            |
| <p>HotelARIGetRequest </p><p><strong>/HotelARIGetRQ/HotelARIGetRequests</strong>  </p>                                             | <p>Contains a fetch request for a given hotel. </p><p>For this version of the specification, only one HotelARIGetRequest would be sent. </p>                           | <p>Y </p><p>  </p>              |
| <p>ProductReference </p><p><strong>/HotelARIGetRQ/HotelARIGetRequests/HotelARIGetRequest</strong></p>                              | <p>  </p><p>The product for which the ARI information is being requested. </p><p><br></p>                                                                              | <p>Y </p><p><br></p>            |
| <p>@InvTypeCode </p><p> <strong>/HotelARIGetRQ/HotelARIGetRequests/HotelARIGetRequest/ ProductReference</strong>  </p>             | <p>  </p><p>Identifies the room type for which the ARI information is being requested. </p><p> </p>                                                                    | Y                               |
| <p>@RatePlanCode </p><p> <strong>/HotelARIGetRQ/HotelARIGetRequests/HotelARIGetRequest/ ProductReference</strong>  </p>            | <p>  </p><p>Identifies the rate type for which the ARI information is being requested. </p><p> </p>                                                                    | Y                               |
| <p>ApplicationControl </p><p><strong>/HotelARIGetRQ/HotelARIGetRequests/HotelARIGetRequest</strong></p>                            | <p>  </p><p>The date range for which the ARI information is being requested. </p><p><br></p>                                                                           | <p>Y </p><p><br></p>            |
| <p>@Start </p><p><strong>/HotelARIGetRQ/HotelARIGetRequests/HotelARIGetRequest</strong> <strong>/ApplicationControl</strong>  </p> | <p>  </p><p>The start date of the date span for which the ARI information is being requested. </p><p><br></p><p>Date format : YYYY-MM-DD </p>                          | <p>Y </p><p><br></p>            |
| <p>@End </p><p><strong>/HotelARIGetRQ/HotelARIGetRequests/HotelARIGetRequest</strong> <strong>/ApplicationControl</strong>  </p>   | <p>  </p><p>The end date of the date span for which the ARI information is being requested. </p><p><br></p><p>Date format : YYYY-MM-DD </p>                            | <p>Y </p><p><br></p>            |


# HotelARIGetRS

* **HotelARIGetRS**:
  * OTA should respond to the `HotelARIGetRQ` request by sending a `HotelARIGetRS` message.

**Validation and Errors**:

* Response messages indicating failures must contain at least one error element. It is possible to return more than one error element.

**Successful Response**:

* After validating the hotel code and the product, the OTA should:
  * Return a `HotelARIGetRS` message with a single Success element.
  * Return the ARI information for the products for the hotel in the request.
* **HotelARIDataSet Node**:
  * The response message must include one `<HotelARIDataSet>` node.
  * Inside this element, one `HotelARIData` node should be included for each date in the date range.
  * In case there is no data loaded for any given date, the `HotelARIData` node may be replaced with a `HotelARIStatus` node.

**Product Identification**:

* DirectConnect identifies a product by room type and rate type.

**Allotment and Restrictions**:

* Allotment is supported at the Room Level.
* In response XML, Allotment returns at Room Level along with all other restrictions/settings, if applicable.

| <p><strong>Element/@Attribute</strong> </p><p><strong>Parent Xpath</strong>  </p>                                                                   | <p>  </p><p><strong>Description</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>  </p><p><strong>Mandatory</strong></p>                   |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| <p>@TimeStamp </p><p><strong>/HotelARIGetRS</strong>  </p>                                                                                          | Time of the transaction in XML schema date-time format.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>  </p><p>Y </p>                                           |
| <p>@Version </p><p><strong>/HotelARIGetRS</strong>  </p>                                                                                            | <p>  The version of the message schema. For this version of the specification, set to</p><p>“1.0”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>Y </p><p><br></p>                                         |
| <p>Success </p><p><strong>/HotelARIGetRS</strong>       </p>                                                                                        | <p>If included, this element will indicate that the request message was successfully processed. </p><p>If this element is returned, a Product element must also be returned. Either a</p><p>Success element or an Error element is required in every response. </p>                                                                                                                                                                                                                                                                                                                                                                            | Y                                                            |
| <p>Errors </p><p><strong>/HotelARIGetRS</strong> </p>                                                                                               | If included, this element will indicate that the request message could not be processed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Y?                                                           |
| <p>Error </p><p><strong>/HotelARIGetRS/Errors</strong>  </p>                                                                                        | <p>Description of cause for a fatal problem during request message processing. </p><p>\*If an Errors element is included, at least one Error element is required. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Y                                                            |
| <p>@Type </p><p> <strong>/HotelARIGetRS/Errors/Error</strong>  </p>                                                                                 | <p>This is an enumeration of error types. </p><p>See Code Lists below for supported values. Code list ErrorTypes </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Y                                                            |
| <p> @Code </p><p><strong>/HotelARIGetRS/Errors/Error</strong>  </p>                                                                                 | <p>This is an enumeration of error codes. </p><p>See the Code Lists below for supported values. Code list Error Codes. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Y                                                            |
| <p>HotelARIDataSet </p><p><strong>/HotelARIGetRS</strong>  </p>                                                                                     | <p>  </p><p>This element contains ARI information. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Y                                                            |
| <p>@HotelCode </p><p><strong>/HotelARIGetRS/HotelARIDataSet</strong>  </p>                                                                          | This attribute identifies the hotel for which the ARI information is given.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Y                                                            |
| <p>HotelARIData </p><p><strong>/HotelARIGetRS/HotelARIDataSet</strong>  </p>                                                                        | The element is used to transfer the ARI information for a product for a date range (with day-of-week applicability). If different sets o values need to be specified for a single date range based on different days of week applicability, separate HotelARIData elements must be used.                                                                                                                                                                                                                                                                                                                                                       | Y                                                            |
| <p>@ItemIdentifier </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p>                                                       | A number identifying a HotelARIData element in a HotelARIDataSet collection. Useful for correlating request and response message items.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>        Y </p><p><br></p><p><br></p>                      |
| <p>ProductReference </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p>                                                       | <p>  </p><p>Identifies the product for which the ARI information is given. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Y                                                            |
| <p>@InvTypeCode  </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/ProductReference</strong></p>                                           | Identifies the room type for which the ARI information is being returned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p><br></p><p>Y </p>                                         |
| <p>@RatePlanCode </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/ProductRefere nce</strong>  </p>                                        | Identifies the rate type for which the ARI information is being returned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Y                                                            |
| <p>ApplicationControl </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p>                                                     | <p>Identifies the date range that the ARIData applies to. </p><p>If any one of the day of week attributes are passed, they all must be passed.</p><p>If no day of week attribute is passed, it is assumed that the ARI data applies to all dates within the start date and end dates. </p>                                                                                                                                                                                                                                                                                                                                                     | <p>Y </p><p><br></p>                                         |
| <p>@Start </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/ApplicationContro l</strong>  </p>                                            | <p>The start date of the date range for which the ARI data applies. The date range includes the start date.</p><p>  </p><p>Date format: YYYY-MM-DD </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Y                                                            |
| <p>@End </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/ApplicationContro l</strong>  </p>                                              | <p>The end date of the date range for which the ARI data applies. The date range includes the end date.</p><p>  </p><p>Date format : YYYY-MM-DD </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Y                                                            |
| <p>RateAmounts </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p>                                                            | <p>  </p><p>This element contains Rate amounts for each check-in date between Start date & End date </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | N                                                            |
| <p>@Currency </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/RateAmoun ts</strong>  </p>                                                 | The currency of the rates. This must be the primary currency of the hotel. Three letter ISO code.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p><br></p>                                                  |
| <p>Base </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/RateAmoun ts</strong>  </p>                                                      | The base rates. The rates could be expressed as “Room” rates or occupancy-based prices. 1 Adult, 2 Adults etc are commonly used base occupancies.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | N                                                            |
| <p>@OccupancyCode </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/RateAmounts/ Bas e</strong>  </p>                                     | <p>  </p><p>The code of the base occupancy. See the Code Lists section for supported values. Code list Occupancy Codes. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p>Y </p><p><br></p><p><br></p>                              |
| <p>@Amount </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/RateAmounts/ Bas e</strong>  </p>                                             | <p>  </p><p>The rate amount for this occupancy in the currency mentioned above. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Y                                                            |
| <p>MealPlans </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/RateAmounts</strong></p>                                                    | <p>This element contains the meal plans available for this rate. Meal Plan is also commonly referred to as Board and Pension. For example Bed\&Breakfast, Full Board, Half Pension etc. </p><p>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                          | N                                                            |
| <p>MealPlan </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/</strong> </p><p><strong>RateAmounts/MealPlans</strong> </p>                 | <p>This element provides information on one of the meal plan available for this product.  </p><p><br></p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | N                                                            |
| <p>@MealPlanCode </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/</strong> </p><p><strong>RateAmounts/MealPlans/MealPlan</strong> </p>  | The code of the meal plan. Full Board, Half Board, Bed and Breakfast, Room only etc. are commonly used meal plans. See the Code Lists section for supported values. (Code list Meal Plan Codes).  Mandtory if MealPlan node is present                                                                                                                                                                                                                                                                                                                                                                                                         | <p><br></p><p>       Y </p><p><br></p><p><br></p><p><br></p> |
| <p>Additional </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/RateAmoun ts</strong></p>                                                  | <p>  </p><p>Rate amounts for additional occupancies. Extra Adult, Extra Child etc. are commonly used  additional occupancies. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | N                                                            |
| <p>@OccupancyCode </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/RateAmoun ts</strong></p><p><strong>/Additional</strong>  </p>         | <p>  </p><p>The code of the additional occupancy. See the Code Lists section for supported values. Code list Occupancy Codes. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>Y </p><p><br></p>                                         |
| <p>@Amount </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/RateAmoun ts</strong></p><p><strong>/Additional</strong>  </p>                | The rate amount for this occupancy in the currency mentioned above.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Y                                                            |
| <p>Availability </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p>                                                           | <p>  </p><p>This element provides information regarding the availability of the hotel product. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | N                                                            |
| <p>  </p><p>@Master </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/Availability</strong></p>                                           | <p>This is the master availability. If master is ‘Closed’, the product is not bookable if any of the stay dates includes one of the dates specified by the Application Control element. If master is ‘Open’, additional restrictions on arrival and departure may be placed. OTA is expected to retain the</p><p>ARI information when the master availability is changed from ‘Open’ to ‘Closed’, so that when the availability becomes ‘Open’ once again, the</p><p>previously set values of price and other restrictions could be restored. For that  matter, this restriction could also be considered to be equivalent to ‘Stop Sell’.</p> | N                                                            |
| <p>@Arrival </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/Availability</strong></p>                                                   | <p>This is an availability restriction commonly referred to as Closed To Arrival (CTA). If Arrival availability is ‘Closed’, the product is not bookable if the first date of the stay is one of the dates specified by the Application Control element.If this element is not passed, it is assumed as Open for arrival. </p><p> </p>                                                                                                                                                                                                                                                                                                         | N                                                            |
| <p>@Departure </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/Availability</strong></p>                                                 | <p>This is an availability restriction commonly referred to as Closed To Departure (CTD). If Departure availability is ‘Closed’, the product is not bookable if the last date of the stay is one of the dates specified by the Application Control element.If this element is not passed, it is assumed as Open for departure. </p><p> </p>                                                                                                                                                                                                                                                                                                    | N                                                            |
| <p>BookingLimit </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong> </p>                                                            | This element contains information on the allocation of inventory to the OTA.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | N                                                            |
| <p>  </p><p>@FreeSale </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/BookingLimit</strong> </p><p>  </p>                                | <p>Indicates if the hotel has removed all booking limits for this product for this date range. </p><p>If this element is not passed, it is assumed that ‘Free Sale’ is off. Further, it is understood that the product would be bookable subject to the limits given below. If this element is set to ‘On’, the OTA may sell the product without regard to the limits  given below.  </p>                                                                                                                                                                                                                                                      | N                                                            |
| <p>TransientAllotment </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/BookingLi mit</strong>  </p>                                       | <p>This element is used to transfer information on any dynamically allocated hotel inventory. RezGain is a platform for</p><p>optimizing the distribution of available hotel  inventory toOTAs. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                           | N                                                            |
| <p>@Sold </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/BookingLimit/TransientAllotment</strong>  </p>                                  | This attribute indicates the number rooms already sold by the OTA out of dynamically allocated inventory. It is important to understand that if this attribute is used, the Application Control element must refer to a single date rather  than a range of dates.                                                                                                                                                                                                                                                                                                                                                                             | N                                                            |
| <p>@Allotment </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/BookingLi mit</strong>  </p><p><strong>/TransientAllotment</strong>  </p> | <p>  </p><p>  </p><p>The number of rooms received in allotment  by the hotel under dynamic allocation. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p>N </p><p><br></p>                                         |
| <p>BookingRules </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p><p>  </p>                                                  | This element contains booking rules. Booking rules are additional restrictions placed by the hotel on bookings of this product.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | N                                                            |
| <p>MinAdvancedBookingOffset </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/</strong>  </p><p><strong>/BookingRules</strong>  </p>       | <p>This element indicates the minimum number of days before the check-in date after which the product is not available to be booked. </p><p>This restriction is usually used to offer discounts on early bookings. </p>                                                                                                                                                                                                                                                                                                                                                                                                                        | N                                                            |
| <p>MaxAdvancedBookingOffset </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData/</strong>  </p><p><strong>/BookingRules</strong>  </p>       | This element indicates the maximum number of days before the check-in date before which the product is not available to be booked.  This restriction is usually used to offer last-minute discounts on unsold inventory.                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>N </p><p>  </p>                                           |
| <p>MinLoSOnArrival </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p><p><strong>/BookingRules</strong>  </p>                 | <p>This element indicates the minimum number of nights for which a stay must be booked to obtain this rate. Applies only to bookings where the first date of the booking is one of the dates referred in the Application Control element. </p><p>This restriction is usually used to offer discounts on longer stays. </p>                                                                                                                                                                                                                                                                                                                     | <p>N </p><p>  </p>                                           |
| <p>MaxLoSOnArrival </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p><p><strong>/BookingRules</strong>  </p>                 | <p>  </p><p>This element indicates the maximum number of nights for which a stay can be booked to obtain this rate. Applies only to bookings where the first date of the booking is one of the dates referred in the Application Control element. </p>                                                                                                                                                                                                                                                                                                                                                                                         | N                                                            |
| <p> MinLoSThrough  </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p><p><strong>/BookingRules</strong>  </p>                 | <p>This element indicates the minimum number of nights for which a stay must be booked to obtain this rate. Applies to bookings where anyof thestaydates of the booking includes any of the dates referred in the Application Control element. </p><p>This restriction is usually used to offer discounts on longer stays. </p>                                                                                                                                                                                                                                                                                                                | <p>N </p><p>  </p>                                           |
| <p> MaxLoSThrough </p><p><strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong>  </p><p><strong>/BookingRules</strong>  </p>                  | This element indicates the maximum number of nights for which a stay can be booked at this rate. Applies to bookings where any of the stay dates of the booking includes any of the dates referred in the Application Control element.                                                                                                                                                                                                                                                                                                                                                                                                         | N                                                            |
| <p>Description </p><p> <strong>/HotelARIGetRS/HotelARIDataSet/HotelARIData</strong> </p><p>  </p>                                                   | Reserved for future use.  This element is used to provide a textual description of the product. Usually used to describe the special features of the room or rate. Also used commonly to describe what is included in the price.                                                                                                                                                                                                                                                                                                                                                                                                               | N                                                            |
| <p>HotelARIStatus </p><p><strong>/HotelARIGetRS/HotelARIDataSet</strong>  </p>                                                                      | This element is used to return status information where ARI data is not available or cannot be returned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | N                                                            |
| <p>ProductReference </p><p> <strong>/HotelARIGetRS/HotelARIDataSet</strong>  </p>                                                                   | The product for which the status is sent is  specified in this element. Please refer to the description of this element under HotelARIData above.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Y                                                            |
| <p>ApplicationControl </p><p><strong>/HotelARIGetRS/HotelARIDataSet</strong>    </p>                                                                | The date range for which the status is sent is specified in this element. Please refer to the description of this element under HotelARIData above.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Y                                                            |
| <p>Status </p><p><strong>/HotelARIGetRS/HotelARIDataSet</strong>  </p>                                                                              | The status of ARI data on the OTA. This can be used to return an error if the ARI information is not available.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>       N </p><p>  </p><p><br></p>                         |
| <p> @Code </p><p>   </p><p><strong>/HotelARIGetRS/HotelARIDataSet/Status</strong>  </p>                                                             | Code 842 can be used to indicate that rates have not been loaded yet for this product for this date range. This is an enumeration of error codes. See Code Lists below for supported values. Code list Error Codes.                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>N </p><p>  </p>                                           |


# Test Use Cases

Sample Xml contains below test cases.&#x20;

| **TestCases** | **Title**                | **Description**                                                                                                                                                    |
| ------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| TC1           | Invalid Credential       | Return error response with message "Invalid Username or Password" in case of wrong username or password in the request                                             |
| TC2           | Invalid HotelCode        | Return error response with message "Invalid HotelCode" in case of wrong HotelCode in the request                                                                   |
| TC3           | Invalid RoomRate         | Return error response with message "Invalid Room/Rate" in case of wrong RoomTypeCode/RatePlanCode in the request                                                   |
| TC4           | No Inventory Loaded      | Return success response with message "No inventory loaded for the requested dates" in HotelARIStatus/Status for all days                                           |
| TC5           | Partial Inventory Loaded | <p>Return success response with data for some days and message  "No inventory loaded for the requested dates" in  </p><p>HotelARIStatus/Status for some days  </p> |
| TC6           | Full Inventory Loaded    | Return success response with data for all days                                                                                                                     |

<br>


# FAQ

**Invalid Credentials and Codes**:

* **Invalid Username/Password**:
  * If the `HotelARIGetRQ` contains an invalid Username/Password, the partner should return an error response with `ShortText="Invalid Username or Password"`.
* **Invalid HotelCode**:
  * If the `HotelARIGetRQ` contains an invalid HotelCode, the partner should return an error response with `ShortText="Invalid HotelCode"`.
* **Invalid RoomTypeCode or RatePlanCode**:
  * If the `HotelARIGetRQ` contains an invalid RoomTypeCode or RatePlanCode, the partner should return an error response with `ShortText="Invalid Room/Rate"`.

**XML Attributes**:

* **Request and Response XML**:
  * Will always contain an attribute `xmlns="http://cgbridge.rategain.com/OTA/2012/05"` at the root element.
* **Date Format**:
  * The date format for Start and End is always `YYYY-MM-DD`.


# Operation: ARI Update

This operation allows DirectConnect to update the ARI information on the OTA system for a single product for a date range.&#x20;


# HotelARIUpdateRQ

* DirectConnect will use this message to request the OTA to update the ARI information.
* The information will be sent at the product level.

**Allotment**:

* Allotment is supported at the Room Level only.
* **Product Reference**: Only `InvTypeCode` is required in the Product reference.

<br>

| <p><strong>Element/@Attribute</strong> </p><p><strong>Parent XPath</strong>  </p>   | <p>  </p><p><strong>Description</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | **Mandatory**                                                 |
| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| <p>@TimeStamp </p><p><strong>/HotelARIUpdateRQ</strong>  </p>                       | Time of the transaction in xml schema date time format                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Y                                                             |
| <p>@Version </p><p><strong>/HotelARIUpdateRQ</strong>  </p>                         | For this version of the specification set to “1.0”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>Y<br></p>                                                  |
| <p>Authentication </p><p><strong>/HotelARIUpdateRQ</strong>  </p>                   | All DirectConnect request messages would include an Authentication element. A set of UserName and Password are passed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>        Y </p><p><br></p><p>  </p>                         |
| <p>  @UserName </p><p> <strong>/HotelARIUpdateRQ/Authentication</strong>  </p>      | The UserName part of the credentials. UserName and Password combination (credentials) required to authorize the request are sent in these attributes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Y                                                             |
| <p>@Password </p><p><strong>/HotelARIUpdateRQ/Authentication</strong>  </p>         | The Password part of the credential.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Y                                                             |
| <p>HotelARIUpdateRequest </p><p><strong>/HotelARIUpdateRQ</strong>  </p>            | Contains rate changes for a given hotel. Only the updates of a single product are sent in one request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Y                                                             |
| <p>@HotelCode </p><p><strong>/HotelARIUpdateRQ/HotelARIUpdateRequest</strong>  </p> | <p>  </p><p>Hotel code of the property whose ARI information is being updated. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>Y </p><p><br></p>                                          |
| <p>@UpdateType </p><p><strong>/HotelARIUpdateRQ/HotelARIUpdateRequest</strong> </p> | <p>Specifies the type of update i.e. “Partial”. RezGain currently only sends “Partial” updates. </p><p>If update type is “Partial”, OTA should overwrite only the values which are specifically passed in the update and retain previously set values for other ARI information.  If any element or attribute is missing,   they are assumed to retain their previously set values. For example, if Availability information is not passed in the update the OTA must continue to apply the previously set values of Availability for the dates specified. It should be noted that the</p><p>OTA could have different values set previously for the dates specified in the update and they should all be retained as is. If an allocation is specified in the update, Free Sale should be turned off. </p> | <p>        Y </p><p><br></p><p><br></p><p><br></p><p><br></p> |

&#x20;

| <p>@InvTypeCode </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /ProductReference  </p>                       | <p>  </p><p>Identifies the room type for which the ARI information is given. </p><p> </p>                                                                                                                                                                                                           | Y |
| ------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| <p>@RatePlanCode </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /ProductReference  </p>                      | <p>  </p><p>Identifies the rate type for which the AR information is given.  </p><p> Need to be absent in case of Allocation TransientAllotment update.  </p>                                                                                                                                       | N |
| <p>ApplicationControl </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData</p> | <p>Identifies the date range that the ARIData applies to. </p><p>If any one of the day of week attributes are passed, they all must be passed. </p><p>If no day of week attribute is passed, it is assumed that the ARI data applies to all dates within the start date and end dates. </p><p> </p> | Y |
| <p>@Start </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /ApplicationControl  </p>                           | <p>  </p><p>The start date of the date range for which the</p><p>ARI data applies. The date range includes  the start date. </p><p> </p><p>Date format : YYYY-MM-DD </p>                                                                                                                            | Y |

| <p>@End </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /ApplicationControl  </p> | <p> </p><p>The end date of the date range for which the ARI data applies. The date range includes the end date. </p><p>  </p><p>Date format : YYYY-MM-DD </p> | <p>Y </p><p> </p><p> </p> |
| --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| <p>RateAmounts </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData</p>                                  | This element contains the rates and meal  plan information.                                                                                                   | N                         |
| <p>@Currency </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /RateAmounts  </p>   | <p>  </p><p>The currency of the rates.This must be the primary currency of the hotel. Three letter  ISO code. </p>                                            | Y                         |

| <p>    </p><p>Base </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /RateAmounts  </p>     | <p>The base rates. The rates could be expressed as</p><p>“Room” rates or occupancy based prices. Single Adult, Two Adults etc. are commonly used base occupancies. </p><p> If the UpdateType is “Partial”, OTA should only update the occupancies, which are passed and must retain the old prices for the other occupancies. </p> | N |
| ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| <p>@OccupancyCode </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /RateAmounts/Base  </p> | <p>  </p><p>The code of the base occupancy.  </p><p>See the Code Lists section for supported  values.</p><p>Code list Occupancy Codes. </p>                                                                                                                                                                                        | N |
| <p>@Amount </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /RateAmounts/Base  </p>        | <p>  </p><p>  </p><p>The rate amount for this occupancy. </p><p> </p>                                                                                                                                                                                                                                                              | N |
| <p>MealPlans </p><p> </p><p> </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /RateAmounts </p>              | This element contains the meal plans available for this rate. Meal Plan is also commonly referred to as Board and  Pension. For example Bed and Breakfast, Full Board, Half Pension etc.                                                                                                                                           | N |
| <p>MealPlan </p><p> </p><p> </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest  /HotelARIData/RateAmounts/MealPlans </p>    | <p>This element provides information on one o the meal plan available for this product.  </p><p> </p><p> </p>                                                                                                                                                                                                                      | N |

| <p>@MealPlanCode </p><p> </p><p> </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest  </p><p>/HotelARIData/RateAmounts/MealPlans/MealPlan </p>          | <p>The code of the meal plan. Full Board, Half Board, Bed and Breakfast, Room only etc. are commonly used meal plans.  </p><p>See the Code Lists section for supported values. (Code list Meal Plan Codes). </p><p> </p><p>Mandtory if MealPlan node is present </p>                        | <p> </p><p>        Y </p><p> </p><p> </p> |
| -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| <p>Additional </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /RateAmounts  </p> | <p>  </p><p>Rate amounts for additional occupancies. Extra Adult, Extra Child etc. are commonly used additional occupancies. </p><p>If the UpdateType is “Partial”, OTA should only update the occupancies which are passed and must retain the old prices for the  other occupancies. </p> | <p>N </p><p> </p><p> </p>                 |

| <p>@OccupancyCode </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData/RateAmounts/Additional </p>                               | <p>The code of the additional occupancy. </p><p>See the Code Lists section for supported values.</p><p> Code list Occupancy Codes. </p>                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>N </p><p> </p>                         |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- |
| <p>@Amount </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /RateAmounts/Additional  </p>                                    | <p>  </p><p>  </p><p>The rate amount for this occupancy. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | N                                         |
| <p>Availability </p><p>   </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData</p>                                                                 | <p>  </p><p>This element provides information regarding the availability of the hotel  product. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>N </p><p> </p>                         |
| <p>@Master  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData</p><p>/Availability  </p>                     | <p>  </p><p>This is the master availability. If master is ‘Closed’, the product is not bookable if any of the stay dates includes one of the dates specified by the</p><p> Application Control element. If master is</p><p>‘Open’, additional restrictions on arrival and departure may be placed. OTA is expected to retain the ARI information when the master availability is changed from ‘Open’ to ‘Closed’, so that when the availability becomes ‘Open’ once again, the previously set values of price and other restrictions could be restored. </p> | <p>N </p><p> </p>                         |
| <p>@Arrival </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData</p><p>/Availability  </p>   | <p>This is an availability restriction commonly referred to as Closed To Arrival (CTA). If Arrival availability is ‘Closed’, the product is not bookable if the first date of the stay is one of the dates specified by the Application Control element. </p><p>If the UpdateType is “Partial”, and this attribute is not passed, the OTA should</p><p> </p><p>retain the previously existing value of this restriction. </p>                                                                                                                                | <p>N </p><p> </p><p> </p><p> </p><p> </p> |
| <p>@Departure </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData</p><p>/Availability  </p> | <p>This is an availability restriction commonly referred to as Closed To Departure (CTD). If</p><p>Departure availability             is ‘Closed’, the</p><p>product is not bookable if the last date of the stay is one of the dates specified by the Application Control element. </p><p>If the UpdateType is “Partial”, and this attribute is not passed, the OTA should</p><p> </p><p>retain the previously existing value of this restriction. </p>                                                                                                     | <p>N </p><p> </p><p> </p><p> </p><p> </p> |

| <p>  </p><p>BookingLimit </p><p>   </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData </p>                                                         | This   element  contains  information on the allocation of inventory to the OTA.                                                                                                                                                                                                                                                                                                                        | N                         |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| <p>@FreeSale </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /BookingLimit  </p> | <p>  </p><p>Indicates if the hotel has removed all booking limits for this product for this date range. </p><p>If this element is not passed, it is assumed that</p><p>‘Free Sale’ is off. Further, it is understood that the product would be bookable subject to the limits given below.  If this element is set to ‘On’, the OTA may sell the product without regard to the limits given below. </p> | <p>N </p><p> </p><p> </p> |
| <p>TransientAllotment </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData /BookingLimit  </p>                            | <p>  </p><p>This element is used to transfer informationon any dynamically allocated hotel inventory. RezGain is a platform for optimizing the distribution of available hotel inventory to OTAs.</p>                                                                                                                                                                                                   | <p>N </p><p> </p>         |

| <p>  </p><p>@Allotment </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData  /BookingLimit/TransientAllotment  </p>             | <p>The number of rooms received in allotment by the hotel under dynamic allocation. </p><p>If a negative value is received, the OTA must treat it as a value of 0 and must not offer the product for booking unless Free Sale is set to On. </p>                                                                                                                                                             |                                                                            |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
| <p>  </p><p>  </p><p>BookingRules </p><p>  </p><p>  </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData  </p>         | <p>This element contains booking rules. Booking rules are additional restrictions placed by the hotel on bookings of this product. </p><p>If the UpdateType is “Partial”, the OTA should only update the values of the restrictions that are passed in the update. </p><p>It is assumed that the minimum possible length of stay is 1 and that a MinLoS of 0 is functionally equivalent to MinLoS of 1. </p> | <p>        N </p><p> </p><p>  </p><p> </p><p> </p><p> </p><p> </p><p> </p> |
| <p>MinAdvancedBookingOffset </p><p>  </p><p>  </p>                                                                                                       | <p>  </p><p>This element indicates the minimum number of days before the check-in date after which the product is not available to be booked. </p>                                                                                                                                                                                                                                                           | <p>N </p><p>  </p><p>  </p>                                                |
| <p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData/Bo okingRules  </p><p>  </p><p>  </p>                                                            | <p> This restriction is usually used to offer discounts on early bookings. </p><p>  </p>                                                                                                                                                                                                                                                                                                                     | <p>  </p><p>  </p>                                                         |
| <p>MaxAdvancedBookingOffset </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData  </p><p>/  </p><p>/BookingRules  </p> | <p>  </p><p>This element indicates the maximum number of days before the check-in date before which the product is not available to be booked. </p><p>This restriction is usually used to offer last minute discounts on unsold inventory. </p>                                                                                                                                                              | <p>N </p><p> </p><p>  </p><p> </p>                                         |
| <p>MinLoSOnArrival </p><p>  </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData  </p><p>/BookingRules  </p>           | <p>This element indicates the minimum number of nights for which a stay must be booked to obtain this rate. Applies only to bookings where the first date of the booking is one of the dates referred in the Application Control element. </p><p>This restriction is usually used to offer discounts on longer stays. </p>                                                                                   | <p>N </p><p> </p>                                                          |

| <p>MaxLoSOnArrival </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData  </p><p>/BookingRules  </p> | <p>  </p><p>This element indicates the maximum number of nights for which a stay can be booked to obtain this rate. Applies only to bookings where the first date of the booking is one of the dates referred in the Application Control element. </p>         | N |
| ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| <p>MinLoSThrough </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData  </p><p>/BookingRules  </p>   | <p>  </p><p>This element indicates the minimum number of nights for which a stay must be booked to obtain this rate. Applies to bookings where anyof the stay dates of the booking includes any of the dates referred in the Application Control element. </p> | N |
| <p>MaxLoSThrough </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData  </p><p>/BookingRules  </p>   | <p>  </p><p>This element indicates the maximum number of nights for which a stay can be booked at this rate. Applies to bookings where any of the stay dates of the booking includes any of the dates referred in the Application Control element. </p>        | N |
| <p>Description </p><p>  </p><p>  </p><p>  </p><p>  </p><p>/HotelARIUpdateRQ/HotelARIUpdateRequest/HotelARIData  </p>                  | <p>  </p><p>Reserved for future use. </p><p>This element is used to provide a textual description of the product. Usually used to describe the special features of the room or rate. Also used commonly to describe what is included in the price. </p>        | N |

<br>


# HotelARIUpdateRS

**Response Message**:

* **HotelARIUpdateRS**:
  * OTA should respond to the `HotelARIUpdateRQ` request by sending a `HotelARIUpdateRS` message.
  * If the OTA is not able to validate a message at the application level, it should still return a `HotelARIUpdateRS` message.

**Validation and Errors**:

* Response messages indicating failures must contain at least one error element. It is possible to return more than one error element.
* **Update Failure**: If any of the requested updates cannot be completed successfully, the OTA must ensure that no update is made to ARI information at all.

**Successful Update**:

* After updating the ARI information, the OTA should:
  * Return a `HotelARIUpdateRS` message with a single Success element.

| <p><strong>Element/@Attribute</strong></p><p><strong>Parent XPath</strong>  </p> | <p>  </p><p><strong>Description</strong> </p>                                                                                                                                                                                                                         | **Mandatory**                    |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| <p>@TimeStamp </p><p><strong>/HotelARIUpdateRS</strong>  </p>                    | <p>  </p><p>Time of the transaction in XML schema date-time format. </p>                                                                                                                                                                                              | Y                                |
| <p>@Version </p><p><strong>/HotelARIUpdateRS</strong>  </p>                      | <p>  </p><p>For this version of the specification set to “1.0” </p>                                                                                                                                                                                                   | Y                                |
| <p>  Success </p><p><strong>/HotelARIUpdateRS</strong>  </p>                     | <p>If included, this element will indicate that the request message was successfully processed. </p><p>If this element is returned, a Products element must also be returned. Either a Success element or an</p><p>Errors element is required in every response. </p> | <p><br> Y? </p>                  |
| <p>Errors </p><p><strong>/HotelARIUpdateRS</strong></p>                          | <p>If included, this element will indicate that the request message could not be processed. </p><p>Either a Success element or an Errors element is required in every response. </p>                                                                                  | <p>Y? </p><p><br></p><p><br></p> |
| <p>Error </p><p><strong>/HotelARIUpdateRS/Errors</strong>  </p>                  | <p>Description of cause for a fatal problem during request message processing. </p><p>\*If an Errors element is included, at least one Error element is required. </p>                                                                                                | Y                                |
| <p>@Type </p><p><strong>/HotelARIUpdateRS/Errors/Error</strong>  </p>            | <p>  </p><p>This is an enumeration of error types. </p><p>See the appendix for supported values. Code list Error types. </p>                                                                                                                                          | Y                                |
| <p>@Code </p><p><strong>/HotelARIUpdateRS/Errors/Error</strong>  </p>            | <p>  </p><p>This is an enumeration of error codes. </p><p>See the appendix for supported values. Code list Error Codes. </p>                                                                                                                                          | Y                                |


# Test Use Cases

Test cases given in DirectConnect Sample XMLs kit attached as per use case scenarios for each attribute. Also, given use cases are per attribute wise, so the composite test cases need to be executed (in a single HotelAriUpdateRQ message) as per the no. of attributes/OPBs supported by Partner. Please refer to below use cases.

**Partial Update (per attribute / OPB)**&#x20;

**Allocation**&#x20;

| **Test Case** | **Title**                   | **Description**                                                           |
| ------------- | --------------------------- | ------------------------------------------------------------------------- |
| TC1           | Update Allocation=0         | Request to update TransientAllotment=0 for a single date                  |
| TC2           | Update for consecutive days | Request to update TransientAllotment for continuous days                  |
| TC3           | Update for alternate days   | Request to update TransientAllotment for discontinuous days               |
| TC4           | Update for cross the month  | Request to update TransientAllotment for continuous days across the month |

**Available**&#x20;

| **Test Case** | **Title**                   | **Description**                                               |
| ------------- | --------------------------- | ------------------------------------------------------------- |
| TC1           | Update for a single date    | Request to update Master for a single date                    |
| TC2           | Update for consecutive days | Request to update Master for continuous days                  |
| TC3           | Update for alternate days   | Request to update Master for discontinuous days               |
| TC4           | Update for cross-the-month  | Request to update Master for continuous days across the month |

&#x20;      &#x20;

**CTA** &#x20;

| **Test Case** | **Title**                   | **Description**                                                |
| ------------- | --------------------------- | -------------------------------------------------------------- |
| TC1           | Update for a single date    | Request to update Arrival for a single date                    |
| TC2           | Update for consecutive days | Request to update Arrival for continuous days                  |
| TC3           | Update for alternate days   | Request to update Arrival for discontinuous days               |
| TC4           | Update for cross the month  | Request to update Arrival for continuous days across the month |

**CTD** &#x20;

| **Test Case** | **Title**                   | **Description**                                                  |
| ------------- | --------------------------- | ---------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update Departure for a single date                    |
| TC2           | Update for consecutive days | Request to update Departure for continuous days                  |
| TC3           | Update for alternate days   | Request to update Departure for discontinuous days               |
| TC4           | Update for cross the month  | Request to update Departure for continuous days across the month |

<br>

**Free Sale**&#x20;

| **Test Case** | **Title**                   | **Description**                                                 |
| ------------- | --------------------------- | --------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update FreeSale for a single date                    |
| TC2           | Update for consecutive days | Request to update FreeSale for continuous days                  |
| TC3           | Update for alternate days   | Request to update FreeSale for discontinuous days               |
| TC4           | Update for cross the month  | Request to update FreeSale for continuous days across the month |

**Min LOS**&#x20;

| **Test Case** | **Title**                   | **Description**                                                        |
| ------------- | --------------------------- | ---------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update MinLoSOnArrival for a single date                    |
| TC2           | Update for consecutive days | Request to update MinLoSOnArrival for continuous days                  |
| TC3           | Update for alternate days   | Request to update MinLoSOnArrival for discontinuous days               |
| TC4           | Update for cross the month  | Request to update MinLoSOnArrival for continuous days across the month |

**Min LOS Through**&#x20;

| **Test Case** | **Title**                   | **Description**                                                      |
| ------------- | --------------------------- | -------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update MinLoSThrough for a single date                    |
| TC2           | Update for consecutive days | Request to update MinLoSThrough for continuous days                  |
| TC3           | Update for alternate days   | Request to update MinLoSThrough for discontinuous days               |
| TC4           | Update for cross the month  | Request to update MinLoSThrough for continuous days across the month |

**Max LOS**&#x20;

| **Test Case** | **Title**                   | **Description**                                                        |
| ------------- | --------------------------- | ---------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update MaxLoSOnArrival for a single date                    |
| TC2           | Update for consecutive days | Request to update MaxLoSOnArrival for continuous days                  |
| TC3           | Update for alternate days   | Request to update MaxLoSOnArrival for discontinuous days               |
| TC4           | Update for cross the month  | Request to update MaxLoSOnArrival for continuous days across the month |

**Max LOS Through**&#x20;

| **TestC ase** | **Title**                   | **Description**                                                      |
| ------------- | --------------------------- | -------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update MaxLoSThrough for a single date                    |
| TC2           | Update for consecutive days | Request to update MaxLoSThrough for continuous days                  |
| TC3           | Update for alternate days   | Request to update MaxLoSThrough for discontinuous days               |
| TC4           | Update for cross the month  | Request to update MaxLoSThrough for continuous days across the month |

**Min Advance Purchase**&#x20;

| **Test Case** | **Title**                   | **Description**                                                                 |
| ------------- | --------------------------- | ------------------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update MinAdvancedBookingOffset for a single date                    |
| TC2           | Update for consecutive days | Request to update MinAdvancedBookingOffset for continuous days                  |
| TC3           | Update for alternate days   | Request to update MinAdvancedBookingOffset for discontinuous days               |
| TC4           | Update for cross the month  | Request to update MinAdvancedBookingOffset for continuous days across the month |

**Max Advance Purchase**&#x20;

| **Test Case** | **Title**                   | **Description**                                                                 |
| ------------- | --------------------------- | ------------------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update MinAdvancedBookingOffset for a single date                    |
| TC2           | Update for consecutive days | Request to update MinAdvancedBookingOffset for continuous days                  |
| TC3           | Update for alternate days   | Request to update MinAdvancedBookingOffset for discontinuous days               |
| TC4           | Update for cross the month  | Request to update MinAdvancedBookingOffset for continuous days across the month |

**1Adult (Single)**&#x20;

| **Test Case** | **Title**                   | **Description**                                                         |
| ------------- | --------------------------- | ----------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update OccupancyCode A1 for a single date                    |
| TC2           | Update for consecutive days | Request to update OccupancyCode A1 for continuous days                  |
| TC3           | Update for alternate days   | Request to update OccupancyCode A1 for discontinuous days               |
| TC4           | Update for cross the month  | Request to update OccupancyCode A1 for continuous days across the month |

&#x20;&#x20;

**2Adult (Double)**&#x20;

| **Test Case** | **Title**                   | **Description**                                                         |
| ------------- | --------------------------- | ----------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update OccupancyCode A2 for a single date                    |
| TC2           | Update for consecutive days | Request to update OccupancyCode A2 for continuous days                  |
| TC3           | Update for alternate days   | Request to update OccupancyCode A2 for discontinuous days               |
| TC4           | Update for cross the month  | Request to update OccupancyCode A2 for continuous days across the month |

**3Adult (Triple)**&#x20;

| **Test Case** | **Title**                   | **Description**                                                         |
| ------------- | --------------------------- | ----------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update OccupancyCode A3 for a single date                    |
| TC2           | Update for consecutive days | Request to update OccupancyCode A3 for continuous days                  |
| TC3           | Update for alternate days   | Request to update OccupancyCode A3 for discontinuous days               |
| TC4           | Update for cross the month  | Request to update OccupancyCode A3 for continuous days across the month |

&#x20;&#x20;

**4Adult (Quad)**&#x20;

| **Test Case** | **Title**                   | **Description**                                                         |
| ------------- | --------------------------- | ----------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update OccupancyCode A4 for a single date                    |
| TC2           | Update for consecutive days | Request to update OccupancyCode A4 for continuous days                  |
| TC3           | Update for alternate days   | Request to update OccupancyCode A4 for discontinuous days               |
| TC4           | Update for cross the month  | Request to update OccupancyCode A4 for continuous days across the month |

**1Child**&#x20;

| **Test Case** | **Title**                   | **Description**                                                         |
| ------------- | --------------------------- | ----------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update OccupancyCode C1 for a single date                    |
| TC2           | Update for consecutive days | Request to update OccupancyCode C1 for continuous days                  |
| TC3           | Update for alternate days   | Request to update OccupancyCode C1 for discontinuous days               |
| TC4           | Update for cross the month  | Request to update OccupancyCode C1 for continuous days across the month |

**2Child**&#x20;

| **Test Case** | **Title**                   | **Description**                                                         |
| ------------- | --------------------------- | ----------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update OccupancyCode C2 for a single date                    |
| TC2           | Update for consecutive days | Request to update OccupancyCode C2 for continuous days                  |
| TC3           | Update for alternate days   | Request to update OccupancyCode C2 for discontinuous days               |
| TC4           | Update for cross the month  | Request to update OccupancyCode C2 for continuous days across the month |

**AdditionalAdult**&#x20;

| **TestCase** | **Title**                   | **Description**                                                         |
| ------------ | --------------------------- | ----------------------------------------------------------------------- |
| TC1          | Update for single date      | Request to update OccupancyCode AA for a single date                    |
| TC2          | Update for consecutive days | Request to update OccupancyCode AA for continuous days                  |
| TC3          | Update for alternate days   | Request to update OccupancyCode AA for discontinuous days               |
| TC4          | Update for cross the month  | Request to update OccupancyCode AA for continuous days across the month |

&#x20;  &#x20;

**AdditionalChild**&#x20;

| **TestCase** | **Title**                   | **Description**                                                         |
| ------------ | --------------------------- | ----------------------------------------------------------------------- |
| TC1          | Update for single date      | Request to update OccupancyCode AC for a single date                    |
| TC2          | Update for consecutive days | Request to update OccupancyCode AC for continuous days                  |
| TC3          | Update for alternate days   | Request to update OccupancyCode AC for discontinuous days               |
| TC4          | Update for cross the month  | Request to update OccupancyCode AC for continuous days across the month |

**RoomPrice / FullOccupancy**&#x20;

| **Test Case** | **Title**                   | **Description**                                                         |
| ------------- | --------------------------- | ----------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update OccupancyCode SR for a single date                    |
| TC2           | Update for consecutive days | Request to update OccupancyCode SR for continuous days                  |
| TC3           | Update for alternate days   | Request to update OccupancyCode SR for discontinuous days               |
| TC4           | Update for cross the month  | Request to update OccupancyCode SR for continuous days across the month |

&#x20;&#x20;

&#x20;      **Full Update**&#x20;

| **Test Case** | **Title**                                         | **Description**                                                               |
| ------------- | ------------------------------------------------- | ----------------------------------------------------------------------------- |
| TC1           | Full Update for all supported attributes and OPBs | Request to update all supported attributes / OPBs in a single Update message. |

&#x20;&#x20;

&#x20;   **MealPlan** &#x20;

| **Test Case** | **Title**                   | **Description**                                                                                           |
| ------------- | --------------------------- | --------------------------------------------------------------------------------------------------------- |
| TC1           | Update for single date      | Request to update MealPlan: “Bed and breakfast”(MealPlanCode =”3”) for a single date                      |
| TC2           | Update for consecutive days | Request to update MealPlan: “Family plan” (MealPlanCode =”9”) for continuous days                         |
| TC3           | Update for alternate days   | Request to update No MealPlan: “Room only” (MealPlanCode =”14”) for discontinuous days                    |
| TC4           | Update for cross the month  | Request to update MealPlan: “Caribbean breakfast” (MealPlanCode =”5”) for continuous days cross the month |


# FAQ

**Invalid Credentials and Codes**:

* **Invalid Username/Password**:
  * If the `HotelARIUpdateRQ` contains an invalid Username/Password, the partner should return an error response with `ShortText="Invalid Username or Password"`.
* **Invalid HotelCode**:
  * If the `HotelARIUpdateRQ` contains an invalid HotelCode, the partner should return an error response with `ShortText="Invalid HotelCode"`.
* **Invalid RoomTypeCode or RatePlanCode**:
  * If the `HotelARIUpdateRQ` contains an invalid RoomTypeCode or RatePlanCode, the partner should return an error response with `ShortText="Invalid Room/Rate"`.

**XML Attributes**:

* **Request and Response XML**:
  * Will always contain an attribute `xmlns="http://cgbridge.rategain.com/OTA/2012/05"` at the root element.
* **Date Format**:
  * The date format for Start and End is always `YYYY-MM-DD`.

**Partial Update**:

* **Mandatory Support**:
  * OTA must support Partial Update, which means each attribute (i.e., Availability, rates, restrictions, or inventory) should be updated by API individually.
  * Partial update is mandatory, and existing values should not be impacted; only updated values should be impacted.
  * **Example**:
    * If a hotel is managing occupancy pricing for 1 Adult, 2 Adults, 3 Adults, etc., the API should update each individual occupancy price without impacting other occupancy-based pricing.
    * If the 1 Adult price is sent for a date, the API should only update the 1 Adult price while the pricing for 2 Adults and 3 Adults should remain the same with existing values.


# Points to remember

**Partial Updates**:

* RG Channel Manager will always send partial updates to the channel.
  * **Purpose**: Allows a hotel to change any specific field (Allocation/ClosedOut/any restriction/Pricing type) for a day.
  * **Validation**: There should not be any validation at the channel end to expect any mandatory field in the update.
* **Allocation**:
  * Manageable at Room level only by a channel partner.
  * Separate RQ for Allocation updates; other fields will be updated in another RQ.
* **Price**:
  * Channel Manager will reject any updates with price=0; this should not be supported for any channel partner.
* **MinLOS and MaxLOS Rule**:
  * MinLOS (Minimum Length of Stay) should always be lesser than or equal to MaxLOS (Maximum Length of Stay).
  * If MinLOS=4 and the current MaxLOS is 3 for the same product, the channel should fail the request with an error message.
* **Monthly Data Updates**:
  * Channel partners should accept an update with 1 month of data in a single RQ.
  * If there are 20 days updated for a month, RezGain will send 1 update RQ with all 20 days included.
* **Invalid Test Scenarios**:
  * Invalid credentials/HotelCode/RoomCode/RateCode cannot be tested through the sandbox; this will be validated during the certification process.
  * Only 14 days of updates can be tested through the sandbox tool.
* **Cross-Month Updates**:
  * Allows a hotel to update multiple dates across the month, e.g., 25 Jan-3 Feb in a single update RQ.
* **Cross-Year Updates**:
  * Allows a hotel to update multiple dates across the year, e.g., 25 Dec-3 Jan in a single update RQ.
* **Continuous and Discontinuous Dates**:
  * A request message can contain data for continuous and discontinuous dates as received from the hotel.

**Multithreading**:

* API should support multiple parallel updates for a single hotel with different Product Types (A Product is a combination of 1 RoomType + 1 RatePlan).
* Example of parallel updates to the `HotelARIUpdate` operation:
  * Update 1: RoomType A + RatePlan 1
  * Update 2: RoomType B + RatePlan 2
  * Update 3: RoomType C + RatePlan 3

| **Request#** | **HotelCode** | **RoomCode** | **RatePlanCode** | **StartDate** | **EndDate**               | **Updates Made**                             |
| ------------ | ------------- | ------------ | ---------------- | ------------- | ------------------------- | -------------------------------------------- |
| RQ1          | HTL1          | DLX          | STD              | 1-May-20      | <p>10-May-</p><p>20  </p> | <p>Allocation=10,</p><p>1Adult=250USD  </p>  |
| RQ2          | HTL1          | SUP          | BAR              | 1-May-20      | <p>10-May-</p><p>20  </p> | <p>Allocation=10,</p><p>1Adult=500USD  </p>  |
| RQ3          | HTL1          | SUI          | ADVP             | 1-May-20      | <p>10-May-</p><p>20  </p> | <p>Allocation=10,</p><p>1Adult=1000USD  </p> |

* &#x20;The partner should implement the API accordingly.           &#x20;
* Alternate date updates allow a hotel to update multiple days with non-continuous dates in a single Update RQ.
* Only 1 MealPlanCode can be supported for a given check-in date.


# Code Lists

### Error Types

| **Error Type** | **Description**            |
| -------------- | -------------------------- |
| **1**          | **Unknown**                |
| **2**          | **No implementation**      |
| **3**          | **Biz rule**               |
| **4**          | **Authentication**         |
| **5**          | **Authentication timeout** |
| **6**          | **Authorization**          |
| **7**          | **Protocol violation**     |
| **8**          | **Transaction model**      |
| **9**          | **Authentication model**   |
| **10**         | **Required field missing** |
| **11**         | **Advisory**               |
| **12**         | **Processing exception**   |
| **13**         | **Application error**      |

### Error Codes

| **Error Codes** | **Description**                                                                |
| --------------- | ------------------------------------------------------------------------------ |
| **15**          | **Invalid Date**                                                               |
| **41**          | **Occupancy must include an adult**                                            |
| **44**          | **No under/over occupancy allowed**                                            |
| **43**          | **Too many accommodation types**                                               |
| **51**          | **Prices not yet released**                                                    |
| **135**         | **Invalid End Date**                                                           |
| **136**         | **Invalid Start Date**                                                         |
| **137**         | **Adult numbers/occupancy mismatch**                                           |
| **138**         | **Child numbers/occupancy mismatch**                                           |
| **143**         | **Price incorrect for room/unit**                                              |
| **175**         | **Invalid Username or Password**                                               |
| **177**         | **Premises suspended - access denied**                                         |
| **182**         | **Password required**                                                          |
| **186**         | **Booking closed - contact provider**                                          |
| **187**         | **System currently unavailable**                                               |
| **188**         | **Transaction error - please report**                                          |
| **190**         | **Wrong network - access denied**                                              |
| **191**         | **System busy - please try later**                                             |
| **197**         | **Undetermined error - please report**                                         |
| **249**         | **Invalid rate code**                                                          |
| **320**         | **Invalid value**                                                              |
| **321**         | **Required field missing**                                                     |
| **356**         | **Invalid Action/Status code**                                                 |
| **361**         | **Invalid hotel**                                                              |
| **362**         | **Invalid number of nights**                                                   |
| **375**         | **Hotel not active**                                                           |
| **392**         | **Invalid Hotel Code**                                                         |
| **397**         | **Invalid number of adults**                                                   |
| **400**         | **Invalid property code**                                                      |
| **402**         | **Invalid room type code**                                                     |
| **404**         | **Invalid start date-end date combination**                                    |
| **407**         | **Item too long**                                                              |
| **424**         | **No hotels found which match this input**                                     |
| **425**         | **No match found**                                                             |
| **427**         | **No rooms available for requested dates**                                     |
| **447**         | **Unable to update – simultaneous updates**                                    |
| **448**         | **System error**                                                               |
| **450**         | **Unable to process**                                                          |
| **458**         | **Date outside inventory period**                                              |
| **497**         | **Authorization error**                                                        |
| **502**         | **Advance notice requirements not met**                                        |
| **558**         | **Accounts are settled in a currency different from the quoted rate currency** |
| **731**         | **Room type discontinued at this hotel**                                       |
| **732**         | **Invalid room type for rate requested**                                       |
| **784**         | **Time out – Please modify your request**                                      |
| **842**         | **Rate not loaded**                                                            |

### Occupancy Codes

| **Occupancy Code** | <p><strong>Occupancy</strong></p><p><strong>Type</strong>  </p> | **Description**                                                                                                        |
| ------------------ | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **SR**             | **Base**                                                        | **Full occupancy / Room price. Occupancy based prices are not used, the price is for the room, apartment or cottage.** |
| **A1**             | **Base**                                                        | **1 Adult (Also called Single or 1 Pax)**                                                                              |
| **A2**             | **Base**                                                        | **2 Adults (Also called Double or 2 Pax)**                                                                             |
| **A3**             | **Base**                                                        | **3 Adults (Also called Triple or 3 Pax)**                                                                             |
| **A4**             | **Base**                                                        | **4 Adults (Also called Quad or 4 Pax)**                                                                               |
| **A5**             | **Base**                                                        | **5 Adults**                                                                                                           |
| **A6**             | **Base**                                                        | **6 Adults**                                                                                                           |
| **A7**             | **Base**                                                        | **7 Adults**                                                                                                           |
| **A8**             | **Base**                                                        | **8 Adults**                                                                                                           |
| **A9**             | **Base**                                                        | **9 Adults**                                                                                                           |
| **A10**            | **Base**                                                        | **10 Adults**                                                                                                          |
| **C1**             | **Base**                                                        | **1 Child**                                                                                                            |
| **C2**             | **Base**                                                        | **2 Children**                                                                                                         |
| **C3**             | **Base**                                                        | **3 Children**                                                                                                         |
| **C4**             | **Base**                                                        | **4 Children**                                                                                                         |
| **C5**             | **Base**                                                        | **5 Children**                                                                                                         |
| **AA**             | **Additional**                                                  | **Additional Adult**                                                                                                   |
| **AC**             | **Additional**                                                  | **Additional Child**                                                                                                   |

### Meal Plan Codes

| **Meal Plan Codes** | **Description**                       |
| ------------------- | ------------------------------------- |
| **1**               | **All inclusive**                     |
| **2**               | **American**                          |
| **3**               | **Bed & breakfast**                   |
| **4**               | **Buffet breakfast**                  |
| **5**               | **Caribbean breakfast**               |
| **6**               | **Continental breakfast**             |
| **7**               | **English breakfast**                 |
| **8**               | **European plan**                     |
| **9**               | **Family plan**                       |
| **10**              | **Full board**                        |
| **11**              | **Full breakfast**                    |
| **12**              | **Half board/modified American plan** |
| **13**              | **As brochure**                       |
| **14**              | **Room only**                         |
| **15**              | **Self-catering**                     |
| **16**              | **Bermuda**                           |
| **17**              | **Dinner bed and breakfast plan**     |
| **18**              | **Family American**                   |
| **19**              | **Breakfast**                         |
| **20**              | **Modified**                          |


# Interface Specifications – Reservation Notification Service


# Technical overview

This interface is designed to be used in a connected model. In this model, information is sent (pushed) by the OTA is sent to PMS in the same format in which the information originated. &#x20;


# Communication protocols

**Information Exchange**:

* The exchange of information between DirectConnect and OTA happens through the HTTP POST method with the `OTA_HotelResNotifRQ` request as postdata.

**HTTP Headers for Reservation Push**:

* **Content-Type**: `text/xml; charset=utf-8`
* **Authorization**: Basic Authorization using Username and Password configured for the hotel/chain/common login.


# General design

**Reservation Notification Process**:

* **OTA\_HotelResNotifRQ**:
  * OTA will push the bookings to DirectConnect using the reservation notification request message `OTA_HotelResNotifRQ`.
  * Each reservation notification request will hold a single reservation record.

**Response from DirectConnect**:

* DirectConnect will send either a success response or an error response with reasons for failure.

**Handling Different Reservation States**:

* **Commit, Modified, and Canceled Reservations**:
  * All types of reservations (commit, modified, and canceled) are pushed by sending an `OTA_HotelResNotifRQ` message.
  * DirectConnect responds with an `OTA_HotelResNotifRS` message.


# Authentication

All request messages exchanged between the OTA and DirectConnect must be authenticated using the  Basic Authorization. This is sent in HttpRequest Header. &#x20;

Below is an example to implement Basic Authorization in C# language.&#x20;

```csharp
string username = "Your username";   string password = "Your password";   
  
string credentials = Convert.ToBase64               (ASCIIEncoding.ASCII.GetBytes(username + ":" + password));  
  
request.Headers.Add("Authorization" , "Basic " + credentials);  
```


# Operation: Reservation

**Operation Overview**:

* This web service operation allows the OTA to push reservations to DirectConnect.

**Messages Involved**:

1. **OTA\_HotelResNotifRQ**:
   * Sent by OTA to the DirectConnect service to notify the commit, modify, or cancel a booking.
2. **OTA\_HotelResNotifRS**:
   * Sent by DirectConnect in response to acknowledge the notification.


# OTA\_HotelResNotifRQ

**OTA\_HotelResNotifRQ**:

* OTA will send reservations using this message.
* Each message will contain only one reservation record.

**DirectConnect Response**:

* DirectConnect will process the message and return a synchronous response with a Success or Error message.
* **Confirmation Number**: No confirmation number is returned.

| <p><strong>Element/@Attribute</strong> </p><p><strong>Parent XPath</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>  </p><p><strong>Description</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | **Occurrences**                                                                    |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| <p>  </p><p>@EchoToken </p><p><strong>/OTA\_HotelResNotifRQ</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | This value is the reservation’s Control Center UniqueID (guid).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 1                                                                                  |
| <p>@TimeStamp </p><p><strong>/OTA\_HotelResNotifRQ</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>Time of the transaction in XML schema date time format. </p><p>Date Format: yyyy-mm-ddThh:mm:ssZ </p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                                                                  |
| <p>@Version </p><p><strong>/OTA\_HotelResNotifRQ</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | The DirectConnect schema version. Default is“1.0”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 1                                                                                  |
| <p>@Target </p><p><strong>/OTA\_HotelResNotifRQ</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>  </p><p>Always Set to “Production” </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                                                                                  |
| <p>  @ResStatus </p><p><strong>/OTA\_HotelResNotifRQ</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p>To specify the type of action requested. Will be one of: </p><p>•       <strong>“Commit”</strong> -><strong>New reservation</strong>  </p><p>•       <strong>“Modify”</strong> -><strong>Modification</strong>  </p><p>•       <strong>“Cancel” -></strong> <strong>Cancellation</strong>  </p>                                                                                                                                                                                                                                                                                                  | 1                                                                                  |
| <p>POS </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Element for including the channel from which the booking was received.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 1                                                                                  |
| <p>Source </p><p><strong>/OTA\_HotelResNotifRQ/POS</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Provides information on the source of a request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                                  |
| <p>RequestorID </p><p><strong>/OTA\_HotelResNotifRQ/POS/Source</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | An identifier of the entity making the request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 1                                                                                  |
| <p>@Type </p><p><strong>/OTA\_HotelResNotifRQ/POS/Source/RequestorID</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>  </p><p>Always set to “14” </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                                                                  |
| <p>@ID</p><p><strong>/OTA\_HotelResNotifRQ/POS/Source/RequestorID</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>  </p><p>Partner ChannelID shared in the Account form by shared Rategain </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p>1 </p><p><br></p>                                                               |
| <p>BookingChannel </p><p><strong>/OTA\_HotelResNotifRQ/POS/Source</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>  </p><p>Booking channel details </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                                                                  |
| <p>@Type  </p><p><strong>/OTA\_HotelResNotifRQ/POS/Source/BookingChannel</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>  </p><p>Always set to “7” </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 1                                                                                  |
| <p>@Primary </p><p><strong>/OTA\_HotelResNotifRQ/POS/Source/BookingChannel</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>  </p><p>Always set to “true” </p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                                  |
| <p>CompanyName </p><p><strong>/OTA\_HotelResNotifRQ/POS/Source/BookingChannel</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>  </p><p>Will contain the name of the OTA. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 1                                                                                  |
| <p>@Code </p><p><strong>/OTA\_HotelResNotifRQ/POS/Source/BookingChannel/CompanyName</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Will contain code for the channel from which RezGain receives the booking. DirectConnect assigns a unique code to each OTA.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>1 </p><p><br></p>                                                               |
| <p>HotelReservations </p><p><strong>/OTA\_HotelResNotifRQ</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Contains the hotel reservations. OTA should send only one reservation in one message.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                                                                  |
| <p>HotelReservation </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Reservation record                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 1                                                                                  |
| <p>   </p><p>@CreateDateTime </p><p><strong>/OTA\_HotelResNotifRQ/Ho</strong> <strong>telReservations/</strong> <strong>HotelReservation</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>Time of Booking </p><p>Date Format: yyyy-mm-ddThh:mm:ssZ </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                                  |
| <p>@LastModifiedDateTime </p><p><strong>/OTA\_HotelResNotifRQ/Ho</strong> <strong>telReservations/</strong> <strong>HotelReservation</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p>Last updated time of booking </p><p><br></p><p>Date Format: yyyy-mm-ddThh:mm:ssZ </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                                                                               |
| <p>@ResStatus </p><p> <strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/</strong> <strong>HotelReserv ation</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>Reservation Status. Since only one reservation record is sent in a message, the ResStatus a the message level and at the reservation level will both be the same. </p><p>To specify the type of action requested. </p><p>Will be one of: </p><p>•       <strong>“Commit” -></strong> <strong>New reservation</strong>  </p><p>•       <strong>“Modify”</strong> -><strong>Modification</strong>  </p><p>•       <strong>“Cancel”</strong> -><strong>Cancellation</strong>  </p>                                                                                                                  | 1                                                                                  |
| <p>RoomStays </p><p><strong>/OTA\_HotelResNotifRQ/Ho</strong> <strong>telReservations/</strong> <strong>HotelReservation</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>  </p><p>Contains RoomStay elements. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                                                                                  |
| <p>RoomStay </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/RoomStays</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>  </p><p>  </p><p>Room stay details. Max occurrences of this field is one. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 1                                                                                  |
| <p>RoomTypes </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/RoomStays /RoomStay</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>  </p><p>  </p><p>Contains Room Type information </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                                                                  |
| <p>RoomType </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/RoomTypes</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p><br></p><p> Contains a Room Type information </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                                                                                  |
| <p>@RoomTypeCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomSta ys/RoomStay/</strong> </p><p><strong>RoomTypes/ RoomType</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>  </p><p>Room type code of this room stay </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 1                                                                                  |
| <p>@NumberOfUnits </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/RoomSta ys/RoomStay/</strong> </p><p><strong>RoomTypes/ RoomType</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>This is the number of rooms booked for the room type listed in the RoomStay.  </p><p>Always set to “1”. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 1                                                                                  |
| <p>  </p><p><a href="https://modelviewers.pilotfishtechnology.com/modelviewers/OTA/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.RoomTypes.RoomType.BedTypeCode.html">@</a><a href="https://modelviewers.pilotfishtechnology.com/modelviewers/OTA/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.RoomTypes.RoomType.BedTypeCode.html">BedTypeCod</a><a href="https://modelviewers.pilotfishtechnology.com/modelviewers/OTA/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.RoomTypes.RoomType.BedTypeCode.html">e</a><a href="https://modelviewers.pilotfishtechnology.com/modelviewers/OTA/model/Format.OTA_DynamicPkgAvailRQ.DynamicPackage.Components.HotelComponent.RoomStays.RoomStay.RoomTypes.RoomType.BedTypeCode.html"> </a></p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/</strong> </p><p><strong>HotelReservation/RoomSta ys/RoomStay/</strong> </p><p><strong>RoomTypes/ RoomType</strong>  </p> | Indicates the type of bed(s) found in the room. Typical values would be Double, Twin, Queen, or King. Refer to OpenTravel Code List Bed Type Code (BED).List of OpenTravel Codes.                                                                                                                                                                                                                                                                                                                                                                                                                   | 0..1                                                                               |
| <p>RoomDescription </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/RoomStays/RoomStay/RoomTypes/Ro omType</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p>  </p><p>Description of the RoomType </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 0..1                                                                               |
| <p>@Name </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/RoomStays/RoomStay/RoomTypes/Ro omType/RoomDescription</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>  </p><p>Name of the RoomType </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                                                                  |
| <p>RatePlans </p><p><strong>/OTA\_HotelRe sNotifRQ/HotelReservations/ HotelReservati</strong></p><p><strong>on/RoomStays /RoomStay</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>  </p><p>Contains RatePlans information </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p><br>1</p>                                                                       |
| <p>RatePlan </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/RatePlans</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>    </p><p>Rate Plan details. Max occurrences of this field is one. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                                                                                  |
| <p>@RatePlanCode </p><p><strong>/OTA\_HotelRe sNotifRQ/HotelReservations/ HotelReservation/RoomStays/RoomStay</strong>  </p><p><strong>/RatePlans/RatePlan</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p>  </p><p>  </p><p>The Rate Plan Code. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                                                                  |
| <p>Commission </p><p><strong>/OTA\_HotelRe sNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay</strong>  </p><p><strong>/RatePlans/RatePlan/Commission</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Contains Commission information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                                  |
| <p>CommissionPayableAmount </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/RoomStays /RoomStay</strong>  </p><p><strong>/RatePlans/RatePlan/Commission/CommissionPayableAmount</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Commission amount details.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                                                                  |
| <p>@Amount </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/RoomStays /RoomStay</strong>  </p><p><strong>/RatePlans/RatePlan/Commission/CommissionPayableAmount</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Commission amount of this RatePlan.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                                                                  |
| <p>@CurrencyCode </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/RoomStays /RoomStay</strong>  </p><p><strong>/RatePlans/RatePlan/Commission/CommissionPayableAmount</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Indicates the currency of the Commission Amount.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                                  |
| <p>MealsIncluded </p><p>   </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay</strong>  </p><p><strong>/RatePlans/RatePlan</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>  </p><p>Used to identify meals that are included. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 0..1                                                                               |
| <p>@Breakfast </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay</strong>  </p><p><strong>/RatePlans/RatePlan/MealsIncluded</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>  </p><p>When true, indicates breakfast is included.                                        </p><p>                                                                         </p>                                                                                                                                                                                                                                                                                                                                                                                                                 | 0..1                                                                               |
| <p>@Lunch </p><p><strong>/OTA\_HotelRe sNotifRQ/HotelReservations/HotelReservati on/RoomStays/RoomStay</strong></p><p><strong>/RatePlans/RatePlan/MealsIncluded</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>                        </p><p>When true, indicates lunch is included </p><p>                                                                         </p>                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                                                                               |
| <p>@Dinner </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay</strong>  </p><p><strong>/RatePlans/RatePlan/MealsIncluded</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>  </p><p>When true, indicates dinner is included.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>  </p><p> 0..1 </p>                                                             |
| <p>RoomRates </p><p><strong>/OTA\_HotelRe sNotifRQ/HotelReservations/HotelReservati on/RoomStays /RoomStay</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Contains RoomRate elements associated with this room stay.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                                                                  |
| <p>RoomRate </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/RoomRates</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>  </p><p>Room Rate </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 1                                                                                  |
| <p>@RoomTypeCode </p><p><strong>/OTA\_HotelRe sNotifRQ/HotelReservations/HotelReservati on/RoomStays/RoomStay/ RoomRates/RoomRate</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>  </p><p>Room type code of this room stay </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 1                                                                                  |
| <p>@NumberOfUnits </p><p><strong>/OTA\_HotelRe sNotifRQ/HotelReservations/HotelReservati on/RoomStays/RoomStay/</strong></p><p><strong>RoomRates/RoomRate</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>This is the number of rooms booked for the room type listed in the RoomTypeCode attribute. We expect only 1 room booking per reservation. </p><p><br></p><p>Always set to “1” </p>                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                                                                  |
| <p>@PromotionVendorCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/</strong>  </p><p><strong>RoomRates/RoomRate</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>  </p><p>vendor codes associated with a promotion.                                 </p><p>                                                                         </p>                                                                                                                                                                                                                                                                                                                                                                                                                          | 0..1                                                                               |
| <p>@RatePlanCode </p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/</strong> </p><p><strong>RoomRates/RoomRate</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Rate type code of this room stay                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                                  |
| <p>Rates </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/RoomStays /RoomStay/</strong></p><p><strong>RoomRates/RoomRate</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>  </p><p>Contains Rate elements </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                                                                                  |
| <p>Rate </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservation/RoomStays /RoomStay/ RoomRates/RoomRate/Rates</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>  </p><p>Rate for each of the Stay Dates </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1..n                                                                               |
| <p>@EffectiveDate </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/RoomStays /RoomStay/ RoomRates/R oomRate/Rate s/Rate</strong>  </p><p>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | The EffectiveDate attribute indicates the start of the date  Range for which this specific rate is applied. A RoomStay could have different rates applied for different stay dates. EffectiveDate and ExpireDate of each rate element together define for which dates of the stay that rate is applicable                                                                                                                                                                                                                                                                                           | <p>  </p><p> 1 </p><p>  </p>                                                       |
| <p>@ExpireDate </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReserv ation/RoomStays/RoomStay/RoomRates/RoomRate/Rates/Rate</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>  </p><p>The ExpireDate attribute indicates the end of the date range for which this specific rate is applied. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p> 1 </p><p><br></p><p><br></p>                                                   |
| <p>Base </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong>  </p><p><strong>HotelReserv ation/RoomStays/RoomStay/RoomRates/RoomRate/Rates/Rate</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p><br></p><p>The base amount charged for the accommodation or service per unit of time </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                                                                                  |
| <p>@CurrencyCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates</strong></p><p><strong>/ RoomRate/Rates/Rate/Base</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>  </p><p>Indicates the currency of the rate. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                                                                                  |
| <p>@AmountBeforeTax </p><p>/@AmountAfterTax </p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/RoomStays/RoomStay/RoomRates/</strong></p><p><strong>RoomRate/Rates/Rate/Base</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p>Base Amount of the room stay. This is the nightly rate amount of a Product for all no. of units (room count) booked in this RoomStay. </p><p>Either AmoutBeforeTax or AmountAfterTax is required. </p>                                                                                                                                                                                                                                                                                                                                                                                           | <p>1 </p><p><br></p>                                                               |
| <p>GuestCounts </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/</strong> </p><p><strong>HotelReservation/RoomSta ys/RoomStay</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Contains the guest counts of the room stay.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                                                                                  |
| <p>  GuestCount </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/RoomStays/RoomStay/GuestCounts</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>Contains the type and number of guests included in the room stay. Will be repeated for each type of guest i.e Adult and Child. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1..2                                                                               |
| <p>@AgeQualifyingCode </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/</strong></p><p><strong>HotelReservati on/RoomStays /RoomStay/</strong> </p><p><strong>GuestCounts/</strong> <strong>GuestCount</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p> DirectConnect supports the following values: </p><p><strong>10 = Adult</strong>  </p><p><strong>8 = Child</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                                                                                  |
| <p>@Count </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/RoomStays</strong></p><p><strong>/RoomStay/GuestCounts/GuestCount</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>  </p><p>Guest Count </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                                                                                  |
| <p>TimeSpan </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati</strong></p><p><strong>on/RoomStays /RoomStay</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | The Time Span which covers the Room Stay. Used to specify a time window range by specifying the earliest and latest date for the start date and end date.                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1                                                                                  |
| <p>@Start </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/RoomStays</strong></p><p><strong>/RoomStay/TimeSpan</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>  </p><p>Check-in date for this room stay.  </p><p>Date format : YYYY-MM-DD </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                                                                  |
| <p>@End </p><p><strong>/OTA\_HotelResNoti fRQ/HotelReservati ons/</strong> <strong>HotelReservation/R oomStays/</strong> </p><p><strong>RoomStay/TimeSpan</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>Check-out date for this room stay </p><p><br></p><p>Date format : YYYY-MM-DD </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                                                                                  |
| <p>Total </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati</strong></p><p><strong>on/RoomStays /RoomStay</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>  </p><p>The total amount charged for the Room Stay </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                                                                                  |
| <p>@CurrencyCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/RoomStays/RoomStay/Total</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p>  </p><p>Indicates the currency of the total </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                                                                                  |
| <p>  </p><p>@AmountBeforeTax </p><p>/@AmountAfterTax </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/RoomStays/RoomStay/Total</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>Total amount of the room stay. </p><p>Either AmoutBeforeTax or AmountAfterTax is required. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 1                                                                                  |
| <p>@Type  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/Total</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p>Type denotes the pricing received for a RoomStay is inclusive or exclusive of partner commission.  The possible values are: </p><p>1.    Net: The actual amount (including room cost/taxes / fees) what Hotel is charged to the Guest. </p><p>2.    Sell: The amount that include Net amount + commission (OTA charge to the hotel for each booking generated through their system) </p>                                                                                                                                                                                                         | <p>1 </p><p><br></p><p>  </p><p><br></p><p>  </p><p><br></p><p><br></p><p><br></p> |
| <p>Taxes </p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/Total</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Contains taxes and surcharges information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 0..1                                                                               |
| <p>Tax </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/Total/Taxes</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>  </p><p>Tax or surcharges information </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                                                                  |
| <p>@CurrencyCode </p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/Total/Taxes/Ta x</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>Currency of the total Amount of Taxes </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                                                                  |
| <p>@ Amount </p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/Total/Taxes/Ta x</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>Amount of the specific tax/fee transferred </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                                                                  |
| <p>BasicPropertyInfo </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/RoomStays /RoomStay/</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Property Information for the reservation. An abbreviated short summary of hotel descriptive information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                                                                  |
| <p>@HotelCode </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/BasicPropertyI nfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p>  </p><p>Hotel Code for this reservation. This code is assigned by OTA. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>1 </p><p><br></p>                                                               |
| <p>@HotelName </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/BasicPropertyI nfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p>  </p><p>The name of the Hotel. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                                                                               |
| <p>Comments </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/ HotelReservati on/RoomStays /RoomStay/</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | A collection of comments                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                                                                               |
| <p>Comment </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/Comments</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | A comment that applies to the room stay. A comment can either be guest-viewable or not.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1..n                                                                               |
| <p>@GuestViewable </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/Comments/Co mment</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | This indicates that the comment can actually be seen by the guest and is necessary when two different types of comments are passed: one which is guest viewable and one that isn’t.                                                                                                                                                                                                                                                                                                                                                                                                                 | 0..1                                                                               |
| <p>Text </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/RoomStays/RoomStay/Comments/Co mment</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>  </p><p>Comment text </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                                                                  |
| <p> ServiceRPHs  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservati on/RoomStays/RoomStay</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | A collection of unsigned integers that reference the RPH (Reference Place holder) attribute in the Service object.    The ServiceRPH attribute in the Service object is an indexing attribute that identifies the services attached to this room stay.                                                                                                                                                                                                                                                                                                                                              | 0..1                                                                               |
| <p>ResGuests </p><p><strong>/OTA\_HotelResNotifRQ/Ho</strong> <strong>telReservations/HotelReservation</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Contains guest information elements. Will always contain at least one element with the primary guest information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 1                                                                                  |
| <p>ResGuest</p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/</strong> <strong>HotelReservation/ResG uests</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>  </p><p>At least one guest-information will be sent. May optionally contain additional guest information. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 1..n                                                                               |
| <p>  </p><p>@AgeQualifyingCode </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/ResGuests/</strong></p><p><strong>ResGuest</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p>DirectConnect supports the following values:  </p><p>10=Adult 8=Child  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                                                                  |
| <p>  </p><p>@PrimaryIndicator </p><p><strong>/OTA\_HotelRes NotifRQ/HotelR eservations/ HotelReservati on/ResGuests/ ResGuest</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Will be true for primary guest. Only one ResGuest element in the ResGuests container will have the value of primary indicator set to true.                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                                                                  |
| <p>Profiles </p><p><strong>/OTA\_HotelRe sNotifRQ/Hote lReservations/ HotelReservati on/ResGuests/ResGuest</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Mandatory for the primary guest and optional for other guests.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                                                                  |
| <p>ProfileInfo </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Only one ProfileInfo element is allowed for each guest                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 1                                                                                  |
| <p> UniqueID  </p><p>   </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/ProfileIn fo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>  </p><p>Used to allow additional ids for matching purposes  </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 0..1                                                                               |
| <p> @Type  </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/UniqueI D</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>The Type attribute refers to OpenTravel Alliance code type UIT and the choices recommended by HTNG should be:  </p><p><strong>1 – Customer 4 – Company 5 –TravelAgency</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                                                                               |
| <p>@ID  </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/UniqueI D</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>             </p><p>The actual ID.  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 0..1                                                                               |
| <p>@IDContext  </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/UniqueI D</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Used to identify the source of the (e.g., identifier IATA, ABTA, Guest loyalty ID).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 0..1                                                                               |
| <p>Profile </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong> <strong>ProfileInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>             </p><p>Contains profile info details used to booked this reservation.          </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                                                                  |
| <p>@ProfileType </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/ProfileIn fo/Profile</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>             </p><p>The Type attribute refers to OTA code type UIT and the choices recommended by HTNG are:  </p><p><strong>1 = Customer</strong>                                               </p><p><strong>18 = Booker</strong>  </p><p><strong>3 = Corporation</strong>  </p><p><strong>4 = Travel Agent</strong>  </p>                                                                                                                                                                                                                                                                     | 1                                                                                  |
| <p>Customer </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong> <strong>ProfileInfo/Profile</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Profile details of a guest. This path is used to transmit the Customer details.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 1                                                                                  |
| <p>PersonName </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong>  </p><p><strong>ProfileInfo/Profile/Customer</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>  </p><p>Name of guest </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                                                                  |
| <p>GivenName </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/ ProfileInfo/Profile/Customer/PersonName</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Person name Part of guest name. This field would be used to pass the guest’s first name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                                                                  |
| <p>SurName </p><p><strong>/OTA\_HotelResNoti fRQ/HotelReservati ons/</strong> </p><p><strong>HotelReservation/R esGuests/ResGuest/Profiles/ProfileInfo/Profile/Customer/Pers onName</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>  </p><p>Surname part of guest name </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                                                                                  |
| <p>Telephone </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/R esGuests/ResGuest/Profiles/</strong> </p><p><strong>ProfileInfo/Profile/Customer</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Guest phone number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 0..1                                                                               |
| <p>@PhoneNumber </p><p>   </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p>    </p><p>The actual phone number </p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 0..1                                                                               |
| <p>@PhoneTechType </p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>The PhoneTechType attribute refers to the OTA PTT code list and indicates which type of number is transmitted (phone vs fax). The 2 codes to be used are: </p><p><strong>1 –Voice</strong>  </p><p> <strong>3 –Fax</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                | 0..1                                                                               |
| <p> @FormattedInd </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>FormattedInd is MANDATORY. If the partner can use Country and Area codes then it should be set to NO. </p><p>If country code and area code are passed then they should not appear again in the Phone Number field. </p><p>If the partner cannot use country and area code then the entire number is passed in the</p><p>PhoneNumber field and FormattedInd it should be set to YES if the number needs to be parsed as</p><p>there is a separation of the different parts or set to  NO to indicate that the phone number field contains the entire phone number without a specific format. </p> | <p>0..1 </p><p><br></p><p><br></p>                                                 |
| <p>@ DefaultInd </p><p>  </p><p><strong>/OTA\_HotelResNoti fRQ/HotelReservations/HotelReservation/R esGuests/ResGuest/Profiles/</strong> </p><p><strong>ProfileInfo/Profile/Customer/Telephone</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | DefaultInd is optional and would indicate whether the phone number is the primary phone number for the profile.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                                                                               |
| <p>Email </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/ ProfileInfo/Profile/Cust omer</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>  </p><p>Guest Email </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 0..1                                                                               |
| <p> @EmailType </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Email</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | The Email Type attribute uses the OTA code lis EAT and indicates the type of email address provided (personal – code 1 vs business – code 2, in the case of the Guest details) and must be passed if more than one email address is passed.                                                                                                                                                                                                                                                                                                                                                         | 0..1                                                                               |
| <p>@DefaultInd </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/</strong></p><p><strong>ResGuests/ResGuest/Profiles/ProfileInfo/Profile/Customer/Email</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>  </p><p>DefaultInd is optional and would indicate whether the email is  the primary email for the profile </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>0..1 </p><p><br></p>                                                            |
| <p>Address </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGues ts/ResGuest/Profiles/ ProfileInfo/Profile/Cust omer</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>    </p><p>Address of the guest </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                                                                               |
| <p>@Type </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>The Type attribute uses the OTA code list CLT and indicates the type of address provided </p><p><strong>1 - Home</strong>  </p><p><strong>2 - Business</strong>  </p><p><strong>3 – Other</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                         | 0..1                                                                               |
| <p>AddressLine </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong> <strong>ProfileInfo/Profile/Customer/Address</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>  </p><p>Will contain 1 to 3 Address lines.  Will contain at least 1 line </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 0..1                                                                               |
| <p>CityName </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>  </p><p>City Name </p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 0..1                                                                               |
| <p>StateProv </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/R esGuests/ResGuest/Profiles/</strong> </p><p><strong>ProfileInfo/Profil e/Customer/Address</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>  </p><p>State Name </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 0..1                                                                               |
| <p>@ StateCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address/StateProv</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | <p>  </p><p> State Code </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 0..1                                                                               |
| <p>PostalCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>  </p><p>Postal Code </p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                                                                               |
| <p>CountryName </p><p><strong>/OTA\_HotelResNoti fRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong> </p><p><strong>ProfileInfo/Profile/Customer/Address</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>  </p><p>Country name </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                                                                               |
| <p>@ Code </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/Customer/Address/CountryName</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>  </p><p>ISO Country code </p><p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 0..1                                                                               |
| <p> CompanyInfo </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGuests/ResGuest/Profiles/ ProfileInfo/Profile</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Company information related to the profile. Detailed information about a company or a travel agent.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p> 0..1 </p><p><br></p>                                                           |
| <p>CompanyName </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGues ts/ResGuest/Profiles/ ProfileInfo/Profile/CompanyInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Detailed name information for the company. Identifies a company by name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 0..1                                                                               |
| <p>TelephoneInfo </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGues ts/ResGuest/Profiles/ ProfileInfo/Profile/CompanyInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>  </p><p>Company phone number </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 0..1                                                                               |
| <p>@PhoneNumber </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGu ests/ResGuest/Profiles/ ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | The actual phone number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                                                                               |
| <p>@PhoneTechType </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>The PhoneTechType attribute refers to the OTA PTT code list and indicates which type of number is transmitted (phone vs fax). The 2 codes to be</p><p>used are: </p><p><strong>1 –Voice</strong>  </p><p><strong>3 –Fax</strong>  </p>                                                                                                                                                                                                                                                                                                                                                           | 0..1                                                                               |
| <p>@FormattedInd </p><p> <strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>FormattedInd is MANDATORY. If the partner can use Country and Area codes then it should be set to NO. </p><p>If country code and area code are passed then they should not appear again in the PhoneNumber field. </p><p>If the partner cannot use country and area code then the entire number is passed in the PhoneNumber field and FormattedInd it should be set to YES if the number needs to be parsed as there is a separation of the different parts or set to NO to indicate that the PhoneNumber field contains the entire phone number without a specific format. </p><p><br></p>     | <p>0..1 </p><p><br></p>                                                            |
| <p>@ DefaultInd </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong></p><p><strong>ProfileInfo/Profile/CompanyInfo/TelephoneInfo</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | DefaultInd is optional and would indicate whether the  phone number is the primary phone number for the profile                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                                                                               |
| <p>Email </p><p><strong>/OTA\_HotelResNoti fRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong> </p><p><strong>ProfileInfo/Profil e/CompanyInfo</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>This element is used to pass the Company or</p><p>Travel Agency’s email </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>0..1 </p><p><br></p>                                                            |
| <p>AddressInfo </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/</strong> </p><p><strong>HotelReservation/ResGues ts/ResGuest/Profiles/ ProfileInfo/Profile/CompanyInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>    </p><p>Address of the guest </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                                                                               |
| <p>AddressLine </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> <strong>HotelReservation/ResGuests/ResGuest/Profiles/</strong> <strong>ProfileInfo/Profile/CompanyInfo/AddressInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>  </p><p>Will contain 1 to 3 Address lines. Will contain at least 1 line </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                                                                               |
| <p>CityName </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/Res</strong></p><p><strong>Guests/ResGuest/Profiles/ProfileInfo/Profile/CompanyInfo/AddressInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <p>                                     </p><p>City Name </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                                                                               |
| <p>StateProv </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong> <strong>ProfileInfo/Profile/CompanyInfo/AddressInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>                                     </p><p>State Name </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                                                                               |
| <p>@ StateCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong> </p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo/StateProv</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>                                     </p><p>State Code </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                                                                               |
| <p>PostalCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong> <strong>ProfileInfo/Profile/CompanyInfo/AddressInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>                                     </p><p>Postal Code </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                                                                               |
| <p>CountryName </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong>  </p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>                                     </p><p>Country name </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                                                                               |
| <p>@ Code </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGuests/ResGuest/Profiles/</strong> </p><p><strong>ProfileInfo/Profile/CompanyInfo/AddressInfo/CountryName</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>                                     </p><p>ISO Country code </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 0..1                                                                               |
| <p> ResGlobalInfo </p><p><strong>/OTA\_HotelResNotifRQ/Ho</strong> <strong>telReservations/</strong> <strong>HotelReservation</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | ResGlobalInfo is a container for various information elements that affect the Reservation as a whole. These include global comments, counts, reservation IDs, loyalty programs, and payment methods.                                                                                                                                                                                                                                                                                                                                                                                                | <p>1 </p><p><br></p>                                                               |
| <p> HotelReservationIDs   </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/</strong> </p><p><strong>HotelReservation/ResG</strong></p><p><strong>lobalInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Contains reservation ID elements. For new reservations, this will only contain OTA confirmation number. For modifications and cancellations, original OTA confirmation numbers will be included.                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                                  |
| <p>HotelReservationID </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/HotelReservationIDs</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>  </p><p>  </p><p>The OTA confirmation number assigned to this booking. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p>1 </p><p><br></p>                                                               |
| <p>  </p><p>@ResID\_Type </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/HotelReservationIDs /HotelReservationID</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>ResID\_Type is assigned values from the UIT code list. </p><p><strong>13 - for the IDS confirmation number</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                                                                                  |
| <p>@ResID\_Value </p><p>   </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/HotelReservationIDs /HotelReservationID</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>ResID\_Value would be the confirmation number of the reservation identified by the ResID\_Type </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                                                                  |
| <p>Comments </p><p><strong>/OTA\_HotelRe sNotifRQ/HotelReservations/HotelReservation/</strong> </p><p><strong>ResGlobalInfo</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | A collection of comments at reservation level.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                                                                               |
| <p>Comment </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ ResGlobalInfo/Comments</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | A comment that applies to the room stay. A comment can either be guest-viewable or not.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 0..1                                                                               |
| <p>@GuestViewable </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/Comments/Comment</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>This indicates that the comment can actually be seen by the guest and is necessary when two different types of comments are passed: one which is guest viewable and one that isn’t. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                 | 0..1                                                                               |
| <p>Text </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation ResGlobalInfo/Comments/Comment</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p>  </p><p>Comment text </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                                                                                  |
| <p>Guarantee </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Associated with the Payment info                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                                  |
| <p>@GuaranteeType </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/Guarantee</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | This is the attribute that indicates what guarantee is provided with the reservation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 1                                                                                  |
| <p>@GuaranteeCode </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/Guarantee</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p>This is the guarantee code. This attribute is optional. The enumerated values can be: </p><p>•       <strong>“None”</strong>  </p><p>•       <strong>"CC / DC / Voucher"</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                                                                  |
| <p>GuaranteesAccepted </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/Guarantee</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | A collection  of  guarantee elements                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 0..1                                                                               |
| <p>GuaranteeAccepted </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> <strong>HotelReservation/ResGlobalInfo/Guarantee/</strong> </p><p><strong>GuaranteesAccepted</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Guarantee detail                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                                                                                  |
| <p>PaymentCard </p><p><strong>/OTA\_HotelRes NotifRQ/HotelReservations/ HotelReservatio n/ResGlobalInf o/Guarantee/ GuaranteesAccepted/Guarantee Accepted/PaymentCard</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Identification about a specific credit card                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                                                                                  |
| <p>@CardType </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGlob alInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/Guar anteeAccepted/PaymentCard</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>Optional field. However if it is used, all of the subelements and attributes listed below will also need to be sent. This is the code of the card used as a guarantee for the booking. CardType uses an OTA list. The only item on the CDT list to be used is number 1 – Credit to indicate we are passing a credit card.</p><p><strong>1=Credit Card</strong>  </p>                                                                                                                                                                                                                             | 1                                                                                  |
| <p>@CardCode </p><p><strong>/OTA\_HotelRes NotifRQ/HotelReservations/ HotelReservatio n/ResGlobalInf o/Guarantee/ GuaranteesAccepted/Guarantee Accepted/PaymentCard</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | The Card code is the 2-letter code indicative of the card (VS, MC, AX etc)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                                                                  |
| <p>@CardNumber </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGlob alInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/Guar anteeAccepted/PaymentCard</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Mandatory if credit card guarantee info is passed. This is actual number of the credit card used as guarantee.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                                                                                  |
| <p>@ExpireDate </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGlob alInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/Guar anteeAccepted/PaymentCard</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p>Mandatory if credit card guarantee info is passed. This is expiry date of the credit card used as guarantee. Format MMYY,</p><p>e.g. ExpireDate="1010" </p><p><br></p><p>Date Format: MMYY </p>                                                                                                                                                                                                                                                                                                                                                                                                  | 1                                                                                  |
| <p>CardHolderName </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGlob alInfo/Guarantee/</strong></p><p><strong>GuaranteesAccepted/Guar anteeAccepted/PaymentCard</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | This is the name of the card holder.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                                                                                  |
| <p>SpecialRequests </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Contains SpecialRequest elements. The collection of all special requests associated with any part of the reservation (the reservation in its entirety, one or more guests, or one or more room stays). Which special requests belong to which part is determined by each object's SpecialRequestRPHs collection.                                                                                                                                                                                                                                                                                    | 0..1                                                                               |
| <p>SpecialRequest </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/SpecislRequests</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | If SpecialRequests element is present, at least 1 SpecialRequest must be present.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 1                                                                                  |
| <p>@RequestCode </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGlob</strong> <strong>alInfo/SpecislRequests/</strong> </p><p><strong>SpecialRequest</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>  </p><p>Any specific code can be passed for a request type. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 0..1                                                                               |
| <p>Text </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/SpecislRequests /SpecialRequest</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Contains the text of the Special Request                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                                                                  |
| <p> TimeSpan </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/</strong> <strong>HotelReservation/ResG lobalInfo/</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The Time Span which covers the Room Stay. Used to specify a time window range by either specifying the earliest and latest date for the start date and end date or by giving a date with a time period that can be applied before and/or after the start date.                                                                                                                                                                                                                                                                                                                                      | <p>1 </p><p><br></p>                                                               |
| <p>@Start </p><p><br></p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/TimeSpan</strong> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>Check-in date for this room stay </p><p><br></p><p>Date format : YYYY-MM-DD </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 1                                                                                  |
| <p>@End </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGloba lInfo/TimeSpan</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <p>Check-out date for  this  room stay </p><p><br></p><p>Date format : YYYY-MM-DD </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Y                                                                                  |
| <p>@Duration </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGloba lInfo/TimeSpan</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <p>                                   </p><p>Total night stay of the  Reservation. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <p><br> 1  </p>                                                                    |
| <p>Total </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | The total amount charged for the Room Stay                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                                                                  |
| <p>@CurrencyCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/Total</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <p>  </p><p>Indicates the currency of the total </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                                                                                  |
| <p>@AmountBeforeTax / @AmountAfterTax </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> <strong>HotelReservation/ResGlobalInfo/Total</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Either  AmountBeforeTax      or AmountAfterTax required                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                                                                                  |
| <p>@Type  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/RoomStays/RoomStay/Total</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p>Type denotes the pricing received for a reservation is inclusive or exclusive of partner commission.  The possible values are: </p><p>1.    Net: The actual amount (including room cost / taxes / fees)  what guest is paying to the hotel.  </p><p>2.    Sell: The amount that include Net amount + commission (OTA charge to the hotel for each booking generated through their system) what guest is paying to the hotel. </p>                                                                                                                                                                | <p>1 </p><p>   </p>                                                                |
| <p>BookingRules  </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/HotelReservation/ResGlobalInfo/</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Contains booking rules information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 0..1                                                                               |
| <p>BookingRule  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/BookingRules</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Booking rules information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 1                                                                                  |
| <p>AcceptableGuarantees  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/BookingRules/ BookingRule</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Contains acceptable guarantee details.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p><br>1</p>                                                                       |
| <p>AcceptableGuarantee  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong>  <strong>HotelReservation/ResGlobalInfo/ BookingRules/BookingRule/AcceptableGuarantees</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Acceptable guarantee information.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 1                                                                                  |
| <p>@PaymentType  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/ResGlobalInfo/BookingRules/ BookingRule/ AcceptableGuarantees/</strong>  </p><p>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>It denotes where amount is paid. It has following values:</p><p>1. Prepaid  </p><p>2. PayAtHotel </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 1                                                                                  |
| <p>  </p><p>TPA\_Extensions </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> <strong>HotelReservation/</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>  </p><p>A placeholder in the schema to allow for additional elements and attributes to be included per Trading Partner Agreement (TPA) </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 0..1                                                                               |
| <p>  </p><p>SourceofBusinesss  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/TPA\_Extensions</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | This value is the reservation’s Market Source Code. If there is no Market Source Code, the reservation’s Primary Channel Code is used.                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <p><br>0..1</p>                                                                    |
| <p>@PrimaryCode </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/TPA\_Extensions/SourceOfBusiness</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>This value is the Control Center code for the reservation’s Primary Channel. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p><br>0..1</p>                                                                    |
| <p>@PrimarID </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/Ho telReservations/</strong> <strong>HotelReservation/TPA\_Extensions</strong>  </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | This value is the Control Center ID for the reservation’s Primary Channel.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <p><br>0..1</p>                                                                    |
| <p>@SecondaryCode </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/TPA\_Extensions/SourceOfBusiness</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>This value is the Control Center code for the reservation’s Secondary Channel. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <p>0..1<br></p>                                                                    |
| <p><strong>@</strong>SecondaryID </p><p><strong>OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/TPA\_Extensions/SourceOfBusiness</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | This value is the Control Center ID for the reservation’s Secondary Channel.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p><br>0..1</p>                                                                    |
| <p>@SubSourceCode </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/TPA\_Extensions/SourceOfBusiness</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p>This value is the Control Center ID for the reservation’s Sub Channel. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 0..1                                                                               |
| <p>@SubSourceID </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/TPA\_Extensions/SourceOfBusiness</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <p>This value is the Control Center ID for the reservation’s Sub Channel. </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 0..1                                                                               |
| <p>@MarketSourceCode </p><p>  </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/HotelReservation/TPA\_Extensions/SourceOfBusiness</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | <p>  </p><p>The source of the market that applies to the business </p><p> </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                                                                               |
| <p>  MarketSegmentCode </p><p><strong>/OTA\_HotelResNotifRQ/HotelReservations/</strong> </p><p><strong>HotelReservation/TPA\_Extensions/SourceOfBusiness</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | This is only added if a reservation has a market segment assigned. This value is the reservation’s leisure or business Market Segment Code. If there is no Market Segment Code, the reservation’s Primary Channel Code is used.                                                                                                                                                                                                                                                                                                                                                                     | 0..1                                                                               |

&#x20;  &#x20;

&#x20;&#x20;


# OTA\_HotelResNotifRS

| <p><strong>Element/@Attribute</strong> </p><p><strong>Parent XPath</strong> </p> | <p>  </p><p><strong>Description</strong> </p>                                                                                                        | **Mandatory** |
| -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| <p>@TimeStamp </p><p><strong>/OTA\_HotelResNotifRS</strong>  </p>                | <p>  </p><p>Response Time Stamp </p>                                                                                                                 | Y             |
| <p>@Version </p><p><strong>/OTA\_HotelResNotifRS</strong>  </p>                  | <p>  </p><p>Mandatory </p>                                                                                                                           | Y             |
| <p>Success / Errors </p><p><strong>/OTA\_HotelResNotifRS</strong>  </p>          | Either Success / Error element must be present                                                                                                       | Y             |
| <p>Error </p><p><strong>/OTA\_HotelResNotifRS/Errors</strong>  </p>              | <p>  </p><p>Response will include as many Errors as required. At least one Error element must be present if the response</p><p>contains Errors. </p> | N             |
| <p>@Type </p><p><strong>/OTA\_HotelResNotifRS/Errors/Error</strong> </p>         | <p>Error Type.  </p><p>This is always set to “3” </p>                                                                                                | N             |
| <p>@Code </p><p><strong>/OTA\_HotelResNotifRS/Errors/Error</strong>  </p>        | <p>Error code.  </p><p>This is always set to “400” </p>                                                                                              | N             |
| <p>@ShortText </p><p><strong>/OTA\_HotelResNotifRS/Errors/Error</strong>  </p>   | <p>  </p><p>Free Text </p>                                                                                                                           | N             |
| <p>@Status </p><p><strong>/OTA\_HotelResNotifRS/Errors/Error</strong>  </p>      | Will be set to the string “Failed”                                                                                                                   | N             |




---

[Next Page](/llms-full.txt/1)