• Angelegt von Unbekannter Benutzer (jacke), zuletzt geändert am März 17, 2021

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

Unterschiede anzeigen Seitenhistorie anzeigen

« Vorherige Version anzeigen Version 9 Nächste Version anzeigen »

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

Message Description

  • Lookup by Member ID w/ Currency for Points
  • Receive Membership Info w/ Points & Account Balance in Hotel Currency

IO_LoyaltyAccountInfoRQ - Attributes

Element | @AttributeNumDescription outboundContent outboundpAirOnPrem

IO_LoyaltyAccountInfoRQ

1Root element of the message.




@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.




@CorrelationID

1

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




@TimeStamp

0..1

Time of the transaction.

"2019-06-05T09:12:14Z"

@Version

0..1

Message version.

Version="3.001"



@PrimaryLangID

0..1

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




IO_LoyaltyAccountInfoRQ | ReadRequests0..1



@HotelCode0..1Full name of the property which the transferred stay information belongs to.


@HotelID0..1

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




@HotelName0..1Full name of the property which the transferred stay information belongs to.




@ChainCode0..1Full name of the property which the transferred stay information belongs to.


ReadRequests | LoyaltyReadRequest1..n



@CurrencyCode0..1An ISO 4217 (3) alpha character code that specifies a monetary unit.


@MemberCode1The MemberCode attribute will indicate the actual number.


@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.


@LevelCode0..1Indicates special privileges in program assigned to individual.


@AccountStatus0..1



@PrimaryInd0..1When true, indicates this is the primary customer loyalty program and when false, indicates this is not the primary customer loyalty program.
  • true
  • false


LoyaltyReadRequest | EffectiveDateBefore0..1
yyyy-mm-dd

LoyaltyReadRequest | ExpireDateAfter0..1
yyyy-mm-dd

ReadRequests | User1



@UserName0..1



@Organisation0..1



@Department0..1



@Occupation0..1



User | FirstName0..1

This field would be used to pass the guest’s GivenName.




User | LastName0..1This field would be used to pass the guest’s LastName.


User | Email0..1This field would be used to pass the guest’s Email.


User | Phone0..1This field would be used to pass the guest’s Phone


User | UserID0..1This field would be used to pass the guest’s UserID


Sample Message

<p:IO_LoyaltyAccountInfoRQ xmlns:p="http://protel.io/soap" CorrelationID="TRIGGER#000500#UPDATE#000420#1613999060824#E564" Version="1.0" TimeStamp="2021-02-22T13:04:20Z" EchoToken="TRIGGER#000500#UPDATE#000420#1613999060824#E564" PrimaryLangID="en" Target="Test" TargetName="Test">
	<p:ReadRequests HotelCode="2535" HotelID="500" HotelName="DEV 2535" ChainCode="n/a">
		<p:LoyaltyReadRequest CurrencyCode="CZK" MemberCode="2345754635123" ProgramCode="Lounge Coders Club" LevelCode="HighRoller" AccountStatus="4" PrimaryInd="true">
			<p:EffectiveDateBefore>2019-07-04</p:EffectiveDateBefore>
			<p:ExpireDateAfter>2019-07-04</p:ExpireDateAfter>
		</p:LoyaltyReadRequest>
		<p:User UserName="johnD" Organisation="Hotel 2535" Department="dev.protel.net" Occupation="">
			<p:FirstName>John</p:FirstName>
			<p:LastName>Dev</p:LastName>
			<p:Email>jdev@protel.net</p:Email>
		</p:User>
	</p:ReadRequests>
</p:IO_LoyaltyAccountInfoRQ>

IO_LoyaltyAccountInfoRS - Attributes

Element | @AttributeNumDescription outboundContent outboundpAirOnPrem

IO_LoyaltyAccountInfoRS

1Root element of the message.




@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.




@CorrelationID

1

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




@TimeStamp

0..1

Time of the transaction.

"2019-06-05T09:12:14Z"

@Version

0..1

Message version.

Version="3.001"



@PrimaryLangID

0..1

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




IO_LoyaltyAccountInfoRS | Success0..1



IO_LoyaltyAccountInfoRS | Errors0..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.


Errors | Error0..1

An error that occurred during the processing of a message.




@ShortText0..1An abbreviated version of the error in textual format.


@Code0..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).


@Type0..1Mandatory. Refer to OTA Code List: Error Warning Type (EWT).


IO_LoyaltyAccountInfoRS | Warnings0..1Used in conjunction with the Success element to define one or more business errors.


Warnings | Warning0..1Used when a message has been successfully processed to report any warnings or business errors that occurred.


@ShortText0..1An abbreviated version of the error in textual format.


@Code0..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).


@Type0..1Mandatory. Refer to OTA Code List: Error Warning Type (EWT).


IO_LoyaltyAccountInfoRS | LoyaltyReadResults0..1



@HotelCode0..1Full name of the property which the transferred stay information belongs to.


@HotelID0..1

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




@HotelName0..1Full name of the property which the transferred stay information belongs to.


@ChainCode0..1Full name of the property which the transferred stay information belongs to.


LoyaltyReadResults | LoyaltyAccount1



@MemberCode1The MemberCode attribute will indicate the actual number.


@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.


@LevelCode0..1Indicates special privileges in program assigned to individual.


@AccountStatus0..1



@PrimaryInd0..1When true, indicates this is the primary customer loyalty program and when false, indicates this is not the primary customer loyalty program.
  • true
  • false


LoyaltyAccount | CardHolderName0..1



LoyaltyAccount | ExpireDate0..1



LoyaltyAccount | EffectiveDate1



LoyaltyAccount | AccountBalance1



@Amount

1



@Type1



AccountBalance | CurrencyAmount0..1



@CurrencyCode

0..1



@ExchangeRate0..1



CurrencyAmount | Amount1



LoyaltyAccount | AccountAccrued0..1



@Amount

1



@Type1



AccountAccrued | CurrencyAmount0..1



@CurrencyCode

0..1



@ExchangeRate0..1



CurrencyAmount | Amount1



LoyaltyAccount | AccountRedeemed0..1



@Amount

1



@Type1



AccountAccrued | CurrencyAmount0..1



@CurrencyCode

0..1



@ExchangeRate0..1



CurrencyAmount | Amount1



LoyaltyAccount | UserCreated0..1



@UserName0..1



@Organisation0..1



@Department0..1



@Occupation0..1



UserCreated | FirstName0..1

This field would be used to pass the guest’s GivenName.




UserCreated | LastName0..1This field would be used to pass the guest’s LastName.


UserCreated | Email0..1This field would be used to pass the guest’s Email.


UserCreated | Phone0..1This field would be used to pass the guest’s Phone


UserCreated  | UserID0..1This field would be used to pass the guest’s UserID


LoyaltyAccount | UserModified0..1



@UserName0..1



@Organisation0..1



@Department0..1



@Occupation0..1



UserModified | FirstName0..1

This field would be used to pass the guest’s GivenName.




UserModified | LastName0..1This field would be used to pass the guest’s LastName.


UserModified  | Email0..1This field would be used to pass the guest’s Email.


UserModified | Phone0..1This field would be used to pass the guest’s Phone


UserModified | UserID0..1This field would be used to pass the guest’s UserID


Sample Message

<p:IO_LoyaltyAccountInfoRS xmlns:p="http://protel.io/soap" CorrelationID="TRIGGER#000500#UPDATE#000420#1613999060824#E564" Version="1.0" TimeStamp="2021-02-22T13:07:02Z">
	<p:Success>true</p:Success>
	<p:LoyaltyReadResults HotelCode="2535" HotelName="DEV 2535" ChainCode="n/a" ChainName="n/a">
		<p:LoyaltyAccount MemberCode="2345754635123" ProgramCode="Lounge Coders Club" LevelCode="HighRoller" AccountStatus="4" PrimaryInd="true">
			<p:CardHolderName>Oneoone K. Board</p:CardHolderName>
			<p:ExpireDate>2021-06-02</p:ExpireDate>
			<p:AccountBalance Amount="0" Type="L$C">
				<p:CurrencyAmount CurrencyCode="CZK" ExchangeRate="1">
					<p:Amount>0</p:Amount>
				</p:CurrencyAmount>
			</p:AccountBalance>
			<p:AccountAccrued Amount="0" Type="L$C">
				<p:CurrencyAmount CurrencyCode="CZK" ExchangeRate="1">
					<p:Amount>0</p:Amount>
				</p:CurrencyAmount>
			</p:AccountAccrued>
			<p:AccountRedeemed Amount="0" Type="L$C">
				<p:CurrencyAmount CurrencyCode="CZK" ExchangeRate="1">
					<p:Amount>0</p:Amount>
				</p:CurrencyAmount>
			</p:AccountRedeemed>
			<p:UserCreated UserName="johnD" Organisation="Hotel 2535" Department="dev.protel.net" Occupation="">
				<p:FirstName>John</p:FirstName>
				<p:LastName>Dev</p:LastName>
				<p:Email>jdev@protel.net</p:Email>
			</p:UserCreated>
			<p:UserModified UserName="johnD" Organisation="Hotel 2535" Department="dev.protel.net" Occupation="">
				<p:FirstName>John</p:FirstName>
				<p:LastName>Dev</p:LastName>
				<p:Email>jdev@protel.net</p:Email>
			</p:UserModified>
		</p:LoyaltyAccount>
	</p:LoyaltyReadResults>
</p:IO_LoyaltyAccountInfoRS>
  • Keine Stichwörter