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.
Affected Message | Direction from protel | PMS | Path | Example | Summary | Internal reference | Version | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
TBA IDS | |||||||||||||||||||||||||||||||||||||||||
TBA PWS | |||||||||||||||||||||||||||||||||||||||||
OTA_ResRetrieveRS | outbound | onPrem | OTA_ResRetrieveRS | ReservationsList | HotelReservation | @RoomNumberLockedIndicator |
| This indicates if a room number has been permanently assigned. | PWS-3650 | |||||||||||||||||||||||||||||||||||
OTA_ResRetrieveRS | outbound | onPrem | OTA_ResRetrieveRS | ReservationsList | HotelReservation | RoomStays | RoomStay | RoomTypes | RoomType | TPA_Extensions | pxs:RoomStatusExtensions | pxs:HouseKeepingInfo | @RoomStatus |
| Displays the current status of the room for arrivals and in-house guests. | PWS-3650 | |||||||||||||||||||||||||||||||||||
OTA_HotelResNotifRQ | outbound | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | @RoomNumberLockedIndicator |
| This indicates if a room number has been permanently assigned. | PWS-3650 | ||||||||||||||||||||||||||||||||||||
OTA_HotelResNotifRQ | outbound | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | RoomStays | RoomStay | RoomTypes | RoomType | TPA_Extensions | pxs:RoomStatusExtensions | pxs:HouseKeepingInfo | @RoomStatus |
| Displays the current status of the room for arrivals and in-house guests. | PWS-3650 | ||||||||||||||||||||||||||||||||||||
OTA_HotelResNotifRQ | outbound | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | TPA_Extensions | px:Traces | No change in the XML, but traces from the past (before the current PMS date) are no longer sent. | PWS-3676 | |||||||||||||||||||||||||||||||||||||
TBA IPA | |||||||||||||||||||||||||||||||||||||||||
IO_ResModifyNotifRQ | inbound | pair | IO_ResModifyNotifRQ | Reservations | Reservation | ProfileReferences | ProfileReference @RelationToPrimary |
| 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. | IPA-1314 | |||||||||||||||||||||||||||||||||||
OTA_ResRetrieveRS | outbound | pAir | OTA_ResRetrieveRS | ReservationsList | HotelReservation | @GroupName ResGuests | ResGuest | Profile | TPA_Extensions | px:ReservationGroupExtensions | px:GroupInfo| @GroupName |
| 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 profile 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 | |||||||||||||||||||||||||||||||||||
ESB 323 | |||||||||||||||||||||||||||||||||||||||||
HTNG_ChargePostingRS | outbound | onPrem pAir | HTNG_ChargePostingRS | Errors | Error |
| If no RS is generated by the PMS service within ~55 seconds, then:
! 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 | ||||||||||||||||||||||||||||||||||
PWS 3.14.X
| |||||||||||||||||||||||||||||||||||||||||
OTA_ProfileModifyRQ | In/Outbound | onPrem | ProfileModify | Customer | TPA_Extensions | ProfileInfoExtensions | PersonInfos | Registration |
| Implmented guest BirthCountry & BirthPlace in profile messages, both inbound and outbound. | PWS-3571 | 3.14.X | ||||||||||||||||||||||||||||||||||
OTA_ProfileModifyRQ | In/Outbound | onPrem | ProfileModify | Customer | TPA_Extensions | ProfileInfoExtensions | AccountingInfos |
| Implemented Tax1 and Tax2 attributes in the profile messages. | PWS-3590 | 3.14.X | ||||||||||||||||||||||||||||||||||
IO_SystemDataRS | Outbound | onPrem | IO_SystemDataRS | Reservations | DefaultValues |
| The default arrival / departure time which is set by hotel can be displayed in the reservation section of IO_SystemDataRS | PWS-3573 | 3.14.X | ||||||||||||||||||||||||||||||||||
HTNG_HotelCheckOutNotifRQ | Inbound | onPrem | HTNG_HotelCheckOutNotifRQ | RetransmissionIndicator |
| Implemented the RetransmissionIndicator. When true, indicates the message is being re-sent. The RS message will hold all invoices attached to the reservation for the CO guest. | PWS-3542 | 3.14.X | ||||||||||||||||||||||||||||||||||
OTA_HotelResNotifRQ | Inbound | onPrem | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | Services | Service |
| For Transaction Action "Modify": If Service/@ID="RemoveAll" is provided, then any bookable package/s that are attached to the reservation will be removed from it. | PWS-3556 | 3.14.X | ||||||||||||||||||||||||||||||||||
PWS 3.13.X | |||||||||||||||||||||||||||||||||||||||||
IO_ResModifyNotifRQ | inbound | onPrem | IO_ResModifyNotifRQ | Reservations | Reservation | ProfileReferences | ProfileReference | Use Case 11 (Change attached guest profile): only the main reservation profile can be exchanged, no profiles on the list of attached guest profiles! Use Case 11b (Add attached guest profile): an unlimited number of profiles can be attached to the list of attached guest profiles. | PWS-3489 | 3.13.3 | |||||||||||||||||||||||||||||||||||
OTA_HotelAvailRS | outbound | onPrem | OTA_HotelAvailRS | RoomStays | RoomStay | RoomRates | RoomRate | Rates | Rates | TPA_Extensions | px:FixedChargesAmountsExtensions |
| New element TPA_Extensions will be added IF the respective rate has an exclusive fixed charge package. The value of the FixedChargesAmountsExtensions | RateAmount | AmountAfterTax is NOT included in the Base/Total amounts and should NOT be used for OTA_HotelResNotifRQ to the PMS. This value has informative purpose to the walk-in guest - since the charge will be added automatically by the PMS logic during EOD. | PWS-3505 | 3.13.0 | ||||||||||||||||||||||||||||||||||
IO_ResModifyNotifRQ | inbound | onPrem | IO_ResModifyNotifRQ | Reservations | Reservation | ProfileReferences | ProfileReference UseCase 11: Change arriving guest |
| UseCase 11: Change arriving guest With this PWS version, only the arriving guest will be exchanged, all folio recipients remain as they are. | PWS-3463 | 3.13.0 | ||||||||||||||||||||||||||||||||||
IO_ResModifyNotifRQ | inbound | onPrem | IO_ResModifyNotifRQ | Reservations | Reservation | InvoiceReferences | InvoiceReference | ProfileReferences | ProfileReference UseCase 12: Change invoice recipient |
| UseCase 12: Change invoice recipient With this PWS version, the invoice recipient for folios A to F can be exchanged. The arriving guest will not be touched. | PWS-3463 | 3.13.0 | ||||||||||||||||||||||||||||||||||
IO_RatePackageNotifRQ | Outbound | onPrem | IO_RatePackageNotifRQ | Packages | Package | PackageItems | PackageItem | Calculation | @FixedChargeInd |
| New attribute added to schema: @FixedChargeInd. The attribute is boolean and optional. If @FixedChargeInd="false" (or the attribute is missing) then the package is "not a fixed charge". Else if the @FixedChargeInd="true" then the package "is a fixed charge". This is extra cost to the accommodation amount - but unlike the "add to rate" packages, it should not be included in the inbound reservation total amount to the PMS. | PWS-3492 | 3.13.0 | ||||||||||||||||||||||||||||||||||
HTNG_ChargePostingRQ | Inbound | onPrem | HTNG_ChargePostingRQ | Posting | Transaction | RevenueDetails | RevenueDetail |
| The new value 'Deposit' can be applied to the SubTypeID attribute. In this case partial payments for the guests who depart on the current business date will be possible. | PWS-3509 | 3.13.0 | ||||||||||||||||||||||||||||||||||
IPA 23.4042
| |||||||||||||||||||||||||||||||||||||||||
OTAIO_HotelResNotifRQResModifyNotifRQ | outbound + inbound | pAir | HotelReservation IO_ResModifyNotifRQ | ResGuests Reservations | ResGuest Reservation | TPA_Extensions | px:GuestStayExtensions | px:StayInfoProfileReferences | ProfileReference @RelationToPrimary |
| 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. | IPA-1302 IPA-1304 | 23.40 | ||||||||||||||||||||||||||||||||||
Anker | IPA 23.38 | IPA 23.38 | OTA_HotelResNotifRQ | outbound | pAir | no changes in XML | Only the current traces for a reservation are sent (from current protel date onwards) and not the ones from the past. | IPA-1295 | 23.38 | IO_InvoiceFiscalizeRQ IO_InvoiceFiscalizeNotifRQ | outbound | pAir |
Codeblock | ||||
---|---|---|---|---|
| ||||
<p:Invoice BusinessDate="2023-08-10" DeliveryDate="2023-08-10" ExternallyFiscalized="false" FiscalCode="123456" FiscalCodeID="2" FiscalCodeName="Nota de plata" FiscalDate="2023-08-10T08:19:02+03:00" Fiscalized="true" InvoiceCode="RE_8623" InvoiceDate="2023-08-10T08:19:02+03:00" InvoiceID="4321" Open="false" PastEndOfDay="false" Type="Reservation" User="Beniamin Icobescu" UserTaxNo="" Void="false" TaxProcedureCode="FP"> |
<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 soon be transferred by the additional attribute with.
This is for example important for police reports.
IPA 23.40
Anker IPA 23.40 IPA 23.40
HotelReservation | ResGuests | ResGuest | TPA_Extensions | px:GuestStayExtensions | px:StayInfo
@RelationToPrimary
Codeblock | ||||
---|---|---|---|---|
| ||||
<GuestStayExtensions xmlns:htng="http://htng.org/2014B" xmlns:p="http://protel.io/soap" xmlns:px="http://protel.io/htng/extensions">
<StayInfo Role="BookerAndArrivingGuest" RelationToPrimary="Abuelo" PrimaryInd="false" />
</GuestStayExtensions> |
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.
IPA-1302
IPA-1304
IPA 23.38
Anker IPA 23.38 IPA 23.38
Due to Polish legal fiscal requirements, we're extending the schema by adding a new attribute.
For some TAA’s it’s necessary to assign TaxProcedureCode. When this code is assigned then it has to be reported to the Government server.
e.g.:
"FP" = Invoice that has been generated to fiscal receipt
Full list of allowed values: PMS_TaxProcedureCode
IO_InvoiceFiscalizeRQ
IO_InvoiceFiscalizeNotifRQ
IO_InvoiceFiscalizeRQ | Invoice | Charges | Item | @GroupCode@TaxProcedureCode
IO_InvoiceFiscalizeNotifRQ | Invoice | Charges | Item | @GroupCode@TaxProcedureCode
Codeblock | ||||
---|---|---|---|---|
| ||||
<p:Charges> <p:Item ID="230326" PostingAccount="4" Quantity="1" ServiceDate="2023-08-09" SystemDateInvoice BusinessDate="2023-08-10" DeliveryDate="2023-08-10" ExternallyFiscalized="false" FiscalCode="123456" FiscalCodeID="2" FiscalCodeName="Nota de plata" FiscalDate="2023-08-10T08:19:02+03:00" Fiscalized="true" InvoiceCode="RE_8623" InvoiceDate="2023-08-09T2010T08:19:3502+03:00" TaxCodeInvoiceID="4321" Open="19%false" TaxRatePastEndOfDay="19.000000000false" Type="Article" GroupCode="GTU01="Reservation" User="Beniamin Icobescu" UserTaxNo="" Void="false" TaxProcedureCode="FP"> |
Due to Polish legal fiscal requirements, we're extending the schema by adding a new attribute.
In some situations it is necessary to have GTUCode assigned to the invoice header.
This should be related to fiscal code (assignable to fiscal code in PMS SD)For some TAA’s it’s necessary to assign TaxProcedureCode. When this code is assigned then it has to be reported to the Government server.
e.g.:
"GTU01" = Alcohol products"GTU02" = Fuel productsFP" = Invoice that has been generated to fiscal receipt
Full list of allowed values: PMS_GroupCodeTaxProcedureCode
IO_InvoiceFiscalizeRQ
IO_InvoiceFiscalizeNotifRQ
IPA 23.36
OTA_ProfileModifyRQ
IO_InvoiceFiscalizeRQ | Invoice | Charges | Item | @GroupCode
IO_InvoiceFiscalizeNotifRQ | Invoice | Charges | Item | @GroupCode
| TPA_Extensions | px:ProfileInfoExtensions | px:DocumentTypes | px:DocumentTypeCodeblock | ||||
---|---|---|---|---|
| ||||
<TPA_Extensions>
<px:ProfileInfoExtensions>
<px:AddressTypes/>
<px:ContactDetails>
<px:AdditionalInfo/>
</px:ContactDetails>
<px:PersonInfos>
<px:LastNameAtBirth/>
<px:FirstNameAtBirth/>
<px:LastNameMother/>
<px:FirstNameMother/>
<px:Language DefaultInd="true">en-us</px:Language>
<px:VipCodes/>
<px:MarketingCodes/>
<px:Keywords/>
</px:PersonInfos>
<px:ProfileStatus/>
<px:DocumentTypes>
<px:DocumentType DefaultInd="false" DisplaySequence="-1" ID="199" ID_Context="protelIO" RPH="cd434bf7-2fc0-4245-8a1d-f1cd0fd41695" Type="Checking for validation">Checking for validation</px:DocumentType>
<px:DocumentType DefaultInd="true" DisplaySequence="1" ID="350" ID_Context="protelIO" RPH="9b313b86-b33a-49da-87aa-8c81dd4ea22c" Type="Identity card">Identity card</px:DocumentType>
</px:DocumentTypes>
<px:StatisticalInfos/>
<px:Traces/>
<px:LogEntries/>
<px:Memberships/>
</px:ProfileInfoExtensions>
<px:UserDefinedFieldExtensions>
<px:UserDefinedField Name="BM" Type="List">August</px:UserDefinedField>
<px:UserDefinedField Name="AM" Type="List">September</px:UserDefinedField>
<px:UserDefinedField Name="DR" Type="List">Allergy</px:UserDefinedField>
</px:UserDefinedFieldExtensions>
</TPA_Extensions> |
IPA 23.32
Codeblock | ||||
---|---|---|---|---|
| ||||
<RoomStays>
<RoomStay MarketCode="CORP_GRP" SourceOfBusiness="3PAR">
<RoomTypes>
<RoomType IsRoom="true" NumberOfUnits="1" RoomID="53" RoomType="51" RoomTypeCode="CLASTW">
<TPA_Extensions>
<px:RoomStatusExtensions>
<px:HouseKeepingInfo RoomStatus="1"/>
</px:RoomStatusExtensions>
</TPA_Extensions>
</RoomType>
</RoomTypes> |
<p:Charges>
<p:Item ID="230326" PostingAccount="4" Quantity="1" ServiceDate="2023-08-09" SystemDate="2023-08-09T20:19:35+03:00" TaxCode="19%" TaxRate="19.000000000" Type="Article" GroupCode="GTU01"> |
Due to Polish legal fiscal requirements, we're extending the schema by adding a new attribute.
In some situations it is necessary to have GTUCode assigned to the invoice header.
This should be related to fiscal code (assignable to fiscal code in PMS SD).
e.g.:
"GTU01" = Alcohol products
"GTU02" = Fuel products
Full list of allowed values: PMS_GroupCode
IPA 23.36
Anker IPA 23.36 IPA 23.36
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ
Codeblock | ||||
---|---|---|---|---|
| ||||
<TPA_Extensions>
<px:ProfileInfoExtensions>
<px:AddressTypes/>
<px:ContactDetails>
<px:AdditionalInfo/>
</px:ContactDetails>
<px:PersonInfos>
<px:LastNameAtBirth/>
<px:FirstNameAtBirth/>
<px:LastNameMother/>
<px:FirstNameMother/>
<px:Language DefaultInd="true">en-us</px:Language>
<px:VipCodes/>
<px:MarketingCodes/>
<px:Keywords/>
</px:PersonInfos>
<px:ProfileStatus/>
<px:DocumentTypes>
<px:DocumentType DefaultInd="false" DisplaySequence="-1" ID="199" ID_Context="protelIO" RPH="cd434bf7-2fc0-4245-8a1d-f1cd0fd41695" Type="Checking for validation">Checking for validation</px:DocumentType>
<px:DocumentType DefaultInd="true" DisplaySequence="1" ID="350" ID_Context="protelIO" RPH="9b313b86-b33a-49da-87aa-8c81dd4ea22c" Type="Identity card">Identity card</px:DocumentType>
</px:DocumentTypes>
<px:StatisticalInfos/>
<px:Traces/>
<px:LogEntries/>
<px:Memberships/>
</px:ProfileInfoExtensions>
<px:UserDefinedFieldExtensions>
<px:UserDefinedField Name="BM" Type="List">August</px:UserDefinedField>
<px:UserDefinedField Name="AM" Type="List">September</px:UserDefinedField>
<px:UserDefinedField Name="DR" Type="List">Allergy</px:UserDefinedField>
</px:UserDefinedFieldExtensions>
</TPA_Extensions> |
IPA 23.32
Anker IPA 23.32 IPA 23.32
For reservations that will arrive on the business day, the status of the room (clean, dirty, etc.) will be sent with.
Possible values: IO Types#RoomStatusType
IPA 23.30
Codeblock | ||||
---|---|---|---|---|
| ||||
<HotelReservation CreateDateTime="2023-07-20T12:55:31+02:00" CreatorID="isabell.kniza@protel.net" LastModifierID="isabell.kniza@protel.net" LastModifyDateTime="2023-07-20T12:56:06+02:00" ResStatus="Reserved" RoomNumberLockedIndicator="true"> |
<RoomStays>
<RoomStay MarketCode="CORP_GRP" SourceOfBusiness="3PAR">
<RoomTypes>
<RoomType IsRoom="true" NumberOfUnits="1" RoomID="53" RoomType="51" RoomTypeCode="CLASTW">
<TPA_Extensions>
<px:RoomStatusExtensions>
<px:HouseKeepingInfo RoomStatus="1"/>
</px:RoomStatusExtensions>
</TPA_Extensions>
</RoomType>
</RoomTypes> |
For reservations that will arrive on the business day, the status of the room (clean, dirty, etc.) will be sent with.
Possible values: IO Types#RoomStatusType