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
24.18	2024-05-01 ???
24.16	2024-04-17
24.14	2024-04-03
24.12	2024-03-20
24.10	2024-03-06
24.08	2024-02-21
24.06	2024-02-07
24.04	2024-01-24
24.02	2024-01-10

Release dates PWS (onPrem) LIVE Environment

Version	Release date
3.18	2024-04-17
3.17	2024-03-06
3.16	2023-12-20

TBA IDS

TBA PWS

HTNG_HotelRoomStatusUpdateNotifRQ

outbound / inbound

OnPrem

Message implemented for outbound and inbound processing.

PWS-3202
PWS-3246

TBA

TBA IPA

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

outbound

inbound

pAir

Customer | TPA_Extensions | px:ProfileInfoExtensions | px:AccountingInfos

Codeblock

language	xml
collapse	true

We extend the AccountingInfos with the attributes

@FiscalUID

@CompanyRegNumber

IPA-1377

IPA-1378

TBA

OTA_HotelResNotif

outbound

inbound

pAir

Codeblock

language	xml
collapse	true

We extend the AccountingInfos with the attributes

@FiscalUID

@CompanyRegNumber

IPA-1377

IPA-1378

TBA

OTA_HotelStayInfoNotifRQ

outbound

pAir

Codeblock

language	xml
collapse	true

We extend the AccountingInfos with the attributes

@FiscalUID

@CompanyRegNumber

IPA-1377

TBA

IO_InvoiceFiscalizeRQ

outbound

pAir

IO_InvoiceFiscalizeRQ | Invoice | InvoiceRecipient | AccountingInfos

Codeblock

language	xml
collapse	true

We extend the AccountingInfos with the attributes

@FiscalUID

@CompanyRegNumber

IPA-1380

TBA

IO_InvoiceFiscalizeRQ

outbound

pAir

no schema change

no change in the Schema.

To be legal in Portugal, an IO_InvoiceFiscalizeRQ needs to be triggered as soon as an Proforma or Info Invoice is created.

IPA-1345

TBA

OTA_HotelResNotifRQ

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

OTA_HotelStayInfoNotifRQ

outbound / inbound

pAir

OTA_ProfileModifyRQ | ProfileModify | Customer | Document

Codeblock

language	xml
collapse	true

<OTA_ProfileCreateRQ>
	<Profile>
		<Customer>
			<Document DocIssueLocation="Dortmund_22" DocID="123456" DocType="4" EffectiveDate="2018-12-12" ExpireDate="2050-12-31" DocIssueAuthority="1234"/>
		</Customer>
	</Profile>
</OTA_ProfileCreateRQ>

To be legal in Austria, a new Attribute is added to the Document Element with the label "Issuing Authorities"

IPA-1369

TBA

OTA_HotelResNotifRQ

outbound / inbound

pAir

Codeblock

language	xml
collapse	true

<TPA_Extensions>
    <px:GuestStayExtensions>
        <px:StayInfo Arrival="2024-02-07T12:00:00+01:00" Departure="2024-02-08T12:00:00+01:00" PrimaryInd="true" Role="LinkedProfile" Status="Reserved"/>
        <px:TelephoneSetting ClassOfService="3"/>
    </px:GuestStayExtensions>
</TPA_Extensions>

There is now a new function in the PMS so that the PrimaryInd= true attribute can be used to specify the profile of the leading company OR the travel agency within the same reservation.

IPA-1357

IPA-1358

TBA

IO_InvoiceFiscalizeRQ

outbound

pAir

IO_InvoiceFiscalizeRQ | Invoice | AdditionalText

Codeblock

language	xml
collapse	true

Due to the legal requirements in Romania, we are extend the invoice element with a new element for the additional text for invoices.

IPA-1367

TBA

IO_InvoiceFiscalizeRQ

outbound

pAir

IO_InvoiceFiscalizeRQ | Invoice | InvoiceFormat

Codeblock

language	xml
collapse	true

Due to the legal requirements in Romania, we are expanding the invoice element with a new element for the invoice format for invoices.

IPA-1365

TBA

IO_SystemDataRS

outbound

pAir

IO_SystemDataRS | SystemData | Accounting | InvoiceFormat

Codeblock

language	xml
collapse	true

Due to the legal requirements in Romania, we are expanding the Accounting element with a new element for the invoice format for invoices.

IPA-1365

TBA

IO_InvoiceFiscalizeNotifRQ

outbound

pAir

IO_InvoiceFiscalizeRQ | Invoice | InvoiceRecipient | AccountingInfos

Codeblock

language	xml
collapse	true

<p:InvoiceRecipient ProfileID="1263" ProfileType="Customer">
					<p:FirstName>test</p:FirstName>
					<p:LastName>protel</p:LastName>
					<p:Nationality>IT</p:Nationality>
					<p:Language>it_IT</p:Language>
					<p:Notes/>
					<p:Gender/>
					<p:Addresses/>
					<p:UserDefinedFields>
						<p:UserDefinedField Name="CT_Esenzioni" Type="List">NOE-NON ESENTE</p:UserDefinedField>
						<p:UserDefinedField Name="Category" Type="List">1 - Other</p:UserDefinedField>
						<p:UserDefinedField Name="CT_Riduzioni" Type="List">NOR-NON RIDOTTO</p:UserDefinedField>
					</p:UserDefinedFields>
					<p:AccountingInfos PublicAdministrationInd="true" SplitPaymentInd="true"/>
				</p:InvoiceRecipient>

Due to legal requirements in Italy, we extend
the AccountingInfos with the attributes

@PublicAdministrationInd

@SplitPaymentInd

IPA-1363

TBA

IO_InvoiceFiscalizeRQ

outbound

pAir

IO_InvoiceFiscalizeRQ | Invoice

Codeblock

language	xml
collapse	true

Due to legal requirements in Portugal, we are expanding
the invoice element with the attributes from the fiscal code in the systemdata:

@SystemFiscalCode1 for ATCUD

@SystemFiscalCode2 for NIF

@SystemFiscalCode3 for SAFT

IPA-1350

TBA

PWS 3.17.X

Anker

	PWS 3.17.X
	PWS 3.17.X

OTA_HotelInvBlockNotifRQ

outbound

OnPrem

Codeblock

language	xml
collapse	true

<RatePlan CurrencyCode="EUR" End="2100-01-01" MaxGuestApplicable="9999" RatePlanCode="StdRateExclTax" Start="1980-01-01" TaxInclusive="false">

Flag is linked to the system setup for rate values. If the PWS is set to send "net values only", the attribute will be send with "false". If the system is set up to send "gross values only" OR "net and gross values", the attribute will be send with "true".

PWS-3729

3.17.0

PWS 3.16.X

Anker

	PWS 3.16.X
	PWS 3.16.X

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

outbound

OnPrem

no schema change

With OnPrem 23.060 it will be possible to store more than one travel document per profile so that the outbound profile messages may contain more than one document element.

PWS-3723

3.16.0

OTA_HotelResNotifRQ

outbound

OnPrem

Codeblock

language	xml
collapse	true

<RelatedTraveler BirthDate="2006-03-05">
	<UniqueID ID="181493" ID_Context="protelIO" Type="1"/>
	<PersonName Language="de">
		<NamePrefix/>
		<GivenName>Tick</GivenName>
		<MiddleName/>
		<Surname>Duck</Surname>
		<Document DocID="987654321" DocType="5"/>
	</PersonName>
	<TPA_Extensions>
		<px:GuestStayExtensions>
			<px:StayInfo PrimaryInd="false" RelationToPrimary="Neffe / Nichte"/>
		</px:GuestStayExtensions>
	</TPA_Extensions>
</RelatedTraveler>

The legal requirements in Spain stipulate that additional guests can be related to the main guest.

The relationship to the main guest can soon be transferred by the additional attribute with.

This is for example important for police reports.

PWS-3697

3.16.0

OTA_HotelResNotifRQ

outbound

OnPrem

OTA_HotelResNotifRQ | HotelReservations | HotelReservation | TPA_Extensions | px:Traces

No change in XML, but traces from the past (before the current PMS business date) are no longer sent.

PWS-3676

3.16.0

OTA_ProfileModifyRQ

outbound

OnPrem

Codeblock

collapse	true

<TPA_Extensions xmlns:px="http://protel.io/htng/extensions">
    <px:ProfileInfoExtensions>
        <px:PersonInfos>
            <px:MarketingCodes>
                <px:Code DefaultInd="false" DisplaySequence="0" ID="3" ID_Context="protelIO" Type="MARKETINGCODE">Wintergast</px:Code>
            </px:MarketingCodes>
            <px:Registration BirthCountry="DE" BirthPlace="Oberhausen">
                <px:Occupation>Polizist</px:Occupation>
            </px:Registration>
            <px:Language DefaultInd="true">en</px:Language>
        </px:PersonInfos>
        <px:Salutation ID="1" ID_Context="protelIO" Type="Salutation">Sehr geehrte Frau Werner</px:Salutation>
    </px:ProfileInfoExtensions>
</TPA_Extensions>

The attribute occupation was added.

PWS-3714

3.16.0

IO_ResModifyNotifRQ

inbound

OnPrem

IO_ResModifyNotifRQ | Reservations | Reservation | ProfileReferences | ProfileReference

@RelationToPrimary

Codeblock

language	xml
collapse	true

<p:IO_ResModifyNotifRQ xmlns:p="http://protel.io/soap" CorrelationID="UseCase11b" TimeStamp="2018-12-29T15:20:35.985Z" Version="1.00">
    <p:Reservations HotelCode="3152">
        <p:Reservation ArrivalDate="2018-11-11">
            <p:UniqueID ID="345474" Type="Reservation" ID_Context="Protel_IO"/>
            <p:ProfileReferences>
                <p:ProfileReference ID_Context="protelIO" Type="Customer" ID="181491" RelationToPrimary="Son" Action="CREATE"/>
            </p:ProfileReferences>
        </p:Reservation>
    </p:Reservations>
</p:IO_ResModifyNotifRQ>

The legal requirements in Spain stipulate that additional guests can be related to the main guest.

The relationship to the main guest can be transferred by the additional attribute for UseCase 11b only.

The relation is for example important for police reports.

PWS-3700

3.16.0

OTA_HotelResNotifRQ

OTA_HotelStayInfoNotifRQ

OTA_ProfileCreateRQ

OTA_ProfileCreateRQ

outbound

OnPrem

Codeblock

language	xml
collapse	true

<Customer>
    <TPA_Extensions>
    ....
        <ProfileInfoExtensions>
        ....
            <PersonInfos>
            ....           
                <Registration BirthDate="1980-01-06" BirthCountry="MA">
                    <Occupation>Mechanic</Occupation>
                    <DocumentInfos>                 
                      <DocumentInfo RPH="665554444" ID_Context="SNDS" ID="120-24440-GV0" Type="DocumentIdentifier"/>
                    </DocumentInfos>
                </Registration> 
            </PersonInfos>
        </ProfileInfoExtensions> 
    </TPA_Extensions>
</Customer>

Due to Spanish legal requirements (Police reports), we extend the TPA extensions in the Customer element with DocumentInfo for the support number of Spanish documents.

PWS-3712

3.16.0

OTA_HotelResNotifRQ

OTA_ProfileCreateRQ

OTA_ProfileCreateRQ

inbound

OnPrem

Codeblock

language	xml
collapse	true

<Customer>
    <TPA_Extensions>
    ....
        <ProfileInfoExtensions>
        ....
            <PersonInfos>
            ....           
                <Registration BirthDate="1980-01-06" BirthCountry="MA">
                    <Occupation>Mechanic</Occupation>
                    <DocumentInfos>                 
                      <DocumentInfo RPH="665554444" ID_Context="SNDS" ID="120-24440-GV0" Type="DocumentIdentifier"/>
                    </DocumentInfos>
                </Registration> 
            </PersonInfos>
        </ProfileInfoExtensions> 
    </TPA_Extensions>
</Customer>

Due to Spanish legal requirements (Police reports), we extend the TPA extensions in the Customer element with DocumentInfo for the support number of a Spanish documents.

PWS-3713

3.16.0

OTA_ProfileCreateRQ

inbound

OnPrem

no change in xml

Codeblock

language	xml
collapse	true

<Customer Gender="Male" BirthDate="2020-01-01" VIP_Indicator="true" Language="de" CustomerValue="ECA - 10%|0;VIP|2">
	<PersonName>
		<NamePrefix>Herr</NamePrefix>
		<GivenName>Donald</GivenName>
		<Surname>Duck</Surname>
	</PersonName>
	<CitizenCountryName DefaultInd="true" Code="DE"/>
	<Document DocID="123456798" DocIssueLocation="" DocType="2" EffectiveDate="2020-01-01" ExpireDate="2030-01-01"/>
	<Document DocID="963852" DocType="1" EffectiveDate="2021-10-10"/>
</Customer>

With OnPrem version 23.060 and higher it is possible to send more than one document per profile.

PWS-3651

3.16.0

OTA_HotelResNotifRQ

OTA_ProfileCreateRQ

outbound / inbound

OnPrem

Codeblock

language	xml
collapse	true

<px:ProfileInfoExtensions>
    <px:PersonInfos>
        <px:Registration BirthCountry="DE" BirthPlace="Entenhausen">
            <LicensePlate>ENT-DD 1</LicensePlate>
        </px:Registration>
    </px:PersonInfos>
</px:ProfileInfoExtensions>

Corrected the xml to follow the schema.

PWS-3711

3.16.0

ESB 323

Anker

	ESB 323
	ESB 323

HTNG_ChargePostingRS

outbound

onPrem

pAir

HTNG_ChargePostingRS | Errors | Error

Codeblock

language	xml
collapse	true

<Errors>
                <Error Code="188" Type="1" ShortText="Transaction error - please report. Incomplete Posting flow. Please check the guest folio before a retry."/>
            </Errors>

If no RS is generated by the PMS service within ~55 seconds, then:

the ESB will not do retries itself
the ESB will generate a generic RS to inform the sender of the RQ about the failure.

! The RQ should not be automatically retried - the posting itself could have happened, yet for some reason - no RS could have been generated by the PMS service (e.g. fiscalization error).

IO-7390

ESB 323

IPA 24.08

Anker

	IPA 24.08
	IPA 24.08

IO_SystemDataRS

outbound

pAir

IO_SystemDataRS | SystemData | Reservations | GuestRelationTypes | GuestRelationType

Codeblock

language	xml
collapse	true

<ns2:GuestRelationTypes>
						<ns2:GuestRelationType Code="Abuelo" ID="1" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Abuelo</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Abuela" ID="2" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Abuela</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Padre" ID="3" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Padre</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Madre" ID="4" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Madre</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Tio" ID="5" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Tio</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Tia" ID="6" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Tia</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Tutor Legal" ID="7" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Tutor Legal</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Hijo" ID="8" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Hijo</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Hija" ID="9" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Hija</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Nieto" ID="10" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Nieto</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Nieta" ID="11" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Nieta</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Sobrino" ID="12" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Sobrino</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Sobrina" ID="13" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Sobrina</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Primo" ID="14" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Primo</ns2:Name>
						</ns2:GuestRelationType>
						<ns2:GuestRelationType Code="Prima" ID="15" ID_Context="protelIO" PrimaryInd="false" Visible="true">
							<ns2:Name Language="es_ES">Prima</ns2:Name>
						</ns2:GuestRelationType>
					</ns2:GuestRelationTypes>

Due to legal requirements in Spain, we are expanding
the GuestRelationTypes element with the attributes from the relationship types.

IPA-1353

24.08

IPA 24.02

Anker

	IPA 24.02
	IPA 24.02

OTA_ProfileCreateRQ

OTA_ProfileModifyRQ

outbound

inbound

pAir

Customer | TPA_Extensions | px:ProfileInfoExtensions | px:AccountingInfos

Codeblock

language	xml
collapse	true

<Customer>
	<TPA_Extensions>
    ....
        <ProfileInfoExtensions>
            ....         
                <px:AccountingInfos PublicAdministrationInd="true" SplitPaymentInd="true"/>
		</ProfileInfoExtensions>
	</TPA_Extensions>
</Customer>

Due to legal requirements in Italy, we extend
the AccountingInfos with the attributes

@PublicAdministrationInd

@SplitPaymentInd

IPA-1346

IPA-1339

24.02

OTA_HotelResNotif

outbound

inbound

pAir

Codeblock

language	xml
collapse	true

<Customer>
	<TPA_Extensions>
    ....
        <ProfileInfoExtensions>
            ....         
                <px:AccountingInfos PublicAdministrationInd="true" SplitPaymentInd="true"/>
		</ProfileInfoExtensions>
	</TPA_Extensions>
</Customer>

Due to legal requirements in Italy, we extend
the AccountingInfos with the attributes

@PublicAdministrationInd

@SplitPaymentInd

IPA-1346

IPA-1339

24.02

OTA_HotelStayInfoNotifRQ

outbound

pAir

Codeblock

language	xml
collapse	true

<Customer>
	<TPA_Extensions>
    ....
        <ProfileInfoExtensions>
            ....         
                <px:AccountingInfos PublicAdministrationInd="true" SplitPaymentInd="true"/>
		</ProfileInfoExtensions>
	</TPA_Extensions>
</Customer>

Due to legal requirements in Italy, we extend
the AccountingInfos with the attributes

@PublicAdministrationInd

@SplitPaymentInd

IPA-1339

24.02

OTA_HotelAvailNotifRQ

outbound

inbound

pAir

OTA_HotelAvailNotifRQ |

@MessageContentCode

no changes in xml - new values for MessageContentCode

We use the value 4 for the restrictions on rate group level.

IPA-1334

24.02

OTA_ResRetrieveRS

outbound

pAir

@GroupName
@GroupID
@PrimaryInd

@GroupName
@GroupID
@PrimaryInd

Codeblock

collapse	true

<TPA_Extensions>
  <px:ReservationGroupExtensions >
    <px:GroupInfo GroupName="Viaggi in Stile SpA -2022-01-17" GroupID="113" PrimaryInd="true" />
  </px:ReservationGroupExtensions >
</TPA_Extensions>

Due to Italian legal requirements (Police reports and Tourism Statistics), we're extending the schema to be able to export information about groups: group name, group ID and group leader.
On reservation level, PrimaryInd="true" will be shown for the reservation containing the group leader profile, all other reservations of this group will be shown with PrimaryInd="false".

On profile/resguest level, PrimaryInd="true" will be shown for the group leader profile, all other profiles of this group will be shown with PrimaryInd="false".

IPA-1040

24.02

...

Seitenhierarchie

Versionen im Vergleich

Alte Version 589

Neue Version 590

Schlüssel