| Affected Message | Direction from protel | PMS | Path | Example | Summary | Internal reference | Version |
|---|
|
|
|
|
|
|
|
|
| OTA_HotelResNotifRQ | outbound | pAir | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | @RoomNumberLockedIndicator |
<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">
| If true, then the room for this reservation cannot be changed by the vendor. If false, then the vendor can be searched for a new available room with the message OTA_ReadRQ. | IPA-1260 | 23.30 |
|
|
|
|
|
|
|
|
| OTA_HotelResNotifRQ | Outbound | pAir | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | TPA_Extensions | ReservationExtensions | Traces |
<TPA_Extensions>
<px:ReservationExtensions xmlns:ns4="http://www.w3.org/2005/08/addressing" xmlns:ns5="http://www.w3.org/2011/03/ws-evt">
<px:ReservationStatus Code="G" ID="5" ID_Context="protelIO" Name="Guaranteed" RPH="198382"/>
<px:ReservationCode Code="CONF" ID="319" ID_Context="protelIO" Language="en_US" Name="Conference" Type="TravelReason">Conference</px:ReservationCode>
<px:ReservationCode Code="Fax" ID="44" ID_Context="protelIO" Language="en_US" Name="Facsimile" Type="CommunicationChannel">Facsimile</px:ReservationCode>
<px:FixedCharges/>
<px:Traces>
<px:Trace TraceBegin="2021-03-17T16:00:00+02:00" TraceDepartment="ACC" TraceEnd="2021-03-17T16:00:00+02:00">Trace Template 333</px:Trace>
<px:Trace TraceBegin="2021-03-18T16:00:00+02:00" TraceDepartment="ACC" TraceEnd="2021-03-18T16:00:00+02:00">Trace Template 444</px:Trace>
<px:Trace TraceBegin="2021-03-19T16:00:00+02:00" TraceDepartment="ACC" TraceEnd="2021-03-19T16:00:00+02:00">Trace Template 222</px:Trace>
<px:Trace TraceBegin="2021-03-18T16:00:00+02:00" TraceDepartment="F&B" TraceEnd="2021-03-18T16:00:00+02:00">Trace Template 123</px:Trace>
<px:Trace TraceBegin="2021-03-19T16:00:00+02:00" TraceDepartment="F&B" TraceEnd="2021-03-19T16:00:00+02:00">Trace Template 123</px:Trace>
</px:Traces>
</px:ReservationExtensions>
</TPA_Extensions>
| Trace information will be added to the ReservationExtensions element of the reservation. | IPA-1224 | 23.22 |
| OTA_ProfileModifyRQ | Outbound | pAir | ProfileModify | TPA_Extensions | ProfileInfoExtensions | Traces |
<px:TPA_Extensions xmlns:px="http://protel.io/htng/extensions">
<px:ProfileInfoExtensions>
<px:Traces>
<px:Trace TraceBegin="2017-09-01T00:00:00" TraceDepartment="Direction">Test-Trace</px:Trace>
</px:Traces>
</px:ProfileInfoExtensions>
</px:TPA_Extensions>
| Trace information will be added to the ProfileInfoExtensions of the guests. | IPA-1224 | 23.22 |
| OTA_ProfileModifyRQ | In/Outbound | pAir | ProfileInfoExtensions | AccountingInfos |
<px:TPA_Extensions xmlns:px="http://protel.io/htng/extensions">
<px:ProfileInfoExtensions>
<px:AccountingInfos ARNumber="223344" Tax1="222222" Tax2="333333" />
</px:ProfileInfoExtensions>
</px:TPA_Extensions>
| We will implement two Tax1,2 attributes in the profile messages. | IPA-1220, IPA-1221 | 23.22 |
| HTNG_ChargePostingRQ | Inbound | pAir | HTNG_ChargePostingRQ | Posting | Transaction | RevenueDetails | RevenueDetail @SubTypeID | no change in XML structure | For the HTNG_ChargePostingRQ in inbound messages deposit payments are now only processed in a KSV-compliant manner.
If packages ("Batches") are transmitted as well, a corresponding warning is then issued that no packages can be processed.
For payments to reservations in the future only the @SubTypeID "Deposit" can be used, we do not support @SubTypeID "Payment" for not checked in reservations. Attention: with the updated implementation no partial payments are accepted for the time being. Partial payments will be implemented again in one of the upcoming versions
Hotfix from 29.06.2023 (Version 23.26) 12a.m. fixed it and partial payments and overpayments are transfered. | IPA-1201,IPA-1251
pair-10977 | 23.22/23.24/23.26 |
| IO_SystemDataRS | Outbound | pAir | IO_SystemDataRS | Reservations | DefaultValues |
<?xml version='1.0' encoding='utf-8'?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope">
<soapenv:Header xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
<htng:CorrelationID xmlns:htng="http://htng.org/PWSWG/2007/02/AsyncHeaders">CorrelationID123</htng:CorrelationID>
</soapenv:Header>
<soapenv:Body xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
<ns2:IO_SystemDataRS xmlns:ns2="http://protel.io/soap" xmlns:ns3="http://www.opentravel.org/OTA/2003/05" CorrelationID="CorrelationID123" EchoToken="CorrelationID123" TimeStamp="2021-01-19T12:16:21Z" Version="1.000">
<ns2:Success/>
<ns2:SystemData ChainCode="n/a" HotelCode="2575" HotelID="2000043" HotelName="protel_IO_Testhotel_pAir_2000043">
<ns2:UniqueID ID="2575" ID_Context="protelIO" Type="10"/>
<ns2:Reservations>
<ns2:DefaultValues ArrivalTime="14:00:00" DepartureTime="11:00:00" >
</ns2:Reservations>
</ns2:SystemData>
</ns2:IO_SystemDataRS>
</soapenv:Body>
</env:Envelope>
| The default arrival / departure time which is set by hotel can be displayed in the reservation section of IO_SystemDataRS | IPA-1231 | 23.22 |
|
|
|
|
|
|
|
|
| OTA_HotelResNotifRQ | Inbound | pAir | OTA_HotelResNotifRQ | HotelReservations | HotelReservation | Services | Service |
<Services>
<Service ID="RemoveAll" ID_Context="protelIO" Type="16"/>
</Services>
| For Transaction Action "Modify":
If Service/@ID="RemoveAll" is provided, then any bookable package/s that were attached to the reservation will be removed from it. | IPA-1197 | 23.14 |
|
|
|
|
|
|
|
|
| HTNG_ChargePostingRQ | Inbound | pAir | HTNG_ChargePostingRQ | Posting | Transaction | RevenueDetails | RevenueDetail |
<RevenueDetails><RevenueDetail Description="Cash" PMSRevenueCode="1" CurrencyCode="AED" Amount="-10.00" SubTypeID="Deposit"><Account ID="342451" Type="14" ID_Context="protelIO"/></RevenueDetail></RevenueDetails>
| We will add a new value 'Deposit' to the SubTypeID attribute. | IPA-1191 | 23.12 |
| HTNG_HotelCheckOutNotifRQ | Inbound | pAir | HTNG_HotelCheckOutNotifRQ | RetransmissionIndicator |
<htng:HTNG_HotelCheckOutNotifRQ xmlns:htng="http://htng.org/2014B" xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:px="http://protel.io/htng/extensions" CorrelationID="IOTEC_4058_05" EchoToken="IOTEC_4058_05" RetransmissionIndicator="true" Version="1" PrimaryLangID="de-DE" Timestamp="2020-07-06T14:41:54">
<POS>
<Source TerminalID="Code2Order">
<RequestorID Type="10" ID="2787" ID_Context="protelIO"/>
</Source>
</POS>
<htng:Room RoomID="110"/>
<htng:HotelReservations>
<HotelReservation ResStatus="Checked out">
<UniqueID ID="198184" ID_Context="protelIO" Type="14"/>
</HotelReservation>
</htng:HotelReservations>
</htng:HTNG_HotelCheckOutNotifRQ>
| When true, indicates the message is being re-sent. This can be apply for the CO guest who need to reprint the invoice | IPA-1196 | 23.12 |
|
|
|
|
|
|
|
|
| OTA_HotelAvailRS | Outbound | pAir | OTA_HotelAvailRS | RoomStays | RoomStay | RoomRates | RoomRate | Rates | Rates | TPA_Extensions | FixedChargesAmountsExtensions |
<Rate RateTimeUnit="Day" EffectiveDate="2019-02-01" ExpireDate="2019-02-03" UnitMultiplier="2">
<Base AmountAfterTax="117.00" CurrencyCode="EUR"/>
<Total AmountAfterTax="234.00" CurrencyCode="EUR"/>
<TPA_Extensions>
<px:FixedChargesAmountsExtensions
xmlns:px="http://protel.io/htng/extensions" End="2019-02-03" Start="2019-02-01">
<px:RateAmount AmountAfterTax="10.00" RevenueCategoryCode="17" CurrencyCode="EUR" />
</px:FixedChargesAmountsExtensions>
</TPA_Extensions>
</Rate>
| 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. | IPA-1183 | 23.10 |
|
|
|
|
|
|
|
|
| OTA_HotelInvCountNotifRQ | Outbound | pAir | N/A | N/A | pAir will no longer send in LIVE mode historical data changes related to inventory. Historical data resync is achievable only through BULK job option. |
| 23.06 |
| OTA_ProfileModifyRQ | Inbound
Outbound | pAir | OTA_ProfileModifyRQ | ProfileModify | Customer | CustLoyalty |
<CustLoyalty MembershipID="Mem-123456" RPH="11" PrimaryLoyaltyIndicator="false" AllianceLoyaltyLevelName="Test" LoyalLevel="GOLD" SignupDate="2017-09-01" EffectiveDate="2017-09-01" ExpireDate="2017-09-01" ShareMarketInd="No" ShareSyncInd="No">
<SubAccountBalance Type="Points" Balance="200"/>
</CustLoyalty>
| Added guestMemberCard fields to the CustLoyalty element in the profile outbound. | IPA-1168
IPA-1169 | 23.06 |
| IO_RatePackageNotifRQ | Outbound | pAir | IO_RatePackageNotifRQ | Packages | Package | PackageItems | PackageItem | Calculation | @FixedChargeInd |
<Calculation AmountAfterTax="10.00" AmountBeforeTax="8.06" Currency="EUR" InclusiveInd="false" FixedChargeInd="false" Recurrence="Daily" Relation="PerAdult">
<DaysOfWeek Fri="true" Mon="true" Sat="true" Sun="true" Thu="true" Tue="true" Wed="true"/>
</Calculation>
| New attribute added to schema: @FixedChargeInd. The attribute is boolean and optional. If @FixedChargeInd="false" 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. | IPA-1179 | 23.06 |
|
|
|
|
|
|
|
|
| HTNG_ChargePostingRQ | Inbound | pAir | HTNG_ChargePostingRQ | Posting | RevenueCenter | ID |
<HTNG_ChargePostingRQ xmlns="http://htng.org/2014B" EchoToken="PWS_3462_14" CorrelationID="PWS_3462_14" TimeStamp="2021-03-18T11:32:36Z" Version="0">
<POS>
<Source xmlns="http://www.opentravel.org/OTA/2003/05">
<RequestorID ID="2787" Type="10" ID_Context="protelIO"/>
<BookingChannel Type="4" Primary="true"/>
</Source>
</POS>
<PropertyInfo HotelCode="2787"/>
<Posting ID="7">
<RevenueCenter Description="Kiosk" ID="99">
<Terminal ID="Kiosk"/>
</RevenueCenter>
<Transaction TicketID="120">
<RevenueDetails>
<RevenueDetail Description="Cash" PMSRevenueCode="1" CurrencyCode="AED" Amount="-100" SubTypeID="Payment">
<Account ID="342443" Type="14" ID_Context="protelIO"/>
</RevenueDetail>
</RevenueDetails>
</Transaction>
</Posting>
</HTNG_ChargePostingRQ>
| The ID value in the RevenueCenter element will be considered as the CashRegister number and in case vendors need to use a different cash register ID than the default one. | IPA-1166 | 23.04 |
|
|
|
|
|
|
|
|
| IO_ResModifyNotifRQ | Inbound | pAir | IO_ResModifyNotifRQ | Reservations | Reservation | Packages | Package |
<IO_ResModifyNotifRQ xmlns="http://protel.io/soap" CorrelationID="" EchoToken="" PrimaryLangID="de-DE" Timestamp="2022-01-27T12:40:14" Version="1">
<Reservations HotelCode="2991">
<Reservation>
<UniqueID ID="20996" ID_Context="protelIO" Type="Reservation"/>
<Packages>
<Package Action="CREATE" Code="GuestLaundry" Recurrence="Daily">
<UniqueID ID="334" ID_Context="protelIO" Type="18"/>
</Package>
</Packages>
</Reservation>
</Reservations>
</IO_ResModifyNotifRQ>
| Inbound IO_ResModifyNotifRQ now accept the PackageID instead of it's name to Create/Delete the package from a reservation. | IPA-1149 | 23.02 |
