Transaction Management
  • Updated on 09 Oct 2019
  • 2 minutes to read
  • Contributors
  • Print
  • Dark
    Light

Transaction Management

  • Print
  • Dark
    Light

Overview

The Payload Attributes are used outside the context of the message to identify and group message sets for debugging purposes.

Payload Attributes Request and Response Elements

Transaction ID

A universally unique identifier used to identify a transaction set. The Transaction ID is used by the Seller to identify the outbound requesting message, the transaction ID is then echoed back by the receiving party in the response.

This allows for both systems to find the message pair (RQ/RS) if one message is present. For example, if the OrderViewRS returns an error, using the echoed back transaction ID, the requestor can find the request that caused that error using that same Transaction ID.

OrderCreateRQ

<iata:PayloadAttributes>
	<iata:TrxID>6379132c-6440-4bc1-b6ea-359b7222bfa7</iata:TrxID>
</iata:PayloadAttributes>

OrderCreateRS

<iata:PayloadAttributes>
	<iata:TrxID>6379132c-6440-4bc1-b6ea-359b7222bfa7</iata:TrxID>
</iata:PayloadAttributes>

Correlation ID

A universally unique identifier used to identify a set of messages that were used together. The Correlation ID is generated by the Seller and echoed back by the Airline.

This is used to find all messages that led up to the point at which there was a potential failure or to understand how a message flow was implemented. For example, if an Order fails, the OrderViewRS will return a failure message and within the transaction element, the Correlation ID. By searching logs for that Correlation ID, all messages from AirShopping, OfferPrice and OrderCreate can be found and linked.

AirShoppingRQ

<iata:PayloadAttributes>
	<iata:CorrelationID>b1159451-0b7c-4da8-9926-86f48ec48ab6</iata:CorrelationID>
	<iata:TrxID>6379132c-6440-4bc1-b6ea-359b7222bfa7</iata:TrxID>
</iata:PayloadAttributes>

AirShoppingRS

<iata:PayloadAttributes>
	<iata:CorrelationID>b1159451-0b7c-4da8-9926-86f48ec48ab6</iata:CorrelationID>
	<iata:TrxID>6379132c-6440-4bc1-b6ea-359b7222bfa7</iata:TrxID>
</iata:PayloadAttributes>

OfferPriceRQ

<iata:PayloadAttributes>
	<iata:CorrelationID>b1159451-0b7c-4da8-9926-86f48ec48ab6</iata:CorrelationID>
	<iata:TrxID>1119132c-6440-4bc1-b6ea-359b7222bfa7</iata:TrxID>
</iata:PayloadAttributes>

OfferPriceRS

<iata:PayloadAttributes>
	<iata:CorrelationID>b1159451-0b7c-4da8-9926-86f48ec48ab6</iata:CorrelationID>
	<iata:TrxID>1119132c-6440-4bc1-b6ea-359b7222bfa7</iata:TrxID>
</iata:PayloadAttributes>

OrderCreateRQ

<iata:PayloadAttributes>
	<iata:CorrelationID>b1159451-0b7c-4da8-9926-86f48ec48ab6</iata:CorrelationID>
	<iata:TrxID>2229132c-6440-4bc1-b6ea-359b7222bfa7</iata:TrxID>
</iata:PayloadAttributes>

OrderCreateRS

<iata:PayloadAttributes>
	<iata:CorrelationID>b1159451-0b7c-4da8-9926-86f48ec48ab6</iata:CorrelationID>
	<iata:TrxID>2229132c-6440-4bc1-b6ea-359b7222bfa7</iata:TrxID>
</iata:PayloadAttributes>

Language

The Language, or Locale is used to request a specific language preference for the responding message.

For example, a Seller requests the message response to be in French.

<iata:PayloadAttributes>
	<iata:PrimaryLangID>fr-FR</iata:PrimaryLangID>
</iata:PayloadAttributes>

Or, Seller requests the response to be in Australian English.

<iata:PayloadAttributes>
	<iata:PrimaryLangID>en-AU</iata:PrimaryLangID>
</iata:PayloadAttributes>

The Airline responds with US English.

<iata:PayloadAttributes>
	<iata:PrimaryLangID>en-US</iata:PrimaryLangID>
</iata:PayloadAttributes>

Timestamp

The sending or responding party may time stamp the message at the time that the message is ready for transmission.

<iata:PayloadAttributes>
	<iata:Timestamp>2010-03-23T10:49:55+01:00</iata:Timestamp>
</iata:PayloadAttributes>

Version

Used for sending information to another party. Note that having the version of the message in the message provides no benefit, however this may be used for other bilateral purposes (such as an aggregator detailing a sourcing message version).

Retransmission ID

Used for recovering a failed transaction, by requesting the Airline to re-send the initial response if it recieved it.

Echo Token

Element has been deprecated and will be removed in 20.2.

SeqNumber

Element has been deprecated and will be removed in 20.2.

TrxStatusCode

Element has been deprecated and will be removed in 20.2.