GenHTNG - StayInfo
- John West
- Stephen Day
- Amanda Milam
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>