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.36	2022-09-07

22.32	2022-08-10
22.30	2022-07-27
22.28	2022-07-13
22.26	2022-06-29
22.24	2022-06-15	22.22	2022-06-01
22.20	2022-05-1822.18	2022-05-04	22.14	2022-04-06

Release dates PWS (onPrem) LIVE Environment

Version	Release date
3.9	2022-07-20
3.8	2022-05-25
3.7	2022-03-30

IPA 22.24 IO_SystemDataRS IOSystemDataRS SystemData Rates RatePlanGroups RatePlanGroup @CategoryCodeIO_SystemDataRS | SystemData | Rates | RatePlanGroups | RatePlanGroup |@CategoryID<ns2:RatePlanGroupCategoryCodePWSTG" CategoryID="21" Code="PWSTRC" ID="1271" ID_Context="protelIO" Type="Standard" Visible="true"> <ns2:Description Language="de">PWS Test Ratecode</ns2:Description> </ns2:RatePlanGroup>PWS 3.8.X

Affected Message

Direction from protel

PMS

Path

Example

Summary

Internal reference

Version

TBA IDS

TBA PWS

TBA IPA

OTA_ProfileCreateRQ
OTA_ProfileModifyRQ

outbound
inbound

pAir

Codeblock

language	xml
collapse	true

<px:Registration BirtDate="2000-01-01" BirthPlace="Dortmund" BirthCountry="DE"/>

Added the three new optional attributes Registration@BirthDate, Registration@BirthPlace and Registration@BirthCountry.
If two (different or equal) valid birthdates are provided in Customer@BirthDate and Registration@BirthDate, the value from Registration@BirthDate will be taken. Customer@Birthdate will only be taken if no (valid) date is provided in Registration@BirthDate.

IPA-1107

22.36

PWS 3.9.X

Anker

	PWS 3.9.X
	PWS 3.9.X

IO_SystemDataRS

outbound

onPremise

Codeblock

language	xml
collapse	true

<ns2:RatePlanGroup CategoryCode="PWSTG" CategoryID="21" Code="PWSTRC" ID="1271" ID_Context="protelIO" Type="Standard" Visible="true">
	<ns2:Description Language="de">PWS Test Ratecode</ns2:Description>
</ns2:RatePlanGroup>

Added two new optional attributes to be able to display the rategroups. Now the message is able to display the onPremise rate structure rategroup → ratecode → ratecodetails.

PWS-3236

3.9.X

OTA_ProfileModifyRQ

OTA_ProfileModifyRS

outbound

inbound

onPremise

OTA_ProfileModifyRQ | POS | ProfileModify

OTA_ProfileModifyRS | Errors | Error

Codeblock

language	xml
collapse	true

<Errors>
	<Error Code="321" ShortText="The Profile is anonymized and will not be updated." Type="10"/>
</Errors>

If an anonymized profile is edited in PMS, then no data is shared.

As soon as an anonymized profile is tried to be updated in the PMS, the error message is displayed.

PWS-3261

and

PWS-3260

3.9.X

PWS 3.8.X

Anker

IPA 22.24

	PWS 3.8.X
	PWS 3.8.X

OTA_HotelInvBlockNotifRQ

outbound

onPremise

OTA_

HotelInvBlockNotifRQ | InvBlocks |

InvBlock |

RoomTypes |

RoomType |

RoomTypeAllocations |

RoomTypeAllocation

Current

Codeblock

language	xml
collapse	true

<RoomTypeAllocations

RoomTypePickUpStatus="

Added two new optional attributes to be able to display the rategroups. Now the message is able to display the onPremise rate structure rategroup → ratecode → ratecodetails.

IPA-1079

22.24

Anker

PWS 3.8.X

OTA_HotelInvBlockNotifRQ

outbound

onPremise

Current

Codeblock

language	xml
collapse	true

<RoomTypeAllocations RoomTypePickUpStatus="X">X">
    <RoomTypeAllocation End="2022-08-01" NumberOfUnits="1" Start="2022-08-01"/>
    <RoomTypeAllocation End="2022-08-02" NumberOfUnits="1" Start="2022-08-02"/>
    <RoomTypeAllocation End="2022-08-03" NumberOfUnits="0" Start="2022-08-03"/>
    <RoomTypeAllocation End="2022-08-04" NumberOfUnits="0" Start="2022-08-04"/>
    <RoomTypeAllocation End="2022-08-05" NumberOfUnits="0" Start="2022-08-05"/>
    <RoomTypeAllocation End="2022-08-0106" NumberOfUnits="13" Start="2022-08-0106"/>
    <RoomTypeAllocation End="2022-08-0207" NumberOfUnits="10" Start="2022-08-0207"/>
    <RoomTypeAllocation End="2022-08-0308" NumberOfUnits="0" Start="2022-08-0308"/>
    <RoomTypeAllocation End="2022-08-0409" NumberOfUnits="0" Start="2022-08-0409"/>
    <RoomTypeAllocation End="2022-08-0510" NumberOfUnits="0" Start="2022-08-0510"/>
</RoomTypeAllocations>

Expected

Codeblock

language	xml
collapse	true

<RoomTypeAllocations RoomTypePickUpStatus="X">
    <RoomTypeAllocation End="2022-08-0602" NumberOfUnits="31" Start="2022-08-0601"/>
    <RoomTypeAllocation End="2022-08-0705" NumberOfUnits="0" Start="2022-08-0703"/>
    <RoomTypeAllocation End="2022-08-0806" NumberOfUnits="03" Start="2022-08-0806"/>
    <RoomTypeAllocation End="2022-08-0910" NumberOfUnits="0" Start="2022-08-0907"/>
    <RoomTypeAllocation End="2022-08-10" NumberOfUnits="0" Start="2022-08-10"/>
</RoomTypeAllocations>

Expected

</RoomTypeAllocations>

RoomTypeAllocation blocks will be grouped for consecutive dates per @NumberOfUnits. This will result in a shorter message. No schema change. Valid for all @RoomTypePickUpStatus supported.

PWS-3193

3.8.X

HTNG_HotelFolioNotifRQ

HTNG_HotelFolioRS

outbound

inbound

onPremise

or/and

Codeblock

language	xml
collapse	true

<RoomTypeAllocations RoomTypePickUpStatus="X">
    <RoomTypeAllocation End="2022-08-02" NumberOfUnits="1" Start="2022-08-01"/>
    <RoomTypeAllocation End="2022-08-05" NumberOfUnits="0" Start="2022-08-03"/>
    <RoomTypeAllocation End="2022-08-06" NumberOfUnits="3" Start="2022-08-06"/>
    <RoomTypeAllocation End="2022-08-10" NumberOfUnits="0" Start="2022-08-07"/>
</RoomTypeAllocations>

RoomTypeAllocation blocks will be grouped for consecutive dates per @NumberOfUnits. This will result in a shorter message. No schema change. Valid for all @RoomTypePickUpStatus supported.

PWS-3193

3.8.X

HTNG_HotelFolioNotifRQ

HTNG_HotelFolioRS

outbound

inbound

onPremise

or/and

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-31513.8.X

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

Codeblock

language	xml
collapse	true

<OTA_ProfileModifyRQ>
	<ProfileModify>
			<TPA_Extensions>
				<px:ProfileInfoExtensions>
					<px:PersonInfos>       <px:Salutation ID="1" ID_Context="protelIO" Type="Salutation">Dear Mrs. and Miss. Mustermann</px:Salutation>

When we receive a new salutation, it is now no longer overwritten. If the TPA_Extensions part is completely not in the XML, then the personal salutation is also not touched. In addition, the personal salutation is changed back if there is no personal salutation in the TPA_Extensions part. PWS-31793.8.X

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

Codeblock

language	xml
collapse	true

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

Add the TPA Extension Language to the profile messages.PWS-31503.8.XOTA_ReadRQinboundonPremise

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>

<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-31513.8.X

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

Codeblock

language	xml
collapse	true

<OTA_ProfileModifyRQ>
	<ProfileModify>

Current

Codeblock

language	xml
collapse	true

<RoomTypeAllocations RoomTypePickUpStatus="X">
    <RoomTypeAllocation End="2022-08-02" NumberOfUnits="2" Start="2022-08-01"/>
    <RoomTypeAllocation End="2022-08-06" NumberOfUnits="3" Start="2022-08-06"/>
</RoomTypeAllocations>

Expected

Codeblock

language	xml
collapse	true

<RoomTypeAllocations RoomTypePickUpStatus="X">
    <RoomTypeAllocation End="2022-08-02" NumberOfUnits="2" Start="2022-08-01"/>
    <RoomTypeAllocation End="2022-08-05" NumberOfUnits="0" Start="2022-08-03"/>
    <RoomTypeAllocation End="2022-08-06" NumberOfUnits="3" Start="2022-08-06"/>
    <RoomTypeAllocation End="2022-08-10" NumberOfUnits="0" Start="2022-08-07"/>
</RoomTypeAllocations>

If @RoomTypePickUpStatus is in ("4","5","13") and there are periods where there are no picked up reservations, then pAir will be still sending the "empty" periods as NumberOfUnits="2". No schema change.IPA-105022.18

HTNG_HotelFolioNotifRQ

HTNG_HotelFolioRS

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

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">ProfileInfoExtensions>
					<px:Room RoomID="303" />
				</px:ReadRequestExtensions>
			</TPA_Extension>
		</HotelReadRequest>
	</ReadRequests>
</OTA_ReadRQ>:PersonInfos>       <px:Salutation ID="1" ID_Context="protelIO" Type="Salutation">Dear Mrs. and Miss. Mustermann</px:Salutation>

When we receive a new salutation, it is now no longer overwritten. If the TPA_Extensions part is completely not in the XML, then the personal salutation is also not touched. In addition, the personal salutation is changed back if there is no personal salutation in the TPA_Extensions part. PWS-31793.8.X

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

outboundonPremiseOTA_ProfileModifyRQ | ProfileModify | Extend the OTA_ReadRQ to search for the RoomIDIPA-102922.18

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

OTA_HotelResNotifRQ

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

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

px:FirstNameAtBirth

px:LastNameMother

px:FirstNameMother

Language

Codeblock

language	xml
collapse	true		true

<OTA_ProfileModifyRQ>
	<ProfileModify>
			<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.18

:Language DefaultInd="true">en-us</px:Language>

Add the TPA Extension Language to the profile messages.PWS-31503.8.XOTA_ReadRQinboundonPremise

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 RoomIDPWS-31303.8.XIPA 22.14 AnkerIPA 22.14IPA 22.14HTNG_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-103022.14

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

...

Seitenhierarchie

Versionen im Vergleich

Alte Version 389

Neue Version 390

Schlüssel