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_ProfileCreateRQ OTA_ProfileModifyRQ | outbound | OnPrem | OTA_ProfileCreateRQ | Profile | Customer | Document OTA_ProfileModifyRQ | ProfileModify | Customer | Document | 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 | TBA | |||||||
OTA_HotelResNotifRQ | outbound | OnPrem | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Customer | RelatedTraveler | TPA_Extensions | px:GuestStayExtensions | px:StayInfo |
| 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 | TBA | |||||||
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.X | ||||||||
OTA_ProfileModifyRQ | outbound | OnPrem | OTA_ProfileModifyRQ | ProfileModify | Customer | TPA_Extensions | px:ProfileExtensions | px:PersonInfos | px:Registration | px:Occupation |
| The attribute occupation was added. | PWS-3714 | 3.16.X | |||||||
IO_ResModifyNotifRQ | inbound | OnPrem | 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 be transferred by the additional attribute for UseCase 11b only. The relation is for example important for police reports. | PWS-3700 | 3.16.X | |||||||
OTA_HotelResNotifRQ OTA_HotelStayInfoNotifRQ OTA_ProfileCreateRQ OTA_ProfileCreateRQ | outbound | OnPrem | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | | px:DocumentInfos | px:DocumentInfo OTA_HotelStayInfoNotifRQ | StayInfos | StayInfo | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | | px:DocumentInfos | px:DocumentInfo OTA_ProfileCreateRQ | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | | px:DocumentInfos | px:DocumentInfo OTA_ProfileModifyRQ | ProfileModify | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | px:DocumentInfos | px:DocumentInfo |
| 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 | TBA | |||||||
OTA_HotelResNotifRQ OTA_ProfileCreateRQ OTA_ProfileCreateRQ | inbound | OnPrem | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | | px:DocumentInfos | px:DocumentInfo OTA_ProfileCreateRQ | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | | px:DocumentInfos | px:DocumentInfo OTA_ProfileModifyRQ | ProfileModify | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | px:DocumentInfos | px:DocumentInfo |
| 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 | TBA | |||||||
TBA IPA | ||||||||||||||
OTA_HotelAvailNotif | outbound inbound | pAir | OTA_HotelAvailNotif | @MessageContentCode | no change in xml - new values for MessageContentCode | We use the value 4 for the restrictions on rate group level. | IPA-1334 | TBA | |||||||
OTA_HotelInvBlockNotifRQ | outbound | pAir | OTA_HotelInvBlockNotifRQ | InvBlocks | InvBlock | RoomTypes | RoomType| RatePlans |RatePlan | @TaxInclusive |
| This indicates if the rate accommodation is set with TAA including taxes or excluding taxes. | IPA-1335 | TBA | |||||||
OTA_HotelRatePlanNotifRQ | outbound | pAir | OTA_HotelRatePlanNotifRQ | RatePlans | RatePlan | @TaxInclusive |
| This indicates if the rate accommodation is set with TAA including taxes or excluding taxes | IPA-1335 | TBA | |||||||
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 | TBA | |||||||
PWS 3.15.X | ||||||||||||||
OTA_ResRetrieveRS | outbound | onPrem | OTA_ResRetrieveRS | ReservationsList | HotelReservation | @RoomNumberLockedIndicator |
| This indicates if a room number has been permanently assigned. | PWS-3650 | 3.15.0 | |||||||
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 | 3.15.0 | |||||||
OTA_HotelResNotifRQ | outbound | onPrem | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | @RoomNumberLockedIndicator |
| This indicates if a room number has been permanently assigned. | PWS-3650 | 3.15.0 | |||||||
OTA_HotelResNotifRQ | outbound | onPrem | 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 | 3.15.0 | |||||||
OTA_ProfileCreateRQ OTA_ProfileModifyRQ | outbound | OnPrem | OTA_ProfileCreateRQ | Profile | Customer | PersonName | NameTitle OTA_ProfileModifyRQ | ProfileModify | Customer | PersonName | NameTitle |
| Added the guest's title to the PersonName element. | PWS-3663 | 3.15.0 | |||||||
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 | |||||||
IPA 23.48
| ||||||||||||||
IO_InvoiceFiscalizeRQ | outbound | pAir | IO_InvoiceFiscalizeRQ | Invoice | DepositReferences | DepositReference |
| Due to Poland legal requirements the relation to the deposit invoice in the final invoice should be shown. | IPA-1153 | 23.48 | |||||||
OTA_ProfileCreateRQ OTA_ProfileModifyRQ | outbound inbound | pAir | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | px:DocumentInfos | px:DocumentInfo |
| Due to spanish legal requirements (Police reports), we extend the TPA extension in the Customer element with DocumentInfo for the support number of a spanish passport. | IPA-1325 IPA-1327 | 23.48 | |||||||
OTA_HotelResNotif | outbound inbound | pAir | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | px:DocumentInfos | px:DocumentInfo |
| Due to spanish legal requirements (Police reports), we extend the TPA extension in the Customer element with DocumentInfo for the support number of a spanish passport. | IPA-1325 IPA-1327 | 23.48 | |||||||
OTA_HotelStayInfoNotifRQ | outbound | pAir | OTA_HotelStayInfoNotifRQ | StayInfos | StayInfo | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile| Customer | TPA_Extensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | px:DocumentInfos | px:DocumentInfo |
| Due to spanish legal requirements (Police reports), we extend the TPA extension in the Customer element with DocumentInfo for the support number of a spanish passport. | IPA-1327 | 23.48 | |||||||
IPA 23.42
| ||||||||||||||
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 | 23.42 | |||||||
IPA 23.40
| ||||||||||||||
OTA_HotelResNotifRQ | outbound + inbound | pAir | HotelReservation | ResGuests | ResGuest | TPA_Extensions | px:GuestStayExtensions | px:StayInfo @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 | |||||||
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 | IO_InvoiceFiscalizeRQ | Invoice | @TaxProcedureCode IO_InvoiceFiscalizeNotifRQ | Invoice | @TaxProcedureCode |
| 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 | IPA-1190 | 23.38 | |||||||
IO_InvoiceFiscalizeRQ IO_InvoiceFiscalizeNotifRQ | outbound | pAir | IO_InvoiceFiscalizeRQ | Invoice | Charges | Item | @GroupCode IO_InvoiceFiscalizeNotifRQ | Invoice | Charges | Item | @GroupCode |
| 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-1190 | 23.38 | |||||||
IPA 23.36
| ||||||||||||||
OTA_ProfileCreateRQ | outbound | pAir | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:DocumentTypes | px:DocumentType |
| Extension of the TPA extension in the Customer element with DocumentType. | IPA-1275 | 23.36 | |||||||
IPA 23.32
| ||||||||||||||
OTA_HotelResNotifRQ, OTA_ResRetrieveRS | outbound | pAir | RoomStay | RoomTypes | RoomType | TPA_Extension | RoomStatusExtensions |
| 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-1259 | 23.32 |
...