# 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 #### 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. | |

Message

Size

| 2 MB | Maximum size for a single message must not exceed 2 MB. | ### Supported Restrictions and Occupancies | **Channel Manager Attribute** | **Attribute Type** | **Data Type** |

XML

Attribute

| **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 |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A1"

| Nightly rates of pax=\[1Adult] for given room-rate combination | | 2Adult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A2"

| Nightly rates of pax=\[2Adult] for given room-rate combination | | 3Adult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A3"

| Nightly rates of pax=\[3Adult] for given room-rate combination | | 4Adult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A4"

| Nightly rates of pax=\[4Adult] for given room-rate combination | | 5Adult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A5"

| Nightly rates of pax=\[5Adult] for given room-rate | | 6Adult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A6"

| Nightly rates of pax=\[6Adult] for given room-rate combination | | 7Adult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A7"

| Nightly rates of pax=\[7Adult] for given room-rate combination | | 8Adult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A8"

| Nightly rates of pax=\[8Adult] for given room-rate combination | | 9Adult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A9"

| Nightly rates of pax=\[9Adult] for given room-rate combination | | 10Adult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="A10"

| Nightly rates of pax=\[10Adult] for given room-rate combination | | 1Child |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="C1"

| Nightly rates of pax=\[1Child] for given room-rate combination | | 2Child |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="C2"

| Nightly rates of pax=\[2Child] for given room-rate combination | | 3Child | Occupancy based Pricing (OPB) | Decimal |

Base Amount

OccupancyCode="C3"

| Nightly rates of pax=\[3Child] for given room-rate combination | | 4Child |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="C4"

| Nightly rates of pax=\[4Child] for given room-rate combination | | 5Child |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="C5"

| Nightly rates of pax=\[5Child] for given room-rate combination | | AdditionalAdult / ExtraAdult |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="AA"

| Nightly rates of pax=\[AdditionalAdult] for given room-rate combination | | AdditionaChild / ExtraChild |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="AC"

| Nightly rates of pax=\[AdditionalAdult] for given room-rate combination | | RoomPrice |

Occupancy based Pricing

(OPB)

| Decimal |

Base Amount

OccupancyCode="SR"

| Nightly rates of complete room for given room-rate combination |