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.
| Node | Description | Values | Occurs | Example |
|---|---|---|---|---|
<TicketRefundRS> | Ticket Refund Response Root Element. The TicketRefundRS is basically a copy of the request (TicketRefundRQ) with the addition of the InfoGroup node. All nodes are optional. InfoGroup is particularly useful to report any error message during the processing of the transaction. | 1 | ||
@Type | Possible values are: ARC and BSP markets: Full .. full refund Partial .. partial refund BSP markets only: FullTax .. full tax only refund PartialTax .. partial tax only refund | [Full] [Partial] [FullTax] [PartialTax] | 0..1 | |
<InfoGroup> | Error and information group | 0..1 | ||
<ForInfo> | Information group | 0..N | ||
@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. | |
@SourceRef | PNR Record Locator associated to Source attribute. | 0..1 | ||
@Code | A code to uniquely identify a specific type of ForInfo message. Currently not returned for most ForInfo messages. | 0..1 | I00001 | |
@Lang | ISO language code. A two letter code as defined by ISO-639-1. | 0..1 | de | |
<Text/> | Information text or error text. | 1..N | Free flow text. Example: Invalid flight number | |
</ForInfo> | ||||
<Error> | Error group | 0..N | ||
@ErrorType | Type of error. | 1 | Air | |
@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. | |
@SourceRef | PNR Record Locator associated to Source attribute. | 0..1 | ||
<Code/> | Error code or equipment type code. | 1 | 0104 (error code), 747 (equipment code) | |
<Text/> | Information text or error text. | 1..N | Free flow text. Example: Invalid flight number | |
<UnderlyingError> | Errors of the backend system can be returned here. | 0..N | ||
@Code | error code of the backend system. | 0..1 | ||
<Text/> | Information text or error text. | 0..N | Free flow text. Example: Invalid flight number | |
</UnderlyingError> | ||||
</Error> | ||||
<BackOffice> | Generic back office response container. Serves as a placeholder for any context specific content. | 0..1 | ||
</BackOffice> | ||||
</InfoGroup> | ||||
<ESAC> | 0..1 | |||
@Declined | true / false | 0..1 | ||
@Manual | true / false True if the ESAC was obtained by agent directly | 0..1 | ||
<ID/> | Electronic Settlement Authorization Code from the airline authorizing the void/cancel. A single SAC/ESAC shall be sent per passenger for all coupons of a ticket/document number within a request for change of coupon status. Characters 1 through 4 of the 14 character code shall be the 3 or 4 digit airline accounting code. When a 3- digit airline accounting code is used, position 1 shall be left blank. The remaining 10 characters (no blanks) of the SAC/ESAC are left to the discretion of the Validating Carrier. | 0..1 | ||
<Date/> | Date in ISO 8601 format (yyyy-mm-dd). | 0..1 | 2001-12-25 | |
</ESAC> | ||||
<RecordLocator/> | PNR record locator. | 0..1 | R1A3SK | |
<Traveler> | Traveler details group | 0..1 | ||
<TravelerElementNumber/> | Element number of traveler associated to this item. | 0..1 | 1 | |
<TravelerName> | Name group | 1 | ||
<Surname/> | Traveler family (last) name. | 1 | SMITH | |
<GivenName/> | Traveler given (first) name. | 1 | JANE | |
<NativeGivenName/> | This field contains the given (first) name as it is returned from the GDS (free form text which contains given name, initial and title). In addition the given name as it comes from the GDS is parsed according to the GDS convention and the content is returned in sibling elments GivenName, Initial and Title. NOTE: client applications which implement their own parsing algorithm should use the content of this field! EXAMPLE: JOHN A MR | 0..1 | ||
</TravelerName> | ||||
</Traveler> | ||||
<OriginalIssueData> | 0..1 | |||
<TktIssueDate/> | Date in ISO 8601 format (yyyy-mm-dd). | 1 | 2001-12-25 | |
<TktIssueTime/> | Time in ISO 8601 format (hh:mm). | 0..1 | 14:00 | |
<IATA/> | IATA number of the agency originating the request. | 1 | 123456 | |
<PseudoCityCode> | Pseudo City Code of the agency requesting the void/cancel. Used to verify if it has the authority for this request. | 1 | LNJ2 | |
</PseudoCityCode> | ||||
<Commission> | The commision that was originally collected (if any) | 0..1 | 200 | |
@Type | The type of commission: Percentage (P) or Amount (A). | 1 | A | |
@NumberOfDecimals | The number of decimals if the commission type is A. | 0..1 | 2 | |
</Commission> | ||||
</OriginalIssueData> | ||||
<TicketData> | Ticket Data | 0..1 | ||
@Conjunctive | true / false | 0..1 | ||
@Origin | Trip's overall Origin - may not match this ticket's first segment's Departure airport if this is not the first coupon in a Conjunctive set. | 0..1 | ||
@Destination | Trip's overall Destination - may not match this ticket's last segment's Arrival airport if this is not the last coupon in a Conjunctive set. | 0..1 | ||
<Ticket> | Data of the ticket. In case of a conjunctive ticket, all ticket numbers must be supplied with the coupon numbers that are to be refunded. NOTE: Sabre does automatically refund all unused segments when using automated refunds. | 1..4 | ||
@Number | The 13 digt ticket number of the ticket to be refunded. | 1 | 0012345467891 | |
<CouponNumber/> | The number of the coupoun to be refunded. | 1..4 | 1 | |
</Ticket> | ||||
<FormOfPayment> | Form of payment group | 1 | ||
<CreditCard> | Credit card group | 0..N | ||
@PartialPayment | (Partial) Amount allocated to this FOP in case of a split payment. This is not to be confused with the amount requested for authorization - see ...CreditCard/ Authorization/Amount. | 0..1 | 75000 | |
@ActualAmount | Actual Amount is mandatory if refunding to one single FOP. This represents the amount to be refunded | 0..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 group | 1 | ||
<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> | ||||
<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 | |
</CreditCard> | ||||
<Other> | Other payment information. | 0..N | CHECK 113 | |
@PartialPayment | (Partial) Amount allocated to this FOP in case of a split payment. This is not to be confused with the amount requested for authorization - see ...CreditCard/ Authorization/Amount. | 0..1 | 75000 | |
@ActualAmount | Actual Amount is mandatory if refunding to one single FOP. This represents the amount to be refunded | 0..1 | ||
</Other> | ||||
<NativeElementText/> | 1 | |||
</FormOfPayment> | ||||
<FareData> | Base Fare, Taxes, and Total Fare data to be refunded | 1 | ||
<CurrencyCode> | Currency code. | 1 | USD | |
@NumberOfDecimals | Decimal position in fare amount. | 1 | 2 | |
</CurrencyCode> | ||||
<Price> | Price group | 1 | ||
@Total | Total fare amount for one traveler of the specified passenger type. Total price = base fare amount + taxes amount. | 1 | 230000 | |
<BaseFare> | 1 | |||
@Amount | Total base fare amount that includes surcharges (if any). | 1 | 200000 | |
<FiledIn> | This group represents fares filed in a currency different from the currency of a point of sale. The content elements represent the original currency and amount as filed. | 0..1 | ||
<CurrencyCode> | Currency code. | 1 | USD | |
@NumberOfDecimals | Decimal position in fare amount. | 1 | 2 | |
</CurrencyCode> | ||||
<Amount/> | Base Fare Amount as originally filed. | 1 | ||
</FiledIn> | ||||
<Surcharges> | Surcharges group | 0..1 | ||
@Amount | Total surcharges amount. | 1 | 2000 | |
<Surcharge> | Surcharges break down information. | 0..N | ||
@Amount | Individual surcharge amount. | 1 | 270 | |
<Designator/> | Surcharge designator. | 1 | ||
<Description/> | Surcharge descriptions as free form text. | 0..1 | ||
@Segment | Segment number to which the surcharge applies. | 0..1 | 1 | |
</Surcharge> | ||||
</Surcharges> | ||||
</BaseFare> | ||||
<Taxes> | Tax break down information group | 1 | ||
@Amount | Total taxes amount. | 1 | 30000 | |
<Tax> | Tax break down information group | 1..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> | ||||
</Tax> | ||||
</Taxes> | ||||
</Price> | ||||
<FareRules> | Fare rules information | 0..1 | ||
<FareCalculation/> | Fare Calculation line | 0..1 | ||
<Remark/> | Free form text remark. FUTURE USE. | 0..N | ||
<TourCode/> | Tour code identifier. | 0..1 | ITGF12 (Galileo / Apollo) | |
</FareRules> | ||||
<NetRemit> | Net Remit group | 0..1 | ||
@NRIndicator | Identifies Fare as a Net Remit transaction. Identifier is carried through for BSP reporting; Values are "Y/N" | [N] [Y] | 1 | |
<APBC/> | This IATA term stands for 'Amount Paid By Customer' and is needed for Net Remit methods 2A, 2E (Currency and decimals taken from FareGroup) | 0..1 | 57500 | |
<AEBA/> | This IATA term stands for 'Amount Entered By Agent' and is needed for Net Remit methods 2A, 2E (Currency and decimals taken from FareGroup) | 0..1 | 40000 | |
</NetRemit> | ||||
</FareData> | ||||
<TicketRemark> | Ticket remark group | 0..N | ||
<Text/> | Information text. | 1..N | Free flow text | |
</TicketRemark> | ||||
<ValidatingCarrier/> | Validating carrier is mandatory for BSP markets. | 0..1 | EK | |
<RefundType> | Defines the refund type depending on the reporting area Values are: D .. Domestic - Journey takes place whollywithin the reporting area T .. Transborder - Journey takes place partially outside of reporting area I .. International - Journey takes place wholly outside of the reporting area | 0..1 | Agency Location MAD: BCN-MAD is domestic BCN-PAR is transborder PAR-NCE is international | |
@DomesticJourneyType | BSP France only. Applicable only when RefundType = 'D' Values are: B .. From MRS, NCE, TLN to Corsica only F .. France metropolitan M .. France metropolitan to Corsica, except locations specified in B | [B] [F] [M] | 0..1 | |
</RefundType> | ||||
</TicketData> | ||||
<RefundData> | Data specific to the monetary refund | 0..1 | ||
<CurrencyCode> | Currency code. | 1 | USD | |
@NumberOfDecimals | Decimal position in fare amount. | 1 | 2 | |
</CurrencyCode> | ||||
<FeesAndPenalties> | Fees, penalties or commission taken on the refund. Breakdown of refundable Taxes. | 0..1 | ||
@Amount | Total fees and penalties amount. | 1 | 30000 | |
<Tax> | Breakdown of taxes to be refunded. Tax break-down needed for some settlement authorities such as BSP | 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> | ||||
</Tax> | ||||
<CancellationCommission> | The amount of commission taken on the cancellation penalty. Raised by the agency processing the refund. | 0..1 | 100 | |
@Type | The type of commission: Percentage (P) or Amount (A). | [A] [P] | 1 | A |
</CancellationCommission> | ||||
<CancellationPenalty/> | The amount that is to be paid as cancellation penalty. Raised by the agency processing the refund. | 0..1 | 100 | |
<CommFee/> | Non-refundable commission fee amount charged (if any). Raised by the agency processing the refund. | 0..1 | 1000 | |
<PenaltyFee/> | penalty fee amount charged based on the original fare rules (if any). | 0..1 | 1000 | |
<AdminFee/> | Administrative fee amount charged for the processing of the refund transaction (if any). Raised by the agency processing the refund. | 0..1 | 1000 | |
</FeesAndPenalties> | ||||
<TotalRefund> | Taxes group | 1 | ||
@Amount | Total taxes amount. | 1 | 30000 | |
</TotalRefund> | ||||
<RefundAuthNumber/> | Refund Authorization Number. Alphanumeric. | 0..1 | XYZ999 | |
<WaiverCode/> | Refund Waiver Code. Mandatory in some BSP countries such as Japan. | 0..1 | XYZ123 | |
</RefundData> | ||||
</TicketRefundRS> |
| Column | Description |
|---|---|
| Node | Name 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. |
| Description | Description of meaning and usage of the node. |
| Values | List of predefined values (each in square brackets) or range of values ("[a] to [z]") allowed for the node, if formally defined in the schema. |
| Occurs | Minimum 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. |
| Example | Example value for the node. |
XML Schema documentation generated with XX/1 server