Skip to main content

PMS Reservation Sync (HTNG)

10.33
Property Connect
HTNG
Reservations
SOAP API
Data Migration
PMS Integration

Not Signed In.

Looks like you may not have access to all of the resources and documentation for this page.
Please log-in or contact your support desk team if you believe you should have access.

The PMS Reservation Sync (HTNG) (OTA_HotelResNotifRQ) API is used to communicate reservation data from a PMS to SynXis CRS.

Target Audience
Data Migration
PMS Integration
API Version
10.33
Authentication
Security Credentials
Service Action Code
OTA_HotelResNotifRQ

Inventory Adjustments

In the SynXis system, a hotel may choose to use the PMS or the SynXis CRS as the system of record for inventory. When a hotel uses the PMS as the system of record for inventory, reservation uploads will create, modify and cancel reservations in the SynXis system but will not result in changes to available inventory values.

The PMS will manage available inventory values in the SynXis CRS system through inventory uploads. When a hotel uses the SynXis CRS as the system of record for inventory, reservation uploads will create, modify and cancel reservations in the SynXis system and will result in changes to available inventory values. Uploads of available inventory values by the PMS are not supported and SynXis will calculate available inventory internally based on all inventory related data that is stored in the SynXis CRS system, including all stored reservations.

Import Reservations

New hotel (chain) customers can use the HTNG interface to upload or import all existing reservations for their hotels into the SynXis CR before the hotel/chain goes live on the SynXis system. The reservation import process seamlessly transfers reservation data from the customer CRS to SynXis CR.

The OTA_HotelResNotifRQ message type, which is used for reservation uploads and downloads, will also be used to import reservation data. The OTA_HotelResNotifRQ message will support the following import actions:

  • Import New Reservation
  • Import Modified Reservation
  • Import Cancelled Reservation

If a customer decides to use the Res Import method to upload existing reservations into SynXis CRS, make sure reservations from all applicable hotels are imported before going live on the SynXis CRS.

Notes:

  • Each reservation message contains one reservation for a single hotel.
  • Reservation download messages only include multiple RatePlan elements if the system receiving the reservation message is configured in the Control Center as supporting multiple rate plan reservations. Otherwise, reservation download messages will be limited to one RatePlan element only.
Sample Request
<OTA_HotelResNotifRQ xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05/OTA_HotelResNotifRQ.xsd" Version="1.003" ResStatus="Commit" TimeStamp="2019-11-12T11:26:23" xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <POS>
        <Source>
            <RequestorID Type="22" ID="PMS"/>
            <BookingChannel Primary="true" Type="4"/>
        </Source>
    </POS>
    <HotelReservations>
        <HotelReservation CreatorID="PMS" CreateDateTime="2019-11-12T11:22:06" ResStatus="In-house">
            <UniqueID Type="10" ID="PMS000002"/>
            <RoomStays>
                <RoomStay MarketCode="MKTSEG" SourceOfBusiness="MKTSRC">
                    <RatePlans>
                        <RatePlan RatePlanCode="RACK">
                            <RatePlanInclusions TaxInclusive="false"/>
                        </RatePlan>
                    </RatePlans>
                    <RoomRates>
                        <RoomRate RatePlanCategory="RACKCAT" RoomTypeCode="KING" NumberOfUnits="1" RatePlanCode="PMS Rate Code">
                            <Rates>
                                <Rate RateTimeUnit="Day" EffectiveDate="2019-01-12" ExpireDate="2019-01-15" UnitMultiplier="3">
                                    <Base CurrencyCode="USD" AmountBeforeTax="100.00">
                                        <Taxes Amount="10.00" CurrencyCode="USD"/>
                                    </Base>
                                </Rate>
                            </Rates>
                        </RoomRate>
                    </RoomRates>
                    <GuestCounts IsPerRoom="true">
                        <GuestCount AgeQualifyingCode="10" Count="2"/>
                        <GuestCount AgeQualifyingCode="8" Count="1"/>
                    </GuestCounts>
                    <TimeSpan Start="2019-01-12" End="2019-01-15"/>
                    <Total CurrencyCode="USD" AmountBeforeTax="300.00">
                        <Taxes Amount="30.00" CurrencyCode="USD"/>
                    </Total>
                    <BasicPropertyInfo HotelCode="10001" ChainCode="1111"/>
                    <ResGuestRPHs>
                        <ResGuestRPH RPH="1"/>
                    </ResGuestRPHs>
                </RoomStay>
            </RoomStays>
            <ResGuests>
                <ResGuest ResGuestRPH="1" PrimaryIndicator="true">
                    <Profiles>
                        <ProfileInfo>
                            <UniqueID Type="1" ID="9876543" ID_Context="pms">
                                <CompanyName CodeContext="hotel" Code="10001"/>
                            </UniqueID>
                            <Profile ProfileType="1">
                                <Customer Birthdate="0001-01-01">
                                    <PersonName>
                                        <NamePrefix>Mr</NamePrefix>
                                        <GivenName>James</GivenName>
                                        <MiddleName>Q</MiddleName>
                                        <Surname>Bond</Surname>
                                        <NameSuffix>Sr</NameSuffix>
                                    </PersonName>
                                    <Telephone PhoneTechType="1" PhoneNumber="1115551212" FormattedInd="false" DefaultInd="true"/>
                                    <Telephone PhoneTechType="1" PhoneNumber="1115551213" FormattedInd="false" DefaultInd="false"/>
                                    <Telephone PhoneTechType="3" PhoneNumber="1115551214" FormattedInd="false" DefaultInd="false"/>
                                    <Telephone PhoneTechType="5" PhoneNumber="1115551215" FormattedInd="false" DefaultInd="false"/>
                                    <Email>jamesbond@homeemail.com</Email>
                                    <Address Type="2" Remark="Work address">
                                        <CompanyName>My Company</CompanyName>
                                        <AddressLine>123 Main St</AddressLine>
                                        <AddressLine>Suite 100</AddressLine>
                                        <AddressLine>Cubicle 5</AddressLine>
                                        <CityName>Newton</CityName>
                                        <StateProv StateCode="MA"/>
                                        <PostalCode>02458</PostalCode>
                                        <CountryName Code="US"/>
                                    </Address>
                                </Customer>
                            </Profile>
                        </ProfileInfo>
                    </Profiles>
                </ResGuest>
            </ResGuests>
            <ResGlobalInfo>
                <HotelReservationIDs>
                    <HotelReservationID ResID_Type="10" ResID_Value="PMS000002" ResID_Source="PMS" ForGuest="true"/>
                </HotelReservationIDs>
            </ResGlobalInfo>
        </HotelReservation>
    </HotelReservations>
</OTA_HotelResNotifRQ>
Sample Response
<OTA_HotelResNotifRS xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05/OTA_HotelResNotifRQ.xsd" Version="1.003" TimeStamp="2015-11-18T11:29:23.112" ResResponseType="Committed" xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Success/>
    <HotelReservations>
        <HotelReservation>
            <UniqueID Type="10" ID="PMS000002"/>
            <ResGlobalInfo>
                <HotelReservationIDs>
                    <HotelReservationID ResID_Type="14" ResID_Value="10001SY000002" ResID_Source="CRS" ForGuest="true" />
                    <HotelReservationID ResID_Type="10" ResID_Value="PMS000002" ResID_Source="PMS" ForGuest="true" />
                </HotelReservationIDs>
            </ResGlobalInfo>
        </HotelReservation>
    </HotelReservations>
</OTA_HotelResNotifRS>