Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

Inhalt


OTA_ProfileMergeRQ

Message Description

The process being facilitated is that of having one or more (losing) guest profile/s set obsolete and merge into one (winning) other. This process has to be done generally, but not exclusively by a Customer Relationship System (CRM) and a Property Management System (PMS). 

Image Added

Info
titleNote!

Each record in this table has been flagged to indicate whether an element or attribute is currently implemented in protel AIR or protel MPE/SPE (On-Prem). Functionality enhancements are ongoing, so it is important to check the SMP site documentation for regular updates.

OTA_ProfileMergeRQ - Attributes

Element | @AttributeNumDescriptionComments + Contents outboundpAIROnPrem  Comments + Contents inboundpAironPrem

OTA_ProfileMergeRQ

1

Root element of the message.


(Haken)

(Haken)


(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

(Haken)

(Haken)


(Fehler)(Haken)
@TimeStamp0..1Indicates the creation date and time of the message in UTC using the format specified by ISO 8601 with time values using the 24 hour clock.

YYY-MM-DDThh;mm;ssZ

(e.g.: 2019-06-11T06:14:42Z)

(Haken)

(Haken)

YYY-MM-DDThh;mm;ssZ

(e.g.: 2019-06-11T06:14:42Z)

(Fehler)(Haken)

@Version

1

For all Open Travel versioned messages,the version of the message is indicated by a decimal value .Version="4"

(Haken)

(Haken)

Version="4"(Fehler)(Haken)
@CorrelationID

1

Allow end-to-end correlation of log messages with the corresponding Web service message throughout the processing of the WEB service message. 

0B486ADD-005D-4DFC-AEA9-83D6964E2646

(Haken)

(Haken)

0B486ADD-005D-4DFC-AEA9-83D6964E2646(Fehler)(Haken)

OTA_ProfileMergeRQ | POS

1

Point of Sale (POS) identifies the party or connection channel making the request.


(Haken)(Haken)
(Fehler)(Haken)

OTA_ProfileMergeRQ | POS | Source

1

Provides information on the source of a request.


(Haken)(Haken)
(Fehler)(Haken)

OTA_ProfileMergeRQ | POS | Source | RequestorID

1

Identifies the system that is sending the request.


(Haken)(Haken)
(Fehler)(Haken)

@ID

1

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


(Haken)(Haken)
(Fehler)(Haken)

@Type

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)

  • 10 - "Hotel"
(Haken)(Haken)
  • 10 - "Hotel"
(Fehler)(Haken)

@ID_Context

1

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

"protelIO"(Haken)(Haken)"protelIO"(Fehler)(Haken)

OTA_ProfileMergeRQ | POS | Source | BookingChannel

0..1

Specifies the booking channel type and whether it is the primary means of connectivity of the source.


(Haken)(Haken)
(Fehler)(Fehler)

@Primary

0..1

Indicates whether the enumerated booking channel is the primary means of connectivity used by the source.

  • "true" 
  • "false"
(Haken)(Haken)


(Fehler)(Fehler)

@Type

0..1

The type of booking channel. Refer to the OTA code lists: Booking Channel Type (BCT).

  1. Global distribution system (GDS)

  2. Alternative distribution system (ADS)

  3. Sales and catering system (SCS)

  4. Property management system (PMS) – used by protel

  5. Central reservation system (CRS)

  6. Tour operator system (TOS)

  7. Internet

(Haken)(Haken)


(Fehler)(Fehler)
OTA_ProfileMergeRQ | UniqueID

1..9

Identifies the profile for which information is being merged from the profiles identified by the ObsoleteProfileID together with the owner of the profile or an id provided by the client.


(Haken)

(Haken)


(Fehler)(Haken)
@Type

1

A reference to the type of object defined by the UniqueId element. Refer to Open Travel Code List Unique ID type(UIT)

"1" = Profile

(Haken)

(Haken)

"1" = Profile(Fehler)(Haken)
@ID

1

A unique identifying value assigned by the creating system.The ID attribute may be used to reference a primary -key value within a database or in a particular implementation

ProfileID in protel

"2918"

(Haken)

(Haken)

"2918"(Fehler)(Haken)
@ID_Context 

0..1

Used to identify the source of the identifier."protelIO"

(Haken)

(Haken)

"protelIO"(Fehler)(Haken)
@Instance0..1Used to identify the sending service"com.demo_crm.crm"(Fehler)(Fehler)"com.demo_crm.crm"(Fehler)(Haken)
OTA_ProfileMergeRQ | ObsoleteProfileID

1..99

The profile(s) to be merged into the profile represented by UniqueID


(Haken)

(Haken)
(Fehler)(Haken)
@Type

1

A reference to the type of object defined by the UniqueId element. Refer to Open Travel Code List Unique ID type(UIT)

"1" = Profile

(Haken)

(Haken)

"1" = Profile(Fehler)(Haken)
@ID

1

A unique identifying value assigned by the creating system.The ID attribute may be used to reference a primary -key value within a database or in a particular implementation

ProfileID in protel


(Haken)

(Haken)


(Fehler)(Haken)
@ID_Context

0..1

Used to identify the source of the identifier."protelIO"

(Haken)

(Haken)

"protelIO"(Fehler)(Haken)

OTA_ProfileMergeRQ | Profile

1The target profile

(Haken)

(Haken)


(Fehler)(Haken)

See OTA_ProfileModify

OTA_ProfileMergeRS - Attributes

Element | @AttributeNum DescriptionComments + Contents outboundpAIROnPrem

OTA_ProfileMergeRS 

1

This message provides the acknowledgement of a merge request 


(Haken)(Haken)

@EchoToken 

1

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


(Haken)(Haken)

@TimeStamp 

1

Time of the transaction. 


(Haken)(Haken)

@Version 

1

Version of the message


(Haken)(Haken)

@Target 

0..1 

Used to indicate whether the request is for the Test or Production system. 


(Haken)(Haken)

OTA_ProfileMergeRS | Errors

0..1

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


(Haken)(Haken)

OTA_ProfileMergeRS | Errors | Error

1..n

An error that occurred during the processing of a message.


(Haken)(Haken)

@Type

1

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


(Haken)(Haken)

@Code

0..1

Refer to OTA Code List: Error Codes (ERR). 


(Haken)(Haken)

@ShortText

0..1

Describes the occurring error in short.

Example: "A rate plan 'XY' was not found for the code provided."


(Haken)(Haken)

OTA_ProfileMergeRS | Success

0..1

The presence of the empty Success element explicitly indicates that the OpenTravel versioned message succeeded.


(Haken)(Haken)

OTA_ProfileMergeRS | Warnings

0..1

Used in conjunction with the Success element to define one or more business errors.


(Haken)(Haken)

OTA_ProfileMergeRS | Warnings | Warning

1..n

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


(Haken)(Haken)

@Type 

1

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


(Haken)(Haken)

@Status 

0..1 

If present, recommended values are "NotProcessed," " Incomplete," "Complete," or "Unknown." This is a 'string' data type; Partners may identify and use additional status conditions not included in this enumeration.


(Haken)(Haken)

@ShortText 

1

An abbreviated version of the error in textual format. 


(Haken)(Haken)

@Code 

0..1 

If 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). 


(Haken)(Haken)

OTA_ProfileMergeRS | UniqueID 

1..9 

Used to convey the identity of the created profile, the owner of the profile, or an id provided by the client. 


(Haken)(Haken)

@Type 

1

A reference to the type of object defined by the UniqueID element. Refer to OpenTravel Code List Unique ID Type (UIT). 


(Haken)(Haken)

@ID_Context 

0..1 

Used to identify the source of the identifier (e.g.; IATA, ABTA). 


(Haken)(Haken)

@ID 

1

A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. 


(Haken)(Haken)

OTA_ProfileMergeRS | ObsoleteProfileID 

1..9 

Used to convey the identity of the created profile, the owner of the profile, or an id provided by the client. 


(Haken)(Haken)

@Type 

1

A reference to the type of object defined by the UniqueID element. Refer to OpenTravel Code List Unique ID Type (UIT). 


(Haken)(Haken)

@ID_Context 

0..1 

Used to identify the source of the identifier (e.g.; IATA, ABTA). 


(Haken)(Haken)

@ID 

1

A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. 


(Haken)(Haken)

Sample messages

Request messages

OTA_ProfileMergeRQ  pAIr

Codeblock
languagexml
linenumberstrue
collapsetrue
<OTA_ProfileMergeRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:p="http://protel.io/soap" xmlns:px="http://protel.io/htng/extensions" xmlns:htng="http://htng.org/2014B" CorrelationID="NSD_08/17_07" EchoToken="NSD_08/17_04" PrimaryLangID="fr" TimeStamp="2020-05-29T13:24:45Z" Version="2.001">
			<UniqueID ID="8632" ID_Context="protelIO" Type="4"/>
			<UniqueID ID="2920" ID_Context="protelIO" Type="10"/>			
			<ObsoleteProfileID ID="8617" ID_Context="protelIO" Type="4"/>
			<Profile CreateDateTime="2019-06-11T06:14:42Z" CreatorID="ndzhenkov" LastModifierID="ndzhenkov" LastModifyDateTime="2020-04-23T06:38:28Z" ProfileType="1" RPH="8617" ShareAllOptOutInd="No" StatusCode="4">				
			</Profile>
		</OTA_ProfileMergeRQ>

OTA_ProfileMergeRQ  onPremise

Codeblock
languagexml
linenumberstrue
collapsetrue
      <OTA_ProfileMergeRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:p="http://www.opentravel.org/OTA/2003/05" xmlns:px="http://protel.io/htng/extensions">
			<POS>
				<Source>
					<RequestorID Type="10" ID="3009" ID_Context="protelIO"/>
				</Source>
			</POS>
			<ObsoleteProfileID Type="4" ID="315311" ID_Context="protelIO"/>
			<UniqueID Type="4" ID="351536" ID_Context="protelIO"/>
			<Profile ProfileType="4" LastModifyDateTime="2019-10-23T13:11:17" CreateDateTime="2019-10-23T13:45:00" LastModifierID="protel 1">
				<Customer Gender="Unknown" Language="en">
					<PersonName>
						<NamePrefix>Yoo</NamePrefix>
						<GivenName></GivenName>
						<Surname>Abdat</Surname>
						<NameTitle/>
					</PersonName>					
					<Email DefaultInd="true" EmailType="1" Remark="EMAIL"></Email>					
				</Customer>								
				<CompanyInfo>
					<CompanyName CompanyShortName="" Department="">protel</CompanyName>
				</CompanyInfo>
			</Profile>
		</OTA_ProfileMergeRQ>


OTA_ProfileMergeRS - Success

Codeblock
languagexml
linenumberstrue
collapsetrue
<?xml version='1.0' encoding='utf-8'?>
<OTA_ProfileMergeRS
            xmlns="http://www.opentravel.org/OTA/2003/05"
            xmlns:ns2="http://htng.org/2014B"
            xmlns:ns3="http://protel.io/soap" CorrelationID="PROFILE#2100254#UPDATE#000103#1562139357125#4E2C" EchoToken="PROFILE#2100254#UPDATE#000103#1562139357125#4E2C" TimeStamp="2019-04-4T03:00:39.663577" Version="4">
	<Success/>
</OTA_ProfileMergeRS>  

OTA_ProfileMergeRS - Error

Codeblock
languagexml
linenumberstrue
collapsetrue
<?xml version='1.0' encoding='utf-8'?>
<OTA_ProfileMergeRS
            xmlns="http://www.opentravel.org/OTA/2003/05"
            xmlns:ns2="http://htng.org/2014B"
            xmlns:ns3="http://protel.io/soap" CorrelationID="PROFILE#2100254#UPDATE#000103#1562162050211#FA17" EchoToken="PROFILE#2100254#UPDATE#000103#1562162050211#FA17" TimeStamp="2019-04-4T03:00:39.663577" Version="4">
	<Errors>
		<Error Code="450" ShortText="Unable to process" Type="3"/>
	</Errors>
	<UniqueID ID="9970" ID_Context="protelIO" Type="10"/>
</OTA_ProfileMergeRS>

OTA_ProfileMergeRS - Warning 

Codeblock
languagexml
linenumberstrue
collapsetrue
<?xml version='1.0' encoding='utf-8'?>
<OTA_ProfileMergeRS
            xmlns="http://www.opentravel.org/OTA/2003/05"
            xmlns:ns2="http://htng.org/2014B"
            xmlns:ns3="http://protel.io/soap" CorrelationID="PROFILE#2100254#UPDATE#000103#1562221116991#53F8" EchoToken="PROFILE#2100254#UPDATE#000103#1562221116991#53F8" TimeStamp="2019-04-4T03:00:39.663577" Version="4">
	<Warnings>
		<Warning Code="320" ShortText="No Cancellation reference provided for Reservation 384725" Type="3"/>
		<Warning Code="320" ShortText="No Reservation record found for Reservation 384725 and will not be recorded" Type="3"/>
	</Warnings>
	<UniqueID ID="2920" ID_Context="protelIO" Type="10"/>
</OTA_ProfileMergeRS>