Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 2 Next »

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>

  • No labels