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 |
---|
24. |
46 |
2024- |
12- |
11 |
Release dates PWS (onPrem) LIVE Environment
24.42 | 2024-11-13 |
24.42 | 2024-11-06 NO regular Release |
24.42 | 2024-10-30 NO regular Release |
24.42 | 2024-10-16 NO regular Release |
24.38 | 2024-09-30 |
24.38 | 2024-09-18 NO regular Release |
24.36 | 2024-09-04 - IPA update will be now every 4 weeks |
24.34 | 2024-08-21 |
24.32 | 2024-08-07 NO regular Release |
24.30 | 2024-07-24 NO regular Release |
24.29 | 2027-07-17 |
24.28 | 2024-07-10 NO regular Release |
24.26 | 2024-06-26 NO regular Release |
24.24 | 2024-06-12 |
24.22 | 2024-05-29 |
24.20 | 2024-05-15 |
24.18 | NO regular Release on Wednesday 01.05.2024 due to public Holiday in Germany |
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 ESB (I/O) LIVE Environment
Version | Release date |
---|---|
2.6.3 | 2024-11-06 |
2.6.2 | 2024-09-25 |
2.6.1 | 2024-08-21 |
2.6.0 | 2024-07-15 |
2.5.3 | 2024-06-10 |
2.5.2 | 2024-05-15 |
2.5.1 | 2024-04-10 |
2.5.0 | 2024-02-26 |
TBA IDS | ||||||||||||||
TBA ESB | ||||||||||||||
Bulk Export from SMP UI | outbound | OnPrem pAir | n/a | no schema change | Each bulk job can be of maximum 2 years timespan. If it is necessary to have longer time span - more bulk jobs should be created. | SMP-2928 | TBA | |||||||
Bulk Export from SMP UI | outbound | OnPrem pAir | n/a | no schema change | #1 For one destination - only one bulk job can be running. Any further bulk jobs for the same destination will be saved in the sequence - but it will not start unless all previous jobs are finalized (cancelled, completed). #2 If the queue for a destination in BULK mode exceeds 10K messages, no new bulk job should start. Any further bulk jobs for the same destination will be saved in the sequence - but it will not start unless the queue in BULK mode for the destination drops under 10K messages. | IO-8229 | 2.5.4 | |||||||
TBA PWS | ||||||||||||||
OTA_ReadRQ/OTA_ResRetrieveRS | inbound | onPremise | extend the Reservation search by roomtypes |
| In the ReadRQ it is now possible to request the RoomType in addition to the time period and reservation status. | PWS-3822 | TBA | |||||||
TBA IPA | ||||||||||||||
IO_SystemDataRS | outbound | pAir | no schema change but we will expand for pAir the attributes
| no schema change | In the pAir SystemData in Rate Configuration you can define Discount Groups. With the extension for pAir we send the attributes
| IPA-1467 | TBA | |||||||
OTA_ProfileCreateRQ OTA_ProfileModifyRQ | outbound / inbound | pAir | no schema change | no schema change | no change in the Schema. Export @LoyalLevel value with the string label the way it is defined by the user instead of the PMS SystemData ID | IPA-1277 | TBA | |||||||
OTA_HotelResNotifRQ OTA_ProfileCreateRQ OTA_ProfileModifyRQ OTA_HotelStayInfoNotifRQ | outbound / inbound | pAir | OTA_ProfileModifyRQ | ProfileModify | Customer | Document |
| To be legal in Austria, a new Attribute is added to the Document Element with the label "Issuing Authorities" | IPA-1369 | TBA | |||||||
IO_SystemDataRQ | inbound | pAir | IO_SystemDataRQ | Request | Rates |
| The vendor should be able to tell us in the RQ with the attribute IncludeInvisible="true or false" which rates he wants to see.
| IPA-1404 | TBA | |||||||
IO_SystemDataRS | outbound | pAir | IO_SystemDataRS | SystemData | Rates | RatePlans | RatePlan |
| The vendor should be able to tell us in the RQ with the attribute IncludeInvisible="true or false" which rates he wants to see.
| IPA-1403 | TBA | |||||||
PWS 3.19.X | ||||||||||||||
OTA_HotelResNotifRQ | inbound | OnPrem | no schema changes | We will no longer import fixed charges with inbound OTA_HotelResNotifRQ. This can only be done with IO_ResModifyNotifRQ. | PWS-3810 | 3.19.0 | ||||||||
OTA_HotelResNotifRQ | inbound | OnPrem | no schema changes | Implemented the import of the attributes CommunicationChannel and TravelReason. | PWS-3820 | 3.19.0 | ||||||||
OTA_HotelRatePlanNotifRQ | inbound | OnPrem | no schema changes |
| PWS-3821 | 3.19.0 | ||||||||
IO_SystemDataRQ | inbound | OnPrem | IO_SystemDataRQ | Request | Rates @IncludeInvisible |
| To shorten the RS message we implemented a new attribute to exclude information about expired rates. If this new attribute is not provided, the RS message will contain information about all rates as before (default=true). If the new attribute is sent with "false", the RS message will no longer contain information about expired rates. | PWS-3805 | 3.19.0 | |||||||
IO_SystemDataRS | outbound | OnPrem | IO_SystemDataRS | SystemData | Reservations | GuestRelationTypes | GuestRelationType |
| Added the GuestRelationType to the SystemDataRS. | PWS-3835 | 3.19.0 | |||||||
PWS 3.17.X | ||||||||||||||
OTA_HotelInvBlockNotifRQ | outbound | OnPrem | OTA_HotelInvBlockNotifRQ | InvBlocks | InvBlock | RoomTypes | RoomType | RatePlans | RatePlan@TaxInclusive |
| 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 | |||||||
HTNG_HotelRoomStatusUpdateNotifRQ | outbound / inbound | OnPrem | Message implemented for outbound and inbound processing. | PWS-3202 PWS-3246 | 3.17.0 | |||||||||
PWS 3.16.X | ||||||||||||||
OTA_ProfileCreateRQ | outbound | OnPrem | OTA_ProfileCreateRQ | Profile | 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 | 3.16.0 | |||||||
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 | 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 | OTA_ProfileModifyRQ | ProfileModify | Customer | TPA_Extensions | px:ProfileExtensions | px:PersonInfos | px:Registration | px:Occupation |
| The attribute occupation was added. | PWS-3714 | 3.16.0 | |||||||
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.0 | |||||||
OTA_HotelResNotifRQ | 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 |
| 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 | 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 |
| 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 OTA_ProfileCreateRQ | inbound | OnPrem | no change in xml |
| 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 OTA_ProfileCreateRQ | outbound / inbound | OnPrem | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:ProfileInfoExtensions | px:PersonInfos | px:Registration | LicensePlate
|
| Corrected the xml to follow the schema. | PWS-3711 | 3.16.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 | |||||||
IPA 24.38
| ||||||||||||||
OTA_HotelResNotifRQ | inbound | pAir | no schema change | no schema change | Handling for CC-Cards
→ Important for Hotels → all possible inbound CardCodes needs to be configured in the System Data (if a vendor is sending "Mastercard (virtual credit card)" it needs to be configured in the SystemData) | IPA-1568 | 24.38 | |||||||
IPA 24.29
| ||||||||||||||
IO_SystemDataRS IO_ResModifyNotifRQ OTA_HotelResNotifRQ | outbound outbound outbound / inbound | pAir | no schema change | no schema change | If the new Xsetup (Guest Relation with Primary) is set for the relations of the guests to the main guest, the various GuestRelationTypes can be queried from the system data via IO_SystemDataRS and sent via IO_ResModifyNotifRQ and OTA_HotelResNotifRQ with the attribute @RelationToPrimary. | NGPR-8321 / IOTEC-5999 | 24.29 | |||||||
IPA 24.24
| ||||||||||||||
IO_InvoiceFiscalizeRQ IO_InvoiceFiscalizeNotifRQ | outbound | pAir | IO_InvoiceFiscalizeRQ | Invoice | AdditionalText |
| 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 IO_InvoiceFiscalizeNotifRQ | outbound | pAir | IO_InvoiceFiscalizeRQ | Invoice | InvoiceFormat |
| 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 |
| 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_InvoiceFiscalizeRQ IO_InvoiceFiscalizeNotifRQ | outbound | pAir | no schema change | 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 | 24.24 | |||||||
IPA 24.20
| ||||||||||||||
OTA_HotelResNotifRQOTA_HotelStayInfoNotifRQOTA_ResRetrieveRSHTNG_HotelCheckInNotifRQHTNG_HotelCheckOutNotifRQ | outbound | pAir | HotelReservation | ResGuests | ResGuest | TPA_Extensions | px:GuestStayExtensions | px:StayInfo @CheckedIn @CheckedOut |
Affected Message | Direction from protel | PMS | Path | Example | Summary | Internal reference | Version | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
TBA IDS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TBA PWS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TBA IPA | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Anker | PWS 3.9.X | PWS 3.9.X | IO_SystemDataRS | outbound | onPremise | IO_SystemDataRS | SystemData | Rates | RatePlanGroups | RatePlanGroup |@CategoryCode IO_SystemDataRS | SystemData | Rates | RatePlanGroups | RatePlanGroup |@CategoryID |
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
OTA_ProfileModifyRS
Codeblock | ||||
---|---|---|---|---|
| ||||
<Errors>
<Error Code="321" ShortText="The Profile is anonymized and will not be updated." Type="10"/>
</Errors> |
IO_SystemDataRS | SystemData | Rates | RatePlanGroups | RatePlanGroup |@CategoryCode
IO_SystemDataRS | SystemData | Rates | RatePlanGroups | RatePlanGroup |@CategoryID
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
Current
Codeblock | ||||
---|---|---|---|---|
| ||||
<RoomTypeAllocations RoomTypePickUpStatus="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-06" NumberOfUnits="3" Start="2022-08-06"/>
<RoomTypeAllocation End="2022-08-07" NumberOfUnits="0" Start="2022-08-07"/>
<RoomTypeAllocation End="2022-08-08" NumberOfUnits="0" Start="2022-08-08"/>
<RoomTypeAllocation End="2022-08-09" NumberOfUnits="0" Start="2022-08-09"/>
<RoomTypeAllocation End="2022-08-10" NumberOfUnits="0" Start="2022-08-10"/>
</RoomTypeAllocations> |
Expected
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
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.
HTNG_HotelFolioNotifRQ
HTNG_HotelFolioRS
outbound
inbound
HTNG_HotelFolioNotifRQ | Folios | Folio | RevenueDetails | RevenueDetail | FolioIDs | FolioID
or/and
HTNG_HotelFolioNotifRQ | Folios | Folio | RevenueDetails | RevenueDetail | RevenueDetailItems | RevenueDetailItem | FolioIDs | FolioIDCodeblock | ||||
---|---|---|---|---|
|
<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
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ
Codeblock | ||||
---|---|---|---|---|
| ||||
<OTA_ProfileModifyRQ>
<ProfileModify>
<TPA_Extensions>
<px:ProfileInfoExtensions>
<px:PersonInfos>
<px:Language DefaultInd="true">en-us</px:Language> |
<TPA_Extensions>
<px:GuestStayExtensions>
<px:StayInfo Arrival="2024-02-27T09:13:06+01:00" CheckedIn="2024-04-26T09:13:06+02:00" CheckedOut="2024-05-02T15:12:21+02:00" Departure="2024-02-28T15:12:21+01:00" PrimaryInd="true" Role="BookerAndArrivingGuest" Status="Checked out"/>
<px:TelephoneSetting ClassOfService="3"/>
</px:GuestStayExtensions>
</TPA_Extensions> |
To be legal compliant for police reports we added new attributes in the StayInfo Element
@CheckedIn = date and time for the logged checkin for the reservation
@CheckedOut = date and time for the logged checkout for the reservation
IPA-1392
OTA_HotelResNotifRQ
px:ReservationExtensions | px:ProcessingInstructions | px:ResGuests |
@FullOverlay
@Role
Codeblock | ||||||
---|---|---|---|---|---|---|
| ||||||
<px:ReservationExtensions>
<px:ProcessingInstructions>
<px:ResGuests FullOverlay="true" Role="LinkedProfile"/>
</px:ProcessingInstructions> |
Extending the handling of list of profiles linked to a reservation:
- If px:ProcessingInstructions | px:ResGuests | @FullOverlay="true", then the list of profiles provided in the inbound RQ msg will completely replace those existing in the PMS for the designated @Role. This allows to use intentional removal of existing profiles linked to a reservation.
- Else - if the new element is missing or the @FullOverlay="false" - the current existing logic remains - profiles are appended to the reservation.
! Caution - If the vendor does not have the intention to remove a profile from a reservation - then this element should not be sent inbound !
IPA-1387
IPA 24.14
Anker IPA 24.14 IPA 24.14
IO_InvoiceFiscalizeRQ
IO_InvoiceFiscalizeNotifRQ
IO_InvoiceFiscalizeRQ | Invoice
Codeblock | ||||
---|---|---|---|---|
| ||||
<p:Invoice BusinessDate="2022-08-09" ExternallyFiscalized="false" FiscalCode="gg12cc" FiscalCodeID="2" FiscalCodeName="Test_AB" FiscalDate="2024-03-27T08:31:34+01:00" Fiscalized="true" InvoiceCode="RE_23" InvoiceDate="2024-03-27T08:31:34+01:00" InvoiceID="34" Open="false" PastEndOfDay="false" SystemFiscalCode1="AA" SystemFiscalCode2="bb" SystemFiscalCode3="cc" Type="Reservation" User="Julia W" UserTaxNo="" Void="false"> |
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
IO_InvoiceFiscalizeRQ
IO_InvoiceFiscalizeNotifRQ
IO_InvoiceFiscalizeRQ | Invoice | InvoiceRecipient | AccountingInfos
Codeblock | ||||
---|---|---|---|---|
| ||||
<p:InvoiceRecipient ProfileID="919" ProfileType="Corporation">
<p:FirstName/>
<p:LastName>Agenzia delle Entrate</p:LastName>
<p:Language>it_IT</p:Language>
<p:Notes/>
<p:Gender/>
<p:TaxNumber>06363391001</p:TaxNumber>
<p:AccountingInfos CompanyRegNumber="987654321" FiscalUID="1234567890" PublicAdministrationInd="false" SplitPaymentInd="false" Tax1="06363391001" Tax2="06363391001"/>
</p:InvoiceRecipient> |
We extend the AccountingInfos with the attributes
@FiscalUID
@CompanyRegNumber
IPA-1380
IO_InvoiceFiscalizeNotifRQ
IO_InvoiceFiscalizeRQ
IO_InvoiceFiscalizeRQ | Invoice | InvoiceRecipient | AccountingInfos
OTA_ReadRQ | ReadRequests | HotelReadRequest | TPA_Extensions | px:ReadRequestExtensions | px:Room | @RoomID
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
Current
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
Codeblock | ||||
---|---|---|---|---|
|
<p:InvoiceRecipient |
ProfileID=" |
1234" |
ProfileType="Customer">
<p:FirstName>Jessica</p:FirstName>
<p:LastName>Alba</p:LastName>
<p:BirthDate>1980-10-10</p:BirthDate>
<p:Gender>F</p:Gender>
<p:Addresses/>
<p:AccountingInfos PublicAdministrationInd="true" SplitPaymentInd="true"/>
</p:InvoiceRecipient> |
Due to legal requirements in Italy, we extend
the AccountingInfos with the attributes
@PublicAdministrationInd
@SplitPaymentInd
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ
outbound
inbound
Customer | TPA_Extensions | px:ProfileInfoExtensions | px:AccountingInfos
Codeblock | ||||
---|---|---|---|---|
| ||||
<px:ProfileInfoExtensions>
<px:AddressTypes/>
</px:ContactDetails>
</px:PersonInfos>
<px:AccountingInfos CompanyRegNumber="98711654321" FiscalUID="1525234567890"/>
</px:ProfileInfoExtensions> |
We extend the AccountingInfos with the attributes
@FiscalUID
@CompanyRegNumber
IPA-1377
IPA-1378
OTA_HotelResNotif
outbound
inbound
OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:AccountingInfos
HTNG_HotelFolioNotifRQ
HTNG_HotelFolioRS
outbound
inbound
Codeblock | ||||
---|---|---|---|---|
|
<px: |
ProfileInfoExtensions> |
<px: |
AddressTypes/>
</px:ContactDetails>
</px:PersonInfos>
<px:AccountingInfos CompanyRegNumber="98711654321" FiscalUID="1525234567890"/>
</px:ProfileInfoExtensions> |
We extend the AccountingInfos with the attributes
@FiscalUID
@CompanyRegNumber
IPA-1377
IPA-1378
OTA_HotelStayInfoNotifRQ | StayInfos | StayInfo | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile| Customer
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
| TPA_Extensions | px:
ProfileInfoExtensions | px:
AccountingInfos
Codeblock | ||||
---|---|---|---|---|
|
<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>
<px:ProfileInfoExtensions>
<px:AddressTypes/>
</px:ContactDetails>
</px:PersonInfos>
<px:AccountingInfos CompanyRegNumber="98711654321" FiscalUID="1525234567890"/>
</px:ProfileInfoExtensions> |
We extend the AccountingInfos with the attributes
@FiscalUID
@CompanyRegNumber
IPA-1377
IPA 24.12
Anker IPA 24.12 IPA 24.12
OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | TPA_Extensions | px:GuestStayExtensions | px:StayInfo
Codeblock | ||||
---|---|---|---|---|
| ||||
<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
IPA 24.08
Anker IPA 24.08 IPA 24.08
IO_SystemDataRS
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ
OTA_HotelResNotifRQ
outbound
- px:LastNameAtBirth
- px:FirstNameAtBirth
- px:LastNameMother
- px:FirstNameMother
OTA_ProfileModifyRQ | ProfileModify | TPA_Extensions | px:ProfileInfoExtensions | px:PersonInfos |
- px:LastNameAtBirth
- px:FirstNameAtBirth
- px:LastNameMother
- px:FirstNameMother
OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:PersonInfos |
- px:LastNameAtBirth
- px:FirstNameAtBirth
- px:LastNameMother
- px:FirstNameMother
Codeblock | ||||
---|---|---|---|---|
|
<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"> |
Codeblock | ||||
---|---|---|---|---|
| ||||
<HTNG_HotelRoomStatusUpdateNotifRQ>
<Room>
<RoomType NumberOfUnits="1"/> |
OTA_HotelRatePlanNotifRQ
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
<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> |
IPA 24.02
Anker IPA 24.02 IPA 24.02
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ
outbound
inbound
Customer | TPA_Extensions | px:ProfileInfoExtensions | px:AccountingInfos
Codeblock | ||||
---|---|---|---|---|
| ||||
<AdditionalGuestAmounts>
<AdditionalGuestAmount AgeQualifyingCode="7" Amount="18.18" CurrencyCode="EUR" MaxAge="3" MinAge="0" TaxInclusive="false">
<Taxes Amount="1.82" CurrencyCode="EUR"/>
</AdditionalGuestAmount> |
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
Codeblock | ||||
---|---|---|---|---|
| ||||
<AdditionalGuestAmounts>
<AdditionalGuestAmount AgeQualifyingCode="7" Amount="18.18" CurrencyCode="EUR" MaxAge="3" MinAge="0" TaxInclusive="false">
<Taxes Amount="1.82" CurrencyCode="EUR"/>
</AdditionalGuestAmount> |
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ
OTA_ProfileCreateRQ | Profile | Customer | PersonName | MiddleName
OTA_ProfileModifyRQ | ProfileModify | Customer | PersonName | MiddleName
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
OTA_ProfileCreateRQ
OTA_ProfileModifyRQ
OTA_ProfileCreateRQ | Profile | TPA_Extensions | px:ProfileInfoExtensions | px:StatisticalInfos | px:ParentProfile
OTA_ProfileModifyRQ | ProfileModify | TPA_Extensions | px:ProfileInfoExtensions | px:StatisticalInfos | px:ParentProfileCodeblock | ||||
---|---|---|---|---|
|
<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
OTA_HotelResNotif
outbound
inbound
OTA_HotelResNotifRQ | HotelReservations | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile | Customer | TPA_Extensions | px:ProfileInfoExtensions | px:AccountingInfos
Codeblock | ||||
---|---|---|---|---|
|
<Customer> <TPA_Extensions> .... <ProfileInfoExtensions> .... |
<px:AccountingInfos PublicAdministrationInd="true" SplitPaymentInd="true"/> </ProfileInfoExtensions> </TPA_Extensions> |
And add the new official XSD TPA_Extensions "px:ParentProfile "
</Customer> |
Due to legal requirements in Italy, we extend
the AccountingInfos with the attributes
@PublicAdministrationInd
@SplitPaymentInd
IPA-1346
IPA-1339
OTA_HotelStayInfoNotifRQ | StayInfos | StayInfo | HotelReservation | ResGuests | ResGuest | Profiles | ProfileInfo | Profile| Customer | TPA_Extensions | px:ProfileInfoExtensions | px:AccountingInfos
Codeblock | ||||
---|---|---|---|---|
|
<Customer> <TPA_Extensions> |
.... |
|
|
<ProfileInfoExtensions> .... |
<px:AccountingInfos PublicAdministrationInd="true" |
HTNG_ChargePostingRQ
HTNG_ChargePostingRQ | Posting | Transaction | RevenueDetails | RevenueDetail | Account
Codeblock | ||||
---|---|---|---|---|
| ||||
<RevenueDetails>
<RevenueDetail Description="Cash Payment" PMSRevenueCode="1" CurrencyCode="AED" Amount="-45.00" SubTypeID="Payment">
<Account ID="555342188" Type="14" ID_Context="External"/>
</RevenueDetail>
</RevenueDetails> |
SplitPaymentInd="true"/>
</ProfileInfoExtensions>
</TPA_Extensions>
</Customer> |
Due to legal requirements in Italy, we extend
the AccountingInfos with the attributes
@PublicAdministrationInd
@SplitPaymentInd
outbound
inbound
OTA_HotelAvailNotifRQ |
@MessageContentCode
no changes in xml - new values for MessageContentCode
We use the value 4 for the restrictions on rate group level.
OTA_ResRetrieveRS | ReservationsList | HotelReservation |
TPA_Extensions | px:ReservationGroupExtensions| px:GroupInfo|
@GroupName
@GroupID
@PrimaryInd
ResGuests | ResGuest | TPA_Extensions | px:ReservationGroupExtensions | px:GroupInfo|
@GroupName
@GroupID
@PrimaryInd
Codeblock | ||
---|---|---|
| ||
<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".
IO_RatePackageNotifRQ | Packages | Package | Validity
IO_RatePackageNotifRQ | Packages | Package | PackageItem | Validity
Codeblock | ||||
---|---|---|---|---|
| ||||
<Validity From="1990-01-01" To="2050-01-01"/> |