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 | |||||||||||||||||||||||||||||||
TBA IPA | |||||||||||||||||||||||||||||||
IO_InvoiceFiscalizeRQ | outbound | pAir | 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 | |||||||||||||||||||||||||
IO_InvoiceFiscalizeRQ | outbound | pAir | 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 IPA 23.32 Anker | | IPA 23.32 | IPA 23.32 | OTA_HotelResNotifRQ, OTA_ResRetrieveRS | outbound | pAir | RoomStay | RoomTypes | RoomType | TPA_Extension | RoomStatusExtensions |
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> |
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
ESB 323 Anker ESB 323 ESB 323
onPrem
pAir
Codeblock | ||||
---|---|---|---|---|
| ||||
<Errors> <Error Code="188" Type="1" ShortText="Transaction error - please report. Incomplete Posting flow. Please check the guest folio before a retry."/> </Errors> |
- the ESB will not do retries itself
- the ESB will generate a generic RS to inform the sender of the RQ about the failure.
! 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).
PWS 3.14.X
Anker | ||||
---|---|---|---|---|
|
Codeblock | ||||
---|---|---|---|---|
| ||||
<px:Registration BirthCountry="IT" BirthPlace="CALVIGNASCO" LicensePlate="35347444" /> |
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
Codeblock | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="utf-8"?> <env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:htnga="http://htng.org/PWSWG/2007/02/AsyncHeaders" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <env:Header> <htnga:CorrelationID>CorrelationID123</htnga:CorrelationID> <Source xmlns="http://protel.io/soap" Module="protel.WebServices" ModuleVersion="0.0.0.3" Product="protel On Premise SPE" ProductVersion="23.01000" Service="io.protel.onpremise"/> </env:Header> <env:Body> <ns2:IO_SystemDataRS xmlns:ns2="http://protel.io/soap" CorrelationID="CorrelationID123" TimeStamp="2023-05-11T07:25:25.4624218Z" Version="3.000"> <ns2:UniqueID ID="3152" ID_Context="protelIO" Type="10"/> <ns2:Success/> <ns2:SystemData ChainCode="HC1" HotelCode="3152" HotelID="1" HotelName="Hotel Lamm"> <ns2:UniqueID ID="3152" ID_Context="protelIO" Type="10"/> <ns2:Reservations> <ns2:DefaultValues ArrivalTime="14:00" DepartureTime="10:00"/> </ns2:Reservations> </ns2:SystemData> </ns2:IO_SystemDataRS> </env:Body> </env:Envelope> |
Codeblock | ||||
---|---|---|---|---|
| ||||
<?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"> </soapenv:Header> <soapenv:Body xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope"> <HTNG_HotelCheckOutNotifRQ xmlns="http://htng.org/2014B" EchoToken="PWS_3542_13" CorrelationID="PWS_3542_13" RetransmissionIndicator="true"> <POS> <Source xmlns="http://www.opentravel.org/OTA/2003/05"> <RequestorID ID="3153" Type="10" ID_Context="protelIO"/> <BookingChannel Type="4" Primary="true"/> </Source> </POS> <PropertyInfo ChainCode="n/a" HotelCode="3153" HotelCodeContext="protelIO" HotelName="protel"/> <AffectedGuests> <UniqueID ID="342692" ID_Context="protelIO" Type="14"/> </AffectedGuests> <HotelReservations> <HotelReservation xmlns="http://www.opentravel.org/OTA/2003/05" CreateDateTime="2020-08-14T15:59:15Z" CreatorID="ame1" ResStatus="Checked Out"> <UniqueID ID="342692" Type="14" ID_Context="protelIO"/> </HotelReservation> </HotelReservations> </HTNG_HotelCheckOutNotifRQ> </soapenv:Body> </env:Envelope> |
Codeblock | ||||
---|---|---|---|---|
| ||||
<Services> <Service ID="RemoveAll" ID_Context="protelIO" Type="16"/> </Services> |
If Service/@ID="RemoveAll" is provided, then any bookable package/s that are attached to the reservation will be removed from it.
PWS 3.13.X Anker PWS 3.13.X PWS 3.13.X
Use Case 11b (Add attached guest profile): an unlimited number of profiles can be attached to the list of attached guest profiles.
px:FixedChargesAmountsExtensions
Codeblock | ||||
---|---|---|---|---|
| ||||
<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.
UseCase 11: Change arriving guest
Codeblock | ||||
---|---|---|---|---|
| ||||
<p:ProfileReferences> <p:ProfileReference ID_Context="protelIO" Type="Customer" ID="36975" Action="DELETE"/> <p:ProfileReference ID_Context="protelIO" Type="Customer" ID="36888" Action="CREATE"/> </p:ProfileReferences> |
With this PWS version, only the arriving guest will be exchanged, all folio recipients remain as they are.
UseCase 12: Change invoice recipient
Codeblock | ||||
---|---|---|---|---|
| ||||
<p:InvoiceReferences> <p:InvoiceReference Type="Invoice" ID="34161-0" ID_Context="protelIO"> <p:ProfileReferences> <p:ProfileReference ID_Context="protelIO" Type="Customer" ID="36975" Action="DELETE" Role="InvoiceRecipient"/> <p:ProfileReference ID_Context="protelIO" Type="Customer" ID="36842" Action="CREATE" Role="InvoiceRecipient"/> </p:ProfileReferences> </p:InvoiceReference> </p:InvoiceReferences> |
With this PWS version, the invoice recipient for folios A to F can be exchanged. The arriving guest will not be touched.
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
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.
Codeblock | ||||
---|---|---|---|---|
| ||||
<RevenueDetails><RevenueDetail Description="Cash" PMSRevenueCode="1" CurrencyCode="AED" Amount="-10.00" SubTypeID="Deposit"><Account ID="342451" Type="14" ID_Context="protelIO"/></RevenueDetail></RevenueDetails> |
IPA 23.32
Anker IPA 23.32 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> |
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
Anker IPA 23.30 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"> |
IPA 23.22
Anker | ||||
---|---|---|---|---|
|
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
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
Codeblock | ||||
---|---|---|---|---|
| ||||
<?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> |
IPA 23.14
Anker | ||||
---|---|---|---|---|
|
Codeblock | ||||
---|---|---|---|---|
| ||||
<Services> <Service ID="RemoveAll" ID_Context="protelIO" Type="16"/> </Services> |
If Service/@ID="RemoveAll" is provided, then any bookable package/s that were attached to the reservation will be removed from it.
IPA 23.12 Anker IPA 23.14 IPA 23.14
Codeblock | ||||
---|---|---|---|---|
| ||||
<RevenueDetails><RevenueDetail Description="Cash" PMSRevenueCode="1" CurrencyCode="AED" Amount="-10.00" SubTypeID="Deposit"><Account ID="342451" Type="14" ID_Context="protelIO"/></RevenueDetail></RevenueDetails> |
HTNG_HotelCheckOutNotifRQ
HTNG_HotelCheckOutNotifRQ | RetransmissionIndicator
Codeblock | ||||
---|---|---|---|---|
| ||||
<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> |
IPA 23.10
Anker | ||||
---|---|---|---|---|
|
px:FixedChargesAmountsExtensions
Codeblock | ||||
---|---|---|---|---|
| ||||
<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.
...