Page Comparison

Element | @Attribute

Num

Description/Contents

Origin | Value

OTA_HotelInvBlockNotifRQ  

 1  

Root element of the message.  

@EchoToken  

 0..1  

Unique number for every transaction

@TimeStamp  

 1  

Time of the transaction.

Time the message was assembled

@Version  

 1  

 Version is a mandatory attribute in OTA; therefore, it must remain Mandatory in HTNG to be able to use the same message.

4.000  

OTA_HotelInvBlockNotifRQ / InvBlocks/

 1  

At least one InvBlocks containing one InvBlock element should be sent for the message to have meaning.

OTA_HotelInvBlockNotifRQ  / InvBlocks / InvBlock

 1…n  

At least one InvBlock element should be sent for the message to have meaning. For multiple sub block or attendee types, this could be repeated.

 @InvBlockStatusCode  

 0..1  

Refers to OTA IBS and indicates the status of the block (such as Tentative, Definite, etc.).

“2”  

@InvBlockCode  

 1  

String to identify the Block as a code using the Group system code convention.

@InvBlockLongName  

 0..1  

 This is the full name of the inventory block.  

Group name  

@TransactionAction  

 1  

 Enumerated list that describes the action associated to the message. Used to set a new block, modify, cancel, or other action as per enumerated list to be agreed between partners.  

"create", "modify", "cancel", “release” depending on Transaction Sub-Type  

OTA_HotelInvBlockNotifRQ  / InvBlocks / InvBlock / HotelRef

 1  

Not mandatory in OTA but is Mandatory in the HTNG recommendation. This is the element containing the code of the property whose inventory blocks are being updated.

@HotelCode  

 1  

Not mandatory in OTA but is Mandatory in the HTNG recommendation. This is the code of the property whose inventory blocks are being updated.

OTA_HotelInvBlockNotifRQ  / InvBlocks / InvBlock / InvBlockDates  

 1  

@Start  

 1  

Not mandatory in OTA but is Mandatory in the HTNG recommendation. This is the first day for which the inventory block update is being sent.

Arrival Date  

@End  

 1  

Not mandatory in OTA but is Mandatory in the HTNG recommendation. This represent the last date for which the inventory block update is being sent.

Departure Date  

@AbsoluteCutoff  

 0..1  

Used to determine when the inventory block is released back into house inventory.

Cutoff Date  

OTA_HotelInvBlockNotifRQ / InvBlocks / InvBlock / RoomTypes / RoomType

 1...n  

Should be repeated for each room type that is part of the block as it will also contain allocations and rates for the specific room type.

One for each Room Type in the transaction  

@RoomTypeCode  

 1  

Mandatory. Room type codes of each room type used as part of the block.  

OTA_HotelInvBlockNotifRQ  / InvBlocks / InvBlock /
RoomTypes / RoomType / RoomTypeAllocations

 0..n  

@RoomTypePickUpStatus

 0..1  

Ability to specify Inventory Count Type. (i.e. 1 Physical, 2 Definitive availability, 3 Tentative availability, 4 Definite sold, 5 Tentative sold)

OTA_HotelInvBlockNotifRQ / InvBlocks / InvBlock / RoomTypes / RoomType / RoomTypeAllocations / RoomTypeAllocation

 0..n  

One element for each unique combination of allocation, which will be consolidated over the larges possible range of consecutive dates.

@Start  

 0..1  

Used in conjunction with END to determine different number of rooms of a specific type for different dates.

For this room type for the first day of the range.

@End  

 0..1  

Used in conjunction with START to determine different number of rooms of a specific type for different dates.

For this room type for the last day of the range.  

@NumberOfUnits  

 1  

Mandatory. Number of units of a specific type that are allocated as part of the inventory block. Comments have been submitted to Open Travel to allow 0 in this field.

(Blocked) for this room type. Same for all days in the range.

@CompRoomQuantity & @CompRoomFactor

 0..1  

Used to indicate whether a certain number of rooms are allocated as complimentary and whether they are subject to a certain number of rooms being booked first.  

OTA_HotelInvBlockNotifRQ /InvBlocks/InvBlock / RoomTypes / RoomType / RatePlans / RatePlan

 0..1  

@RatePlanCode  

 1  

Mandatory. Rate plan used for the inventory block. If no further rate information is included, the rate plan code refers to rate plan information already passed using the OTA_HotelRatePlanNotifRQ message.

@CurrencyCode  

 0..1  

This is the currency associated to the rate assigned to the block– it could be different to the currency loaded for the property.

OTA_HotelInvBlockNotifRQ / InvBlocks / InvBlock / RoomTypes / RoomType / RatePlans / RatePlanBaseByGuestAmnts

 0..1  

OTA_HotelInvBlockNotifRQ / InvBlocks / InvBlock / RoomTypes / RoomType / RatePlans / RatePlanBaseByGuestAmnts / BaseByGuestAmt  

 1..n  

Conditionally Mandatory. AT LEAST 1 INSTANCE FOR NUMBEROFGUESTS=1 is Mandatory if the rate information is being defined in the message. Must be repeated for all different type of occupancies of the specific room. We recommend that for varying rates by occupant should be implemented like this.

@NumberOfGuests

 1  

The NumberOfGuest Attribute indicates what type of rate is being passed – if NumberOfGuests is = 1 then we are transmitting a single rate, if higher than 1 then it is a double or full occupancy rate.

@AmountBeforeTax or @AmountAfterTax  

 1  

Either @AmountBeforeTax or @AmountAfterTax is Mandatory for each @NumberOfGuests.
Partners must select whether to send
either the @AmountBeforeTax or
@AmountAfterTax (or both) attributes.

OTA_HotelInvBlockNotifRQ / InvBlocks / InvBlock / RoomTypes / RoomType / RatePlans / RatePlan / AdditionalGuestAmounts / AdditionalGuestAmount

 0..n  

Used to transfer extra adult and extra child amount.  

@AgeQualifyingCode

 0..1  

 AgeQualifyingCode - 8 = child, 10 = adult.  

@Percent OR @Amount  

 0..1  

This is the percentage of the single rate that represents the child rate. Could also be expressed as fixed amount.

OTA_HotelInvBlockNotifRQ / InvBlocks / InvBlock / MethodInfo

 0..1  

@BillingType  

 0..1  

BillingType is used to indicate charges to be billed to master account (enumeration).

@SignFoodAndBev  

 0..1  

SignFoodAndBev is a Boolean to indicate whether food and drinks should be billed to master account.

@ReservationMethodCode  

 0..1  

ReservationMethodCode indicates the method by which reservations are received.

OTA_HotelInvBlockNotifRQ / InvBlocks / InvBlock / BlockDescriptions / BlockDescription

 0…9  

OTA_HotelInvBlockNotifRQ / InvBlocks / InvBlock / BlockDescriptions / BlockDescription / Text

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact

 1…9  

This element and its sub-elements can be repeated to include all contact information needed. It is down to implementing partners to agree which contacts would be captured by either system and which contacts should indeed be exchanged. At the very least the Group Organizer
details should be transferred.

Not mapped 

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / PersonName

 0..1  

This element and sub-elements will be sent to transfer the name of contacts that are “INDIVIDUAL”. To transfer COMPANY/TA details, the OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / CompanyName path should be used as highlighted below.

OTA_HotelInvBlockNotifRQ  / InvBlocks / Contacts / Contact / PersonName / NamePrefix  

 0..1   

Optional but should be highly recommended by HTNG that partners use it if possible. This path is used to transmit the Contact’s details. This field would be used to pass the contact’s name Prefix.

 OTA_HotelInvBlockNotifRQ OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / PersonName / GivenName  

 0..1  

This field would be used to pass the contact’s First name.  

 OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts /  

 contact’s First name.  

 ContactContact / PersonName / Given  

 Name  

 OTA_HotelInvBlockNotifRQ MiddleName  

 0..1  

This field would be used to pass the

 contact’s Middle name.

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts /  

 contact’s Middle name.  

 Contact Contact / PersonName / Surname     

 MiddleName  

 OTA_HotelInvBlockNotifRQ  

 1  

If a contact is passed then at least

 /InvBlocks/Contacts/  

 Surname Surname must be passed. This field would 

 Contact /PersonName/  

 be would be used to pass the contact’s Surname.  

 Surname  

 OTA_HotelInvBlockNotifRQ  

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / CompanyName

 0..1  

This element and attributes will be sent to

 /InvBlocks/Contacts/  

 transfer the name of contacts that are  

 Contact/CompanyName  

 “Organizations”. To  

are “Organizations”. To transfer individual details, the

OTA_HotelInvBlockNotifRQ / InvBlocks /

Contacts / Contact / PersonName path

should be used as highlighted above.

 @CompanyShortName @CompanyShortName  

 0..1  

Used to provide the Company common

 namename.  

 @Code @Code  

 0..1  

Identifies the company by the company

 codecode.  

 @CodeContext @CodeContext  

 0..1  

Identifies the context of the identifying

code, such as DUNS, IATA, or

internal code, SIC, etc.

 OTA

OTA_HotelInvBlockNotifRQ  / InvBlocks / Contacts / Contact / Telephone

 0..5  

This field would be used to pass the

 /InvBlocks/ Contacts/  

 contact’s phone number contact’s phone number and fax numbers.   

@PhoneLocationType

 Contact/Telephone  

 @PhoneLocationType  @PhoneTechType
@CountryAccessCode
@Area City Code
@DefaultInd

 0  

The PhoneLocationType attribute refers to

 @PhoneTechType  

 the the OTA PLT code list and indicates  

 @CountryAccessCode  

 where where the phone number is based – the  

 @Area City Code  

 two two codes to be used by HTNG are code  

 @DefaultInd  

 7 – Home 7 – Home and code 8 – Office.  

The PhoneTechType attribute refers to

the OTA PTT code list, and indicates

which type of number is transmitted

(phone versus fax). The two codes to be

used by HTNG are code 1 –Voice and

code 3 – Fax. 5-Mobile

CountryAccessCode and Area City Code

should be Optional.

If country code and area code are passed then they should not appear again in the

PhoneNumber field.

DeafultInd is Optional and would indicate

whether the phone number is the primary

phone number for the profile.

@Phone Number

@FormattedInd

 1  

PhoneNumber contains the actual  as a string of max 32 characters and it is Mandatory. FormattedInd is Mandatory. If the partner can use Country and Area codes then
formattedInd would be set to NO. If the partner cannot use country and area code then 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 filed contains the entire phone number without a specific format.

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / Email

 0..1  

Optional. This field would be used to pass the contact’s email address.

@EmailType

@DefaultInd

 0..1  

The Email Type attribute uses the OTA code list EAT and indicates the type of email address provided (personal – code 1 versus 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 it can be
Optional. DeafultInd is Optional and would indicate
whether the email is the primary email for the profile.

OTA_HotelInvBlockNotifRQ /InvBlocks/Contacts/ Contact/Address

 0..1  

If a contact is passed then at least one address must be passed. This field would be used to pass the contact’s mail address.

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / Address / AddressLine  

 0..5  

This field would be used to pass the contact’s address. More than one line can be sent.

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / Address / CityName

 0..1  

This field would be used to pass the contact’s city.  

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / Address / StateProv

@StateCode  

 0..1  

This field would be used to pass the contact’s State expressed in the Standard 2-8 characters code.

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / Address / PostalCode

 0..1  

This field would be used to pass the  contact’s Postal/ZIP code.  

OTA_HotelInvBlockNotifRQ / InvBlocks / Contacts / Contact / Address / CountryName

@Code

 0..1

Optional. This field would be used to pass the contact’s Country expressed in the Standard ISO 3166 code.