This document was uploaded by user and they confirmed that they have the permission to share
it. If you are author or own the copyright of this book, please report to us by using this DMCA
report form. Report DMCA
Overview
Download & View Ug_wbs_pnr_addmultielements_12.2_194 (3).docx as PDF for free.
5.2.3 Possible Errors ...............................................................................................................................................................42
5.10 Operation: Fare Discount for a child ................................................................................... 75 5.10.1 Query Structure ........................................................................................................................................................... 75 5.10.2 Reply Structure............................................................................................................................................................. 75 ii
Table of Contents
5.10.3 Possible Errors .............................................................................................................................................................78
5.11 Operation: Fare Discount for a child with a birth date................................................. 79 5.11.1 Query Structure ........................................................................................................................................................... 79 5.11.2 Reply Structure............................................................................................................................................................. 79 5.11.3 Possible Errors ............................................................................................................................................................ 82
5.12 Operation: Fare Discount for senior citizen...................................................................... 83 5.12.1 Query Structure ........................................................................................................................................................... 83 5.12.2 Reply Structure............................................................................................................................................................. 83 5.12.3 Possible Errors ............................................................................................................................................................ 86
5.13 Operation: Fax Number ............................................................................................................ 87 5.13.1 Query Structure ........................................................................................................................................................... 87 5.13.2 Reply Structure............................................................................................................................................................. 87 5.13.3 Possible Errors ............................................................................................................................................................ 90
5.14 Operation: Form of Payment.................................................................................................. 91 5.14.1 Query Structure ........................................................................................................................................................... 91 5.14.2 Reply Structure............................................................................................................................................................. 91 5.14.3 Possible Errors ............................................................................................................................................................ 94
5.18 Operation: Group Name ........................................................................................................ 111 5.18.1 Query Structure ........................................................................................................................................................ 111 5.18.2 Reply Structure .......................................................................................................................................................... 112 iii
Table of Contents
5.18.3 Possible Errors .......................................................................................................................................................... 116
5.20 Operation: Infant With First And Last Name And Date of Birth .............................. 119 5.20.1 Query Structure ........................................................................................................................................................ 119 5.20.2 Reply Structure .......................................................................................................................................................... 120 5.20.3 Possible Errors .......................................................................................................................................................... 123
5.21 Operation: Infant With First Name Only .......................................................................... 124 5.21.1 Query Structure ........................................................................................................................................................ 124 5.21.2 Reply Structure .......................................................................................................................................................... 124 5.21.3 Possible Errors .......................................................................................................................................................... 127
5.22 Operation: Infant With No Information ........................................................................... 128 5.22.1 Query Structure ........................................................................................................................................................ 128 5.22.2 Reply Structure .......................................................................................................................................................... 128 5.22.3 Possible Errors .......................................................................................................................................................... 131
5.23 Operation: Infant with own Native firstname ................................................................ 132 5.23.1 Query Structure ........................................................................................................................................................ 132 5.23.2 Reply Structure .......................................................................................................................................................... 133 5.23.3 Possible Errors .......................................................................................................................................................... 136
5.26.3 Possible Errors .......................................................................................................................................................... 147
5.27 Operation: Name With ID Code.......................................................................................... 148 5.27.1 Query Structure ........................................................................................................................................................ 148 5.27.2 Reply Structure .......................................................................................................................................................... 148 5.27.3 Possible Errors .......................................................................................................................................................... 151
5.28 Operation: Name With Passenger Type Code .............................................................. 152 5.28.1 Query Structure ........................................................................................................................................................ 152 5.28.2 Reply Structure .......................................................................................................................................................... 152 5.28.3 Possible Errors .......................................................................................................................................................... 155
5.29 Operation: Name with title separated from firstname ............................................... 156 5.29.1 Query Structure ........................................................................................................................................................ 156 5.29.2 Reply Structure .......................................................................................................................................................... 156 5.29.3 Possible Errors .......................................................................................................................................................... 159
5.30 Operation: Native name with Native Infant name ....................................................... 160 5.30.1 Query Structure ........................................................................................................................................................ 160 5.30.2 Reply Structure .......................................................................................................................................................... 161 5.30.3 Possible Errors .......................................................................................................................................................... 164
5.34 Operation: Past Dated Segment ......................................................................................... 178 5.34.1 Query Structure ........................................................................................................................................................ 178 5.34.2 Reply Structure .......................................................................................................................................................... 179 v
Table of Contents
5.34.3 Possible Errors .......................................................................................................................................................... 182
5.35 Operation: Received From Information............................................................................ 184 5.35.1 Query Structure ........................................................................................................................................................ 184 5.35.2 Reply Structure .......................................................................................................................................................... 184 5.35.3 Possible Errors .......................................................................................................................................................... 186
5.42.3 Possible Errors .......................................................................................................................................................... 213
5.49 Operation: Tour Code in Free Flow Format.................................................................... 236 5.49.1 Query Structure ........................................................................................................................................................ 236 5.49.2 Reply Structure .......................................................................................................................................................... 236 5.49.3 Possible Errors .......................................................................................................................................................... 238
5.50 Operation: UnStructured Mailing and Billing Addresses ........................................... 239 5.50.1 Query Structure ........................................................................................................................................................ 239 5.50.2 Reply Structure .......................................................................................................................................................... 239 vii
Table of Contents
5.50.3 Possible Errors .......................................................................................................................................................... 241
Web services User guide for function PNR_AddMultiElements
Preface 1 Purpose of this document The purpose of this document is to provide basic functional overview descriptions and relevant examples for a better understanding of the functions.
2 Intended Audience This document is aimed at those who implement this function.
3 Associated Documents This document has to be combined to its corresponding Technical Reference Guide and possibly to Product specifications.
4 Structure of this document This document is composed of the following parts: • the functional description: overview, supported operations, limitations, unsupported operations, prerequisites and possibly reference to product specifications • the detailed description to build the query and to retrieve data from the reply • a set of relevant examples
Web services User guide for function PNR_AddMultiElements
Function: PNR_AddMultiElements. 1 Overview The AddMultiElements function allows a user to make an entire reservation in the Amadeus system with one transaction, bearing in mind that the full itinerary details mustbe known at the time of the function usage.This function allows many different elements to be combined into one transaction, thus it is more efficient by reducing the number of transactions required from the client application.
1.1 Supported Operations The following operations are supported within this function: Adding Names This function may be used to add the following types of traveler names: • Individual Names Used for general travelers. • Infant Name Used for children under the age of 2 years. • Child Name Used for children between the ages of 2-12years. • Group Name Used to incorporate a group of travelers. • Name Element for Cabin Baggage Used to reserve extra space for excess cabin baggage. • Name element for Extra Seat requirement Used to reserve an extra seat in the cabin for a traveler. Note that the Individual Traveler Name (traveler last name and first name), Adult, Infant, Child Name, can be entered in Roman (it can then also be called a passport name) or Native characters (it will then be called a Native name). Special settings are needed to be able to handle Native characters. Only Korean characters are supported as Native characters today. If entered in UTF8 characters, the name must be entered in a dedicated section that supports UTF8 characters. Please refer to the operations related to Native Names. The traveler title can also be entered separately from the first name if wished. In that case, a dedicated section must be used. Adding Itinerary Elements When all mandatory details of the itinerary element required for booking are known, this function may be used to add the following types of itinerary elements:
Web services User guide for function PNR_AddMultiElements
Air Segments • Single flight segments • Connection flight segments • Open flight segments • Arrival Unknown segments (ARNK.) • Ghost segments • Informational segments • Passive segments • Service segments • Past dated segments Non Automated Segments • Air Taxi • Non-Automated Car • Non-Automated Hotel • Miscellaneous Segment • Surface Segment • Non-Automated Tour Segment Hotel Segments •
Automated Hotel Segment
Adding Miscellaneous Data Elements This function may be used to add the following miscellaneous PNR data elements: • Accounting Information Used to send additional information to an agency back office accounting system. • Confidential Remarks Used to store comments in the PNR that can only be viewed by the selected agencies specified. • Contact information Mandatory PNR element containing contact information. • Document Remarks Used to customize information contained on documents such as itineraries or invoices. • Fare Discount Used to automatically price the travel itinerary at a discounted rate without the need to specify the fare discount in a pricing request. • Fare Endorsements/Restrictions Used to identify any restrictions, rules or airline comments that may apply to a ticket. • Fare Print Override Used to override the fare, tax, and total information printed on a document. • Form of Commission Used to identify the specific amount for agency commission on the tickets issued. • Form of Payment Used to store the form of payment to be taken into account when issuing the ticket. •
Web services User guide for function PNR_AddMultiElements
Used to store applicable frequent flyer numbers for travelers. • General Remarks Used to store general remarks in a passenger record. • General Special Service Requests Used to send special service request information, such as a special meal, to applicable airlines. • Individual PNR Security element Used to specify special security rules regarding the retrieval of traveler PNRs. • Manual Document Registration Used to store ticket numbers for tickets not issued via the system. • Miscellaneous Ticketing Information Used to store record data for accounting purposes with association to record the ticketing image. • Original Issue Information Used when a new ticket is issued in exchange for a coupon, a voucher or another airline ticket. • Other Special Information Used to send other special information, such as child indicators, to applicable airlines. • Queuing Option Information Used to place a newly created or retrieved PNR to on a specified queue within a specified office ID for a specified date. • Received From Information Mandatory PNR element containing information identifying the agent responsible for creating or modifying the reservation. • Shadow Destination Used to define different destination offices for the accounting interface records from a back office accounting system. • Structured and Unstructured Billing Address Used to store traveler billing address information. • Structured and Unstructured Mailing Address Used to store traveler mailing address information. • Special Keywords (SK) Used to contain special information about a booking or passenger that can be used by an airline for service or marketing purposes. • Ticketing Information Mandatory PNR Element identifying information regarding the issuance of the ticket, such as a ticketing time limit, or date for ticket issuance. •
Tour Code
Used to store a tour code when a published tour or special negotiated fare is sold in conjunction with a ticket. Adding Seat Elements This function may be used to add the following types of seat elements: PNRdata elements: •
Web services User guide for function PNR_AddMultiElements
• • • • • • • • • •
Smoking Seat Non Smoking Aisle Seat Smoking Aisle Seat Non Smoking Window Seat Smoking Window Seat Non Smoking Rear facing Seat Smoking Rear facing Seat Non Smoking Bulkhead Seat Smoking Bulkhead Seat Specific Seat Number
End transact This function may be used to end transact and then to store the newly created PNR in the database (or modificatiosn in case of a retrieved PNR) with the followings option codes: Option Code
Description
10
End transact (ET)
11
End transact with retrieve (ER)
12
End transact and change advice codes (ETK)
13
End transact with retrieve and change advice codes (ERK)
14 End transact split PNR (EF) Those actions may may be combined with the following codes: Option code
Description
30
Show warnings at first EOT
267
Stop EOT if segment sell error
Ignore This function may be used to ignore an entry with the following codes: Option code
Description
20
Ignore (IG)
21
Ignore with retrieve (IR)
1.2 Limitations Stand-alone entry (Special Service Request) Once an SSR (Special Service Request) OTHS ZZ is entered in a PNR it can no longer be updated: an error message is displayed by the system at the entry input time.In addition it is also not possible to add SSR OTHS ZZ in a already modified PNR. Error message: RESTRICTED: COMBINATION NOT ALLOW WITH SSR OTHS ZZ
Web services User guide for function PNR_AddMultiElements
Other Service Information (OSI) If no company ID is provided, an element without company ID is temporarily created and then removed at EOT time because no airline code of the segments in the itinerary obviously matches the two blank characters. Record locator length Record locator is mandatory when user wants to create Ghost segments, Passive segment and Service segment in this cases : the length of OA record locator have to be from one to seven alpha numeric characters ( from a to z and from 0 to 9).
1.3 Unsupported Operations The following operations are currently unsupported within this function: • Airline Staff Names • Corporate Names • Multiple Names (Native Name and passport name in Roman characters) for a same passenger • Extended Form of Payment Information • Update an already existent FP element • Add Special FP elements: INS/CAR/HTL • MCO • Total Payment Options • Air Sequence number elements • Shadow A.I.R. sequence numbers • Automated Invoice Numbers • Transmission Control Numbers • Hotel Segment Reservations Note: the structures for such operations may already be in place within the message in anticipation of the functionality, but currently will not function until the Amadeus System Enhancements are completed.
1.4 Prerequisites Air, Hotel, Non-Automated Auxiliary segments All mandatory element information must be known for segment reservations prior to using this function. Selling from previous availability responses is not allowed with this function, as it is not cross-referenced with any availability processes. Amadeus system element limitations This function will forward all requests to the Amadeus system regardless of the content. As this function allows for numerous operations to be combined the security and limitations of each Amadeus system element requested within this operation is verified at the time of processing in the Amadeus system. Therefore, functional errors may be returned to the user at processing time on the Amadeus system however the correct elements will be created.
Web services User guide for function PNR_AddMultiElements
2 Building A Query The queries for the operations are clearly explained with data element examples the Technical Reference Guide. It is important to note that the examples given are only illustrations and are meant to provide the basis for a better understanding on which fields are mandatory for basic operation utilization. It is not a full explanation of every field that can be utilized for the operation, but rather a guideline to its use. Note: The Fare Discount element cannot process multiple discounts. If you wish to enter multiple discounts for a passenger, you should enter several FD elements and associate them to the same passenger. Note related to Names: Two structures exist to carry names, one supporting only Roman characters, one supporting possibly some native and Roman characters. As an illustration, the individual passenger names can be carried in: • passengerData section: if the passenger name (last name and firstname) is a passport name (Roman name) OR • enhancedPassengerData section: if the individual passenger name (last name and firstname) has a Native name(and possibly also a passport name) or a passport name (Roman name)(it includes for example case with a title separated from the firstname in the query). Remark: addition of multiple names (Native Name and possibly also a passport name) for a same passenger functionality is not supported today. Note related to the Contact element: For type P02 (email), it is possible to restrict its access by entering an office (or range of offices) with a possible access mode, at the begining of the freetext (separate the offices and the freetext by a /). For type 5:N (APN), the field containing the freeflow text of the element shall be filled the following: {XX/}{YYYYYYYYY}{-W}/{X}\+{XXXXXXXX...}{/LG}{/F} • XX is the airline association: • (Mandatory) If logged in an ATO/CTO: mandatory association to the ATO/CTO's airline • (Forbidden) Otherwise: forbidden • YYYYYYYYY (Optional) is a set of office IDs. If not entered the system defaults to let the APN element visible and modifiable by any office. Up to a maximum of three (3) office identifications in addition to the creator office can be entered in each element. Each office ID will be separated by a comma. A valid office ID can be a complete office ID or a partial office id (e.g. HEL6X0100, ***6X0***, LIS2X0***, ***2X0100). These Ids have read access to the element. (1) • W (Optional) is the identification code that indicates if the office ID or the range is able to update/cancel the element. If the code is not present, the office identification(s) indicated will be able to see but will not have the ability to update/cancel the element. • X (Mandatory) is the mandatory code identifier to specify the mean of contact. The supported media are M (Mobile phone), E (Email). Whenever a media type is chosen, the system will expect a specific address structure for this media in the following input. Note only one media type can be selected per APN. • XXXXXXXX... (Mandatory) is the media address to contact the person with. Its type and structure depends on the media type, selected in the previous input. For the phone number, the process checks at entry time that the phone number does not start by +00. For the email, it checks that the ‘@’ is present. The email address should only contain alphanumeric characters and some special symbols (‘.’, ’-’, ’_’).
Web services User guide for function PNR_AddMultiElements
• LG (Optional) is the preferred language identification code. It refers to the list of ISO language codes. • F (Optional) is the third-party indicator. In certain use cases, the Agent may have to specify a third-party contact element that should get notification linked to the passenger’s journey (e.g.: a friend picking him at the arrival airport).
2.1 Query Sub Structure: 2.1.1 Description 2.1.2 Xml Structure
Web services User guide for function PNR_AddMultiElements
3 Receiving A Reply For each query sent, the Reply message structure will be returned with the appropriate PNR information requested or applicable errors. Please refer to the Technical Reference Guide for detailed message information. As each query receives only the Reply message structure, any errors that are returned to the query will be found in the appropriate section of the Reply . Reply Structure Names Elements When creating a name item within this function the following information should be noted: • There is no special processing required for adding a name element. Therefore, the mandatory option code is set to 0. • The type of element being added is a passenger reference and therefore the / elementManagementPassenger /reference /qualifier is set to PR. • Reference numbers of passengers added begin with 1 and should be numbered sequentially when adding. • The type of passenger reference element being requested is defined as one of the following: NM=Name or NG=Group Name. • When requesting a name, a surname and a first name are mandatory elements within the structure. Passenger type codes, ID codes, etc are optional parameters. Note that both passengerData and enhancedPassengerData will be filled, except in some error cases. For individual passengers: • passengerData contains Romanization in pure Roman characters or Passport name, depending on the name "active"/"reference" for the passenger in the PNR. • enhancedPassengerData contains the Native name, Romanized name (romanization) (and possibly also a passport name) or a passport name. These names are labelled by a nameType. The information related to the name that is the "active"/reference name in the PNR is provided in referenceName. The information related to the name(s) that would be displayed in a PNR cryptic display, depending on settings to support Native name, is provided in displayedName. For Romanized name, the Romanization method is also provided in romanizationMethod. Remark: addition of multiple names (Native Name and possibly also a passport name) for a same passenger functionality is not supported today. General A passenger name is mandatory for the creation of a passenger name record (PNR). A minimum of 1 passenger name must be entered prior to storing the record. A maximum of 99 names may be added in the passenger name record. A title for the passenger is not mandatory. The maximum length of the whole name and name attributes is 59 characters, however this does not mean that 59 characters can be input into the XML structure as additional attributes may be added. Passenger Type Codes A passenger type code is not mandatory. If a passenger type code is not included, the system considers the passenger is an adult. A maximum of one passenger type code may be specified, except under some conditions. Group Names
Web services User guide for function PNR_AddMultiElements
A maximum of one group name may exist in the passenger name record. A group name may contain a maximum of 99 individual passengers Itinerary Elements Using the Function Message Structure The following should be noted when using the AddMultiElements function for reserving an itinerary element: • All of the itinerary details must be known at the time of the segment request. Reserving from an availability is not allowed with this function. • There is no special processing required for adding an itinerary element. Therefore, the mandatory option code is set to 0. • The type of element being added is a segment reference and therefore the /elementManagementItinerary / reference /qualifier is set to SR. • The air auxiliary status code of the request is normally NN for a reservation request. • The business function is always 1 for airline request. • The originDestinationDetails element is used to group connecting flights and or married segments. • When selling an outbound and inbound journey, you must use two different originDestinationDetails elements (For example: 1 for the outboundflight and 1 for the inbound flight). AIR / Flight Reservations The type of element being added is an AIR segment and therefore the elementManagementItinerary Segment Name is set to AIR. General A maximum of 99 itinerary element reservations may be requested. The reservation requests are manual requests and therefore are processed via the standard Amadeus system processing. i.e., direct access bookings are not possible. Miscellaneous Date Elements Using the Function Message Structure The following should be noted when using the AddMultiElements function for reserving a miscellaneous data element: • There is no special processing required for adding a miscellaneous element. Therefore, the mandatory option code is set to 0. • The type of element being added is classified as "other type" and therefore the / elementManagementItinerary /reference /qualifier is set to OT. • As the operational information is generally free form text, in most instances a special detail qualifier is required to identify the type of free form text being entered. Such information can be found under the applicable section. Accounting Information The accounting information is identified with a segment name of AI. Each optional element for the accounting information is of free flow text. Accounting information may be stored in the Amadeus Record. This information will be transmitted to the applicable back office accounting system. The accounting information may contain the following optional elements: • Account Number • Cost Center Number • Company ID Number • Client Reference Number
Web services User guide for function PNR_AddMultiElements
The accounting elements may be passenger and segment associated. A maximum of 1 accounting information element may be requested for per passenger per segment. Contact Information A PNR must contain at least one contact element prior to storage. A maximum of 127 contact elements may be requested. Each contact element is of free form text and therefore the content is not verified by the Amadeus System. The contact information is identified with a segment name of AP and consists of freeflow text. Each type of contact is qualified with a free form text detail type number in the message structure in conjunction with a free form indicator following the actual contact number. The common indicators for different contact numbers that are entered at the end of the contact number and their applicable detail types are as follows: Type of contact
Description
Free Form Text Detail Type in output
Basic contact element
Blank
blank
Passenger Business Number
B
3
Passenger Home Number
H
4
Unknown Type
Blank
5
Agency Contact Number
AGCY
6
Mobile Phone Number
Mobile
7
Fax Number
FAX
P01
E-mail Contact
Email
P02
Internet Contact
URL
P03
Force Sent
S
5:S
Inhibit Sent
X
5:X
Notification Contact
Notification
5:N
Fare Discount Element The fare discount information stored in a passenger record is verified and applied at the time of a pricing request. Up to 3-fare discount codes per passenger may be stored in the Amadeus system record. Note: The Fare Discount element cannot process multiple discounts. If you wish to enter multiple discounts for a passenger, you should enter several FD elements and associate them to the same passenger. The fare discount information is identified with a segment name of FD and consists of a type of discount identifying code and any additional information the applicable discount requires. The following standard fare discounts are applicable in the Amadeus system: Type of Discount
Web services User guide for function PNR_AddMultiElements
Adult with Companion
CN
--
Companion
CP
Percentage Discount
Seriously Disabled Psgr
DB
--
Government Officials
DG
Percentage Discount
Labor
DL
--
Teacher
DT
Percentage Discount
Emigrant
EM
Percentage Discount
Group
GC
Percentage Discount
School Group
GP
--
Group - Inclusive Tour
GV
--
Air Industry Employee
ID
Percentage Discount/Status Code
Infant
IN
Date of Birth/Age in Yrs
Individual Inclusive Tour
IT
--
Military
MM
Percentage Discount
Family
PD
--
Family - Head of family
PH
--
General Sales Agent
RG
Percentage Discount
Regular Passenter
RP
Percentage Discount
Seaman
SC
Percentage Discount or Country Code
Student
SD
Date of Birth/Age in Yrs
Special Event
SE
--
Spouse
SH
--
Spouse - Accompany
ST
Percentage Discount
Standby
UU
--
Youth - Student Certificate Required
ZS
Date of Birth/Age in Yrs
Youth ZZ Date of Birth/Age in Yrs Note: Certain fare discounts require specific parameters to be included in the request for proper processing, such as; age, birth date, certificate numbers, etc. The Fare Discount element cannot process multiple discounts. If you wish to enter multiple discounts for a passenger, you should enter several FD elements and associate them to the same passenger. Frequent Flyer Information The frequent flyer information is transmitted to the applicable airlines at the time the record is stored. As this information is a unique identifier for an individual passenger, it must be passenger associated in the case of a multiple passenger record.
Web services User guide for function PNR_AddMultiElements
The frequent flyer information is deemed as a type of special services request, and therefore will utilize the special services request (/dataElementsMaster /dataElementsIndiv /serviceRequest (SSR)) structure in this function. The segment name will be requested as an SSR will be have an associated type of FQTV, indicating frequent traveler information. Being that this is stored as an SSR item, the applicable airline information for the surrounding SSR structure will need to be propagated in the structure to indicate which airlines should receive the transmitted frequent traveler information. Failure to complete the SSR required structure information would result in an error message for the request. Note:Some airlines may reject these manual SSR FQTV. These elements are not validated against Amadeus Frequent Flyer database General Remark Information In addition, the RM and RI remark types may contain an additional sub category indicator for system sorting. i.e., all sub categories of similar type will be grouped together. The Category indicator is not applicable for RC and RQ remark Types. Following types of remarks may be requested: Remark Type
Code
Miscellaneous Remark
RM
Confidential Remark
RC
Invoice Remark
RI
Quality Control Remark
RQ
Mailing & Billing Address Information The mailing and billing address information is optional information used for the itinerary and invoice documents. Two forms of the mailing and billing address information exist: Type Definition
Segment Name Code
Structured Billing----
AB
Structured Mailing----
AM
UnStructured Billing----
ABU
UnStructured Mailing---ABU ----The billing and mailing address information is structured in a specific manner to identify each element of the address. This format is typically used in conjunction with a back office accounting system.A structured mailing or billing address must contain at least 1 address line. Therefore, the A1 option is mandatory in this function. Each element of the structured mailing or billing address is identified with a specific code. The following coded structured address elements may be stored in the passenger record: Code
Web services User guide for function PNR_AddMultiElements
A1
ADDRESS LINE 1
50
A2
ADDRESS LINE 2
50
PO
POST OFFICE BOX
8
ZP
POSTAL/ZIP CODE
20
CI
CITY
30
ST
STATE
25
CO COUNTRY 25 When creating a structured mailing or billing address, the type of address being entered is mandatory. The following types are applicable for structured addresses: Type of Address
Type Code
Billing Address
2
General Mailing Address
P08
Miscellaneous Address
P19
Home Mailing Address
P24
Delivery Mailing Address P25 ---The billing and address information for unstructured format is of free form text. A maximum of 126 characters may be stored. The information is printed on Amadeus generated itinerary and invoice documentation inline formats. The start of each new line of information may be indicated by a comma (,) in the freeform text information for printing purposes. The maximum number of character per line on an Amadeus generated document is 27. Therefore, a maximum of 27 characters should be adhered to between commas to avoid any truncation by the Amadeus system when generating documentation. The following illustrates a free form text with new line indicators for printing purposes: Free Form Text Entered Mr. John Smith, 124 south Hampton, Atlanta GA 30039
Printed Format on Amadeus Generated Documents Mr. John Smith 124 south Hampton Atlanta GA 30039
Received From Information The received from information is a mandatory element for a passenger name record. This element is of free form text and is used to identify who has created or updated the passenger name record or who has given the instruction / authorization for the creation or update to the passenger name record. A maximum of one received from information element may exist in the record. Ticketing Information The ticketing information is a mandatory element prior to record storage. This information details the ticketing arrangements with the date of when the ticket will be issued. A maximum of one ticketing information element may exist in the record.
Web services User guide for function PNR_AddMultiElements
The ticketing information elements are identified with the segment name of TK with an associated sub type of ticketing information. A Ticketing Arrangement element may be passenger associated (except TKXL) at any time during the creation or modification of the PNR.Segment association is only allowed if a TST (Transitional Stored Ticket) has been created for that segment. Maximum number of Ticket Arrangement Elements per PNR is 127. The following types of ticketing information elements may be requested: Ticketing Type
Code
Ticketing time limit
TL
Domestic Ticket Type
DO
International Ticket Type
IN
Ticket issued, No Queue Placement required
OK
Automatic cancel Date
XL
Tickets to be Mailed
MA
Tickets to be issued at the airport office
AT
Revalidated Ticket
TR
3.1 Reply Sub Structure: 3.1.1 Description 3.1.2 Xml Structure
Web services User guide for function PNR_AddMultiElements
5 Operations 5.1 Operation: Accounting Information The example below illustrates a request to add an accounting element with the following information: Parameter
Web services User guide for function PNR_AddMultiElements
5.2 Operation: ARNK Segment When the arrival is unknown, an ARNK is input. Segment indicates that it is not known how the passenger proceeds from the arrival city of the previous segment to the departure city of the next segment. An ARNK segment may be passenger associated at input or prior to end transaction. ARNK, without association, applies to all passenger names in a PNR. When associated to less than the total number of names elements entered, a non homogeneous condition exists. Itinerary is not valid if an ARNK precedes another ARNK.
Web services User guide for function PNR_AddMultiElements
5.11 Operation: Fare Discount for a child with a birth date The example below illustrates a request to store a fare discount element for child with 10% dicount and birth date 01FEB03.
Web services User guide for function PNR_AddMultiElements
5.12 Operation: Fare Discount for senior citizen The example below illustrates a request to store a fare discount element senior citizen with 10% discount.
5.14.3 Possible Errors INVALID FORM OF PAYMENT: If there are errors in the FOP syntax. For example invalid FOP code. INVALID ACCOUNT NUMBER: The CC number is not compliant with Luhn algorithm or length restrictions (too short or too long) CREDIT CARD EXPIRED: if the credit card is expired.
Web services User guide for function PNR_AddMultiElements
5.15 Operation: Frequent Flyer Numbers The frequent flyer information is deemed as a type of special services request, and therefore will utilize the special services request (/dataElementsMaster /dataElementsIndiv /serviceRequest (SSR)) structure in this function. The segment name will be requested as an SSR will have an associated type of FQTV, indicating frequent traveler information. Besides this, it is stored as an SSR item, the applicable airline information for the surrounding SSR structure will need to be propagated in the structure to indicate which airlines should receive the transmitted frequent traveler information. Failure to complete the SSR required would result in an error message. Note:Some airlines may reject these manual SSR FQTV. These elements are not validated against Amadeus Frequent Flyer database The example below illustrates a request for a frequent flyer number with the following information Parameter
Web services User guide for function PNR_AddMultiElements
5.17 Operation: Ghost Segment Segment originally booked in another system, or speculative booking. These segments are not reported or billed to the controlling carrier. For Ghost segments: • Record Locator mandatory • Action codes: GK, GN, GL • Departure/arrival time mandatory if flight not recorded in 1A Example: Parameter
Web services User guide for function PNR_AddMultiElements
5.17.3 Possible Errors ? Record Locator missing: Error Information (ERC) ZZZ and IFT "NEED AGENT SIGN / RECORD LOCATOR" ? Departure/arrival time missing whereas flight is not recorded in 1A: Error Information (ERC) 134 and Error Free From Text ( IFT) "INPUT TIMES"
Web services User guide for function PNR_AddMultiElements
5.18 Operation: Group Name The example below illustrates a group name with 2 travelers containing the following information: Parameter
Information
Group Name
MARTIEN GROUP
Traveler1 Surname
CHILDS
Traveler1 First name
LISA
Traveler2 Surname
CHIKKLES
Traveler2 First name ROBERT Note: the /elementManagementPassenger /reference /qualifier and the /elementManagementPassenger / reference /number are not set for the group name, but rather only for the individual names entered beneath the group name title.
Web services User guide for function PNR_AddMultiElements
5.20 Operation: Infant With First And Last Name And Date of Birth The infant has to be associated to another passenger, and is attached to the same /travellerInfo / passengerData /travellerInformation element field quantity = 2.
Web services User guide for function PNR_AddMultiElements
5.21 Operation: Infant With First Name Only The infant has to be associated to another passenger, and is attached to the same /travellerInfo / passengerData /travellerInformation element,field quantity = 2.
Web services User guide for function PNR_AddMultiElements
5.22 Operation: Infant With No Information The infant has to be associated to another passenger, andis attached to the same /travellerInfo / passengerData /travellerInformation element,field quantity = 2.
Web services User guide for function PNR_AddMultiElements
5.23 Operation: Infant with own Native firstname The infant has to be associated to another passenger, and is attached to the same /travellerInfo / passengerData /travellerInformation element,field quantity = 2. Native name 김/지훈 will be used for the adult, 수진 for the firstname infant, to be able to illustrate. In the reply, the header flag RCH is displayed, as Native names are present in the PNR.
Web services User guide for function PNR_AddMultiElements
5.24 Operation: Informational Segment An information flight segment gives details of a non-Altea flight that has not been booked through Amadeus. Entering this segment may or may not generate a message to the Airline involved, depending on whether any other element for action by the same airline is enterd in the PNR during the same or a subsequent transaction.This informational segment is not recognized by the system for pricing or ticketing. Informational segment can be included in group and non-group PNRs. For Informational segments: • Departure/arrival time mandatory • HK, HL, HN are the only authorized status code • Only for non Altea airlines • N will be added at the end of TVL segment (Edifact message) Example: Parameter
5.24.3 Possible Errors ? Departure/arrival time missing: Error Information (ERC) 134 and Error Free From Text ( IFT) "INPUT TIMES" ? Other action code than HK, HL, HN: Error Information (ERC) ZZZ and IFT "INVALID STATUS CODE" ? On Altea airline: Error Information (ERC) ZZZ and Error Free From Text ( IFT) "RESTRICTED ACTION CODE"
Web services User guide for function PNR_AddMultiElements
5.27 Operation: Name With ID Code The example below illustrates a simple name request with thefollowing information: Parameter
Information
Traveler Surname
CHIPIE
Traveler First name
ROBERT
Passenger ID Code ID12344 Note: Two identification codes are supported they are 'ID' and or 'CR'. The ID codes are individually assigned and can form part of a client's department name and or even a description. Therefore it may be unique to a passenger. The CR code can form part of a name element and can reference when a PNR has been created from a Cruise Application via a specific message.
Web services User guide for function PNR_AddMultiElements
5.30 Operation: Native name with Native Infant name The infant has to be associated to another passenger, and is attached to the same /travellerInfo/ enhancedPassengerData/enhancedTravellerInformation element field quantity = 2. The infant indicator must be set to 3, meaning that the infant has his proper surname and lastname. Native name 김/지훈 will be used for the adult, 이/수진 for the infant, for illustration. In the reply, the header flag RCH is displayed, as Native names are present in the PNR.
Web services User guide for function PNR_AddMultiElements
5.31 Operation: Open Segment An Open Segment (SO) may be entered into the PNR for the purposes of ticketing and faring. No flight inventory is adjusted. The process checks for format only. An Open segment may be included in both Group and Non Group PNRs. Open segments are considered valid itinerary only when a PTA is present in the PNR. If no PTA exists and the PNR contains only Open Segments without SA status code. Example: Parameter
Web services User guide for function PNR_AddMultiElements
5.33 Operation: Passive Segment Passive booking enable you to ticket an itinerary which has been actively booked in a system other than Amadeus, specifically for the purpose of transmitting the ticket number to the airline For Passive segments: • Record Locator mandatory • Departure/arrival time mandatory if flight not recorded in 1A • Only for non Altea airlines • PK and PL action codes Example: Parameter
Web services User guide for function PNR_AddMultiElements
5.33.3 Possible Errors ? Record Locator missing: Error Information (ERC) ZZZ and Error Free From Text ( IFT) "NEED AGENT SIGN / RECORD LOCATOR" ? Departure/arrival time missing whereas flight is not recorded in 1A: Error Information (ERC) 134 Error Free From Text ( IFT) IFT "INPUT TIMES" ? On Altea airline: Error Information (ERC) ZZZ and Error Free From Text ( IFT) "INVALID ACTION CODE FOR XX" ? On Ticketless acces carrier: Error Information (ERC) ZZZ and Error Free From Text ( IFT) "CHECK ACTION CODE"
Web services User guide for function PNR_AddMultiElements
5.34 Operation: Past Dated Segment Past dated segment can be added using GK action code and it can be 999 days in the past maximum. Rloc is not madatory because PAST will be displayed as Rloc in the replay. Example: Parameter
Web services User guide for function PNR_AddMultiElements
17SECJ931 <status>GK <status>B <productDetails> <equipment>ECJ 0 <weekDay>3 2316 <selectionDetails> <selection> <subjectQualifier>3 DOES NOT MATCH PUBLISHED PASSIVE FLIGHT/CLASS SCHEDULE*WARNING: THIS SEGMENT IS 139 DAYS IN THE PAST <markerRailTour>
Web services User guide for function PNR_AddMultiElements
5.38 Operation: Service segment Service segments can be included in a PNR to facilitate the ticketing process, when one or more segments have been booked outside Amadeus. They are identified by the use of HK Action Code with an OA sign, which are transmitted to the corresponding airlines when the PNR is filed (EOT), for action and information. For Service segment: • Record Locator mandatory • Departure/arrival time mandatory if flight not recorded in 1A • Only for non Altea airlines • Use of HK in RPI segment (in Edifact message) Example: Parameter
5.38.2 Reply Structure 5.38.3 Possible Errors ? Record Locator missing: Error Information (ERC) ZZZ and Error Free From Text ( IFT) "NEED AGENT SIGN / RECORD LOCATOR" ? Departure/arrival time missing whereas flight is not recorded in 1A: Error Information (ERC) 134 Error Free From Text ( IFT) IFT "INPUT TIMES" ? On Altea airline: Error Information (ERC) ZZZ and Error Free From Text ( IFT) "INVALID ACTION CODE FOR XX"
5.40.3 Possible Errors RESTRICTED ACTION CODE if you try to sell an action code not authorized by the airline. CHECK CLASS OF SERVICE if you try to sell the restricted class returns the message. CHECK FLIGHT NUMBER INVALID CITY PAIR
Web services User guide for function PNR_AddMultiElements
DE <marker2> <elementManagementData> OT1 <segmentName>RM 1 <miscellaneousRemarks> RM*A.I.R REMARK, USE CATEGORY FOR ACCOUNTING REMARKS <extendedRemark> <structuredRemark> RM*A.I.R REMARK, USE CATEGORY FOR ACCOUNTING REMARKS
5.41.3 Possible Errors See "Error Messages" section.
Web services User guide for function PNR_AddMultiElements
5.42 Operation: Structured Mailing The example below illustrates a structured mailing address element including the following optional address information: Type
Data
Name
Dave Johnson
Address Line 1
1234 so. Main street
Address Line 2
Villa 9
City
Atlanta
State
Georgia
Zip Code
30039
Country USA Note: a structured billing address will follow the same constraints asa mailing address. By simply changing the segment name code to AB, the below example will illustrate a structured billing address.
Web services User guide for function PNR_AddMultiElements
5.43 Operation: Structured Remark The example below illustrates a request for a remark creation. This example is for a general remark (RM) but it applies in the same way for Itinerary and Invoice remarks. Just replace RM by RIR, RII, RIF or RIZ
5.43.1 Query Structure 0 <marker1> <elementManagementData> OT10 <segmentName>RM <extendedRemark> <structuredRemark> RMTHIS IS A GENERAL REMARK
Web services User guide for function PNR_AddMultiElements
MUC <sbrPreferences> <userPreferences> DE <marker2> <elementManagementData> OT3 <segmentName>RM 1 <miscellaneousRemarks> RMTHIS IS A GENERAL REMARK <extendedRemark> <structuredRemark> RMTHIS IS A GENERAL REMARK
5.43.3 Possible Errors See "Error Messages" section.
Web services User guide for function PNR_AddMultiElements
5.44 Operation: Structured Remark with basic security The example below illustrates a request for a secured remark creation. In this example, no office is specified for the security. It means only the creator office will have access to the remark (in read & write). This example is for a general remark (RM) but it applies in the same way for Itinerary and Invoice remarks. Just replace RM by RIR, RII, RIF or RIZ
5.44.1 Query Structure 0 <marker1> <elementManagementData> OT10 <segmentName>RM <extendedRemark> <structuredRemark> RMTHIS IS A SECURED REMARK
Web services User guide for function PNR_AddMultiElements
5.45 Operation: Structured Remark with corporate security The example below illustrates a request for a corporate remark with Unicode characters and a category. This example is for a general remark (RM) but it applies in the same way for Itinerary and Invoice remarks. Just replace RM by RIR, RII, RIF or RIZ
5.45.1 Query Structure 0 <elementManagementData> OT10 <segmentName>RM <extendedRemark> <structuredRemark> RMAMR 김 지 훈 IS A VIP <serviceDetails> <statusDetails> RX
Web services User guide for function PNR_AddMultiElements
5.46 Operation: Structured Remark with specific security The example below illustrates a request for a secured remark creation. In this example, the security is specified as follows: - an office Id (NCE6X0980) with read & write access - a Family (F-LON6X0100) with read access It means NCE6X0980 and the creator office (MUC1A0701) will have access to the remark in read & write mode and the Family (offices having FRX EOS agreement with LON6X0100) will have access in read only. This example is for a general remark (RM) but it applies in the same way for Itinerary and Invoice remarks. Just replace RM by RIR, RII, RIF or RIZ
Web services User guide for function PNR_AddMultiElements
5.47 Operation: Structured Timestamped Remark NOTE THAT THIS OPTION IS NOT PART OF THE BASELINE REMARK PACKAGE. The example below illustrates a request for a Timestamped remark with Unicode characters and a category. This example is for a general remark (RM) but it applies in the same way for Itinerary and Invoice remarks. Just replace RM by RIR, RII, RIF or RIZ
5.47.1 Query Structure 0 <elementManagementData> OT10 <segmentName>RM <extendedRemark> <structuredRemark> RMAMR 김 지 훈 IS A VIP <serviceDetails> <statusDetails> TS
Web services User guide for function PNR_AddMultiElements
5.48 Operation: Ticketing Arrangement Element The example below illustrates a request for a ticketing element with the following information: Parameter
Web services User guide for function PNR_AddMultiElements
5.50 Operation: UnStructured Mailing and Billing Addresses The example below illustrates an unstructured mailing address element including free form address text information in the following desired printable format: Dave Johnson 1234 so main street Atlanta GA 30039 USA Note: an unstructured billing address will follow the same constraints as a mailing address. By simply changing the segment name code to ABU, the below example will illustrate an unstructured billing address.
5.50.1 Query Structure 0 <elementManagementData> OT1 <segmentName>AMU <subjectQualifier>3 P08Dave Johnson, 1234 so main street, Atlanta GA 30039, USA
Web services User guide for function PNR_AddMultiElements
5.51 Operation: Upgrade The example below show a SSR FQTU. Note: All the information is added in the freetext (for what concerns edifact respectively XML, no FTI segment respectively frequentTravellerData tag follows SSR FQTU segment). In the reply some flights appears to provide a complete example.
5.51.3 Possible Errors DUPLICATE EXISTS TARGET AIRLINE MISSING CARD AIRLINE MISSING FF NUMBER MISSING NO AIR SEGMENTS PASSENGER AND_OR SEGMENT DATA NOT VALID SSR ITEM TOO LONG INVALID ACTION CODE INVALID NIP (NIP=Number In Party) NO AGREEMENT BETWEEN CN TOO LONG (CN=certificate number) PC TOO LONG (PC= promotion code) UQ TOO LONG (UQ=upgrade qualifier) AC TOO LONG (AC=award code) NO EOT UPGRADE CLASS INVALID UPGRADE CLASS MISSING