RoomMaster Inside Availability Data Formats
Galileo International
MULTIPLE CURRENCY HOC
Data Formats
For HRS That Has Implemented Triples and Quads
March 9, 2005
DRAFT
COPY
ONLY
Galileo International Confidential
CONTENTSPAGE
DOCUMENT REVISION HISTORY2
PURPOSE3
GENERAL NOTES3
HOC - HOTEL COMPLETE AVAILABILITY REQUEST (GDS TO HRS)4
HOC - HOTEL COMPLETE AVAILABILITY RESPONSE (HRS TO GDS)6
DOCUMENT REVISION HISTORY
Date / Page(s) / Updates9 Mar 2005 / Created specifically for Multiple Currencies
PURPOSE
This document details the changes to the data records passed between Galileo International Global Distribution System (GDS) and a Hotel Reservation System (HRS). These formats presume that the HRS has already implemented the Inside Availability product.
These changes are to upgrade the Galileo hotel requests and the HRS responses to verify that accommodations exist and quoted rates are for more than 2 people in a room.
GENERAL NOTES
Unless otherwise indicated, EBCDIC Hex values are listed for text characters. In some instances a different special character may be sent due to Communications software translation issues. The end-item character (Cross-of-Lorraine or vertical bar) has EBCIDIC value hex 4F. It translates to ASCII value 5C or the backslash (\).
Use 3 character currency codes when displaying values in text (e.g. 30.00 USD). Avoid imbedded $'s.
Header Information has fixed length data fields. Specific Information has variable length data fields. Maximum length of variable length fields is provided. Variable length fields may have less information than the guideline.
On subsequent pages, the field types are:
Field Type / Definition GDS to HRS / Definition HRS to GDSM - Mandatory / Field sent in every request. / Field must be returned or processing will error.
R - Required / N/A / Field contains required data, however processing will complete if not supplied.
A - Applicable / Field sent when information is available or if it applies to the request. / Field returned when information is available or if it applies to the request.
HOC - HOTEL COMPLETE AVAILABILITY REQUEST (GDS TO HRS)
Specific Data (Variable):
The format for each field is Length (2 bytes), ID (2 bytes), and Data (variable length). "MS" must appear after the Specific Data Count in the fixed header section. Other fields are expected in the following order.
MaxField
LengthTypeIDData
5MMSAction Code
"HOC" - Hotel Complete Availability Request
3MBDDestination System (Same as HRS in Header)
5MPNProperty Number
3ACTAgent's City Code
2ACOAgent's ISO Country Code
19ABSBooking Source (ARC/IATA Number)
5MINIn-Date
5MOTOut-Date
1MNONumber of Adults
25ACDCorporate Discount Number (Max 3)[1]
7ARRRate Requested/Booking Code (Max 8)[2]
30AMIMore Information Storage[3]
3MCCCurrency Code Requested[4]
1RMCMultiple Currency Codes can be returned to the subscriber
Y = Multiple currency codes are acceptable
N = Do not respond with multiple currencies
MaxField
LengthTypeIDData
23ASQSearch Qualifiers (Max 15)[5]
HOC - HOTEL COMPLETE AVAILABILITY RESPONSE (HRS TO GDS)
Specific Data (Variable):
The format for each field is Length (2 bytes), ID (2 bytes), and Data (variable length). "MS" must appear after the Specific Data Count in the fixed header section. Other fields are expected in the following order.
MaxField
LengthTypeIDData
5MMSAction Code
"HOCER" - HOC Availability Returned
2MVRVersion number for the HOC response(must be version ‘00’)
30N/AMIMore Information Storage[6]
3MCCCurrency Code for Rates
1MDPDecimal Places for Rates (Values are 0-3.)
1ANONumber of Adults Allowed for Quoted Rates
36AMMMarketing Message
Rate item fields may occur multiple times and must appear in this order:
7MRRRate Requested Code (Must be an alphanumeric Booking Code.)
3ACCCurrency Code for Rates. This is not a new field. It has been repeated
to allow a different currency for each rate.
1ADPDecimal Places for this currency (Values are 0-3.) This is not a new field.
It has been repeated to allow a different currency for each rate.
9MRERate Amount (Does not include decimal, i.e. "05RE19500".)
8ABIBooking Code Indicators:
Char 1 - Rate Changes during Stay (Y/N)
Char 2 - Rate Available via I.A. Only (Y/N)
Char 3 - Invalid CD # Stored in RoomMaster (Y/N)
Char 4 -6 - Spares
Char 7 - Room Type on Request
Char 8 - Spare
25ACDCorporate ID number (Max 1)[7]
47MRDRate Description (Max 3)
1
Galileo International Confidential
[1] The format of the "CD" field is the CD number or SI data (max 15 chars, stored in the RoomMaster database, corresponding to the RoomMaster rate access code), a single delimiter character, and the agent-entered RoomMaster rate access code (max 6 chars). Blanks are removed from CD/SI information, i.e. "11CDN12345@AMEX" or "19CDAMERICANEXPRES@AMEX". If the HRS receives a "CD" field, it is expected to return the field intact to the GDS with the HOC response.
[2]Requests for multi-level rates, those associated with a rate access code, are an exception. Only the corresponding booking codes in the RoomMaster database (if any exist) are sent. Regular booking codes are not sent. On a reference HOC, if multiple requested rate access codes share the exact same room codes (i.e. A1KAMX and A1KHIC exist), only one will be sent. Order depends on the first rate access code stored in the RoomMaster database.
[3] The "MI" field is available for HOC processing. The HRS may use this field to store information for sending multiple blocks of data between the HRS and GDS. If the HRS sends an "MI" field to the GDS in the HOC Response, the GDS will build another Request block. The "MI" field will be returned in the Request as it was sent in the Response. "RR" fields will not be sent in subsequent Requests since the RoomMaster database is bypassed.
[4] The "CC" field in the Request contains the currency code attached to the property in the RoomMaster database. With a referenced HOC Request, if the agent specifies a different currency in the previous HOA entry (i.e. >HOA/$GBP), the requested currency code will be sent. Variations of the HOC entry offer currency conversion by the GDS. Rates provided in text information are not converted by the GDS.
[5] The format of the "SQ" field is a 2-character Item Identifier, a 2-character Item Priority, and a maximum 19 characters of data.
[6] The "MI" field is available for HOC processing. The HRS may use this field to store information for sending multiple blocks of data between the HRS and GDS. If the HRS sends an "MI" field to the GDS in the HOC Response, the GDS will build another Request block. The "MI" field will be returned in the Request as it was sent in the Response. "RR" fields will not be sent in subsequent Requests since the RoomMaster database is bypassed.
[7] The format of the "CD" field is the CD number or SI data (max 15 chars, stored in the RoomMaster database, corresponding to the RoomMaster rate access code), a single delimiter character, and the agent-entered RoomMaster rate access code (max 6 chars). Blanks are removed from CD/SI information, i.e. "11CDN12345@AMEX" or "19CDAMERICANEXPRES@AMEX". If the HRS receives a "CD" field, it is expected to return the field intact to the GDS with the HOC response.