Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Note

Please check this page regularly for functionality and feature updates to SiteConnect.

...

Element

Number

Type

Description

OTA_HotelAvailNotifRQ

1


Root node

AvailStatusMessage /
LengthsOfStay / LengthOfStay

0..2


Optional, used for minimum and maximum length of stay

@MinMaxMessageType

1

String

Mandatory if LengthsOfStay present. Can be one of the following
SetMinLOS: Sets the minimum length of stay on arrival
SetMaxLOS: Sets the maximum length of stay on arrival
SetForwardMinStay: Sets the maximum length of stay through
SetForwardMaxStay: Sets the maximum length of stay through

For any property only either SetMinLOS and SetMaxLOS or SetForwardMinStay and SetForwardMaxStay will be used.

@Time

0..1

Integer

Mandatory if @MinMaxMessageType is ‘SetMinLOS' or 'SetForwardMinStay’: Sets the minimum or maximum number of days required for a stay.

If @MinMaxMessageType is ‘SetMaxLOS' or 'SetForwardMaxStay’: Sets the maximum number of days bookable. If no MaxLOS value is set, no @Time will be specified.

...


Element
Number
Type
Description
ResGlobalInfo / Guarantee /
GuaranteesAccepted / GuaranteeAccepted / 
PaymentCard
0..1
Guarantee provided with the reservation. This element is used if there is no deposit payed for the reservation.
@CardType0..1
Always 1 to indicate credit card
@CardCode1
The 2 character code of the credit card issuer. Please see the OTA Payment Card Provider Codes table for reference
@CardNumber0..1
This is actual number of the credit card used for deposit/prepayment.
@SeriesCode0..1
The SeriesCode attribute is used (Optionally) for the security number of the card. NOTE: While this attribute is supported in the reservation XML, the details of this attribute are ONLY passed through when a Channel decides to utilise the SiteConnect Reservation Email notification. SeriesCode will not be stored anywhere within SiteConnect for PCI compliance. 
@ExpireDate0..1
This is the expiry date of the credit card used for deposit/prepayment. Format MMyy.
PaymentCard / CardHolderName0..1
The name of the card holder.
PaymentCard / ThreeDomainSecurity / Results0..1

Transaction results.

IMPORTANT NOTE: SCA / 3DS details will only be passed through to hoteliers integrated with a 3DS compatible property management system. If the hotelier is not integrated with a property management system or the property management system does not support SCA, information within the 'ThreeDomainSecurity' element will not be visible in The Channel Manager.

@ThreeDSVersion1
The 3DS version used for authentication
@ECI1
Electronic Commerce Indicator. Please see Electronic Commerce Indicator Codes table for reference.
@CAVV0..1
Cardholder Authentication Verification Value (CAVV); Authentication Verification Value (AVV); Universal Cardholder Authentication Field (UCAF)
@PAResStatus0..1
Transactions status result identifier. Please see Transactions Status Result Identifier Codes table for reference.
@SignatureVerification0..1
Transaction Signature status identifier. Please see Transaction Signature Status Codes table for reference.
@XID0..1

Transaction identifier resulting from authentication processing

When ThreeDSVersion = 1.x.x the transaction identifier MUST be provided in the @XID attribute
@Enrolled0..1
Status of Authentication eligibility. Please see Status of Authentication Codes table for reference.
@DSTransactionID0..1

Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction

When ThreeDSVersion = 2.x.x the transaction identifier MUST be provided in the @DSTransactionID attribute

PaymentCard / TPA_Extensions / VirtualCreditCard0..1
Denotes that the payment card is a virtual credit card.
@isVCC1
Must always be “true”.

@VCCActivationDate

0..1

Date

The date from when the card can be charged. Format YYYY-MM-DD.

@VCCDeactivationDate

0..1

Date

The date from when the card will no longer be chargeable. Format YYYY-MM-DD.

@VCCCurrentBalance

0..1

Decimal

The amount which can be charged to the card. If this is not included, it does not mean a 0 balance.

@VCCCurrencyCode

0..1

String

The ISO currency code of the VCCCurrentBalance. Must be included if there is @VCCCurrentBalance.

ResGlobalInfo / DepositPayments /GuaranteePayment0..1
Deposit provided with the reservation.
GuaranteePayment /
AcceptedPayments / AcceptedPayment
0..1
Deposit payment information.
AcceptedPayment / PaymentCard1
Mandatory if AcceptedPayment is sent. The card to which the deposit or prepayment is charged.
@CardType0..1
Always 1 to indicate credit card
@CardCode1
The 2 character code of the credit card issuer. Please see the OTA Payment Card Provider Codes table for reference
@CardNumber0..1
This is actual number of the credit card used for deposit/prepayment.
@SeriesCode0..1
The SeriesCode attribute is used (Optionally) for the security number of the card. NOTE: While this attribute is supported in the reservation XML, the details of this attribute are not stored or passed through to the hotel due to PCI-DSS requirements.
@ExpireDate0..1
This is the expiry date of the credit card used for deposit/prepayment. Format MMyy.
PaymentCard / CardHolderName0..1
The name of the card holder.
PaymentCard / ThreeDomainSecurity / Results0..1

Transaction results.

IMPORTANT NOTE: SCA / 3DS details will only be passed through to hoteliers integrated with a 3DS compatible property management system. If the hotelier is not integrated with a property management system or the property management system does not support SCA, information within the 'ThreeDomainSecurity' element will not be visible in The Channel Manager.

@ThreeDSVersion1
The 3DS version used for authentication
@ECI1
Electronic Commerce Indicator. Please see Electronic Commerce Indicator Codes table for reference.
@CAVV0..1
Cardholder Authentication Verification Value (CAVV); Authentication Verification Value (AVV); Universal Cardholder Authentication Field (UCAF)
@PAResStatus0..1
Transactions status result identifier. Please see Transactions Status Result Identifier Codes table for reference.
@SignatureVerification0..1
Transaction Signature status identifier. Please see Transaction Signature Status Codes table for reference.
@XID0..1

Transaction identifier resulting from authentication processing

When ThreeDSVersion = 1.x.x the transaction identifier MUST be provided in the @XID attribute

@Enrolled0..1
Status of Authentication eligibility. Please see Status of Authentication Codes table for reference.
@DSTransactionID0..1

Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction

When ThreeDSVersion = 2.x.x the transaction identifier MUST be provided in the @DSTransactionID attribute

PaymentCard / TPA_Extensions / VirtualCreditCard

0..1


Denotes that the payment card is a virtual credit card.

@isVCC

1


Must always be “true”.

@VCCActivationDate

0..1

Date

The date from when the card can be charged. Format YYYY-MM-DD.

@VCCDeactivationDate

0..1

Date

The date from when the card will no longer be chargeable. Format YYYY-MM-DD.

@VCCCurrentBalance

0..1

Decimal

The amount which can be charged to the card. If this is not included, it does not mean a 0 balance.

@VCCCurrencyCode

0..1

String

The ISO currency code of the VCCCurrentBalance. Must be included if there is @VCCCurrentBalance.


...


Element
Number
Type
Description
ResGlobalInfo / Guarantee /
GuaranteesAccepted / GuaranteeAccepted
PaymentCard
0..1
Guarantee provided with the reservation. This element is used if there is no deposit payed for the reservation.
@CardType0..1
Always 1 to indicate credit card
@CardCode1
The 2 character code of the credit card issuer. Please see the OTA Payment Card Provider Codes table for reference
@CardNumber0..1
This is actual number of the credit card used for deposit/prepayment.
@SeriesCode0..1
The SeriesCode attribute is used (Optionally) for the security number of the card. NOTE: While this attribute is supported in the reservation XML, the details of this attribute are ONLY passed through when a Channel decides to utilise the SiteConnect Reservation Email notification. SeriesCode will not be stored anywhere within SiteConnect for PCI compliance. 
@ExpireDate0..1
This is the expiry date of the credit card used for deposit/prepayment. Format MMyy.
PaymentCard / CardHolderName0..1
The name of the card holder.
PaymentCard / ThreeDomainSecurity / Results0..1

Transaction results.

IMPORTANT NOTE: SCA / 3DS details will only be passed through to hoteliers integrated with a 3DS compatible property management system. If the hotelier is not integrated with a property management system or the property management system does not support SCA, information within the 'ThreeDomainSecurity' element will not be visible in The Channel Manager.

@ThreeDSVersion1
The 3DS version used for authentication
@ECI1
Electronic Commerce Indicator. Please see Electronic Commerce Indicator Codes table for reference.
@CAVV0..1
Cardholder Authentication Verification Value (CAVV); Authentication Verification Value (AVV); Universal Cardholder Authentication Field (UCAF)
@PAResStatus0..1
Transactions status result identifier. Please see Transactions Status Result Identifier Codes table for reference.
@SignatureVerification0..1
Transaction Signature status identifier. Please see Transaction Signature Status Codes table for reference.
@XID0..1
Transaction identifier resulting from authentication processing
@Enrolled0..1
Status of Authentication eligibility. Please see Status of Authentication Codes table for reference.
@DSTransactionID0..1
Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction
ResGlobalInfo / DepositPayments /GuaranteePayment0..1
Deposit provided with the reservation.
GuaranteePayment /
AcceptedPayments / AcceptedPayment
0..1
Deposit payment information.
AcceptedPayment / PaymentCard1
Mandatory if AcceptedPayment is sent. The card to which the deposit or prepayment is charged.
@CardType0..1
Always 1 to indicate credit card
@CardCode1
The 2 character code of the credit card issuer. Please see the OTA Payment Card Provider Codes table for reference
@CardNumber0..1
This is actual number of the credit card used for deposit/prepayment.
@SeriesCode0..1
The SeriesCode attribute is used (Optionally) for the security number of the card. NOTE: While this attribute is supported in the reservation XML, the details of this attribute are ONLY passed through when a Channel decides to utilise the SiteConnect Reservation Email notification. SeriesCode will not be stored anywhere within SiteConnect for PCI compliance. 
@ExpireDate0..1
This is the expiry date of the credit card used for deposit/prepayment. Format MMyy.
PaymentCard / CardHolderName0..1
The name of the card holder.
PaymentCard / ThreeDomainSecurity / Results0..1

Transaction results.

IMPORTANT NOTE: SCA / 3DS details will only be passed through to hoteliers integrated with a 3DS compatible property management system. If the hotelier is not integrated with a property management system or the property management system does not support SCA, information within the 'ThreeDomainSecurity' element will not be visible in The Channel Manager.

@ThreeDSVersion1
The 3DS version used for authentication
@ECI1
Electronic Commerce Indicator. Please see Electronic Commerce Indicator Codes table for reference.
@CAVV0..1
Cardholder Authentication Verification Value (CAVV); Authentication Verification Value (AVV); Universal Cardholder Authentication Field (UCAF)
@PAResStatus0..1
Transactions status result identifier. Please see Transactions Status Result Identifier Codes table for reference.
@SignatureVerification0..1
Transaction Signature status identifier. Please see Transaction Signature Status Codes table for reference.
@XID0..1
Transaction identifier resulting from authentication processing
@Enrolled0..1
Status of Authentication eligibility. Please see Status of Authentication Codes table for reference.
@DSTransactionID0..1
Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction
GuaranteePayment / AmountPercent1
Mandatory if something is passed in the DepositPayment element.
@Amount1
Amount charged as deposit
@CurrencyCode1
Currency of the deposit payment


...

HotelReservations / HotelReservation / RoomStays / RoomStay / RoomRates / RoomRate / Rates

Element
Number
Description
Rate / Total0..1The total amount charged for this rate including additional occupant amounts and fees. If left empty and the Base amount is provided then assume the Base amount to be the Total Amount.

...

HotelReservations / HotelReservation / ResGlobalInfo / Guarantee / GuaranteesAccepted / GuaranteeAccepted / PaymentCard

Element
Number
Description
@CardCode


1The Card code is the 2-letter code indicative of the card. See table below for valid values.

HotelReservations / HotelReservation / ResGlobalInfo / DepositPayments / GuaranteePayment / AcceptedPayments / AcceptedPayment / PaymentCard

Element
Number
Description
@CardCode


1The Card code is the 2-letter code indicative of the card. See table below for valid values.

...

HotelReservations / HotelReservation / ResGuests / ResGuest / Profiles / ProfileInfo / Profile / Customer

Element
Number
Description

Customer / CustLoyalty

0..nA list of loyalty/rewards programs for the customer
@ProgramID 0..1

The defined membership program name or ID applicable to program. e.g. Qantas

@MembershipID 0..1The account identification number for this particular member in this particular program
@ExpireDate0..1The expiry date for this particular membership record in this particular program. Format yyyy-MM-dd

...

HotelReservations / HotelReservation / ResGuests / ResGuest

Element
Number
Description

ResGuest / ArrivalTransport / TransportInfo

0..n

A list of details regarding transport to destination

@Type0..1

The type of transport the guest used for travelling to destination as provided by booking channel

@ID0..1The transport provider's ID for transportation mode the guest is using. e.g. Flight Number QF123
@Time 0..1

The transportation arrival time to destination. Format yyyy-MM-ddThh:mm:ss

ResGuest / DepartureTransport / TransportInfo0..nA list of details regarding transport from destination 
@Type0..1The type of transport the guest used for travelling from destination as provided by booking channel
@ID0..1The transport provider's ID for transportation mode the guest is using. e.g. Flight Number QF123
@Time 0..1

The transportation departure time from destination. Format yyyy-MM-ddThh:mm:ss

...

HotelReservations / HotelReservation / RoomStays / RoomStay / RatePlans / RatePlan

Element
Number
Description

RatePlan / MealsIncluded

0..n

Used to identify the types of meals included with a rate plan

@MealPlanCodes 0..1Meal plan codes outline meal inclusions within rate plan e.g. fullBoard

...

HotelReservations / HotelReservation / RoomStays / ResGuest / Profiles / ProfileInfo / Profile / Customer

Element
Number
Description

Customer / NamePrefix

0..n

The title of the customer

...

HotelReservations / HotelReservation / ResGlobalInfo / Profiles / ProfileInfo / Profile / Customer

Element
Number
Description

Customer / NamePrefix

0..n

The title of the customer

...