TicketIssue request message

Tabular overview of all nodes, which may occur in this message. See legend below for description of table columns.
Note: Some sibling elements or complete sub-trees of the hierarchy may be defined as mutually exclusive alternative choices. This information cannot be expressed in this tabular overview. Please refer to schema diagram for a graphical representation of the message schema.

NodeDescriptionValuesOccursExample
<TicketIssueRQ>
1
@version
Version number. 0..1 1.0
@ReValidate
If 'Y', revalidates the Fares before Issuing a Ticket, otherwise ignore.
Default: N.
0..1
@RePrice
Automatically re-price the itinerary in case the stored fare should not be valid any more.
Possible values: Y, N
Default: N
0..1
@Source
Identifies the source of this element. In other words where the content originates from. Not limited to GDS, applicable to direct connect as well. 0..1 1A, 1V, or other.
@IgnoreWarnings
If IgnoreWarnings is set to "Y", XX/1 will try to override CRS warning messages by re-issuing the ticketing command a second time. Should only be set if request sent without IgnoreWarnings="Y" fails with a warning and the client application has checked it is valid to ignore that warning.

Default: N

[N] [Y] 0..1 Y
@ExtendedFareRuleInfo
This attribute controls whether to use additional transactions to obtain detailed fare rule information, e.g. for refundability or changeability and corresponding penalties for all issued tickets.

This can cause several additional requests being sent to the backend system.

Values are:
- Y: Return additional rule information, only use services that are free of charge.
- C: Return additional rule information, use value added fare rule services that are chargeable if offered by provider.
On Amadeus, this will call Amadeus MiniRules.
- N: dont return additional rule informations (default).
[Y] [C] [N] 0..1
@Lang
ISO language code. A two letter code as defined by ISO-639-1. This code specifies the requested language for text content. Default value is 'en'.0..1
<FlightReq>
1
<TktFlight>
Flight to be ticketed.1..16
@Element
PNR flight element number. 1 1
</TktFlight>
</FlightReq>
<TravelerReq>
1
<TktTraveler>
1..N
@Element
PNR traveler element number.1 1
@ManualPricingInd
In case of a manual fare, fare validation will not succeed and is omitted / the system response is ignored and ticket issued anyway.
Possible values: Y / N.
0..1 N.
<TktFlight>
Flight to be ticketed. If ommited, request applies to all flights for the traveler.0..16
@Element
PNR flight element number. 1 1
</TktFlight>
</TktTraveler>
</TravelerReq>
<ExchangeReq>
1
@Source
Identifies the source of this element. In other words where the content originates from. Not limited to GDS, applicable to direct connect as well. 0..1 1A, 1V, or other.
<TktExchangeRequest>
1
@ExchangeReqNumber
The number of the exchange request to be ticketed as returned by TicketExchangeRS1
</TktExchangeRequest>
</ExchangeReq>
<StoredFareReq>
1
<TktStoredFare>
1
@FareNumber
Number of FareGroup in PNR to be used for ticketing. 1 2
<TktTraveler>
In case the stored fare does not distinctly reference the travelers priced, but only the travelertypes, the travelers to be ticketed can be specified.
If in this case this element is omitted, attempt to ticket all travelers in the PNR will be made.

Currently only supported in WorldspanDIR.
0..N
@Element
PNR traveler element number.1 1
@ManualPricingInd
In case of a manual fare, fare validation will not succeed and is omitted / the system response is ignored and ticket issued anyway.
Possible values: Y / N.
0..1 N.
<TktFlight>
Flight to be ticketed. If ommited, request applies to all flights for the traveler.0..16
@Element
PNR flight element number. 1 1
</TktFlight>
</TktTraveler>
</TktStoredFare>
</StoredFareReq>
<InExchangeFor>
IMPORTANT:
Currently only supported in
- Sabre (only from a PhaseIV and only for BSP markets)
- uAPI (Galileo)

Instant exchange - assumes all preparation is done all fare information/pricing is stored in PNR and PNR is ready to be used for reissue.
1
@Type
Type of exchange transaction.
Values are:
RI - Reissue
RV - Revalidation
Default: RI
[RI] [RV] 0..1
<Ticket>
Data of the ticket that is to be exchanged. In case of a conjunctive ticket, all ticket numbers must be supplied with the coupon numbers that are to be exchanged/refunded.
Sabre automatically exchanges all unused coupons.
1..4
@Number
13-digit ticket or document number that you are exchanging. This includes the three-digit airline code and document number as frist 3 digits.
1 0012345467891
<CouponNumber/>
The number of the coupon to be exchanged.
0..4 1
</Ticket>
<TktStoredFare>
In case of a revalidation use case on Amadeus, there is no stored fare to refer to, as Amadeus does not store a regular TST for revalidations.
Mandatory for all other uses cases and providers.
0..1
@FareNumber
Number of FareGroup in PNR to be used for ticketing. 1 2
@ManualPricingInd
In case of a manual fare, fare validation will not succeed and is omitted / the system response is ignored and ticket issued anyway.
Possible values: Y / N.
0..1 N.
@Tour
Tour Identifier:
F - First Ticket
R - Reissue (Exchange)
I - Inclusive Tour (IT)
Y - IT Ticket Reissue (Exchange)
B - Bulk Tour (BT)
W - Bulk Ticket Reissue (Exchange)
[F] [R] [I] [Y] [B] [W] 0..1
<EquivalentFareOriginalTicket>
In case of a manually priced fare (@ManualPricingInd = 'Y'), the client application has to provide the base fare amount of the original ticket that shall be credited for the new Ticket0..1
@Amount
1
</EquivalentFareOriginalTicket>
<Penalty>
In case of a manually priced fare (@ManualPricingInd = 'Y'), the client application has to provide the penaly amount for the exchange.0..1
@Amount
1
<Taxes>
1
@Amount
Total taxes amount. 1 30000
<Tax>
Tax break down information group 0..N
@Amount
Individual tax amount. 1 2500
<Designator/>
Tax designator.
0..1 US
<Nature/>
Tax nature.
0..1 US2
<Description/>
Tax free form text descriptions.
0..1 US DOMESTIC SEGMENT TAX
<CollectionPoint>
For XF and ZP taxes.
Tax data break down for each collection point.

The sum of individual amounts entered here must be equal to the Amount entered in the Tax element.
0..N
@Amount
Individual amount for collection point.
0..1 2500
<CurrencyCode>
Currency code. 0..1 USD
@NumberOfDecimals
Decimal position in fare amount. 1 2
</CurrencyCode>
<AirportAmount/>
The amount actually filed by the airport in the currency applicable to the geographical location of the airport.0..1
<AirportCode/>
IATA standard airport code .
1 MIA
</CollectionPoint>
@Paid
Indicator to represent that given tax is already paid. Will be used only in the new Ticket issued as part of exchange process is the BSP markets.
Values:
"PD",
"RF" (.. if refunded).
[PD] [RF] 0..1
</Tax>
</Taxes>
</Penalty>
<TourCode/>
Tour identifier code if applicable and associated with the priced fare.
0..1 U46XIT
</TktStoredFare>
<TktTraveler>
If you have more than one person in the Passenger Name Record (PNR) you must name select. 1
@Element
PNR traveler element number.1 1
</TktTraveler>
<IATA/>
The IATA number of the agency originally issuing the ticket.0..1
<TktIssueDate/>
Date in ISO 8601 format (yyyy-mm-dd). 0..1 2001-12-25
<OriginalIssuePlace/>
Three letter IATA code of the town where the ticket originally has been issued.
0..1 MIA
<FormOfPayment>
Form of payment of the original ticket being exchanged.0..1
<CreditCard>
0..N
@PartialAmount
(Partial) Amount allocated to this FOP in case of a split payment. 0..1 75000
<CCCode/>
Credit card code.
The following list of normalized credit card codes is currently supported by XX/1.
AX .. American Express
AXB .. American Express BTA
AXI .. American Express IBTA
CA .. MasterCard
CAD .. MasterCard Debit
CB .. Carte Blanche
DC .. Diners Club
DS .. Discover
JC .. Japan Credit Bureau (JCB)
MA .. Maestro
TP .. Air Plus
VI .. Visa Credit
VID .. Visa Debit
VIL .. Visa Delta
VIE .. Visa Electron

1 VI
<CCNumber/>
Credit card number. 1 4011236654652341 Can be returned encrypted by GDS/CRS. Example: XXXXXXXXXXXXXXXX
<CCExpiration>
Credit card expiration group1
<Month/>
Credit card expiration month. 1 02 Can be returned encrypted by GDS/CRS. Example: XX
<Year/>
Last two digits of the credit card expiration year. 1 06 Can be returned encrypted by GDS/CRS. Example: XX
</CCExpiration>
</CreditCard>
<Other>
Other payment information. 0..N Check 113 or *CHECK, CASH
@PartialAmount
(Partial) Amount allocated to this FOP in case of a split payment. 0..1 75000
</Other>
</FormOfPayment>
<ReportingTo/>
Whether the agency reports to ARC or BSP.[ARC] [BSP] 0..1
<Involuntary/>
Whether the exchange is an involuntary exchange driven by airline-side schedule changes.
Values are:
Y - Yes
Examples: Y
[Y] [N] 0..1
</InExchangeFor>
<RecordLocator/>
The record locator of the PNR for which the ticket(s) are to be issued.
1 XQ23AX
<QualifierGroup>
Data sent in the QualifierGroup supplements or overwrites the content of the PNR, depending on the PNR already containing the respective data or not.0..1
<Commission>
0..1
@Type
Commission type. Values: P = Percent
A = Amount
[P] [A] 1 A
@NumberOfDecimals
Number of decimals for amount value.0..1
</Commission>
<ValidatingCarrier/>
0..1
<FormOfPayment>
Form of Payment Group

Multiple form of payments supported by Sabre and Galileo:

Sabre:
In order to add two forms of payments in your ticketing entry:
- You must be a BSP location.
- Your location must have the two forms of payment indicator active in the
validating carrier table. Only one FOP may be credit card. Note: Sabre does not
accept two credit cards.
- Your location must have the indicator "two forms of payment" active in your
Travel Journal Record (TJR).

Galileo:
- up to 3 form of payments can be added for BSP locations.
0..N
<CreditCard>
1
<CCCode/>
Credit card code.
The following list of normalized credit card codes is currently supported by XX/1.
AX .. American Express
AXB .. American Express BTA
AXI .. American Express IBTA
CA .. MasterCard
CAD .. MasterCard Debit
CB .. Carte Blanche
DC .. Diners Club
DS .. Discover
JC .. Japan Credit Bureau (JCB)
MA .. Maestro
TP .. Air Plus
VI .. Visa Credit
VID .. Visa Debit
VIL .. Visa Delta
VIE .. Visa Electron

1 VI
<CCNumber/>
Credit card number. 1 4011236654652341 Can be returned encrypted by GDS/CRS. Example: XXXXXXXXXXXXXXXX
<CCExpiration>
Credit card expiration group1
<Month/>
Credit card expiration month. 1 02 Can be returned encrypted by GDS/CRS. Example: XX
<Year/>
Last two digits of the credit card expiration year. 1 06 Can be returned encrypted by GDS/CRS. Example: XX
</CCExpiration>
<SecurityID/>
Credit card security number for online transactions (referred to also as CVV2, CVC2, CSC or CID). This is a 3-digit (Visa, Master, Discover) or 4-digit (Amex) number.

0..1 493
<Authorization>
Credit card authorization group0..1
@Type
Credit card authorization type. Values are:
A = authorize card only
S = authorize card and store approval code in the PNR
D = verify the address associated with this credit card and store the verification status in PNR.
If no address associated - error message will be returned.
[A] [S] [D] 1 A
<Amount>
Penalty amount in currency amount or percentage. 1 7500
@Unit
Penalty amount unit. Possible values are:
M = currency money value
P = percentage
[M] [P] 1 M
@MinMax
Minimum or maximum penalty indicator.
[MIN] [MAX] 0..1 MIN (MINIMUM PENALTY AMOUNT) MAX MAXIMUM PENALTY AMOUNT)
</Amount>
<AirlineCode/>
Airline code. 1 AA
</Authorization>
<CardholderFirstName/>
Credit card holder's first name. 0..1 JOHN
<CardholderLastName/>
Credit card holder's last name. This is only required for Sabre. 1 SMITH
<CardholderIDRef/>
Reference to a traveler in PNR as cardholder.1
<ApprovalCode/>
Credit card approval code. 0..1 996456
<ExtendedPayment>
Credit card extended payment. Values are:
Y = Add extended payment
N = Do not add extended payment
0..1 N
@NumberOfMonths
If and only if the value of the ExtendedPayment is set to Y.
Identifies the period of extended payment in months. Usually credit card systems (or the travel agency) allows a payment to be extended over a certain number of months. The actual timeframe will vary depending on the credit card system.
0..1 5
@Code
Code necessary for a special form of payment (if ExtendedPayment=Y).
For Amadeus:
A credit card is used for an initial amount and uniform subsequent monthly installment amounts.
The total of the installment amounts is expected in the PartialAmount attribute of the Other element, which has content INSTALLMENT in this case.
The currency given in the same FormOfPayment element is used.
0..1 CM5
</ExtendedPayment>
<Remark/>
Form of payment to be sent to history remark. Values are: Y = Yes, N = No. [Y] [N] 0..1 Y
<CCAddressGroup>
FOR FUTURE USE!
(not supported for any GDS/CRS yet)
0..1
<Address>
Street or PO Box address. 1..2 5301 Blue Lagoon Drive
@SplitItemLine
Allows to specify how to group address items when SplitItems attribut is at Yes. All items with the same SplitItemLine value will be created in the same address element in the GDS. 0..1 1
</Address>
<City>
City name. 1 Miami
@SplitItemLine
Allows to specify how to group address items when SplitItems attribut is at Yes. All items with the same SplitItemLine value will be created in the same address element in the GDS. 0..1 1
</City>
<PostalCode>
Postal code or zip code. 1 33126
@SplitItemLine
Allows to specify how to group address items when SplitItems attribut is at Yes. All items with the same SplitItemLine value will be created in the same address element in the GDS. 0..1 1
</PostalCode>
<StateCode>
State code. 0..1 FL
@SplitItemLine
Allows to specify how to group address items when SplitItems attribut is at Yes. All items with the same SplitItemLine value will be created in the same address element in the GDS. 0..1 1
</StateCode>
<CountryCode/>
Country code. 1 US
</CCAddressGroup>
</CreditCard>
<Other/>
Other payment information. 1 CHECK, CASH
<Amount>
Sabre:
For second form of payment an amount must be specified. Remaining amount is automatically taken from first form of payment.

Galileo:
For all form of payment an amount must be specified. The sum of amounts of all form of payments must match the price of the ticket.
0..1
@CurrencyCode
Currency code.
1 USD
@NumberOfDecimals
Number of decimals for amount value.1
</Amount>
<Tax>
Sabre supports up to two taxes that can optionally be specified for second form of payment.0..N
@CurrencyCode
Currency code.
1 USD
@NumberOfDecimals
Number of decimals for tax value.1
@Designator
Tax designator.
1 US
</Tax>
</FormOfPayment>
<AddressGroup>
Address group0..N
@Use
Indicates use of address information. Values are:
B = Billing
D = Delivery
A = Agency address (Sabre)
H = Mailing home address (Amadeus)
O = Mailing miscellaneous address (Amadeus)
M = Mailing address (Amadeus, Sabre)
T = Travel arranger

As you can see B and D are supported by all GDS. See for GDS specific address types above.

[B] [D] [A] [H] [O] [M] [T] 1 D
@SplitItems
Indicates if the address elements should be split in the reservation system across multiple lines (entries). Possible values are:
Y = split entries
N = do not split and keep all elements into one entry
[Y] [N] 0..1 N
<TravelerIDRef/>
Unique association ID reference of the traveler associated to this item. No comma separated lists and no ranges allowed. 0..N T1
<SegmentIDRef/>
ID reference used to associate this item to a segment. No comma separated lists and no ranges supported. 0..N F1
<OptionalCompanyName/>
Addressee's if the addressee as an organisation.0..1
<OptionalName/>
Addressee's name. 1 PASS Consulting
<Addressee>
1
<Surname/>
Traveler family (last) name. 1 SMITH
<GivenName/>
Traveler given (first) name. 1 JANE
<Title/>
Traveler title. 0..1 MISS
<Gender/>
[F] [M] 0..1
</Addressee>
<Address>
Street or PO Box address. 1..2 5301 Blue Lagoon Drive
@SplitItemLine
Allows to specify how to group address items when SplitItems attribut is at Yes. All items with the same SplitItemLine value will be created in the same address element in the GDS. 0..1 1
</Address>
<City>
City name. 1 Miami
@SplitItemLine
Allows to specify how to group address items when SplitItems attribut is at Yes. All items with the same SplitItemLine value will be created in the same address element in the GDS. 0..1 1
</City>
<PostalCode>
Postal code or zip code. 1 33126
@SplitItemLine
Allows to specify how to group address items when SplitItems attribut is at Yes. All items with the same SplitItemLine value will be created in the same address element in the GDS. 0..1 1
</PostalCode>
<StateCode>
State code. 0..1 FL
@SplitItemLine
Allows to specify how to group address items when SplitItems attribut is at Yes. All items with the same SplitItemLine value will be created in the same address element in the GDS. 0..1 1
</StateCode>
<CountryCode>
Country code. 1 US
@SplitItemLine
Allows to specify how to group address items when SplitItems attribut is at Yes. All items with the same SplitItemLine value will be created in the same address element in the GDS. 0..1 1
</CountryCode>
</AddressGroup>
<TicketingInstructions>
Used to reference TicketInstructions from PNRViewRS/TicketInstructions that shall be used to drive the ticket(s).
Currently only supports DocumentInsturctions on Worldspan (TicketInstructions with SecondaryAction/@Code = "*" )
0..N
<ElementNumber>
1..N
@TattooNumber
Tattoo number. 0..1 2
@TattooQualifier
Tattoo qualifier. 0..1 ST
</ElementNumber>
</TicketingInstructions>
</QualifierGroup>
<DocumentGroup>
If not specified, the GDS specific standard documents are issued.
On Apollo that are: MIR, Itinerary, Ticket, BoardingPass (if possible).
0..1
<Invoice>
If 'Y', prints Invoice (MIR in Apollo / Galileo) only. Values are: Y = Yes, N = No. 0..1
@JointDocument
Create joint document for all passengers. Values are: Y = Yes, N = No. [Y] [N] 0..1
</Invoice>
<Itinerary>
If 'Y', prints Itinerary only. Values are: Y = Yes, N = No. 0..1
@JointDocument
Create joint document for all passengers. Values are: Y = Yes, N = No. [Y] [N] 0..1
</Itinerary>
<MiniItinerary>
If 'Y', prints Mini Itinerary only.
TEMP NOTE: according to doc, galileo only supports either or
0..1
</MiniItinerary>
</DocumentGroup>
<PrinterGroup>
The PrinterGroup specifies the printer(s) to print to.

NOTE: The PrinterGroup is mandatory for all GDS, although it may not be required on other CRS!
0..1
<PrinterDestination>
Documents are printed on this destination. If not given, the default printer is used.
1..5
@Type
The type of printer.

Values:
B .. boarding pass
I .. invoice / itinerary
M .. mini itinerary
T .. ticket printer
H .. hardcopy / accounting printer
PP .. PrinterProfile (Sabre only)

[B] [I] [M] [T] [H] [PP] 1 T
@CountryCode
The ticket printer country code. Needed by Sabre.

0..1 AB
</PrinterDestination>
<STPDestination>
Documents are printed on this STP (Satellite Ticket Printer, means printer located in a different office location) destination.
If not given, then default printer is used.
0..1
@Type
The type of printer.

Values:
B .. boarding pass
I .. invoice / itinerary
M .. mini itinerary
T .. ticket printer
H .. hardcopy / accounting printer

1 T
<AccountID/>
Needed for Sabre1
<PseudoCityCode/>
Agency's pseudo city code. 1 LNJ2
<STPID/>
The printer desination ID (LNIATA in Apollo / Galileo)1
</STPDestination>
</PrinterGroup>
</TicketIssueRQ>

Legend

ColumnDescription
NodeName of message node (element or attribute). Nodes in bold type are mandatory, if their parent element occurs in the message. Point mouse cursor at table cell to view complete XPath.
DescriptionDescription of meaning and usage of the node.
ValuesList of predefined values (each in square brackets) or range of values ("[a] to [z]") allowed for the node, if formally defined in the schema.
OccursMinimum and maximum number of times the node must/may occur, if its parent element occurs in the message. Examples:
0..3 Node is optional and may occur up to 3 times.
1..N Node must occur at least one (mandatory) and may occur any number of times.
2 Node must occur exactly twice.
ExampleExample value for the node.

XML Schema documentation generated with XX/1 server