Zum Hauptinhalt springen

Correspondence Manager (OTA)

Casablanca Hotelsoftware offers the possibility of connecting a correspondence manager. The booking data as well as the guest data are transmitted in live operation in the OTA standard.

Workflow:

Workflow

info

When connecting to the interface, it is also possible to transfer all existing bookings and guest data to the Correspondence Manager via initial export.

Booking Transmission

The booking is transmitted to the Correspondence Manager via the request OTA_HotelResNotifRQ. The manager confirms the transmission in the response by means of OTA_HotelResNotifRS back to Casablanca Hotelsoftware.

In the response, it would be desirable for the correspondence manager to also transmit the ID for the correspondence back to Casablanca Hotelsoftware. Thus, Casablanca Hotelsoftware offers the possibility to store a URL for the guest by means of this external correspondence manager ID, which leads directly to the created correspondence. The reception can thus quickly call up the desired correspondence. When implementing the interface, the URL that leads directly to the correspondence created must be communicated to Casablanca Hotelsoftware. Of course, it would also be possible to transmit not only the ID to Casablanca Hotelsoftware in the response, but directly the finished URL which can be saved.

OTA_HotelResNotifRQ (example)

<?xml version="1.0" encoding="utf-8"?>
<OTA_HotelResNotifRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" EchoToken="122621" TimeStamp="2018-12-30T17:51:37.9157593Z" TargetName="Production" Version="3.0" TransactionIdentifier="122621" xmlns="http://www.opentravel.org/OTA/2003/05">
<POS>
<Source AgentDutyCode="XXXXXXXX" ERSP_UserID="XXXXXXXXX">
<RequestorID ID="XXX_XXX_XXXX" MessagePassword="XXXXXXXXX" />
</Source>
</POS>
<HotelReservations>
<HotelReservation RoomStayReservation="true" CreateDateTime="2019-09-06T11:45:58"
LastModifyDateTime="2019-09-10T18:33:29.457871" ResStatus="Reserved">
<RoomStays>
<RoomStay RoomStayGroupID="783" RoomStayStatus="Reserved">
<RoomTypes>
<RoomType RoomTypeCode="DZ" RoomID="109" PromotionVendorCode="" BedTypeCode="">
<TPA_Extensions>
<DateTimeSpan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" Start="2019-09-15" End="2019-09-17"
xmlns="http://www.opentravel.org/OTA/2003/05" />
</TPA_Extensions>
</RoomType>
<RoomType RoomTypeCode="EZ" RoomID="110" PromotionVendorCode="" BedTypeCode="" Composite="true">
<TPA_Extensions>
<DateTimeSpan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" Start="2019-09-15" End="2019-09-17"
xmlns="http://www.opentravel.org/OTA/2003/05" />
</TPA_Extensions>
</RoomType>
<RoomType RoomTypeCode="WSZ" RoomID="200" PromotionVendorCode="" BedTypeCode="">
<TPA_Extensions>
<DateTimeSpan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" Start="2019-09-17" End="2019-09-19"
xmlns="http://www.opentravel.org/OTA/2003/05" />
</TPA_Extensions>
</RoomType>
<RoomType RoomTypeCode="APP" RoomID="400" PromotionVendorCode="" BedTypeCode="">
<TPA_Extensions>
<DateTimeSpan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" Start="2019-09-19" End="2019-09-21"
xmlns="http://www.opentravel.org/OTA/2003/05" />
</TPA_Extensions>
</RoomType>
<RoomType RoomTypeCode="WSZ" RoomID="208" PromotionVendorCode="" BedTypeCode=""
Composite="true">
<TPA_Extensions>
<DateTimeSpan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" Start="2019-09-19" End="2019-09-21"
xmlns="http://www.opentravel.org/OTA/2003/05" />
</TPA_Extensions>
</RoomType>
</RoomTypes>
<RoomRates>
<RoomRate InvBlockCode="35" NumberOfUnits="1" RatePlanCode="PMS_6EGV1UY8">
<Rates>
<Rate EffectiveDate="2019-09-15" ExpireDate="2019-09-16" NumberOfUnits="1"
RateTimeUnit="Day">
<Base AmountAfterTax="240" CurrencyCode="EUR" />
<Discount Percent="0" />
<Total AmountAfterTax="240" CurrencyCode="EUR" />
</Rate>
</Rates>
<ServiceRPHs>
<ServiceRPH RPH="1" />
<ServiceRPH RPH="2" />
</ServiceRPHs>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
</RoomRate>
<RoomRate InvBlockCode="35" NumberOfUnits="1" RatePlanCode="PMS_6EGV1UY8">
<Rates>
<Rate EffectiveDate="2019-09-17" ExpireDate="2019-09-20" NumberOfUnits="1"
RateTimeUnit="Day">
<Base AmountAfterTax="240" CurrencyCode="EUR" />
<Discount Percent="0" />
<Total AmountAfterTax="240" CurrencyCode="EUR" />
</Rate>
</Rates>
<ServiceRPHs>
<ServiceRPH RPH="3" />
</ServiceRPHs>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2" />
</GuestCounts>
</RoomRate>
<RoomRate InvBlockCode="36" NumberOfUnits="1" RatePlanCode="PMS_6EGV1UY8">
<Rates>
<Rate EffectiveDate="2019-09-15" ExpireDate="2019-09-16" NumberOfUnits="1"
RateTimeUnit="Day">
<Base AmountAfterTax="60" CurrencyCode="EUR" />
<Discount Percent="10" />
<Total AmountAfterTax="54" CurrencyCode="EUR" />
</Rate>
</Rates>
<GuestCounts>
<GuestCount AgeQualifyingCode="8" Age="10" Count="1" />
</GuestCounts>
</RoomRate>
<RoomRate InvBlockCode="36" NumberOfUnits="1" RatePlanCode="PMS_6EGV1UY8">
<Rates>
<Rate EffectiveDate="2019-09-17" ExpireDate="2019-09-20" NumberOfUnits="1"
RateTimeUnit="Day">
<Base AmountAfterTax="60" CurrencyCode="EUR" />
<Discount Percent="0" />
<Total AmountAfterTax="60" CurrencyCode="EUR" />
</Rate>
</Rates>
<GuestCounts>
<GuestCount AgeQualifyingCode="8" Age="10" Count="1" />
</GuestCounts>
</RoomRate>
</RoomRates>
<GuestCounts IsPerRoom="true">
<GuestCount AgeQualifyingCode="10" Count="2" ResGuestRPH="1" />
<GuestCount AgeQualifyingCode="8" Age="10" Count="1" />
</GuestCounts>
<TimeSpan Start="2019-09-15" End="2019-09-21" />
<Total />
<ResGuestRPHs>
<ResGuestRPH RPH="1" />
</ResGuestRPHs>
<Comments>
<Comment>
<Text>reception remark</Text>
</Comment>
<Comment>
<Text>room remark</Text>
</Comment>
<Comment>
<Text>service remark</Text>
</Comment>
<Comment>
<Text>wellness remark</Text>
</Comment>
</Comments>
<ServiceRPHs>
<ServiceRPH RPH="4" />
</ServiceRPHs>
</RoomStay>
</RoomStays>
<Services>
<Service ServicePricingType="Per night" ServiceRPH="1" ServiceInventoryCode="1" Inclusive="false">
<Price NumberOfUnits="1">
<Base AmountAfterTax="3" CurrencyCode="EUR" />
<Total AmountAfterTax="3" CurrencyCode="EUR">
<Taxes>
<Tax Percent="0" />
</Taxes>
</Total>
</Price>
<ServiceDetails>
<ServiceDescription Name="Ortstaxe" />
<Guarantee />
<Total />
</ServiceDetails>
</Service>
<Service ServicePricingType="Per stay" ServiceRPH="2" ServiceInventoryCode="23" Inclusive="true">
<Price NumberOfUnits="1">
<Base AmountAfterTax="50" CurrencyCode="EUR" />
<Total AmountAfterTax="50" CurrencyCode="EUR">
<Taxes>
<Tax Percent="20" />
</Taxes>
</Total>
</Price>
<ServiceDetails>
<ServiceDescription Name="Flasche Wein" />
</ServiceDetails>
</Service>
<Service ServicePricingType="Per night" ServiceRPH="3" ServiceInventoryCode="1" Inclusive="false">
<Price NumberOfUnits="1">
<Base AmountAfterTax="3" CurrencyCode="EUR" />
<Total AmountAfterTax="3" CurrencyCode="EUR">
<Taxes>
<Tax Percent="0" />
</Taxes>
</Total>
</Price>
<ServiceDetails>
<ServiceDescription Name="Ortstaxe" />
</ServiceDetails>
</Service>
<Service ServicePricingType="Per stay" ServiceRPH="4" ServiceInventoryCode="21">
<Price NumberOfUnits="1">
<Base AmountAfterTax="10" CurrencyCode="EUR" />
<Total AmountAfterTax="10" CurrencyCode="EUR">
<Taxes>
<Tax Percent="20" />
</Taxes>
</Total>
</Price>
<ServiceDetails>
<ServiceDescription Name="W-Lan" />
</ServiceDetails>
</Service>
</Services>
<ResGuests>
<ResGuest ResGuestRPH="1" PrimaryIndicator="true">
<Profiles>
<ProfileInfo>
<UniqueID Type="16" ID="8" ID_Context="PMS" />
<Profile ShareAllSynchInd="No" ShareAllMarketInd="Yes" OptInStatus="OptedOut"
CreateDateTime="2014-06-25T00:00:00" StatusCode="Active">
<Customer Gender="Male" BirthDate="1950-01-01" Language="de">
<PersonName>
<NamePrefix>Herr</NamePrefix>
<GivenName>Max</GivenName>
<Surname>Mustermann</Surname>
</PersonName>
<Telephone PhoneTechType="1" PhoneNumber="0043 5418 5622" />
<Telephone PhoneTechType="3" PhoneNumber="0043 5418 5622 17" />
<Telephone PhoneTechType="5" PhoneNumber="0676 123 45 678" />
<Email>casablancaschulung@gmail.com</Email>
<Address>
<AddressLine>Teststraße 5</AddressLine>
<CityName>Innsbruck</CityName>
<PostalCode>6020</PostalCode>
<CountryName Code="AT" />
<AddresseeName />
</Address>
</Customer>
<CompanyInfo />
<Affiliations />
<Agreements />
<Comments>
<Comment Name="Reception">
<Text>Likes room 103</Text>
</Comment>
<Comment Name="Room">
<Text>Wants a quiet room</Text>
</Comment>
<Comment Name="Service">
<Text>Histamin intolerance</Text>
</Comment>
<Comment Name="Wellness">
<Text>Does not like massage oil</Text>
</Comment>
</Comments>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<DepositPayments>
<GuaranteePayment GuaranteeCode="PMS_IDISE87D">
<AmountPercent Percent="30" CurrencyCode="EUR" Amount="182" />
<Deadline AbsoluteDeadline="2019-09-20" />
</GuaranteePayment>
</DepositPayments>
<Total AmountAfterTax="1816" CurrencyCode="EUR" />
<HotelReservationIDs>
<HotelReservationID ResID_Type="14" ResID_Value="casGeXcVZ" ResID_Source="ChannelManager" />
<HotelReservationID ResID_Type="40" ResID_Value="15" ResID_Source="Pms" />
</HotelReservationIDs>
<Profiles>
<ProfileInfo>
<UniqueID Type="16" ID="8" ID_Context="PMS" />
<Profile ShareAllSynchInd="No" ShareAllMarketInd="Yes" OptInStatus="OptedOut"
CreateDateTime="2014-06-25T00:00:00" StatusCode="Active">
<Customer Gender="Male" BirthDate="1950-01-01" Language="de">
<PersonName>
<NamePrefix>Herr</NamePrefix>
<GivenName>Max</GivenName>
<Surname>Mustermann</Surname>
</PersonName>
<Telephone PhoneTechType="1" PhoneNumber="0043 5418 5622" />
<Telephone PhoneTechType="3" PhoneNumber="0043 5418 5622 17" />
<Telephone PhoneTechType="5" PhoneNumber="0676 123 45 678" />
<Email>casablancaschulung@gmail.com</Email>
<Address>
<AddressLine>Teststraße 5</AddressLine>
<CityName>Innsbruck</CityName>
<PostalCode>6020</PostalCode>
<CountryName Code="AT" />
<AddresseeName />
</Address>
</Customer>
<Comments>
<Comment Name="Reception">
<Text>Likes room 103</Text>
</Comment>
<Comment Name="Room">
<Text>Wants a quiet room</Text>
</Comment>
<Comment Name="Service">
<Text>Histamin intolerance</Text>
</Comment>
<Comment Name="Wellness">
<Text>Does not like massage oil</Text>
</Comment>
</Comments>
</Profile>
</ProfileInfo>
</Profiles>
</ResGlobalInfo>
</HotelReservation>
</HotelReservations>
</OTA_HotelResNotifRQ>

OTA_HotelResNotifRS (example)

In this example, no ID or URL is sent back to Casablanca Hotelsoftware.

<?xml version="1.0"?>
<OTA_HotelResNotifRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
EchoToken="122621" Target="Production" TimeStamp="2018-12-30T17:51:39+00:00" Version="3.0"
xmlns="http://www.opentravel.org/OTA/2003/05">
<Success />
</OTA_HotelResNotifRS>

Guest Update

To ensure that the Correspondence Manager always has the current guest data available, there is also the option of transmitting the guest data. When guest data is changed, the request OTA_ProfileModifyRQ is transmitted to the correspondence manager in the OTA standard. The Correspondence Manager confirms the transmission with the response OTA_ProfileModifyRS.

For marketing purposes, consent fields are transmitted for sending postal mailings and newsletters. Guest flags such as "guest is inactive" or "guest not wanted" are also sent.

Post-Mailing (<ProfileModify> element)

  • ShareAllMarketInd="Yes" - Mailing consent granted
  • ShareAllMarketInd="No" - Mailing consent not granted

Newsletter (<ProfileModify> element)

  • OptInStatus="OptedIn" - Newsletter consent granted
  • OptInStatus="OptedOut" - Newsletter consent not granted

Guest active (Not selectable) (<ProfileModify> element)

  • StatusCode="Active" - is transmitted if the guest is normally active
  • StatusCode="Inactive" - is transmitted if the guest has been defined as "not selectable"

Guest not wanted (<Customer> element)

  • LockoutType="NotWanted" - is sent if the guest was marked as "undesirable"
  • it will not be sent if the flag has not been set for the guest

OTA_ProfileModifyRQ (example)

<?xml version="1.0" encoding="utf-8"?><OTA_ProfileModifyRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" EchoToken="7169" TargetName="Production" Version="3" TransactionIdentifier="7169" xmlns="http://www.opentravel.org/OTA/2003/05">
<POS>
<Source AgentDutyCode="XXXXXXXX" ERSP_UserID="XXXXXXXX">
<RequestorID ID="XXX_XXX_XXXX" MessagePassword="XXXXXXXXX" />
</Source>
</POS>
<UniqueID Type="16" ID="174380" ID_Context="PMS" />
<UniqueID Type="18" ID="BdefNr123123" ID_Context="UserDefined_Reference" />
<ProfileModify ShareAllSynchInd="Yes" ShareAllMarketInd="Yes" OptInStatus="OptedIn" CreateDateTime="2021-02-16T00:00:00" StatusCode="Active">
<Customer Gender="Male" LockoutType="NotWanted" BirthDate="1990-01-01" Language="de">
<PersonName>
<NamePrefix>Herr</NamePrefix>
<GivenName>Max</GivenName>
<Surname>Mustermann</Surname>
<NameTitle>Prof. Dr.</NameTitle>
</PersonName>
<Telephone PhoneLocationType="6" PhoneTechType="1" PhoneNumber="0043 5418 5622" />
<Telephone PhoneLocationType="6" PhoneTechType="3" PhoneNumber="0043 5418 5622 17" />
<Telephone PhoneLocationType="6" PhoneTechType="5" PhoneNumber="0043 664 1234567890" />
<Telephone PhoneLocationType="7" PhoneTechType="1" PhoneNumber="Fa. 0043 5418 5622" />
<Telephone PhoneLocationType="7" PhoneTechType="3" PhoneNumber="Fa. 0043 5418 5622 17" />
<Telephone PhoneLocationType="7" PhoneTechType="5" PhoneNumber="Fa. 0043 664 1234567890" />
<Email EmailType="1">technik@casablanca.at</Email>
<Email EmailType="2">info@casablanca.at</Email>
<Address>
<AddressLine>Öde 58</AddressLine>
<AddressLine>Öde 59</AddressLine>
<CityName>Schönwies</CityName>
<PostalCode>6491</PostalCode>
<StateProv StateCode="A" />
<CountryName Code="AT" />
</Address>
<Document DocIssueAuthority="Bezirkshauptmannschaft Innsbruck" DocID="A1234567890" DocType="Reisepass" EffectiveDate="2020-01-01" BirthCountry="AT" BirthPlace="Schönwies" />
<EmployeeInfo EmployeeLevel="Entwicklung" EmployeeTitle="Leitung Entwicklung" />
</Customer>
<Comments>
<Comment Name="Reception">
<Text>Gast Rezeptionsbemerkung</Text>
</Comment>
<Comment Name="Room">
<Text>Gast Zimmerbemerkung</Text>
</Comment>
<Comment Name="Service">
<Text>Gast Servicebemerkung</Text>
</Comment>
<Comment Name="Wellness">
<Text>Gast Wellnessbemerkung</Text>
</Comment>
<Comment Name="Motive">
<Text>VIP 5 Long Stay ab 8 Nächten;HWC Gast;Alte Motive;Individual</Text>
</Comment>
</Comments>
</ProfileModify>
</OTA_ProfileModifyRQ>

OTA_ProfileModifyRS (example)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_ProfileModifyRS xmlns="http://www.opentravel.org/OTA/2003/05"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" Target="Production" TimeStamp="2022-03-15T15:07:04Z" Version="3">
<Success />
</OTA_ProfileModifyRS>