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 |
---|---|---|---|---|
<ServiceListRS> | Response root element for services request for existing PNRs | 1 | ||
@version | Version number. | 0..1 | 1.0 | |
<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> | ||||
<OptionalServices> | This node is returned when merchandizing options are available for any of the selected flights, regardless of the method used. 1) Fare Integrated Options 2) EMD charged Options 3) Directly settled Options | 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 | ||
<CurrencyCode> | Currency code. | 0..1 | USD | |
@NumberOfDecimals | Decimal position in fare amount. | 1 | 2 | |
</CurrencyCode> | ||||
<Images> | contains any images used for the services offered | 0..1 | ||
<Image> | Image in base64 code | 1..N | ||
@ReasonCode | IATA RFIC (ReasonFor IssuanceCode, a 1-character main code) Example of RFIC: A Note: Only services of same RFIC code can be combined on an EMD-A document. For example, if there are services of RFIC code "A" and "B", two separate EMD documents are needed, issuing all services of "A" and "B" on seperate docs. | 1 | ||
@SubCode | ATPCO RFIS (ReasonForIssuance Subcode). Example of RFIS: 0CC | 1 | ||
@Caption | The caption used for this image | 0..1 | ||
</Image> | ||||
<Media> | Image or media available at an URL | 1..N | ||
<Url/> | Hyperlink defining the location of the referenced media (e.g. location of a JPG file). | 1 | ||
<Width> | Width of media content in specified units. | 1 | ||
@Unit | Unit used to specify dimensions of media content. | [px] [mm] | 1 | mm (millimeter) px (pixel) |
</Width> | ||||
<Height> | Height of media content in specified units. | 1 | ||
@Unit | Unit used to specify dimensions of media content. | [px] [mm] | 1 | mm (millimeter) px (pixel) |
</Height> | ||||
<Type> | Type of media content. For value 'OTA' the attributes @Type and @Code contain the media type information. Values other than 'OTA' are deprecated. Values: OTA image webcam video logo gallery 360 (panorama view) | [OTA] [image] [webcam] [360] [video] [logo] [map] [gallery] | 1 | OTA |
@Type | OTA code type. CTT .. Content Code PIC .. Picture Category Code | [CTT] [PIC] | 0..1 | |
@Code | OTA code. | 0..1 | 16 | |
@Description | Free text description. If none available the OTA code name is used. | 0..1 | Streaming video | |
</Type> | ||||
<Preview> | Preview of the referenced media content (e.g. thumbnail of the picture). | 0..N | ||
<Url/> | Hyperlink defining the location of the referenced media (e.g. location of a JPG file). | 1 | ||
<Width> | Width of media content in specified units. | 1 | ||
@Unit | Unit used to specify dimensions of media content. | [px] [mm] | 1 | mm (millimeter) px (pixel) |
</Width> | ||||
<Height> | Height of media content in specified units. | 1 | ||
@Unit | Unit used to specify dimensions of media content. | [px] [mm] | 1 | mm (millimeter) px (pixel) |
</Height> | ||||
<Type> | Type of media content. For value 'OTA' the attributes @Type and @Code contain the media type information. Values other than 'OTA' are deprecated. Values: OTA image webcam video logo gallery 360 (panorama view) | [OTA] [image] [webcam] [360] [video] [logo] [map] [gallery] | 1 | OTA |
@Type | OTA code type. CTT .. Content Code PIC .. Picture Category Code | [CTT] [PIC] | 0..1 | |
@Code | OTA code. | 0..1 | 16 | |
@Description | Free text description. If none available the OTA code name is used. | 0..1 | Streaming video | |
</Type> | ||||
</Preview> | ||||
<Description> | Media content description (e.g. exterior view). | 0..1 | ||
@Type | OTA code type. PIC .. Content Code | [PIC] | 0..1 | |
@Code | OTA code. | 0..1 | 3 | |
@Description | OTA code name. | 0..1 | Pool view | |
</Description> | ||||
<Caption/> | Title for the media. | 0..1 | Exterior | |
@ReasonCode | IATA RFIC (ReasonFor IssuanceCode, a 1-character main code) Example of RFIC: A Note: Only services of same RFIC code can be combined on an EMD-A document. For example, if there are services of RFIC code "A" and "B", two separate EMD documents are needed, issuing all services of "A" and "B" on seperate docs. | 1 | ||
@SubCode | ATPCO RFIS (ReasonForIssuance Subcode). Example of RFIS: 0CC | 1 | ||
</Media> | ||||
</Images> | ||||
<Service> | Service Details | 1..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 | ||
@Method | Values are: F = FareIntegrated EA = EMD Associated ES = EMD Standalone MA = Flight Associated but settled via MCO MS = Standalone but settle via MCO D = DirectSettlement | [F] [EA] [MA] [ES] [MS] [D] | 1 | |
@Airline | This is the airline code of the Marketing carrier, the carrier actually offering the service. | 1 | ||
@TypeValue | EMD Type Value as defined by ATPCO 1 = Standalone 2 = Associated to a flight 3 = Standalone associated to a ticket (but not flight) 4 = no EMD, carrier directed type 5 = E-Ticket | 0..1 | ||
@SaleStatus | Allowed Values: "Offered" "Pending" "Booked" "Issued" "Canceled" "Issued" represents those services which have been issued and have a valid EMDInfo node "Booked" represent items sold/booked but not yet issued Values are returned in the response | [Offered] [Booked] [Issued] [Pending] [Canceled] | 0..1 | |
@ServiceType | The ATPCO defined code for the type of service (also referred to as 'Flight/Ticket/Merchandise Byte 21)': F = Flight (TypeValue=2) R = Rule Buster (Type Value = 5) T = Ticket (TypeValue=3 if EMD-S is issued, 4 if other) M = Merchandise (TypeValue=1 if EMD-S is issued, 4 if other) | 0..1 | ||
@ReasonCode | IATA RFIC (ReasonFor IssuanceCode, a 1-character main code) Example of RFIC: A Note: Only services of same RFIC code can be combined on an EMD-A document. For example, if there are services of RFIC code "A" and "B", two separate EMD documents are needed, issuing all services of "A" and "B" on seperate docs. A = Air Transportation B = Surface Transportation/Non Air services C = Baggage D = Financial Impact E = Airport Services F = Merchandise G = in-flight Services I = Individual Airline Use | 1 | ||
@SubCode | ATPCO RFISC (ReasonForIssuance Subcode). Example of RFISC: 0CC | 1 | ||
@ServiceCode | Additional unique ATPCO code. | 0..1 | OC | |
@FareBrand | Service is part of a bundle associated to this fare brand | 0..1 | ||
@Status | Values are: NN = "Requested" HK = "Confirmed" KD = "Confirmed pending document issue" HS = "Sold" | 0..1 | ||
@DealID | This ID represents an airline promotion for a special target market and applies only for FQTV numbers identified for this promotion | 0..1 | ||
@Type | Indicator if this option is a discount or a surcharge; Values are: "Discount" 1) "Surcharge" "Included" 2) "Not applicable" 3) "Fee Formula" 1) only applicable when using methof F, applying option directly to a fare (not used in an EMD solution) 2) This item is free of charge due to FQTV status or chosen Price Class 3) This item is not available/applicable due to FQTV status or chosen Price Class. Sample: Earning extra miles may only be allowed for a Top tier FQTV status and is not applicable for any other traveler. | [Discount] [Surcharge] [Included] [Not applicable] [Fee Formula] | 1 | |
@FQTVAirline | The 2-character airline code of the Frequent Flyer membership | 0..1 | AA | |
@FQTVStatus | The status (tier level) of the traveler's FQTV account. This is available as a query results against the airline's FQTV database. Samples: AA(American AAdvantage): -- Gold -- Platinum -- Executive Platinum LH (Miles and More): -- Frequent Traveller -- Senator -- HON Circle EK (Emirates Skywards): -- Silver -- Gold | 0..1 | ||
@FQTVNumber | This is the actual FrequentFlyer number associated to the FQTVStatus. This will allow the POS GUI to associate the actual traveler with the respective option/price | 0..1 | ||
@NotValidBefore | Option is not available/usable until the date entered | 0..1 | ||
@NotValidAfter | Option is not available/usable after the date entered | 0..1 | ||
@Slice | In case of a "Change Of Gauge" flight, this determines to which slice of the flight the option belongs. Default = 0 (or absence) | 0..1 | YY 465 SFO FRA with change of gauge in ORD Slice 0 = SFO to ORD Slice 1 = ORD to FRA | |
@CanDeselect | Any service tagged with a "Y" setting here can be deselected. This attribute is set by the merchandizing engine for services which are typically included in a Price Class or CoS but may not be desired by the traveler, e.g. Premium Drinks on the flight. Allowed value: "Y" | [Y] | 0..1 | |
@MaxQuantity | Will determine what the maximum number can be for the Quantity. | 0..1 | 5 | |
@Quantity | This attribute provides how many service/items of the same type have been ordered, 1 being the default. | 0..1 | 3 | |
@SingleChoiceGroupID | There are cases where a set of Service elements belong to a group of which only one Service may be chosen at a time. Where this is known to XX1, it will add a SingleChoiceGroupID attribute with identical value to each Service of that group. While each Service element of such a set will have the same SingleChoiceGroupID value, different sets of such Service elements will have different values. When a Service has no SingleChoiceGroupID attribute, it may be freely combined with any other Service (or respective restrictions are not known to XX1). | 0..1 | G1 | |
<SegmentIDRef/> | ID reference used to associate this item to a segment. No comma separated lists and no ranges supported. | 0..N | F1 | |
<TravelerIDRef/> | Unique association ID reference of the traveler associated to this item. No comma separated lists and no ranges allowed. | 0..1 | T1 | |
<ServiceLocation/> | Also considered the 'Point of Delivery'. This is the location (city/airport code) where a non-flight associated service is being fullfilled. | 0..1 | DFW | |
<ServiceDate/> | Service date in ISO 8601 format (yyyy-mm-dd). | 0..1 | 2010-12-25 | |
<Description/> | Title description (Commercial Name) of offered service. | 1 | "3rd Bag Fee" | |
<DescriptionVariable/> | This value is used to provide a variable value for an selected service. Sample: for a Premium Seat this will be a seat number; for a annual pass of onboard WiFi this will be the credentials, etc. Examples: "9D" "UID: GO8978 PW: 1234" | 0..1 | ||
<DescriptionDetails> | Detailed description of this service | 0..1 | ||
<Text/> | 1..N | |||
</DescriptionDetails> | ||||
<ServicePrice> | Price for this service; not to be used for 'included' options (no charge options) This node uses the Currency/Decimals of the FareGroup root level | 0..1 | ||
@Total | Total amount for the chosen quantity of this service. Total = base price + total amount of taxes. | 1 | 7500 | |
<CurrencyCode> | Currency code. | 0..1 | USD | |
@NumberOfDecimals | Decimal position in fare amount. | 1 | 2 | |
</CurrencyCode> | ||||
<BasePrice> | Base (net) price of Service | 1 | ||
@Amount | Net price of service | 1 | 6750 | |
</BasePrice> | ||||
<Taxes> | Tax Group | 0..1 | ||
@Amount | Total taxes amount. | 1 | 750 | |
<Tax> | Tax break down information group | 0..N | ||
@Amount | Individual tax amount. | 1 | 250 | |
<Designator/> | Tax or surcharge designator. | 0..1 | US | |
<Description/> | Tax or surcharge description. | 0..1 | US national transportation | |
</Tax> | ||||
</Taxes> | ||||
<ItemPrice> | Recommended to provide at all times, however if quantity is greater than 1 ItemPrice is mandatory | 0..1 | ||
@Total | Total amount for this service based on FQTV status and chosen Price Class. Total = base price + total amount of taxes. | 1 | 7500 | |
<BasePrice> | Base (net) price of Option | 1 | ||
@Amount | Net price of option. | 1 | 6750 | |
</BasePrice> | ||||
<Taxes> | Tax Group | 0..1 | ||
@Amount | Total taxes amount. | 1 | 750 | |
<Tax> | Tax break down information group | 0..N | ||
@Amount | Individual tax amount. | 1 | 250 | |
<Designator/> | Tax or surcharge designator. | 1 | US | |
<Description/> | Tax or surcharge description. | 0..1 | US national transportation | |
</Tax> | ||||
</Taxes> | ||||
</ItemPrice> | ||||
</ServicePrice> | ||||
<TicketByDate> | Date (in ISO 8601 format: (yyyy-mm-dd) by which this service must be issued. | 0..1 | 2010-05-07 | |
</TicketByDate> | ||||
<Penalties> | Option Penalty group | 0..1 | ||
@Refundable | Indicates if option is refundable. Values are: Y = Option refundable N = Option not refundable | [Y] [N] | 0..1 | Y |
@Reusable | Indicates if option is reusable. Values are: Y = Funds are reusable N = Funds are not reusable (default) | [Y] [N] | 0..1 | Y |
<Cancel> | Cancel penalty group | 0..1 | ||
@Application | Penalty application type. Examples: AFTER_DEP (After departure) NO_SHOW (No show) PRIOR_DEP (Prior to departure) | [PRIOR_DEP] [AFTER_DEP] [NO_SHOW] | 0..1 | |
@Total | Total Change fee Taxes + Total Change Fee amount | 0..1 | ||
<Amount> | Penalty amount in currency amount or percentage. | 1..2 | 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> | ||||
<Text/> | Information text or error text. | 0..N | Free flow text. Example: Invalid flight number | |
<Taxes> | Taxes group | 0..1 | ||
@Amount | Total taxes amount. | 1 | 50000 | |
<Tax> | Tax break down information group | 0..N | ||
@Amount | Individual tax amount. | 1 | 6500 | |
<Designator/> | Tax or surcharge designator. | 0..1 | US | |
<Nature/> | Tax nature. | 0..1 | US2 | |
<Description/> | Tax or surcharge description. | 0..1 | US national transportation | |
<CollectionPoint> | For XF and ZP taxes: Tax data break down per collection point. The sum of amounts for all collection points may differ slighty from the Tax/@Amount in cases were the collection point amounts were converted from a different currency. NOTE: this definition will eventually supercede the Calculation element. Use this group instead of Calculation as Calculation will be deprecated in near future. | 0..N | ||
@Amount | Individual amount for collection point. | 0..1 | 2500 | |
<AirportCode/> | Segment departure or arrival airport code. | 1 | JFK | |
</CollectionPoint> | ||||
</Tax> | ||||
</Taxes> | ||||
</Cancel> | ||||
<Change> | Change penalty group | 0..1 | ||
@Application | Penalty application type. Examples: AFTER_DEP (After departure) NO_SHOW (No show) PRIOR_DEP (Prior to departure) | [PRIOR_DEP] [AFTER_DEP] [NO_SHOW] | 0..1 | |
@Total | Total Change fee Taxes + Total Change Fee amount | 0..1 | ||
<Amount> | Penalty amount in currency amount or percentage. | 1..2 | 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> | ||||
<Text/> | Information text or error text. | 0..N | Free flow text. Example: Invalid flight number | |
<Taxes> | Taxes group | 0..1 | ||
@Amount | Total taxes amount. | 1 | 50000 | |
<Tax> | Tax break down information group | 0..N | ||
@Amount | Individual tax amount. | 1 | 6500 | |
<Designator/> | Tax or surcharge designator. | 0..1 | US | |
<Nature/> | Tax nature. | 0..1 | US2 | |
<Description/> | Tax or surcharge description. | 0..1 | US national transportation | |
<CollectionPoint> | For XF and ZP taxes: Tax data break down per collection point. The sum of amounts for all collection points may differ slighty from the Tax/@Amount in cases were the collection point amounts were converted from a different currency. NOTE: this definition will eventually supercede the Calculation element. Use this group instead of Calculation as Calculation will be deprecated in near future. | 0..N | ||
@Amount | Individual amount for collection point. | 0..1 | 2500 | |
<AirportCode/> | Segment departure or arrival airport code. | 1 | JFK | |
</CollectionPoint> | ||||
</Tax> | ||||
</Taxes> | ||||
</Change> | ||||
</Penalties> | ||||
<Commission> | Commission amount or percentage for this option | 0..1 | ||
@Type | Commission type. Values are: P = Percent, A = Amount | [P] [A] | 1 | A |
</Commission> | ||||
<Endorsement> | Endorsements for this service. | 0..N | NONREF | |
<Text/> | Freeflow text. | 1 | ||
</Endorsement> | ||||
<ValidatingCarrier/> | Validating carrier code. Standard IATA 2-letter alphanumeric code. Allows to override the Validating Carrier assigned to the entire FareGroup | 0..1 | AF | |
<ReferenceKey/> | Unique reference key. If present in pricing response messages, must be included. | 0..1 | ||
<Attributes> | ATPCO S5 record attributes | 0..1 | ||
<Group> | Sample codes: BG = Baggage FF = Frequent Flyer GT = Ground Transportation and Non Air Services IE = In-flight entertainment LG = Lounge MD = Medical ML = Meal/Beverage PT = Pets RO = Rule Override SA = Prereserved Seat Assignment SB = Standby ST = Store TS = Travel Services UN = Unaccompanied Travel (Escort) UP = Upgrades WF = WiFi | 1 | ||
<Code/> | 1 | |||
<Text/> | 0..1 | |||
</Group> | ||||
<SubGroup> | Sample codes for group "BG": CT = Container PP = Pre-paid excess baggage Sample codes for group "GT": BU = Bus LI = Limo, etc Sample codes for group "IE": IT = Internet access TV = Television, etc | 0..1 | ||
<Code/> | 1 | |||
<Text/> | 0..1 | |||
</SubGroup> | ||||
<Desc1> | Description codes. Examples: 05 = up to 5 kg 1Y = One Year AI = Aisle B1 = First Bag etc. | 0..1 | ||
<Code/> | 1 | |||
<Text/> | 0..1 | |||
</Desc1> | ||||
<Desc2> | Description codes. Examples: HT = Hot KO = Kosher etc. | 0..1 | ||
<Code/> | 1 | |||
<Text/> | 0..1 | |||
</Desc2> | ||||
</Attributes> | ||||
<BookingInstructions> | Contains instructions how to book this service with respective source | 0..1 | ||
<SSRCode/> | Special service request code. IATA standard. | 0..N | VGML | |
<OSIText/> | 0..N | |||
<UpgradeMethod> | Allowed Values: A = AutoUpgrade S = SSR request | 0..1 | ||
@NewClass | Instructs which new class to book | 0..1 | ||
</UpgradeMethod> | ||||
<Text/> | Any freeflow to instruct DC | 0..N | ||
</BookingInstructions> | ||||
<InstantPurchase/> | Instant Purchase indicator. CC = Purchase is immediately charged to CC AP = Purchase is using AirPass credit(s) PP = Purchase is charged via PayPal N = Not an instant purchase TT = Purchase is immediate after Ticketing time AU = EMD will be automatically issued without sending EMDIssueRQ | [CC] [AP] [PP] [N] [TT] [AU] | 0..1 | TT |
</Service> | ||||
</OptionalServices> | ||||
</ServiceListRS> |
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