Changelog

Stay up to date with the latest changes, enhancements, and fixes for the SiteConnect API.

2024

June 19, 2024

AddedReservations

^{Net or Gross Reservation / Commission Percentage}

When includesCommission is set, all RoomRate and RoomStay level totals will be considered as Net or Gross amounts based on this value. Properties can enable reservation commission percentage to add a commission to the totals sent to the PMS for NET rates. More details in ReservationTotal.

<ResGlobalInfo>
    ...
	<Total CurrencyCode="AUD" AmountBeforeTax="462.73" AmountAfterTax="509.00">
		<Taxes>
			<Tax Amount="46.27" CurrencyCode="AUD"/>
		</Taxes>
		<TPA_Extensions>
			<Total includesCommission="true"/>
		</TPA_Extensions>
	</Total>
    ...
</ResGlobalInfo>

2023

July 6, 2023

AddedRestrictions

^{Minimum Stay Through / Maximum Stay Through}

Property can decide if LengthOfStay MinMaxMessageType is on arrival (SetMinLOS / SetMaxLOS) or through (SetForwardMinStay / SetForwardMaxStay). More details in Availability and Restrictions.

<AvailStatusMessage>
	<StatusApplicationControl End="2024-10-05" InvTypeCode="SGL" RatePlanCode="BAR" Start="2024-10-05"/>
	<LengthsOfStay>
		<LengthOfStay MinMaxMessageType="SetForwardMinStay" Time="1"/>
		<!-- Min Length of Stay -->
		<LengthOfStay MinMaxMessageType="SetForwardMaxStay" Time="3"/>
		<!-- Max Length of Stay -->
	</LengthsOfStay>
</AvailStatusMessage>

2022

March 14, 2022

AddedRates

^{Occupancy Based Pricing}

The booking channel can support now Occupancy Based Pricing (OBP), instead of Per Day Pricing (PDP). More details in Rates.

<Rates>
	<Rate>
		<BaseByGuestAmts>
			<BaseByGuestAmt AgeQualifyingCode="10" AmountAfterTax="100.00" CurrencyCode="EUR" NumberOfGuests="1"/>
			<BaseByGuestAmt AgeQualifyingCode="10" AmountAfterTax="200.00" CurrencyCode="EUR" NumberOfGuests="2"/>
			<BaseByGuestAmt AgeQualifyingCode="10" AmountAfterTax="300.00" CurrencyCode="EUR" NumberOfGuests="3"/>
			<BaseByGuestAmt AgeQualifyingCode="10" AmountAfterTax="400.00" CurrencyCode="EUR" NumberOfGuests="4"/>
			<!-- Additional BaseByGuestAmt elements -->
		</BaseByGuestAmts>
		<AdditionalGuestAmounts>
			<AdditionalGuestAmount AgeQualifyingCode="8" Amount="50" CurrencyCode="EUR"/>
			<!-- Extra Child Rate -->
		</AdditionalGuestAmounts>
		<RateDescription>
			<Text>Contemporary 1 Bedroom Apartment with private balcony.</Text>
			<!-- Inclusions -->
		</RateDescription>
	</Rate>
</Rates>

2020

September 8, 2020

AddedReservations

^{Virtual Credit Card}

Extra information about Virtual Credit Cards can now be included with a Payment Card in a reservation. More details in Guarantee and DepositPayments.

<Guarantee>
	<GuaranteesAccepted>
		<GuaranteeAccepted>
			<PaymentCard CardType="1" CardCode="MC" CardNumber="4321432143214321" SeriesCode="123" ExpireDate="1234">
				<CardHolderName>John Smith</CardHolderName>
				<TPA_Extensions>
					<VirtualCreditCard isVCC="true" VCCActivationDate="2024-09-05" VCCCurrencyCode="EUR" VCCCurrentBalance="620.00" VCCDeactivationDate="2024-10-08"/>
				</TPA_Extensions>
			</PaymentCard>
		</GuaranteeAccepted>
	</GuaranteesAccepted>
</Guarantee>

August 28, 2020

AddedReservations

^{Guest Count Ages}

Ages can now be included within reservation guest counts. More details in GuestCounts.

<GuestCounts>
	<GuestCount AgeQualifyingCode="10" Count="2"/>
	<GuestCount AgeQualifyingCode="8" Age="7" Count="1"/>
	<GuestCount AgeQualifyingCode="8" Age="10" Count="1"/>
	<GuestCount AgeQualifyingCode="7" Count="1"/>
	<!-- Additional GuestCount elements -->
</GuestCounts>

2019

November 6, 2019

ModifiedReservations

^{CVV/CVC of a Payment Card}

Payment card series codes (CVV or CVC) will now be provided only in the Reservation Notification Email.

September 13, 2019

AddedReservations

^{Strong Customer Authentication (SCA)}

Three Domain Security (3DS) data can now be delivered in reservations alongside payment card data. More details in Guarantee and DepositPayments.

<Guarantee>
	<GuaranteesAccepted>
		<GuaranteeAccepted>
			<PaymentCard CardType="1" CardCode="MC" CardNumber="4321432143214321" SeriesCode="123" ExpireDate="1234">
				<CardHolderName>John Smith</CardHolderName>
				<ThreeDomainSecurity>
					<Results ThreeDSVersion="1.0.2" XID="z9UKb06xLziZMOXBEmWSVA1kwG0=" CAVV="MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=" ECI="05" />
				</ThreeDomainSecurity>
			</PaymentCard>
		</GuaranteeAccepted>
	</GuaranteesAccepted>
</Guarantee>

June 4, 2019

AddedReservations

^{Guest ID Document}

Guest profiles can now contain guest ID document details. More details in ResGuests.

<ResGuests>
	<ResGuest ResGuestRPH="1" ArrivalTime="14:00:00" PrimaryIndicator="1">
		<Profiles>
			<ProfileInfo>
				<Profile ProfileType="1">
					<Customer>
						---
						<Document DocID="987654321P" DocType="5" DocHolderNationality="AU" BirthDate="1996-10-05" Gender="Male" BirthCountry="AU" BirthPlace="AU" EffectiveDate="2026-10-05" ExpireDate="2027-10-05" DocIssueAuthority="DAFT" DocIssueLocation="AU" DocIssueStateProv="AU" DocIssueCountry="AU">
							<DocHolderName>John Smith</DocHolderName>
						</Document>
					</Customer>
				</Profile>
			</ProfileInfo>
		</Profiles>
	</ResGuest>
</ResGuests>

February 26, 2019

AddedReservations

^{Corporate Profile ID}

Corporate profiles in reservations can now contain a UniqueID ID: 3

<ProfileInfo>
	<Profile ProfileType="3">
		<CompanyInfo>
			<UniqueID ID="CORP"/>
			<CompanyName>COMPANY</CompanyName>
			<TelephoneInfo PhoneNumber="0266564101"/>
			<Email>contact@company.com</Email>
			<AddressInfo>
				<AddressLine>3 George St</AddressLine>
				<AddressLine>CBD</AddressLine>
				<CityName>Sydney</CityName>
				<PostalCode>2000</PostalCode>
				<StateProv>NSW</StateProv>
				<CountryName>Australia</CountryName>
			</AddressInfo>
		</CompanyInfo>
	</Profile>
</ProfileInfo>

February 26, 2019

AddedRestrictions

^{Maximum Length of Stay}

Maximum stay can now be sent with restriction updates.

<AvailStatusMessage>
	<StatusApplicationControl End="2024-10-05" InvTypeCode="SGL" RatePlanCode="BAR" Start="2024-10-05"/>
	<LengthsOfStay>
		<LengthOfStay MinMaxMessageType="SetMinLOS" Time="1"/>
		<!-- Min Length of Stay -->
		<LengthOfStay MinMaxMessageType="SetMaxLOS" Time="3"/>
		<!-- Max Length of Stay -->
	</LengthsOfStay>
</AvailStatusMessage>

2018

December 1, 2022

AddedReservations

^{AmountBeforeTax}

The Reservation API now has the ability to accept only AmountBeforeTax, instead of requiring AmountAfterTax to be always set.

<Total AmountBeforeTax="558.00" AmountAfterTax="620.00" CurrencyCode="EUR">
	<Taxes>
		<Tax Type="inclusive" Code="35" Amount="62.00" CurrencyCode="EUR"/>
		<!-- Additional Tax elements -->
	</Taxes>
</Total>

2017

May 24, 2017

AddedReservations

^Services

We extended the Reservation API with the ability to provide Services information. Please see relevant additions to both Services and RoomStay below.

<Services>
    <Service ServiceInventoryCode="OTHER" Inclusive="true" Quantity="1" ID="12346">
        <Price>
            <Base AmountBeforeTax="10.00" AmountAfterTax="11.00" CurrencyCode="EUR"/>
            <Total AmountBeforeTax="30.00" AmountAfterTax="33.00" CurrencyCode="EUR"/>
            <RateDescription>
                <Text>Parking for 1 vehicle per night</Text>
            </RateDescription>
        </Price>
        <ServiceDetails>
            <TimeSpan Start="2025-10-05" End="2025-10-08"/>
        </ServiceDetails>
    </Service>
</Services>

2016

June 30, 2016

AddedReservations

^{Company and Travel Agent}

We extended the Reservation API with the ability to provide Company and Travel Agent information. See spec for more details on this functionality.

Company

<ProfileInfo>
	<Profile ProfileType="3">
		<CompanyInfo>
			<UniqueID ID="CORP"/>
			<CompanyName>COMPANY</CompanyName>
			<TelephoneInfo PhoneNumber="0266564101"/>
			<Email>contact@company.com</Email>
			<AddressInfo>
				<AddressLine>3 George St</AddressLine>
				<AddressLine>CBD</AddressLine>
				<CityName>Sydney</CityName>
				<PostalCode>2000</PostalCode>
				<StateProv>NSW</StateProv>
				<CountryName>Australia</CountryName>
			</AddressInfo>
		</CompanyInfo>
	</Profile>
</ProfileInfo>

Travel Agent

<ProfileInfo>
	<Profile ProfileType="4">
		<UniqueID ID="56789"/>
		<CompanyInfo>
			<CompanyName>TRAVEL AGENT LTD</CompanyName>
			<TelephoneInfo PhoneNumber="0266564100"/>
			<Email>contact@travelagent.com</Email>
			<AddressInfo>
				<AddressLine>4 George St</AddressLine>
				<AddressLine>CBD</AddressLine>
				<CityName>Sydney</CityName>
				<PostalCode>2000</PostalCode>
				<StateProv>NSW</StateProv>
				<CountryName>Australia</CountryName>
			</AddressInfo>
		</CompanyInfo>
	</Profile>
</ProfileInfo>

April 4, 2016

AddedReservations

^{Additional Details}

To better support character limitations to certain attributes in the the OTA Specifications, we've modified our 'Retrieve Rooms' API to include shorter character code within AdditionalDetails / AdditionalDetail / @Code (NO_AVAILABILITY, NO_RATES, NO_UPDATES).

<RatePlans>
	<RatePlan RatePlanCode="BAR">
		<RatePlanDescription Name="Best Available Rate">
			<Text>Best Available Rate.</Text>
		</RatePlanDescription>
		<AdditionalDetails>
			<AdditionalDetail Code="NO_RATES"/>
			<AdditionalDetail Code="NO_AVAILABILITY"/>
		</AdditionalDetails>
	</RatePlan>
</RatePlans>

<RatePlans>
	<RatePlan RatePlanCode="BAR">
		<RatePlanDescription Name="Best Available Rate">
			<Text>Best Available Rate.</Text>
		</RatePlanDescription>
		<AdditionalDetails>
			<AdditionalDetail Code="NO_UPDATES"/>
		</AdditionalDetails>
	</RatePlan>
</RatePlans>

2014

July 31, 2014

AddedReservations

^{RoomRate / Rates / Rate / Total}

This total is an important value as most PMS will only receive proper room rate values if this value is provided.

<RoomRates>
	<RoomRate RoomTypeCode="TPL" RatePlanCode="BAR" NumberOfUnits="1">
		<Rates>
			<Rate UnitMultiplier="1" RateTimeUnit="Day" EffectiveDate="2024-10-05" ExpireDate="2024-10-08">
				---
				<Total AmountBeforeTax="558.00" AmountAfterTax="620.00" CurrencyCode="EUR">
					<Taxes>
						<Tax Type="inclusive" Code="35" Amount="62.00" CurrencyCode="EUR"/>
						<!-- Additional Tax elements -->
					</Taxes>
				</Total>
			</Rate>
		</Rates>
    	---
	</RoomRate>
</RoomRates>

July 3, 2014

AddedReservations

^{PaymentCard @CardCode}

Payment card CardCode is now a mandatory field (if any PaymentCard details are sent) due to an issue found where the reservation will not be accepted by all PMSs if it is not included.

<Guarantee>
	<GuaranteesAccepted>
		<GuaranteeAccepted>
			<PaymentCard CardType="1" CardCode="MC" CardNumber="4321432143214321" SeriesCode="123" ExpireDate="1234">
				<CardHolderName>John Smith</CardHolderName>
			</PaymentCard>
		</GuaranteeAccepted>
	</GuaranteesAccepted>
</Guarantee>

April 2, 2014

AddedReservations

^{Customer / CustLoyalty}

Adding loyalty information for the guest.// Some code

<Customer>
	...
	<CustLoyalty ProgramID="LoyaltyProgramName" MembershipID="123456789" ExpireDate="2019-12-30">
</Customer>

April 2, 2014

AddedReservations

^{ArrivalTransport / DepartureTransport}

Adding TransportInfo for arrival and departure.

<ResGuest>
	<ArrivalTransport>
		<TransportInfo Time="2014-01-12T14:00:00" Type="Air" ID="BA125"/>
	</ArrivalTransport>
	<DepartureTransport>
		<TransportInfo Time="2014-01-16T17:00:00" Type="Air" ID="BA143"/>
	</DepartureTransport>
</ResGuest>

April 2, 2014

AddedReservations

^{MealsIncluded MealPlanCodes}

Adding meal plan information to the RatePlan.

<RatePlan>
	<MealsIncluded MealPlanCodes="Full board"/>
</RatePlan>

October 23, 2014

AddedReservations

^{Customer / NamePrefix}

Adding the title of the guest or customer to the reservation profiles.

<ResGuests>
	<ResGuest ResGuestRPH="1" ArrivalTime="14:00:00" PrimaryIndicator="1">
		<Profiles>
			<ProfileInfo>
				<Profile ProfileType="1">
					<Customer>
						<PersonName>
							<NamePrefix>Mr</NamePrefix>
							<GivenName>John</GivenName>
							<Surname>Smith</Surname>

<ResGlobalInfo>
	<Profiles>
		<ProfileInfo>
			<Profile>
				<Customer>
					<PersonName>
						<NamePrefix>Mr</NamePrefix>
						<GivenName>John</GivenName>
						<Surname>Smith</Surname>

Last updated 6 months ago

Was this helpful?