This instance is currently being migrated to the new Atlassian One Confluence sytem.
If you can't find your space anymore, it should be already in the new System: https://confluence.weareplanet.com/
...
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 |
Affected Message | Direction from protel | PMS | Path | Example | Summary | Internal reference | Version | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
TBA IDS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TBA PWS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OTA_ReadRQ | inbound | onPremise | OTA_ReadRQ | ReadRequests | HotelReadRequest | TPA_Extensions | px:ReadRequestExtensions | px:Room | @RoomID |
| Extend the OTA_ReadRQ to search for the RoomID | PWS-3130 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PWS-3128 | inbound | OnPremise | OTA_ProfileCreateRQ | Profile | Customer | PersonName | @MiddleName OTA_ProfileModifyRQ | ProfileModify | Customer | PersonName | @MiddleName |
| Extend the Profile inbound, import as well the MiddleName | PWS-3128 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TBA IPA | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OTA_ProfileCreateRQ OTA_ProfileModifyRQ | outbound | pAir | OTA_ProfileCreateRQ | Profile | TPA_Extensions | px:ProfileInfoExtensions | px:StatisticalInfos | px:ParentProfile OTA_ProfileModifyRQ | ProfileModify | TPA_Extensions | px:ProfileInfoExtensions | px:StatisticalInfos | px:ParentProfile |
| Add the new official XSD TPA_Extensions "px:ParentProfile " | IPA-1015 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IPA 22.10 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OTA_HotelResNotifRQ | outbound | pAir | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | RoomStays | RoomStay | DepositPayments |
| Add Deposit Paid to outbound Reservation Message. | IPA-1014 | 22.10 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IDS 6.095 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OTA_HotelRatePlanNotifRQ | outbound | OnPremise pAir | OTA_HotelRatePlanNotifRQ | RatePlans | RatePlan | Rates | Rate | AdditionalGuestAmounts | AdditionalGuestAmount | @TaxInclusive OTA_HotelRatePlanNotifRQ | RatePlans | RatePlan | Rates | Rate | AdditionalGuestAmounts | AdditionalGuestAmount | Taxes | @Amount OTA_HotelRatePlanNotifRQ | RatePlans | RatePlan | Rates | Rate | AdditionalGuestAmounts | AdditionalGuestAmount | Taxes | @CurrencyCode |
| Include tax details per child bucket | IDS-524 | 6.095 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OTA_HotelRateAmountNotifRQ | outbound | OnPremise pAir | OTA_HotelRateAmountNotifRQ | RatePlans | RatePlan | Rates | Rate | AdditionalGuestAmounts | AdditionalGuestAmount | @TaxInclusive OTA_HotelRateAmountNotifRQ | RatePlans | RatePlan | Rates | Rate | AdditionalGuestAmounts | AdditionalGuestAmount | Taxes | @Amount OTA_HotelRateAmountNotifRQ | RatePlans | RatePlan | Rates | Rate | AdditionalGuestAmounts | AdditionalGuestAmount | Taxes | @CurrencyCode |
| Include tax details per child bucket | IDS-524 | 6.095 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PWS 3.7.X | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HTNG_ChargePostingRQ | inbound | OnPremise | HTNG_ChargePostingRQ | Posting | Transaction | RevenueDetails | RevenueDetail | Account |
| Allow as well posting against external IDs | PWS-3112 | 3.7.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OTA_ProfileCreateRQ OTA_ProfileModifyRQ | outbound | OnPremise | OTA_ProfileCreateRQ | Profile | TPA_Extensions | px:ProfileInfoExtensions | px:StatisticalInfos | px:ParentProfile OTA_ProfileModifyRQ | ProfileModify | TPA_Extensions | px:ProfileInfoExtensions | px:StatisticalInfos | px:ParentProfile |
| Remove the existing TPA_Extensions
And add the new official XSD TPA_Extensions "px:ParentProfile " | PWS-3097 | 3.7.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OTA_HotelResNotifRQ | outbound | OnPremise | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | RoomStays | RoomStay | Guarantee |
| assigned credit cards will be displayed in the outbound Reservation message | PWS-1089 | 3.7.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HTNG_ChargePostingRQ | inbound | OnPremise | HTNG_ChargePostingRQ | Posting | Transaction | RevenueDetails | RevenueDetail | Account |
| Posted Revenue / Payment is possible against External ResID. | PWS-3112 | 3.7.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IO_RatePackageNotifRQ | outbound | OnPremise | IO_RatePackageNotifRQ | Packages | Package | Validity IO_RatePackageNotifRQ | Packages | Package | PackageItem | Validity |
| Remove the time stamp from the Validity element according to our XSD | PWS-3092 | 3.7.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PWS 3.6.X | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OTA_HotelAvailNotifRQ | inbound | OnPrem | OTA_HotelAvailNotifRQ | AvailStatusMessages | AvailStatusMessage | RestrictionStatus |
| Implement Close to Departure as a new restriction in OnPrem | PWS-3012 | PWS 3.6.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HTNG_HotelChargePostingRQ | inbound | OnPrem | HTNG_HotelChargePostingRQ | Posting | Transaction | RevenueDetails | RevenueDetail | @ReferenceID |
| 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 provided | PWS-2996 | PWS 3.6.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IO_RatePackageNotifRQ | outbound | OnPrem | IO_RatePackageNotifRQ | Packages | Package | PackageItem | Calculation |
| Fix the values for the Recurrence Attribute Possible Recurrence
| PWS-3001 | PWS 3.6.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OTA_HotelResNotifRQ | outbound | OnPrem | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | TPA_Extensions | px:ReservationExtensions | px:FixedCharges | px:FixedCharge | px:ServiceDates | px:ServiceDate |
| Add the new Element "SerivceDates" This Element will be displayed for the Recurrence= "floating" Possible Recurrence
| PWS-2547 | PWS 3.6.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HTNG_HotelFolioRS | outbound | OnPrem | HTNG_HotelFolioNotifRQ | Folios | Folio | RevenueDetails | RevnueDetail | FolioIDs | FolioID |
| Add a short in front of the FolioID Element, to describe what is displayed Possible values
| PWS-2961 | PWS 3.5.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
HTNG_HotelFolioNotifRQ | outbound | OnPrem | HTNG_HotelFolioNotifRQ | Folios | Folio | RevenueDetails | RevnueDetail | FolioIDs | FolioID |
| Add a short in front of the FolioID Element, to describe what is displayed Possible values
| PWS-2961 | PWS 3.5.X | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IO_StatsNotifRQ | outbound | OnPrem | IO_StatsNotifRQ | Statistics | Statistic | StatisticApplicationSet | RevenueCategorySummaries |
| If the all value for the RevenueCategorySummaries is zero, we will not display the Element | PWS-2998 | PWS 3.5.X | PWS 3.5.X||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anker | PWS 3.5.X | PWS 3.5.X | HTNG_HotelFolioRS | outbound | OnPrem | HTNG_HotelFolioNotifRQ | Folios | Folio | RevenueDetails | RevnueDetail | FolioIDs | FolioID |
Codeblock | ||||
---|---|---|---|---|
| ||||
<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 | ||||
---|---|---|---|---|
| ||||
<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
Codeblock | ||||
---|---|---|---|---|
| ||||
<RevenueCategory RevenueCategoryCode="2000">
<SummaryAmount CurrencyCode="AED" Amount="-122.50"/>
<RevenueDetails>
<RevenueDetail ReferenceID="575679481" TransactionDate="2019-08-30" RatePlanCode="0" Description="MASTER CARD" PMSRevenueCode="12" CurrencyCode="AED" Amount="-32.40">
<FolioIDs>
<FolioID>InvID|408918</FolioID>
<FolioID>ResID|2390678</FolioID>
<FolioID>GstID|5391177</FolioID>
<FolioID>TAAGrp|PAYMENTS</FolioID>
</FolioIDs>
</RevenueDetail>
<RevenueDetail ReferenceID="575679479" TransactionDate="2019-08-30" RatePlanCode="0" Description="CASH (AED)" PMSRevenueCode="1" CurrencyCode="AED" Amount="-20.0">
<FolioIDs>
<FolioID>InvID|408918</FolioID>
<FolioID>ResID|2390678</FolioID>
<FolioID>GstID|5391177</FolioID>
<FolioID>TAAGrp|PAYMENTS</FolioID>
</FolioIDs>
</RevenueDetail>
<RevenueDetail ReferenceID="575679478" TransactionDate="2019-08-30" RatePlanCode="0" Description="DISCOVERY Dollars" PMSRevenueCode="146" CurrencyCode="AED" Amount="-55.10">
<FolioIDs>
<FolioID>InvID|408918</FolioID>
<FolioID>ResID|2390678</FolioID>
<FolioID>GstID|5391177</FolioID>
<FolioID>TAAGrp|PAYMENTS</FolioID>
</FolioIDs>
</RevenueDetail>
<RevenueDetail ReferenceID="575679480" TransactionDate="2019-08-30" RatePlanCode="0" Description="JCB CARD" PMSRevenueCode="14" CurrencyCode="AED" Amount="-15.00">
<FolioIDs>
<FolioID>InvID|408918</FolioID>
<FolioID>ResID|2390678</FolioID>
<FolioID>GstID|5391177</FolioID>
<FolioID>TAAGrp|PAYMENTS</FolioID>
</FolioIDs>
</RevenueDetail>
</RevenueDetails> |
Add a new @RevenueCategoryCode = 2000 for Payments
needs to be disabled via Xsetup
OTA_ProfileCreateRQ
Codeblock | ||||
---|---|---|---|---|
| ||||
<ProfileModify RPH="155474" LastModifyDateTime="2021-08-11T15:08:20.1833472+02:00" StatusCode="3" /> |
Extend the StatusCode for Profiles
1= Marked for deletion
2= anonymized profile
3=deleted profile
4 = active
- OTA_HotelResNotifRQ | HotelReservations | HotelReservation | TPA_Extensions | px:UserDefinedFieldExtensions
- OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Customer | px:TPA_Extensions | px:UserDefinedFieldExtensions
- OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | TPA_Extensions | px:UserDefinedFieldExtensions
Codeblock | ||||
---|---|---|---|---|
| ||||
<TPA_Extensions xmlns:px="http://protel.io/htng/extensions">
<px:UserDefinedFieldExtensions>
<px:UserDefinedField Name="BWI Group" Type="Integer">local</px:UserDefinedField>
<px:UserDefinedField Name="BWI Cancellation Date" Type="Date"/>
<px:UserDefinedField Name="BWI Cancellation Time" Type="DateTime"/>
<px:UserDefinedField Name="BWI Groupratecode" Type="String">GRP Test</px:UserDefinedField>
</px:UserDefinedFieldExtensions>
</TPA_Extensions> |
OTA_ProfileModifyRQ | ProfileModify | TPA_Extensions | px:ProfileInfoExtensions | PersonInfos | Registration | @LicensePlate
Codeblock | ||||
---|---|---|---|---|
| ||||
<px:TPA_Extensions xmlns:px="http://protel.io/htng/extensions">
<px:ProfileInfoExtensions>
<px:PersonInfos>
<px:Registration LicensePlate="AB-12345" />
</px:PersonInfos>
<px:Salutation ID="1" ID_Context="protelIO" Type="Salutation">Dear Mrs. memari21</px:Salutation>
</px:ProfileInfoExtensions>
<px:UserDefinedFieldExtensions>
<px:UserDefinedField Name="Pet Name" Type="String">pepelolo</px:UserDefinedField>
</px:UserDefinedFieldExtensions>
</px:TPA_Extensions> |
OTA_ProfileCreateRQ
OTA_ProfileCreateRQ | Profile | CompanyInfo | CompanyName
Codeblock | ||||
---|---|---|---|---|
| ||||
<OTA_ProfileCreateRQ>
<UniqueID Type="4" ID="615" ID_Context="External"/>
<Profile>
<CompanyInfo>
<CompanyName CompanyShortName="CKO" Department="DEP">Protel Hotelsoftware GmbH</CompanyName> |
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ | ProfileModify | Comments | Comment
OTA_ProfileCreateRQ | ProfileModify | Comments | Comment
Codeblock | ||||
---|---|---|---|---|
| ||||
<ProfileModify ShareAllOptOutInd="Yes" ProfileType="1" CreateDateTime="2021-01-20T14:42:00" CreatorID="protelIO" RPH="155522" LastModifyDateTime="2021-09-29T12:34:49" LastModifierID="protel 37" StatusCode="4">
<Customer Gender="Unknown" Language="ENG">
<PersonName>
<GivenName>ali</GivenName>
<Surname>memari13</Surname>
</PersonName>
<Telephone ShareMarketInd="No" PhoneNumber="123456" PhoneLocationType="6" PhoneTechType="1" FormattedInd="false" DefaultInd="true" />
<Address FormattedInd="false" ShareMarketInd="No" Type="1" DefaultInd="true" UseType="6">
<AddressLine>str01</AddressLine>
<StateProv/>
<CountryName Code="DE">Germany</CountryName>
</Address>
<CitizenCountryName DefaultInd="true" Code="DE" />
<Document />
<EmployerInfo CompanyShortName="" Department=""/>
</Customer>
<TPA_Extensions xmlns:px="http://protel.io/htng/extensions" />
<Comments>
<Comment Name="Customer_Comment">
<Text TextFormat="PlainText">Remark visible to all Hotels</Text>
</Comment>
<Comment Name="Restaurant_Comment">
<Text TextFormat="PlainText">Notes to restaurant</Text>
</Comment>
</Comments>
</ProfileModify> |
pws | override_profile_notes
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ | ProfileModify | Customer | Address
Codeblock | ||||
---|---|---|---|---|
| ||||
<OTA_ProfileModifyRQ>
<UniqueID Type="4" ID="615" ID_Context="External"/>
<ProfileModify ShareAllOptOutInd="Yes" ProfileType="1" CreateDateTime="2021-08-11T12:42:00" CreatorID="protel 1" RPH="12" LastModifyDateTime="2021-08-31T09:05:24" LastModifierID="protel 1" StatusCode="4">
<Customer Gender="Male" BirthDate="1980-10-20" VIP_Indicator="true" Language="de" CustomerValue="V6 – Previous Feedback Guest|0;V7 – Long Stay Guest |2;V8 – Black Listed Guest|2">
<Address FormattedInd="false" ShareMarketInd="No" Type="1" DefaultInd="true" UseType="6">
<AddressLine>Main Address 110</AddressLine>
<CityName>Osterode</CityName>
<PostalCode>37520</PostalCode>
<StateProv>Niedersachsen</StateProv>
<CountryName Code="DE">Germany</CountryName>
</Address> |