Seitenhistorie

...

The purpose of this page is to inform you about upcoming changes within our OTA/HTNG implementation for both property management systems. Please note that the changes are divided into onPrem and pAir PMS changes. onPrem changes won't be rolled out globally at the date that is mentioned in the table below whilst pAir Updates will always be rolled out for all customers in one step.
Please note that the XML of the examples are shortened for a clear arrangement. The full sample message can be found on the documentation page for the message.

Release dates pAIR LIVE Environment

Version	Release date
22.24	2022-06-15
22.22	2022-06-01
22.20	2022-05-18
22.18	2022-05-04
22.16	2022-04-20
22.14	2022-04-06
22.12	2022-03-23
22.10	2022-03-09
22.08	2022-02-23
22.06	2022-02-09

Release dates PWS (onPrem) LIVE Environment

Version	Release date
3.7	2022-03-30
3.6	2022-02-02

Affected Message

Direction from protel

PMS

Path

Example

Summary

Internal reference

Version

TBA IDS

TBA PWS

OTA_ReadRQ

inbound

onPremise

Codeblock

language	xml
collapse	true

<OTA_ReadRQ xmlns="http://www.opentravel.org/OTA/2003/05" CorrelationID="PWS-3130" Version="0" EchoToken="PWS-3130" MaxResponses="2">
	<POS>
		<Source>
			<RequestorID ID="3152" Type="10" ID_Context="protelIO"/>
		</Source>
	</POS>
	<ReadRequests>
		<HotelReadRequest>
			<SelectionCriteria ResStatus="In-house"/>
			<Verification>
				<PersonName>
					<Surname>Duck</Surname>
				</PersonName>
			</Verification>
			<TPA_Extensions>
				<px:ReadRequestExtensions xmlns:px="http://protel.io/htng/extensions">
					<px:Room RoomID="303" />
				</px:ReadRequestExtensions>
			</TPA_Extension>
		</HotelReadRequest>
	</ReadRequests>
</OTA_ReadRQ>

Extend the OTA_ReadRQ to search for the RoomID

PWS-3130

HTNG_HotelFolioNotifRQ

HTNG_HotelFolioRQ

outbound

inbound

onPremise

Codeblock

language	xml
collapse	true

<htng:HTNG_HotelFolioNotifRQ>
	<htng:Folios>
		<htng:Folio>
			<htng:RevenueDetails>
				<htng:RevenueDetail>
					<FolioIDs>
						<FolioID>OResID | xyz <FolioID/>
						<FolioID>OGstID | xyz <FolioID/>

Add the "OResID" and "OGstID" to the FolioID Element, to display the "originalResID" and "originalGuestID" if an items was shifted from one Reservation to another.

If an Item was not shifted, the Information will not be displayed

PWS-3151

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

outbound

onPremise

Codeblock

language	xml
collapse	true

<OTA_ProfileModifyRQ>
	<ProfileModify>
			<TPA_Extensions>
				<px:ProfileInfoExtensions>
					<px:PersonInfos>
						<px:Language DefaultInd="true">en-us</px:Language>

Add to the Profile Message the TPA Extension for the Language Code.

PWS-3150

TBA IPA

HTNG_HotelFolioNotifRQ

HTNG_HotelFolioRQ

outbound

inbound

pAir

Codeblock

language	xml
collapse	true

<htng:HTNG_HotelFolioNotifRQ>
	<htng:Folios>
		<htng:Folio>
			<htng:RevenueDetails>
				<htng:RevenueDetail>
					<FolioIDs>
						<FolioID>OResID | xyz <FolioID/>
						<FolioID>OGstID | xyz <FolioID/>

Add the "OResID" and "OGstID" to the FolioID Element, to display the "originalResID" and "originalGuestID" if an items was shifted from one Reservation to another.

If an Item was not shifted, the Information will not be displayed

IPA-1043

HTNG_HotelRoomStatusUpdateNotifRQ

outbound/inbound

pAir

HTNG_HotelRoomStatusUpdateNotifRQ | Room | RoomType | @NumberOfUnits

Codeblock

language	xml
collapse	true

<HTNG_HotelRoomStatusUpdateNotifRQ>
	<Room>
		<RoomType NumberOfUnits="1"/>

Add the Attribute @NumberOfUnits to the RoomType in the HTNG_HotelRoomStatusUpdateNotifRQ IPA-1030

IPA 22.16

Anker

	IPA 22.16
	IPA 22.16

Codeblock

language	xml
collapse	true

<OTA_ReadRQ xmlns="http://www.opentravel.org/OTA/2003/05" CorrelationID="PWS-3130" Version="0" EchoToken="PWS-3130" MaxResponses="2">
	<POS>
		<Source>
			<RequestorID ID="3152" Type="10" ID_Context="protelIO"/>
		</Source>
	</POS>
	<ReadRequests>
		<HotelReadRequest>
			<SelectionCriteria ResStatus="In-house"/>
			<Verification>
				<PersonName>
					<Surname>Duck</Surname>
				</PersonName>
			</Verification>
			<TPA_Extensions>
				<px:ReadRequestExtensions xmlns:px="http://protel.io/htng/extensions">
					<px:Room RoomID="303" />
				</px:ReadRequestExtensions>
			</TPA_Extension>
		</HotelReadRequest>
	</ReadRequests>
</OTA_ReadRQ>

Extend the OTA_ReadRQ to search for the RoomIDIPA-102922.16HTNG_HotelRoomStatusUpdateNotifRQ outbound/inboundpAirHTNG_HotelRoomStatusUpdateNotifRQ | Room | RoomType | @NumberOfUnits

Codeblock

language	xml
collapse	true

<HTNG_HotelRoomStatusUpdateNotifRQ>
	<Room>
		<RoomType NumberOfUnits="1"/>

Add the Attribute @NumberOfUnits to the RoomType in the HTNG_HotelRoomStatusUpdateNotifRQ IPA-1030IPA 22.14 AnkerIPA 22.14IPA 22.14

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

OTA_HotelResNotifRQ

px:LastNameAtBirth
px:FirstNameAtBirth
px:LastNameMother
px:FirstNameMother

px:LastNameAtBirth
px:FirstNameAtBirth
px:LastNameMother
px:FirstNameMother

px:LastNameAtBirth
px:FirstNameAtBirth
px:LastNameMother
px:FirstNameMother

Codeblock

language	xml
collapse	true

<TPA_Extensions>
	<px:ProfileInfoExtensions>
		<px:AddressTypes />
		<px:ContactDetails/>
		<px:PersonInfos>
			<px:LastNameAtBirth/>
			<px:FirstNameAtBirth/>
			<px:LastNameMother/>
			<px:FirstNameMother/>
			<px:Language DefaultInd="true">de-de</px:Language>
			<px:VipCodes/>
			<px:MarketingCodes/>
			<px:Keywords/>
			<px:Registration BirthCountry="DE"/>
		</px:PersonInfos>
		<px:Salutation DefaultInd="false" DisplaySequence="1" ID="11" ID_Context="protelIO" Type="SALUTATION">Dear Mr.</px:Salutation>
		<px:ProfileStatus/>
		<px:DocumentTypes/>
		<px:StatisticalInfos/>
		<px:Traces/>
		<px:LogEntries/>
		<px:Memberships/>
	</px:ProfileInfoExtensions>
</TPA_Extensions>

Added four extra fields to profile messages (and the profile part of the reservation message). These fields are a legal requirement in Hungary and Romania.IPA-104122.16

IPA 22.12

Anker

	IPA 22.12
	IPA 22.12

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

outboundpAir

Codeblock

language	xml
collapse	true

<TPA_Extensions xmlns:px="http://protel.io/htng/extensions">
	<px:ProfileInfoExtensions>
		<px:StatisticalInfos>
			<px:ParentProfile Name="Duck AG" ID="181579" ID_Context="protelIO" Type="3"/>
		</px:StatisticalInfos>
	</px:ProfileInfoExtensions>
</TPA_Extensions>

Add the new official XSD TPA_Extensions "px:ParentProfile "

IPA-1015

IPA 22.10

Anker

	IPA 22.10
	IPA 22.10

Codeblock

language	xml
collapse	true

<DepositPayments>
	<GuaranteePayment>
		<AmountPercent Amount="77.00" CurrencyCode="AED" ApplyAs="FirstNightDeposit"/>
		<Deadline AbsoluteDeadline="2019-09-06"/>
	</GuaranteePayment>
	<GuaranteePayment>
		<AcceptedPayments>
			<AcceptedPayment PaymentTransactionTypeCode="charge">
				<PaymentCard>
					<CardType>CASH (AED)</CardType>
				</PaymentCard>
			</AcceptedPayment>
		</AcceptedPayments>
		<AmountPercent Amount="-55.00" CurrencyCode="AED" ApplyAs="FirstNightDeposit"/>
	</GuaranteePayment>
</DepositPayments>

Add Deposit Paid to outbound Reservation Message.IPA-101422.10

IDS 6.095

Anker

	IDS 6.095
	IDS 6.095

OTA_HotelRatePlanNotifRQ

outbound

OnPremise

pAir

Codeblock

language	xml
collapse	true

<AdditionalGuestAmounts>
    <AdditionalGuestAmount AgeQualifyingCode="7" Amount="18.18" CurrencyCode="EUR" MaxAge="3" MinAge="0" TaxInclusive="false">
        <Taxes Amount="1.82" CurrencyCode="EUR"/>
    </AdditionalGuestAmount>

Include tax details per child bucketIDS-5246.095OTA_HotelRateAmountNotifRQoutbound

OnPremise

pAir

Codeblock

language	xml
collapse	true

<AdditionalGuestAmounts>
    <AdditionalGuestAmount AgeQualifyingCode="7" Amount="18.18" CurrencyCode="EUR" MaxAge="3" MinAge="0" TaxInclusive="false">
        <Taxes Amount="1.82" CurrencyCode="EUR"/>
    </AdditionalGuestAmount>

Include tax details per child bucketIDS-5246.095

PWS 3.7.X

Anker

	PWS 3.7.X
	PWS 3.7.X

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

InboundOnPremise

OTA_ProfileCreateRQ | Profile | Customer | PersonName | MiddleName

OTA_ProfileModifyRQ | ProfileModify | Customer | PersonName | MiddleName

Codeblock

language	xml
collapse	true

<Customer BirthDate="1980-01-01" Gender="Female">
	<PersonName>
		<GivenName>Doodi</GivenName>
		<MiddleName>Jacksonn</MiddleName>
		<Surname>Joness</Surname>
	</PersonName>
	<Email DefaultInd="true" EmailType="1" ShareMarketInd="No">xgomez+892372@civitfun.com</Email>
	<Address DefaultInd="true" FormattedInd="false" ShareMarketInd="No" Type="1" UseType="6">
		<AddressLine>Calle Dos 2</AddressLine>
		<CityName>Palma</CityName>
		<StateProv>Islas Baleares</StateProv>
		<CountryName Code="ES">Spain</CountryName>
	</Address>
	<CitizenCountryName Code="ES" DefaultInd="true"/>
	<Document DocID="99999999R" DocType="5" EffectiveDate="2015-01-01" ExpireDate="2024-12-31"/>
	<EmployerInfo CompanyShortName="" Department=""/>
</Customer>

To implement MiddleName for inbound private profilesPWS-31283.7.X

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

outboundOnPremise

Codeblock

language	xml
collapse	true

<TPA_Extensions xmlns:px="http://protel.io/htng/extensions">
	<px:ProfileInfoExtensions>
		<px:StatisticalInfos>
			<px:ParentProfile Name="Duck AG" ID="181579" ID_Context="protelIO" Type="3"/>
		</px:StatisticalInfos>
	</px:ProfileInfoExtensions>
</TPA_Extensions>

Remove the existing TPA_Extensions

Codeblock

language	xml
collapse	true

<TPA_Extensions xmlns:px="http://protel.io/htng/extensions">      
     <Master MasterAccountID="181579"/>     
</TPA_Extensions>

And add the new official XSD TPA_Extensions "px:ParentProfile "

PWS-30973.7.XOTA_HotelResNotifRQoutboundOnPremise

Codeblock

language	xml
collapse	true

<Guarantee GuaranteeType="CC/DC/Voucher">
    <GuaranteesAccepted>
        <GuaranteeAccepted>
            <PaymentCard CardCode="MC" CardType="1" EncryptionKey="hOSJucTz-9QDE-KKKE-qiTa-af8X4oOiNVG" ExpireDate="0123" MaskedCardNumber="XXXXXXXXXXXX5100">
                <CardHolderName>AT</CardHolderName>
            </PaymentCard>
        </GuaranteeAccepted>
    </GuaranteesAccepted>
</Guarantee>

assigned credit cards will be displayed in the outbound Reservation messagePWS-10893.7.X

HTNG_ChargePostingRQ

inboundOnPremise

Codeblock

language	xml
collapse	true

<RevenueDetails>
	<RevenueDetail Description="Cash Payment" PMSRevenueCode="1" CurrencyCode="AED" Amount="-45.00" SubTypeID="Payment">
		<Account ID="555342188" Type="14" ID_Context="External"/>
	</RevenueDetail>
</RevenueDetails>

Posted Revenue / Payment is possible against External ResID. PWS-31123.7.XIO_RatePackageNotifRQoutboundOnPremise

IO_RatePackageNotifRQ | Packages | Package | Validity

IO_RatePackageNotifRQ | Packages | Package | PackageItem | Validity

Codeblock

language	xml
collapse	true

<Validity From="1990-01-01" To="2050-01-01"/>

Remove the time stamp from the Validity element according to our XSDPWS-30923.7.X

PWS 3.6.X

Anker

	PWS 3.6.X
	PWS 3.6.X

OTA_HotelAvailNotifRQ

inboundOnPremOTA_HotelAvailNotifRQ | AvailStatusMessages | AvailStatusMessage | RestrictionStatus

Codeblock

language	xml
collapse	true

<?xml version='1.0' encoding='utf-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope">
	<env:Body>
		<OTA_HotelAvailNotifRQ MessageContentCode="3" TimeStamp="2018-12-03T00:00:00.000Z" Version="2">
			<AvailStatusMessages HotelCode="3153">
				<AvailStatusMessage>
					<StatusApplicationControl Start="2021-08-09" End="2021-08-10" RatePlanCode="Ali2" InvTypeCode="CBR"/>
					<RestrictionStatus Restriction="Departure" Status="Close"/>
					<UniqueID Type="16" ID_Context="info.rateboard.rms" ID="2"/>
				</AvailStatusMessage>
				<AvailStatusMessage>
					<StatusApplicationControl Start="2021-08-09" End="2021-08-10" RatePlanCode="Ali2" InvTypeCode="CS"/>
					<RestrictionStatus Restriction="Departure" Status="Close"/>
					<UniqueID Type="16" ID_Context="info.rateboard.rms" ID="2"/>
				</AvailStatusMessage>
			</AvailStatusMessages>
		</OTA_HotelAvailNotifRQ>
	</env:Body>
</env:Envelope>

Codeblock

language	xml
collapse	true

<HTNG_ChargePostingRQ>
	<Posting ID="1">
		<Transaction TicketID="1">
			<RevenueDetails>
				<RevenueDetail Description="Upsell Article" PMSRevenueCode="1000" ReferenceID="1015" Amount="20.00" SubTypeID="Revenue">
					<ExtendedPrice AmountAfterTax="20.00" DecimalPlaces="2" Quantity="1"/>
					<Account ID="341977-2" Type="16" ID_Context="protelIO"/>
				</RevenueDetail>

With the Attribute @ReferenceID it will be possible to post as well articles. In the Attribute @ReferenceID the Article ID needs to be sent to Protel. In the Attribute @PMSRevenueCode the TAA from the article should be providedPWS-2996PWS 3.6.XIO_RatePackageNotifRQoutboundOnPremIO_RatePackageNotifRQ | Packages | Package | PackageItem | Calculation

Codeblock

language	xml
collapse	true

<IO_RatePackageNotifRQ>
	<Packages>
		<Package>
			<PackageItems>
				<PackageItem>
					<Calculation AmountBeforeTax="40" AmountAfterTax="40" Currency="AED" InclusiveInd="true" Recurrence="Daily" Relation="Complex">
						<DaysOfWeek Mon="true" Tue="true" Wed="true" Thu="true" Fri="true" Sat="true" Sun="true"/>

Fix the values for the Recurrence Attribute

Possible Recurrence

OnArrival
OnDeparture
Daily
DaysOfWeek
Floating
Fixed

PWS-3001PWS 3.6.XOTA_HotelResNotifRQ outboundOnPrem

Codeblock

language	xml
collapse	true

<TPA_Extensions xmlns:px="http://protel.io/htng/extensions">
	<px:ReservationExtensions>
		<px:FixedCharges>
			<px:FixedCharge Code="KosmetikExtNoR" Recurrence="floating" From="2021-01-05" To="2021-01-12" Quantity="1" RequestedIndicator="true">
				<px:Price CurrencyCode="EUR" SingleAmountAfterTax="25.00"/>
				<px:UniqueID Type="FixedCharge" ID="103604" ID_Context="protelIO"/>
				<px:Item ItemID="75"/>
				<px:InvoiceText>Kosmetik täglich ab 5.1.</px:InvoiceText>
				<px:ServiceDates>
					<px:ServiceDate From="2021-01-05" To="2021-01-07"/>
					<px:ServiceDate From="2021-01-10" To="2021-01-12"/>
				</px:ServiceDates>
			</px:FixedCharge>
		</px:FixedCharges>
	</px:ReservationExtensions>
</TPA_Extensions>

Add the new Element "SerivceDates"

This Element will be displayed for the Recurrence= "floating"

Possible Recurrence

OnArrival
OnDeparture
Daily
DaysOfWeek
Floating
Fixed

Codeblock

language	xml
collapse	true

<HTNG_HotelFolioRS>
	<Folios>
		<Folio>
			<RevenueDetails>
				<RevenueDetail>
					<FolioIDs xmlns="http://www.opentravel.org/OTA/2003/05">
						<FolioID>SDate|2017-08-23</FolioID>
                                                <FolioID>InvID|122345</FolioID>
					</FolioIDs>
					<RevenueDetailItems>
						<RevenueDetailItem>
							<FolioIDs xmlns="http://www.opentravel.org/OTA/2003/05">
								<FolioID>SDate|2017-08-23</FolioID>
							</FolioIDs>

Add a short in front of the FolioID Element, to describe what is displayed

Possible values

InvID
InvNo
GstID
Code
TAAGrp
PkgID
SDate

Codeblock

language	xml
collapse	true

<HTNG_HotelFolioNotifRQ>
	<Folios>
		<Folio>
			<RevenueDetails>
				<RevenueDetail>
					<FolioIDs xmlns="http://www.opentravel.org/OTA/2003/05">
						<FolioID>SDate|2017-08-23</FolioID>
                                                <FolioID>InvID|122345</FolioID>
					</FolioIDs>
					<RevenueDetailItems>
						<RevenueDetailItem>
							<FolioIDs xmlns="http://www.opentravel.org/OTA/2003/05">
								<FolioID>SDate|2017-08-23</FolioID>
							</FolioIDs>

Add a short in front of the FolioID Element, to describe what is displayed

Possible values

InvID
InvNo
GstID
Code
TAAGrp
PkgID
SDate

PWS-2961PWS 3.5.XIO_StatsNotifRQoutboundOnPremIO_StatsNotifRQ | Statistics | Statistic | StatisticApplicationSet | RevenueCategorySummaries

Codeblock

language	xml
collapse	true

    <IO_StatsNotifRQ/>
      <Statistics>
        <Statistic>
          <StatisticApplicationSets>
            <StatisticApplicationSet Start="2021-10-28" End="2021-10-28">
              <StatisticCodes>
                <StatisticCode StatCode="Group" StatCategoryCode="3" />
                <StatisticCode StatCode="1" StatCategoryCode="Pseudo" />
              </StatisticCodes>
              <RevenueCategorySummaries>
                <RevenueCategorySummary RevenueCategoryCode="3" CurrencyCode="EUR" Amount="0.00" />
                <RevenueCategorySummary RevenueCategoryCode="6" CurrencyCode="EUR" Amount="0.00" />
                <RevenueCategorySummary RevenueCategoryCode="9" CurrencyCode="EUR" Amount="0.00" />
                <RevenueCategorySummary RevenueCategoryCode="17" CurrencyCode="EUR" Amount="0.00" />
                <RevenueCategorySummary RevenueCategoryCode="123" CurrencyCode="EUR" Amount="0.00" />
                <RevenueCategorySummary RevenueCategoryCode="126" CurrencyCode="EUR" Amount="0.00" />
                <RevenueCategorySummary RevenueCategoryCode="129" CurrencyCode="EUR" Amount="0.00" />
                <RevenueCategorySummary RevenueCategoryCode="1217" CurrencyCode="EUR" Amount="0.00" />
              </RevenueCategorySummaries>

If the all value for the RevenueCategorySummaries is zero, we will not display the ElementPWS-2998PWS 3.5.X

...

Seitenhierarchie

Versionen im Vergleich

Alte Version 364

Neue Version 365

Schlüssel