Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

When a hotel system sends out a status message to notify other systems of the availability at the property, the Status Application Control uses the Inventory Block codes to determine the status of availability for the block.
The <OTA_HotelInvBlockNotifRS> returns a response to the Hotel Inventory Block Notification, indicating that the message was successfully processed. 

Business Rules

  • The RatePlanCode will be automatically created in the CRS for use with the block. Any rate plan codes specified by the PMS are ignored.If a RatePlanCode is provided, that rate code must already exist in the CRS in order for it to post along with the group. If the provided RatePlanCode is not already created in the CRS, this will be ignored and an auto generated RatePlanCode will be used instead. This rate code will be G:InvBlockCode. Example using sample provided below - G:30010000087

  • If a RatePlanCode is provided and does pre-exist in the CRS, any rate amounts sent along with the block request will be ignored and the rate amounts already posted for that RatePlanCode will be in effect for the group. If there are no rate amounts found on that rate plan for the dates of the block, then this will mean the group cannot be booked.

  • If a RatePlanCode is not provided but rate amounts are included, a RatePlanCode will be auto generated. This rate code will be G:InvBlockCode. Example using sample provided below - G:30010000087

  • A Group block cannot be cancelled (deleted) once reservations have been made against it.

...

Code Block
languagexml
<OTA_HotelInvBlockNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLXSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelInvBlockNotifRQ.xsd" Version="4.000" TimeStamp="2010-12-23T12:53:54.19">
	<InvBlocks>
		<InvBlock InvBlockStatusCode="2" TransactionAction="Book" InvBlockCode="30010000087" InvBlockLongName="CONFERENCE CHRISTMAS 2010">
			<HotelRef HotelCode="16886"/>
			<InvBlockDates Start="2010-12-23" End="2010-12-25" AbsoluteCutOff="2010-12-22"/>
			<RoomTypes>
				<RoomType RoomTypeCode="CSUITE">
					<RoomTypeAllocations RoomTypePickUpStatus="1">
						<RoomTypeAllocation Start="2010-12-23" End="2010-12-25" NumberOfUnits="1" SellLimit="1"/>
					</RoomTypeAllocations>
					<RatePlans>
						<RatePlan Start="2010-12-23" End="2010-12-25" CurrencyCode="USD" RatePlanCode="30010000087">
							<BaseByGuestAmts>
								<BaseByGuestAmt AmountBeforeTax="300.00" NumberOfGuests="1" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="300.00" NumberOfGuests="2" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="300.00" NumberOfGuests="3" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="300.00" NumberOfGuests="4" AgeQualifyingCode="10"/>
							</BaseByGuestAmts>
							<AdditionalGuestAmounts>
								<AdditionalGuestAmount AgeQualifyingCode="10" Amount="100.00"/>
								<AdditionalGuestAmount AgeQualifyingCode="8" Amount="20.00"/>
							</AdditionalGuestAmounts>
						</RatePlan>
					</RatePlans>
				</RoomType>
				<RoomType RoomTypeCode="KING">
					<RoomTypeAllocations RoomTypePickUpStatus="1">
						<RoomTypeAllocation Start="2010-12-23" End="2010-12-25" NumberOfUnits="2" SellLimit="2"/>
					</RoomTypeAllocations>
					<RatePlans>
						<RatePlan Start="2010-12-23" End="2010-12-25" CurrencyCode="USD" RateTier="1" RatePlanCode="30010000087">
							<BaseByGuestAmts>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="1" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="2" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="3" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="4" AgeQualifyingCode="10"/>
							</BaseByGuestAmts>
							<AdditionalGuestAmounts>
								<AdditionalGuestAmount AgeQualifyingCode="10" Amount="20.00"/>
								<AdditionalGuestAmount AgeQualifyingCode="8" Amount="10.00"/>
							</AdditionalGuestAmounts>
						</RatePlan>
					</RatePlans>
				</RoomType>
				<RoomType RoomTypeCode="KN">
					<RoomTypeAllocations RoomTypePickUpStatus="1">
						<RoomTypeAllocation Start="2010-12-23" End="2010-12-25" NumberOfUnits="2" SellLimit="2"/>
					</RoomTypeAllocations>
					<RatePlans>
						<RatePlan Start="2010-12-23" End="2010-12-25" CurrencyCode="USD" RateTier="1" RatePlanCode="30010000087">
							<BaseByGuestAmts>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="1" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="2" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="3" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="4" AgeQualifyingCode="10"/>
							</BaseByGuestAmts>
							<AdditionalGuestAmounts>
								<AdditionalGuestAmount AgeQualifyingCode="10" Amount="20.00"/>
								<AdditionalGuestAmount AgeQualifyingCode="8" Amount="10.00"/>
							</AdditionalGuestAmounts>
						</RatePlan>
					</RatePlans>
				</RoomType>
				<RoomType RoomTypeCode="QQPRM">
					<RoomTypeAllocations RoomTypePickUpStatus="1">
						<RoomTypeAllocation Start="2010-12-23" End="2010-12-25" NumberOfUnits="2" SellLimit="2"/>
					</RoomTypeAllocations>
					<RatePlans>
						<RatePlan Start="2010-12-23" End="2010-12-25" CurrencyCode="USD" RateTier="1" RatePlanCode="30010000087">
							<BaseByGuestAmts>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="1" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="2" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="3" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="4" AgeQualifyingCode="10"/>
							</BaseByGuestAmts>
							<AdditionalGuestAmounts>
								<AdditionalGuestAmount AgeQualifyingCode="10" Amount="20.00"/>
								<AdditionalGuestAmount AgeQualifyingCode="8" Amount="10.00"/>
							</AdditionalGuestAmounts>
						</RatePlan>
					</RatePlans>
				</RoomType>
				<RoomType RoomTypeCode="QUEEN">
					<RoomTypeAllocations RoomTypePickUpStatus="1">NumberOfUnits="2" SellLimit="2"/>
						<RoomTypeAllocation Start="2010-12-23" End="2010-12-25"</RoomTypeAllocations>
					<RatePlans>
						<RatePlan Start="2010-12-23" End="2010-12-25" CurrencyCode="USD" RateTier="1" RatePlanCode="30010000087">
							<BaseByGuestAmts>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="1" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="2" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="3" AgeQualifyingCode="10"/>
								<BaseByGuestAmt AmountBeforeTax="170.00" NumberOfGuests="4" AgeQualifyingCode="10"/>
							</BaseByGuestAmts>
							<AdditionalGuestAmounts>
								<AdditionalGuestAmount AgeQualifyingCode="10" Amount="20.00"/>
								<AdditionalGuestAmount AgeQualifyingCode="8" Amount="10.00"/>
							</AdditionalGuestAmounts>
						</RatePlan>
					</RatePlans>
				</RoomType>
			</RoomTypes>
			<BlockDescriptions>
				<BlockDescription>
					<Text>The is the block Description</Text>
				</BlockDescription>
			</BlockDescriptions>
			<Contacts>
				<Contact>
					<PersonName>
						<Surname>BOGUS III, MR SEAN</Surname>
					</PersonName>
					<Telephone FormattedInd="false" PhoneNumber="316 555 1212" PhoneTechType="1"/>
					<Telephone FormattedInd="false" PhoneNumber="316 555 1200" PhoneTechType="3"/>
					<Address>
						<AddressLine>1907 N Murdock</AddressLine>
						<AddressLine>Suite 200A</AddressLine>
						<CityName>Wichita</CityName>
						<PostalCode>67208</PostalCode>
						<StateProv StateCode="KS"/>
						<CountryName Code="US"/>
					</Address>
				</Contact>
			</Contacts>
		</InvBlock>
	</InvBlocks>
</OTA_HotelInvBlockNotifRQ>

...

Element | @Attribute

Num

Description/Contents

Origin | Value

 OTA_HotelInvBlockNotifRS  

EchoToken  

 Optional.  

   

   

Version  

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

   

   

TimeStamp  

Not mandatory in OTA but is Mandatory in the HTNG recommendation – time of the transaction.

   

OTA_HotelInvBlockNotifRS / Errors / Error

Type  

Mandatory in OTA. Refers to OTA EWT list (error warning type).

Log value and all attributes if present. The value of the element should be the text of the error message.

OTA_HotelInvBlockNotifRS / Errors / Error

Code  

Optional. Refers to OTA list ERR. Should be used wherever possible.

   

OTA_HotelInvBlockNotifRS / Errors / Error

RecordID  

Optional. If the receiving system can identify within a batch of inventory blocks messages which specific message failed, the InvBlockCode of the specific inventory that failed should be reported here.

   

OTA_HotelInvBlockNotifRS / Success  

   

Mandatory in OTA and in the HTNG recommendations. This is the annotation that the
inventory block message batch was received
successfully. It could be combined with warning
messages if some of the messages in the batch had
issues.

 Log if present  

OTA_HotelInvBlockNotifRS / Warnings / Warning

Type  

Mandatory in OTA. Refers to OTA EWT list (error warning type).

Log value and all attributes if present. The value of the element should be the text of the error message.

   

Code  

Optional. Refers to OTA list ERR. Should be used wherever possible.

   

   

RecordID  

Optional. If the receiving system can identify within
a batch of inventory block
messages which specific
inventory block failed, the
Invenotry Inventory Block code of the
inventory block that failed
should be reported here.

   

OTA_HotelInvBlockNotifRS / InvBlockCodeRefs / InvBlockCodeRef  

InvSystem

InvBlockCode

Optional. Used to reconfirm back to the sending partner the inventory block that was
uploaded using the code
created for that inventory
code by the receiving system.
It is up to the trading partners
whether to use this field.

OTA_HotelInvBlockNotifRS / InvBlockCodeRefs / HotelRef  

 HotelCode  

Optional. Used to reconfirm back to the sending partner the hotel for which the inventory block/s were sent.

Page Properties
hiddentrue

Method

<OTA_HotelInvBlockNotifRQ/RS>

Message Direction

Inbound

SHR Application

Windsurfer™ CRS, Wave™ RMS

Revision

v1v3.0