Datenabgleich nach OTA (Open Travel Alliance)

Schnittstelle zur WebBox zum Datenabgleich

Zur Verwendung der OTA-Schnittstelle muss die Schnittstelle in der WebBox unter Hotel > Bearbeiten... > Einstellungen aktiviert werden. Der Benutzername und das Passwort müssen ebenfalls hinterlegt werden.

OTA_HotelAvailRQ

Die Funktion OTA_HotelAvailRQ wird zur Abfrage der Rooms und Rates verwendet

Url
https://[WEBBOX-URL]/ota/HotelAvail.sync

Request

Attribut	Value
ID	OTA ID aus WebBox
MessagePassword	OTA Password aus WebBox
HotelCode	Hotel ID aus WebBox

<?xml version="1.0" encoding="UTF-8"?>
<OTA_ReadRQ xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" PrimaryLangID="en" TimeStamp="2014-10-15T12:03:38" Version="4" xmlns="http://www.opentravel.org/OTA/2003/05">
	<POS>
		<Source MessagePassword="[PASSWORD]" ID="[USERNAME]"/>
	</POS>
	<AvailRequestSegments>
		<AvailRequestSegment AvailReqType="Room">
			<HotelSearchCriteria>
				<Criterion>
					<HotelRef HotelCode="[HOTEL ID]"/>
				</Criterion>
			</HotelSearchCriteria>
		</AvailRequestSegment>
	</AvailRequestSegments>
</OTA_ReadRQ>

Response

<OTA_HotelAvailRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2016-06-22T09:35:58">
	<Success />
	<RoomStays>
		<RoomStay>
			<RoomTypes>
				<RoomType RoomTypeCode="1">
					<RoomDescription Name="Einzelzimmer" />
				</RoomType>
			</RoomTypes>
			<RatePlans>
				<RatePlan RatePlanCode="18">
					<RatePlanDescription Name="Standardrate" />
				</RatePlan>					
       				<RatePlan RatePlanCode="19">
          				<RatePlanDescription Name="Promo-Rate" />
        			</RatePlan>
     			</RatePlans>
    		</RoomStay>
		<RoomStay>
		<RoomTypes>
			<RoomType RoomTypeCode="2">
				<RoomDescription Name="Doppelzimmer Superior" />
			</RoomType>
		</RoomTypes>
		<RatePlans>
			<RatePlan RatePlanCode="2">
				<RatePlanDescription Name="Standard" />
			</RatePlan>       
			<RatePlan RatePlanCode="1">
				<RatePlanDescription Name="Kurzaufenthalt" />
			</RatePlan>        
		</RatePlans>
	</RoomStay>    
  </RoomStays>
</OTA_HotelAvailRS>

OTA_HotelInvCountNotifRQ

Die Funktion OTA_HotelInvCountNotifRQ wird zur Übertragung der Verfügbarkeit verwendet.

Url
https://[WEBBOX-URL]/ota/HotelInvCountNotif.sync

Request

Attribute	Value
ID	OTA ID aus WebBox
MessagePassword	OTA Password aus WebBox
HotelCode	Hotel ID aus WebBox
InvTypeCode	Room ID aus WebBox

<?xml version="1.0"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2009-12-07T15:25:16" Version="4">
	<POS>
		<Source MessagePassword="[PASSWORD]" ID="[USERNAME]"/>
	</POS>
	<Inventories HotelCode="[HOTEL ID]">
		<Inventory>
			<StatusApplicationControl Start="2016-05-24" End="2016-05-24" InvTypeCode="[ROOM ID]" />
			<InvCounts>
				<InvCount Count="2" />
			</InvCounts>
		</Inventory>
		<Inventory>
			<StatusApplicationControl Start="2016-05-25" End="2016-05-25" InvTypeCode="[ROOM ID]" />
			<InvCounts>
				<InvCount Count="1" />
			</InvCounts>
		</Inventory>
	</Inventories>
</OTA_HotelInvCountNotifRQ>

Response

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" PrimaryLangID="en" xmlns="http://www.opentravel.org/OTA/2003/05">
	<Success affectedRows="2"/>
</OTA_HotelInvCountNotifRS>

OTA_HotelBookingRuleNotifRQ

Die Funktion OTA_HotelBookingRuleNotifRQ wird zur Übertragung der Buchungsregeln verwendet.

Url
https://[WEBBOX-URL]/ota/HotelBookingRuleNotif.sync

Request

Attribute	Value
ID	OTA ID aus WebBox
MessagePassword	OTA Password aus WebBox
HotelCode	Hotel ID aus WebBox
InvTypeCode	Room ID aus WebBox

<?xml version="1.0"?>
<OTA_HotelBookingRuleNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2009-12-07T15:25:16" Version="4">
	<POS><Source MessagePassword="[PASSWORD]" ID="[USERNAME]"/></POS>
	<RuleMessages HotelCode="[HOTEL ID]">
		<RuleMessage>
			<StatusApplicationControl InvTypeCode="[ROOM ID]" />
			<BookingRules>
				<BookingRule Start="2016-05-24" End="2016-05-24"><RestrictionStatus Restriction="Master" Status="Open" /></BookingRule>
				<BookingRule Start="2016-05-25" End="2016-05-25"><RestrictionStatus Restriction="Master" Status="Closed" /></BookingRule>
			</BookingRules>
		</RuleMessage>
	</RuleMessages>
</OTA_HotelBookingRuleNotifRQ>

Response

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelBookingRuleNotifRS xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" PrimaryLangID="en" xmlns="http://www.opentravel.org/OTA/2003/05">
	<Success affectedRows="2"/>
</OTA_HotelBookingRuleNotifRS>

OTA_HotelRateAmountNotifRQ

Die Funktion OTA_HotelRateAmountNotifRQ wird zur Übertragung der Preise verwendet.

Url
https://[WEBBOX-URL]/ota/HotelRateAmountNotif.sync

Request

Attribute	Value
ID	OTA ID aus WebBox
MessagePassword	OTA Password aus WebBox
HotelCode	Hotel ID aus WebBox
InvTypeCode	Room ID aus WebBox
RatePlanCode	Rate ID aus WebBox

<?xml version="1.0"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2009-08-26T21:28:06" Version="4">
	<POS>
		<Source MessagePassword="[PASSWORD]" ID="[USERNAME]"/>
	</POS>
	<RateAmountMessages HotelCode="[HOTEL ID]">
		<RateAmountMessage>
			<StatusApplicationControl InvTypeCode="[ROOM ID]" RatePlanCode="[RATE ID]"/>
			<Rates>
				<Rate Start="2016-05-24" End="2016-05-24">
					<BaseByGuestAmts>
						<BaseByGuestAmt AmountAfterTax="104.5" NumberOfGuests="2"/>
					</BaseByGuestAmts>
				</Rate>
			</Rates>
		</RateAmountMessage>
		<RateAmountMessage>
			<StatusApplicationControl InvTypeCode="[ROOMID]" RatePlanCode="[RATEID]"/>
			<Rates>
				<Rate Start="2016-05-25" End="2016-05-25">
					<BaseByGuestAmts>
						<BaseByGuestAmt AmountAfterTax="104.5" NumberOfGuests="2"/>
					</BaseByGuestAmts>
				</Rate>
			</Rates>
		</RateAmountMessage>
	</RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Response

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" PrimaryLangID="en" xmlns="http://www.opentravel.org/OTA/2003/05">
	<Success affectedRows="2"/>
</OTA_HotelRateAmountNotifRS>

Reservierungen OTA (Open Travel Alliance)

Allgemein

OTA_HotelResNotifRQ (PUSH)

Die Funktion OTA_HotelResNotifRQ wird zur Push-Benachrichtigung einer neuen Reservierung verwendet. Die Nachricht wird von der WebBox an die Push-Url gesendet. Die Push-Url wird in der WebBox unter Hotel > Bearbeiten... > Einstellungen hinterlegt.

Push

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelResNotifRQ TimeStamp="2016-05-24T11:44:07" Version="4">
	<POS>
		<Source ID="[USERNAME]" MessagePassword="[PASSWORD]" />
	</POS>
	<HotelReservations HotelCode="[HOTE LID]">
		<HotelReservation CreateDateTime="2016-05-24T11:44:07" ResStatus="Reserved">
			<UniqueID ID="[BOOKING ID]" Type="14" />
		</HotelReservation>
  	</HotelReservations>
</OTA_HotelResNotifRQ>

OTA_ReadRQ

Die Funktion OTA_ReadRQ wird zur Abfrage einer Reservierung verwendet.

Url
https://[WEBBOX-URL]/ota/ReadReservation.sync

Request

Parameter

Attribute	Value
ID	OTA ID aus WebBox
MessagePassword	OTA Password aus WebBox
UniqueID	Booking ID aus Push Notification

<?xml version="1.0" encoding="UTF-8"?>
<OTA_ReadRQ xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" PrimaryLangID="en" TimeStamp="2014-10-15T12:03:38" Version="4" xmlns="http://www.opentravel.org/OTA/2003/05">
	<POS>
		<Source MessagePassword="[PASSWORD]" ID="[USERNAME]"/>
	</POS>
	<ReadRequests>
		<ReadRequest>
			<UniqueID ID="[BOOKING ID]" Type="14"/>
		</ReadRequest>
	</ReadRequests>
</OTA_ReadRQ>

Response

<?xml version="1.0" encoding="UTF-8"?>
	<OTA_ResRetrieveRS TimeStamp="2016-05-24T11:44:07" Version="4">
  		<Success />
  		<ReservationsList>
			<HotelReservations>
				<HotelReservation CreateDateTime="2016-05-24T11:44:06" ResStatus="Reserved">
					<UniqueID ID="1371" Type="14" />
					<RoomStays>
						<RoomStay RoomStayStatus="Commit" BoardTypeCode="BB">
							<Total AmountAfterTax="440.80" CurrencyCode="CHF" DecimalPlaces="2" />
							<RoomTypes>
								<RoomType IsRoom="true" RoomTypeCode="[ROOM ID]" NumberOfUnits="1">
									<RoomDescription Name="Einzelzimmer" />
								</RoomType>
							</RoomTypes>
							<RatePlans>
								<RatePlan RatePlanCode="[RATE ID]">
									<RatePlanDescription Name="Standardrate" />
								</RatePlan>
							</RatePlans>
							<GuestCounts IsPerRoom="true">
								<GuestCount AgeQualifyingCode="10" Count="1" />
							</GuestCounts>
							<TimeSpan Start="2016-05-27" End="2016-05-31" />
						</RoomStay>
        				</RoomStays>
        				<Services>
          					<Service Quantity="1" ServiceInventoryCode="1">
            						<Price>300.00</Price>
            						<ServiceDescription Name="Massage" />
         					</Service>
        				</Services>
        				<ResGuests>
         					<ResGuest>
							<Profiles>
								<ProfileInfo>
									<Profile ProfileType="1">
										<Customer>
											<PersonName>
												<NamePrefix />
												<GivenName>Karl</GivenName>
												<Surname>Mustermann</Surname>
											</PersonName>
											<Telephone FormattedInd="true" PhoneTechType="1" PhoneNumber="0650/12415468" PhoneUseType="3" />
											<Email>office@micado-it.at</Email>
											<Address Type="1" Remark="Personal" FormattedInd="false" DefaultInd="false">
												<AddressLine>Test</AddressLine>
												<CityName>Kitzbühel</CityName>
												<PostalCode>6370</PostalCode>
												<StateProv />
												<CountryName>AT</CountryName>
											</Address>
										</Customer>
									</Profile>			
								</ProfileInfo>
							</Profiles>
						</ResGuest>
					</ResGuests>
				<ResGlobalInfo>
					<Comments>
						<Comment>
							<Text>Test</Text>
						</Comment>
					</Comments>
					<Guarantee>
						<GuaranteesAccepted>
							<GuaranteeAccepted PaymentTransactionTypeCode="charge">
								<PaymentCard CardType="1" CardCode="" CardNumber="" ExpireDate="7P0XKWCdwnpto4fbt6It7g==">
									<CardHolderName />
								</PaymentCard>
							</GuaranteeAccepted>
						</GuaranteesAccepted>
					</Guarantee>
					<Total AmountAfterTax="740.80" CurrencyCode="CHF" DecimalPlaces="2" />
				</ResGlobalInfo>
			</HotelReservation>
		</HotelReservations>
	</ReservationsList>
</OTA_ResRetrieveRS>

Zuletzt geändert am 06.06.2016