Sie zeigen eine alte Version dieser Seite an. Zeigen Sie die aktuelle Version an.

Unterschiede anzeigen Seitenhistorie anzeigen

Version 1 Nächste Version anzeigen »

Target audience
Version1.0.
AuthenticationBearer Token
Message typeSynchronous, Outbound

Message Description

  • This message will be used to request points

IO_LoyaltyAccountInquiryRQ - Attributes

Element | @AttributeNumDescription outboundComments + Contents outboundpAirOnPrem

IO_LoyaltyAccountInquiryRQ

1Root element of the message.
(Fehler)(Haken)

@EchoToken

0..1

A reference for additional message identification, assigned by the requesting host system. When a request message includes an echo token the corresponding response message MUST include an echo token with an identical value.


(Fehler)(Haken)

@CorrelationID

1

Used to match result messages (*RS) to request messages (*RQ) in asynchronous communication patterns. Therefore mandatory.


(Fehler)(Haken)

@TimeStamp

0..1

Time of the transaction.

"2019-06-05T09:12:14Z"(Fehler)(Haken)

@Version

0..1

Message version.

Version="3.001"

(Fehler)(Haken)

@PrimaryLangID

0..1

The primary language preference for the message encoded as ISO 639-3.


(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | LoyaltyInquiryRequest

0..1

(Fehler)(Haken)

@TransactionAccount

0..1Describes the action of the points
  • ACCRUAL
(Fehler)(Haken)

@HotelCode

0..1Full name of the property which the transferred stay information belongs to.
(Fehler)(Haken)

@HotelID

0..1

The ID will transfer the HotelID and needs to be agreed by the trading partners and remain the same throughout the messages.


(Fehler)(Haken)

@HotelName

0..1Full name of the property which the transferred stay information belongs to.
(Fehler)(Haken)

@ChainCode

0..1Full name of the property which the transferred stay information belongs to.
(Fehler)(Haken)

@MemberCode

1The member code attribute will indicate the actual number.
(Fehler)(Haken)

@ProgramCode

1The program code attribute can be used to indicate the program that is being passed. For instance, we could use it to pass: Frequent Guest, Frequent Traveller and Company ID.
(Fehler)(Haken)

@LevelCode

0..1Indicates special privileges in program assigned to individual.
(Fehler)(Haken)

@AccountStatus

0..1The account status. Refer to Open Travel Code List Profile Status (PST).
  • 4 = Active
  • 5 = Inactive
(Fehler)(Haken)

@PrimaryInd

0..1When true, indicates this is the primary customer loyalty program and when false, indicates this is not the primary customer loyalty program.
  • true
  • false
(Fehler)(Haken)

@TransactionReference

0..1external Reference ID for the Cancellation
(Fehler)(Haken)

@TransactionVoidInd

0..1Displays if it is a Redemption or a Cancellation
  • true
  • false
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | LoyaltyChargeRequest | TransactionAmount

0..1Information of the Amount of the Redemption 
(Fehler)(Haken)

@Amount

1The Amount of the points
(Fehler)(Haken)

@Type

1Code for Points
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | LoyaltyChargeRequest | TransactionAmount | CurrencyAmount

0..1Information of the Amount of the Redemption in the Hotel Currency
(Fehler)(Haken)

@CurrencyCode

1The Currency Code which is used by the Amount
(Fehler)(Haken)

@ExchangeRate

0..1Exchange Ratedecimal(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | LoyaltyChargeRequest | TransactionAmount | CurrencyAmount | Amount

1The amount which will be paid with the Point Redemption
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | LoyaltyChargeRequest | StayInfo

0..1Reservation Information
(Fehler)(Haken)

@ReservationID

0..1Reservation ID
(Fehler)(Haken)

@ArrivalDate

0..1Arrival Date
(Fehler)(Haken)

@DepartureDate

0...1Departure Date
(Fehler)(Haken)

@CRSNumber

0...1CRS ID
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | User

1Information of the logged-in user
(Fehler)(Haken)

@UserName

0..1Name of the User
(Fehler)(Haken)

@Organisation

0..1Name of the Group the User belongs to
(Fehler)(Haken)

@Department

0..1Name of the Department from the User
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | User | Email

0..1This field would be used to pass the guest’s Email.
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | User | UserID

0..1This field would be used to pass the guest’s UserID
(Fehler)(Haken)
@ID1A unique identifying value assigned by the creating system. In the context of protel IO, this will be the unique hotel ID where the profile was created.


(Fehler)(Haken)
@ID_Context1

Used to identify the source of the identifier. For both outbound (from protel IO) and inbound (to protel IO) request messages, this must carry the string value


(Fehler)(Haken)
@Type0..1

A numeric reference to the type of object defined by the unique ID attribute. Refer to the OTA code lists: Unique ID Type (UIT)


(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS - Attributes

Element | @Attribute

NumDescription inboundComments + Contents inboundpAirOnPrem

IO_LoyaltyAccountInquiryRS

1Root element of the message.
(Fehler)(Haken)

@EchoToken

0..1

A reference for additional message identification, assigned by the requesting host system. When a request message includes an echo token the corresponding response message MUST include an echo token with an identical value.


(Fehler)(Haken)

@CorrelationID

1

Used to match result messages (*RS) to request messages (*RQ) in asynchronous communication patterns. Therefore mandatory.


(Fehler)(Haken)

@TimeStamp

0..1

Time of the transaction.

"2019-06-05T09:12:14Z"(Fehler)(Haken)

@Version

0..1

Message version.

Version="3.001"

(Fehler)(Haken)

@PrimaryLangID

0..1

The primary language preference for the message encoded as ISO 639-3.


(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | Success

0..1

(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | Errors | Error

0..1Indicates an error occurred during the processing of an OpenTravel message. If the message successfully processes, but there are business errors, those errors should be passed in the warning element.
(Fehler)(Haken)

@ShortText

0..1An abbreviated version of the error in textual format.
(Fehler)(Haken)

@Code

0..1If present, this refers to a table of coded values exchanged between applications to identify errors or warnings. Refer to the OTA Code List: Error Codes (ERR).
(Fehler)(Haken)

@Type

0..1Mandatory. Refer to OTA Code List: Error Warning Type (EWT).
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | Errors | Error 

| Message

0..1

(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | Warnings | Warning

0..1Used in conjunction with the Success element to define one or more business errors.
(Fehler)(Haken)

@ShortText

0..1An abbreviated version of the error in textual format.
(Fehler)(Haken)

@Code

0..1If present, this refers to a table of coded values exchanged between applications to identify errors or warnings. Refer to the OTA Code List: Error Codes (ERR).
(Fehler)(Haken)

@Type

0..1Mandatory. Refer to OTA Code List: Error Warning Type (EWT).
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | Warnings | Warning | Message

0...1

(Fehler)(Haken)
IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult0..1

(Fehler)(Haken)
@TransactionReference0..1external Reference ID for the Cancellation
(Fehler)(Haken)
@TransactionVoidInd0..1Displays if it is a Redemption or a Cancellation
  • true
  • false
(Fehler)(Haken)
IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | TransactionAmount1Information of the Amount of the Redemption 
(Fehler)(Haken)

@Amount

1The Amount of the points
(Fehler)(Haken)

@Type

1Code for Points
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | LoyaltyInquiryResult | TransactionAmount | CurrencyAmount

0..1Information of the Amount of the Redemption in the Hotel Currency
(Fehler)(Haken)

@CurrencyCode

1The Currency Code which is used by the Amount
(Fehler)(Haken)

@ExchangeRate

0..1Exchange Ratedecimal(Fehler)(Haken)

IO_LoyaltyAccountInquiryRQ | LoyaltyInquiryResult | TransactionAmount | CurrencyAmount | Amount

1The amount which will be paid with the Point Redemption
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount

0..1

(Fehler)(Haken)

@MemberCode

1The MemberCode attribute will indicate the actual number.
(Fehler)(Haken)

@ProgramCode

1The ProgramCode attribute can be used to indicate the program that is being passed. For instance, we could use it to pass: Frequent Guest, Frequent Traveller and Company ID.
(Fehler)(Haken)

@LevelCode

0..1Indicates special privileges in program assigned to individual.
(Fehler)(Haken)

@AccountStatus

0..1The account status. Refer to Open Travel Code List Profile Status (PST).
  • 4 = Active
  • 5 = Inactive
(Fehler)(Haken)

@PrimaryInd

0..1When true, indicates this is the primary customer loyalty program and when false, indicates this is not the primary customer loyalty program.
  • true
  • false
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | CardHolderName

0..1Name of the Membership card
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | AccountBalance

1Actual amount available, which can be used for redeeming the points
(Fehler)(Haken)

@Amount

1Amount in Points
(Fehler)(Haken)

@Type

1Shortname of the Loyalty Program
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | AccountBalance | CurrencyAmount

0..1Amount in the default Currency
(Fehler)(Haken)

@ExchangeRate

0..1Exchange Rate for the Loyalty Points
(Fehler)(Haken)

@CurrencyCode

0..1Currency Code, from the RQ
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | AccountBalance | CurrencyAmount | Amount

1Amount in the Currency Code, from the RQ
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyAccount | AccountAccrued

0..1Total amount, the collected points
(Fehler)(Haken)

@Amount

1Amount in Points
(Fehler)(Haken)

@Type

1Shortname of the Loyalty Program
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | AccountAccrued | CurrencyAmount

0..1Amount in the default Currency
(Fehler)(Haken)

@ExchangeRate

0..1Exchange Rate for the Loyalty Points
(Fehler)(Haken)

@CurrencyCode

0..1Currency Code, from the RQ
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | AccountAccrued | CurrencyAmount | Amount

1Amount in the Currency Code, from the RQ
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | AccountRedeemed

0..1Total amount of points redeemed
(Fehler)(Haken)

@Amount

1Amount in Points
(Fehler)(Haken)

@Type

1Shortname of the Loyalty Program
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | AccountRedeemed | CurrencyAmount

0..1Amount in the default Currency
(Fehler)(Haken)

@ExchangeRate

0..1Exchange Rate for the Loyalty Points
(Fehler)(Haken)

@CurrencyCode

0..1Currency Code, from the RQ
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | AccountRedeemed | CurrencyAmount  | Amount

1Amount in the Currency Code, from the RQ
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | UserCreated

0..1Information of the logged-in user
(Fehler)(Haken)

@UserName

0..1Name of the User
(Fehler)(Haken)

@Organisation

0..1Name of the Group the user belongs to
(Fehler)(Haken)

@Department

0..1Name of the Department from the User
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | UserCreated | Email

0..1This field would be used to pass the guest’s Email.
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | UserCreated | UserID

0..1This field would be used to pass the guest’s UserID
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | UserModified

0..1Information of the logged-in user
(Fehler)(Haken)

@UserName

0..1Name of the User
(Fehler)(Haken)

@Organisation

0..1Name of the Group the user belongs to
(Fehler)(Haken)

@Department

0..1Name of the Department from the User
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | UserModified | Email

0..1This field would be used to pass the guest’s Email.
(Fehler)(Haken)

IO_LoyaltyAccountInquiryRS | LoyaltyInquiryResult | LoyaltyAccount | UserModified | UserID

0..1This field would be used to pass the guest’s UserID
(Fehler)(Haken)
@ID1A unique identifying value assigned by the creating system. In the context of protel IO, this will be the unique hotel ID where the profile was created.


(Fehler)(Haken)
@ID_Context1

Used to identify the source of the identifier. For both outbound (from protel IO) and inbound (to protel IO) request messages, this must carry the string value


(Fehler)(Haken)
@Type0..1

A numeric reference to the type of object defined by the unique ID attribute. Refer to the OTA code lists: Unique ID Type (UIT)


(Fehler)(Haken)

Sample Message

IO_LoyaltyAccountInquiryRQ

<IO_LoyaltyAccountInquiryRQ xmlns="http://protel.io/soap" EchoToken="LaureenTest_Charge2" TimeStamp="2021-09-16T06:35:41Z" Version="1.000" CorrelationID="LaureenTest_Charge2">
	<LoyaltyInquiryRequest TransactionAccount="ACCRUAL" HotelCode="2691" HotelID="7" HotelName="JA Ocean View Hotel, UAE-Dubai" ChainCode="HC1" MemberCode="12898323" ProgramCode="GHA" LevelCode="Gold" AccountStatus="4" PrimaryInd="true" TransactionVoidInd="false">
		<TransactionAmount Amount="10.320252" Type="D$">
			<CurrencyAmount CurrencyCode="AED" ExchangeRate="0.272242186649243">
				<Amount>37.91</Amount>
			</CurrencyAmount>
		</TransactionAmount>
		<StayInfo ReservationID="2390534" ArrivalDate="2019-08-15T00:00:00" DepartureDate="2019-08-19T00:00:00"/>
		<User UserName="HelloWorld" Organisation="Gruppe" Department="Department">
			<Email>EMail@Email</Email>
			<UserID ID="12315" ID_Context="protelID"/>
		</User>
	</LoyaltyInquiryRequest>
</IO_LoyaltyAccountInquiryRQ>

IO_LoyaltyAccountInquiryRS

<IO_LoyaltyAccountInquiryRS xmlns="http://protel.io/soap" CorrelationID="LaureenTest_Charge2" Version="1.0" TimeStamp="2021-09-16T06:35:41">
	<Success>true</Success>
	<LoyaltyInquiryResult>
		<TransactionAmount Amount="10.0" Type="D$">
			<CurrencyAmount CurrencyCode="AED" ExchangeRate="0.27224218664924316">
				<Amount>36.732</Amount>
			</CurrencyAmount>
		</TransactionAmount>
		<LoyaltyAccount MemberCode="12898323" ProgramCode="GHA" LevelCode="Gold" AccountStatus="4" PrimaryInd="false">
			<CardHolderName>Gary</CardHolderName>
			<AccountBalance Amount="1893.0" Type="D$">
				<CurrencyAmount CurrencyCode="AED" ExchangeRate="0.27224218664924316">
					<Amount>6953.3676000000005</Amount>
				</CurrencyAmount>
			</AccountBalance>
			<AccountAccrued Amount="4893.0" Type="D$">
				<CurrencyAmount CurrencyCode="AED" ExchangeRate="0.27224218664924316">
					<Amount>17972.96760000000</Amount>
				</CurrencyAmount>
			</AccountAccrued>
			<AccountRedeemed Amount="3000.0" Type="D$">
				<CurrencyAmount CurrencyCode="AED" ExchangeRate="0.27224218664924316">
					<Amount>11019.600000000000</Amount>
				</CurrencyAmount>
			</AccountRedeemed>
			<AccountChargeLowerLimit Amount="10.0" Type="D$">
				<CurrencyAmount CurrencyCode="AED" ExchangeRate="0.27224218664924316">
					<Amount>36.7320000000000009068</Amount>
				</CurrencyAmount>
			</AccountChargeLowerLimit>
			<AccountChargeUpperLimit Amount="1893.0" Type="D$">
				<CurrencyAmount CurrencyCode="AED" ExchangeRate="0.27224218664924316">
					<Amount>6953.3676000000005</Amount>
				</CurrencyAmount>
			</AccountChargeUpperLimit>
		</LoyaltyAccount>
	</LoyaltyInquiryResult>
</IO_LoyaltyAccountInquiryRS>
  • Keine Stichwörter