GenHTNG - StayInfo

1 Overview
2 Supported Operations
3 Business Rules
4 Elements & Attributes
5 OTA_HotelStayInfoNotifRQ-Folio Sample
6 OTA_HotelStayInfoNotifRS Sample

Overview

The Hotel Stay Info Notification provides a request and response pair of messages to support the functionality of updating the receiving system with Folio/Revenue data.

Supported Operations

Maverick CRM uses this message to update the guest's profile and reservations to post actualized amounts spent at the hotel across various transaction types.
Wave RMS will use this message to better calculate revenue coming into the hotel, to use in the rate decision process.
Windsurfer CRS will not use this message.

Business Rules

PMSRevenueCode must be mapped within Maverick CRM for data to post to profile correctly.
Reservation number must be present
If PMSRevenueCode is not present, folio data will post based on RevenueCategoryCode

Elements & Attributes

Element \| @Attribute	Num	Description/Contents	Origin \| Value
OTA_HotelStayInfoNotifRQ	1	Root element of the message.
OTA_HotelStayInfoNotifRQ / POS / Source / RequestorID	1		Not Mapped
@Type	1	Refer to OpenTravel Code List Unique ID Type (UIT).	Not Mapped
@ID		A unique identifying value assigned by the creating system.	Not Mapped
@ID_Context		Used to identify the source of the identifier	Not Mapped
OTA_HotelStayInfoNotifRQ / POS / Source / RequestorID/StayInfos
@HotelCode	1	This is the code of the property whose availability is being requested.	Property Code of transaction
@HotelCodeContext			Not Mapped
OTA_HotelStayInfoNotifRQ / POS / Source / RequestorID/StayInfos/StayInfo		Provides details of a guest's stay. The StayInfo class contains the guest revenue and stay data to be sent to the central server.
@RoomStayRPH			Not Mapped
OTA_HotelStayInfoNotifRQ / POS / Source / RequestorID/StayInfos/StayInfo/RevenueCategories/Revenue Category		The classifications of revenue data associated with the StayInfo report
@RevenueCategoryCode		Refer to OpenTravel Code List Revenue Category Code (RCC).
OTA_HotelStayInfoNotifRQ / POS / Source / RequestorID/StayInfos/StayInfo/RevenueCategories/Revenue Category/SummaryAmount
@CurrencyCode	0..1	Currency used. Should be sent in conjunction with Amount.
@DecimalPlaces
@Amount	0..1	This is the amount charged as a for the booking. At least one between Amount, Percent, and must be transferred.
OTA_HotelStayInfoNotifRQ / POS / Source / RequestorID/StayInfos/StayInfo/RevenueCategories/Revenue Category//RevenueDetails/RevenueDetail		The RevenueDetail class contains line item detail about specific revenue transactions.
@ReferenceID	0..1	Reference Number
@TransactionDate	0..1	Date of transaction
@Description	0..1	Item Name/Description
@PMSRevenueCode	0..1	PMS reference value for transaction code
@CurrencyCode	0..1	Currency used. Should be sent in conjunction with Amount.
@DecimalPlaces	0..1
@Amount	0..1	This is the amount charged as a for the booking. At least one between Amount, Percent, and must be transferred.
OTA_HotelStayInfoNotifRQ / POS / Source / RequestorID/StayInfos/StayInfo/RevenueCategories/Revenue Category//RevenueDetails/RevenueDetail/FolioIDs/	0..1	The PMS folio identifier associated with this revenue detail item.
@FolioID	1		Support only 1
OTA_HotelStayInfoNotifRQ / POS / Source / RequestorID/StayInfos/StayInfo/ReservationID		An identifier used to uniquely reference an object in a system
@Type		Refer to OpenTravel Code List Unique ID Type (UIT).	Should be always “14”
@ID		A unique identifying value assigned by the creating system
@ID_Context		Used to identify the source of the identifier	Not Mapped

OTA_HotelStayInfoNotifRQ-Folio Sample

<?xml version='1.0' encoding='UTF-8'?>
<n1:Envelope xmlns:n1="http://www.w3.org/2003/05/soap-envelope" xmlns:n3="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:n2="http://www.w3.org/2005/08/addressing" xmlns:n4="http://htng.org/PWSWG/2007/02/AsyncHeaders">
	<n1:Header>
		<n2:MessageID>{{MessageID}}</n2:MessageID>
		<n4:CorrelationID>2b36432943304e8d81ba5618d5df9e5a</n4:CorrelationID>
		<n2:Action>http://htng.org/PWSWG/2010/12/StayInfo_SubmitRequest</n2:Action>
		<n2:To>https://uat.windsurfercrs.com/pms/genhtngservice.aspx</n2:To>
		<n2:ReplyTo>
			<n2:Address>http://www.w3.org/2005/08/addressing/role/anonymous</n2:Address>
		</n2:ReplyTo>
		<n3:Security mustUnderstand="1">
			<n3:UsernameToken>
				<n3:Username>{{HeaderUserName}}</n3:Username>
				<n3:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">{{HeaderPassword}}</n3:Password>
			</n3:UsernameToken>
		</n3:Security>
		<n4:ReplyTo>
			<n2:Address>https://pmsendpoint/serviceEndpoint</n2:Address>
		</n4:ReplyTo>
	</n1:Header>
	<n1:Body>
		<OTA_HotelStayInfoNotifRQ  xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" EchoToken="{{EchoToken}}" TimeStamp="{{CurrentDateTime}}" xmlns="http://www.opentravel.org/OTA/2003/05">
			<POS>
				<Source>
					<RequestorID Type="22" ID="PMSID" ID_Context="PMS"/>
				</Source>
			</POS>
			<StayInfos HotelCode="{{HotelCode}}" HotelCodeContext="PMS">
				<StayInfo RoomStayRPH="1">
					<RevenueCategories>
						<RevenueCategory RevenueCategoryCode="RGRP01">
							<SummaryAmount CurrencyCode="USD" DecimalPlaces="2" Amount="19160.00"/>
							<RevenueDetails>
								<RevenueDetail ReferenceID="2110" TransactionDate="2020-09-06-04:00" Description="Accommodation" PMSRevenueCode="110010" CurrencyCode="USD" DecimalPlaces="2" Amount="660.00">
									<FolioIDs>
										<FolioID Type="FolioNumber">992</FolioID>
									</FolioIDs>
								</RevenueDetail>
								<RevenueDetail ReferenceID="2193" TransactionDate="2020-09-07-04:00" Description="Accommodation" PMSRevenueCode="110010" CurrencyCode="USD" DecimalPlaces="2" Amount="740.00">
									<FolioIDs>
										<FolioIDType="FolioNumber">992</FolioID>
									</FolioIDs>
								</RevenueDetail>
							</RevenueDetails>
						</RevenueCategory>
					</RevenueCategories>
					<ReservationID Type="14" ID="67454513-1" ID_Context="PMS"/>
				</StayInfo>
			</StayInfos>
		</OTA_HotelStayInfoNotifRQ>
	</n1:Body>
</n1:Envelope>

OTA_HotelStayInfoNotifRS Sample

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
	<SOAP-ENV:Header xmlns:wsa="http://www.w3.org/2005/08/addressing" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
		<wsa:MessageID>urn:uuid:90f53f33-17be-434f-9cf5-9c798e13fa78</wsa:MessageID>
		<htng:CorrelationID xmlns:htng="http://htng.org/PWSWG/2007/02/AsyncHeaders"/>
		<wsa:Action>https://uat.windsurfercrs.com/Htng2AvailabilityService/OTA_HotelAvailNotifRQ</wsa:Action>
		<wsa:ReplyTo>
			<wsa:Address>http://www.w3.org/2005/08/addressing/anonymous</wsa:Address>
		</wsa:ReplyTo>
		<wsa:To>pmsurl</wsa:To>
		<wsa:From>
			<wsa:Address>https://dga-test-dot-message-cruncher-module-dot-social-booking-engine.appspot.com/ota/receiveMessage</wsa:Address>
		</wsa:From>
		<wss:Security xmlns:wss="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:env="http://www.w3.org/2003/05/soap-envelope" env:mustUnderstand="1">
			<wss:UsernameToken wsu:Id="4UCVSBH2AJ6W">
				<wss:Username>username</wss:Username>
				<wss:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">pwd</wss:Password>
				<wsu:Created>2/4/2021 12:42:43 AM</wsu:Created>
			</wss:UsernameToken>
		</wss:Security>
	</SOAP-ENV:Header>
	<SOAP-ENV:Body>
		<OTA_HotelStayInfoNotifRS xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="M83918-1" TimeStamp="2020-10-27T13:37:16.2995651-06:00" Version="1.0">
			<Success/>
		</OTA_HotelStayInfoNotifRS>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>