PASSENGER AND AIRPORT DATA INTERCHANGE STANDARDS EDIFACT IMPLEMENTATION GUIDE PNR DATA PUSHED TO STATES OR OTHER AUTHORITIES PNRGOV MESSAGE Version 13.1 (Approved and published by the WCO/IATA/ICAO API Contact Committee) October 2013 Revision History Version Date Author Section Change History 10.1 19May 2010 M Irons Initial Publication – Numbering to be kept in line with the PADIS EDIFACT MESSAGE STANDARD release schedule 10.1 29Dec 2010 P Heilig Made editiorial changes to segment layouts and example. 11.1 09Jan 2011- A Colbath - Editorial changes based on comments from governments and 27Jul 2011 M. Odgers technical staff M.Zitkova - Editorial changes based on comments from governments - Additional editorial changes based on comments from governments - Agreed changes from the 04-05May11 PNRGOV Working Group. - Removed business case examples and add them to Appendix - Editorial changes - Corrected an error in example 5 of section 5.25. 12.1 27 Jun 2012 M-C Colin/ Agreed changes from 11-12Nov, 14-15Feb12 and 9-10 May12 A. Colbath PNRGOV Working Groups 12.1 17 Jul 2012 M.Zitkova Formatting changes required for the publication 12.1 30 Jul 2012 M. Zitkova Editorial changes 12.1 3 Aug 2012 M. Zitkova Modification of example 3 in 5.28.1 and example 5 in 5.28.2. 13.1 17 Mar 2013 M-C Colin Agreed changes from 14-16 SepPNRGOV Working Groups 13.1 28 Mar 2013 M. Zitkova Updates to reflect the version and approval status 13.1 May 2013 M. Zitkova Updates made as a result of PNRGOV 07 13.1 Jul 2013 M-C Colin Agreed changes/updates from PNRGOV 07 13.1 July 2013 M Zitkova Formatting and editorial changes required for the publication PADIS EDIFACT Implementation Guide – Table for Contents 1.  INTRODUCTION ................................................................................................................................................... 1  1.1.  PNRGOV MESSAGE VERSION RELEASE ...................................................................................................... 1  1.1.1  PROGRESSION LISTING 1  1.1.2  ERRATA 1  1.2.  DOCUMENT STRUCTURE ............................................................................................................................... 2  1.3.  HOW TO USE THIS DOCUMENT ..................................................................................................................... 2  1.4.  GUIDELINES AND RULES ............................................................................................................................... 3  1.5.  CODE SETS ......................................................................................................................................................... 4  1.6.  REFERENCES ..................................................................................................................................................... 4  2  MESSAGE RELATIONSHIP ............................................................................................................................... 5  2.1  PNRGOV ............................................................................................................................................................. 5  2.2  GOVREQ ............................................................................................................................................................. 6  3  MESSAGE STRUCTURE ..................................................................................................................................... 7  3.1  MESSAGE SEGMENT DESCRIPTIONS (PNRGOV) .................................................................................................. 8  3.2  PUSH OF PNR DATA TO STATE - (PNRGOV) .................................................................................................... 10  3.3  ACKRES – ACKNOWLEDGEMENT RESPONSE ..................................................................................................... 12  3.4  PNRGOV ADHOC REQUEST (GOVREQ) ......................................................................................................... 13  4  UNITED NATIONS SERVICE SEGMENTS .................................................................................................... 14  4.1  UNA: SERVICE STRING ADVICE .................................................................................................................. 14  4.2  UNB: INTERCHANGE HEADER .................................................................................................................... 16  4.3  UNE: FUNCTIONAL GROUP TRAILER ........................................................................................................ 18  4.4  UNG: FUNCTIONAL GROUP HEADER ........................................................................................................ 19  4.5  UNH: MESSAGE HEADER .............................................................................................................................. 21  4.6  UNT: MESSAGE TRAILER ............................................................................................................................. 23  4.7  UNZ: INTERCHANGE TRAILER .................................................................................................................... 23  5  PADIS RESERVATIONS SUB-GROUP APPROVED SEGMENTS ............................................................. 24  5.1  ABI: ADDITIONAL BUSINESS SOURCE INFORMATION (PNRGOV) ..................................................... 24  5.2  ADD: ADDRESS INFORMATION (PNRGOV) ...................................................................................................... 25  5.3  APD: ADDITIONAL PRODUCT DETAILS (PNRGOV) ................................................................................ 26  5.4  DAT: DATE AND TIME INFORMATION (PNRGOV) .................................................................................. 27  5.5  EBD: EXCESS BAGGAGE DETAILS (PNRGOV) .......................................................................................... 28  5.6  EQN: NUMBER OF UNITS ............................................................................................................................. 29  5.7  ERC: APPLICATION ERROR INFORMATION ............................................................................................ 30  5.8  FAR: FARE INFORMATION (PNRGOV) ....................................................................................................... 31  5.9  FOP: FORM OF PAYMENT (PNRGOV) ......................................................................................................... 32  5.10  FTI: FREQUENT TRAVELLER INFORMATION (PNRGOV) ....................................................................... 33  5.11  IFT: INTERACTIVE FREE TEXT (PNRGOV) ............................................................................................... 34  5.12  LTS: LONG TEXT STRING (PNRGOV) ......................................................................................................... 35  5.13  MON: MONETARY INFORMATION (PNRGOV) ......................................................................................... 36  5.14  MSG: MESSAGE ACTION DETAILS (PNRGOV), (ACKRES) ..................................................................... 37  5.15  ORG: ORIGINATOR OF REQUEST DETAILS (PNRGOV) .......................................................................... 38  5.15.1  ORG: Push PNR Data to States - PNRGOV 38  5.15.1  ORG: PNRGOV Adhoc Request - GOVREQ 40  5.16  PTK: PRICING/TICKETING DETAILS (PNRGOV) ...................................................................................... 41  5.17  RCI: RESERVATION CONTROL INFORMATION (PNRGOV) ................................................................... 43  5.18  REF: REFERENCE INFORMATION (PNRGOV) .......................................................................................... 44  5.19  RPI: RELATED PRODUCT INFORMATION (PNRGOV) ............................................................................. 44  5.20  SAC: SOURCE AND ACTION INFORMATION (PNRGOV) ........................................................................ 45  5.21  SRC: SEGMENT REPETITION CONTROL (PNRGOV)................................................................................ 46  5.22  SSD: SEAT SELECTION DETAILS (PNRGOV) ............................................................................................. 47  5.23  SSR: SPECIAL REQUIREMENTS DETAILS (PNRGOV) ............................................................................. 48  5.24  TBD: TRAVELER BAGGAGE DETAILS/ELECTRONIC TICKETING (PNRGOV) ............................................ 50  5.25  TIF: TRAVELLER INFORMATION (PNRGOV) ............................................................................................ 52  5.26  TKT: TICKET NUMBER DETAILS (PNRGOV) ............................................................................................ 53  5.27  TRA: TRANSPORT IDENTIFIER ............................................................................................................................ 54  5.28  TRI: TRAVELLER REFERENCE INFORMATION (PNRGOV) ................................................................... 55 PADIS EDIFACT Implementation Guide – Table for Contents 5.29  TVL: TRAVEL PRODUCT INFORMATION (PNRGOV) .............................................................................. 56  5.28.1  Flight Details for Passenger data sent 56  5.28.2  Flight Itinerary 58  5.28.3  Codeshare information 60  5.28.4  Non Air Segments 62  5.30  TXD: TAX DETAILS (PNRGOV) .................................................................................................................... 64  6  CODE SETS .......................................................................................................................................................... 65  7  BUSINESS CASE EXAMPLES ........................................................................................................................... 66  8  ADDITIONAL IMPLEMENTATION GUIDELINES ...................................................................................... 69  8.1  TYPES OF PUSH AND PNR CANCELLATIONS ........................................................................................................ 69  8.1.1  Full PNR Push (PNRGOV) 69  8.1.2  Update PNR Push (PNRGOV) 69  8.1.3  Adhoc PNR Push (GOVREQ/PNRGOV) 69  8.2  ERROR HANDLING ............................................................................................................................................... 70  APPENDIX A – CONTRL MESSAGES ...................................................................................................................... 71  APPENDIX B – BUSINESS EXAMPLES .................................................................................................................... 73  1  EXAMPLE OF PNRS WITH INFANT, RESERVATION AND CHECK-IN DATA AND UNFORMATTED HISTORY ........................................................................................................................................................................ 73  2  EXAMPLE OF CODESHARE PNRS WITH RESERVATION AND CHECK-IN DATA AND UNFORMATTED HISTORY ....................................................................................................................................... 75  3  SIMPLE PNR BOOKED IN ANOTHER SYSTEM (NO PNR HISTORY) .................................................... 76  4  EXAMPLE WITH THREE PNRS CONTAINING TICKET INFORMATION ............................................ 77  5  EXAMPLE WITH ONE ADULT AND AN INFANT ....................................................................................... 80  ASSUMPTIONS: .............................................................................................................................................................. 80  6  PNR WITH FREQUENT TRAVELER (2 ADULTS) AND PNR SPLIT ........................................................ 81  ASSUMPTIONS: .............................................................................................................................................................. 81  7  EXAMPLES WITH DIFFERENT DATA IN EQN SEGMENT ...................................................................... 82  APPENDIX C – PADIS EDIFACT MESSAGE PROCESSING - BACKGROUND FOR PNRGOV USERS ..... 84  1  INTRODUCTION ................................................................................................................................................. 84  1.1  PURPOSE .............................................................................................................................................................. 84  1.2  SCOPE .................................................................................................................................................................. 84  1.3  BACKGROUND ..................................................................................................................................................... 84  1.4  REFERENCES ........................................................................................................................................................ 84  1.5  ASSUMPTIONS AND CONSTRAINTS ....................................................................................................................... 84  1.5.1  Assumptions 84  1.5.2  Constraints 84  1.6  DOCUMENT OVERVIEW ....................................................................................................................................... 85  2  EDIFACT ENVELOPE STRUCTURE .............................................................................................................. 86  2.1  THE INTERCHANGE ENVELOPE ............................................................................................................................ 86  2.2  THE FUNCTIONAL GROUP ENVELOPE .................................................................................................................. 86  2.3  THE MESSAGE ENVELOPE ................................................................................................................................... 86  3  PARSING & PROCESSING STEPS .................................................................................................................. 88 PADIS EDIFACT Implementation Guide – Table for Contents 4  ACKNOWLEDGEMENT RECOMMENDATIONS ........................................................................................ 90  4.1  TYPES OF ACKNOWLEDGEMENTS ........................................................................................................................ 90  4.1.1  Acknowledgement of Receipt 90  4.1.2  Acknowledgement of Processing 90  4.2  RECOMMENDATIONS ........................................................................................................................................... 90  5  EXAMPLES .......................................................................................................................................................... 94 PADIS EDIFACT Implementation Guide – PNRGOV Message 1. INTRODUCTION The purpose of this document is to describe the recommended usage of the Passenger and Airport Data Interchange Standards PNRGOV EDIFACT Message Standards. These messages are intended to facilitate the exchange of data relevant to government requirements on PNR data and Airlines reservation systems. This document was developed, and will be maintained, by the IATA/ATA PNRGOV Sub-Group in coordination with the Passenger and Airport Data Interchange Standards Reservations Sub-Group. This will be a living document and will be updated as necessary. If there are any changes to the message structure, the change process defined in the PNRGOV Principles Document should be followed. 1.1. PNRGOV MESSAGE VERSION RELEASE Version control will be handled in the following manner:  Message structure change requires a new version of the message and new version of the Implementation Guide.  Minor changes can be kept in the Errata document attached to a specific release of the Implementation Guide and eventually incorporated into the next new release and new version of the same.  Any text pending formal approval by the WCO API Contact Committee and/or the PADIS Board will be shaded in grey. 1.1.1 PROGRESSION LISTING This table lists all current PNRGOV EDIFACT messages and shows in which PNRGOV Implementation Guide document release a message was modified from its previous publication. A bold version release shows the first publication of that message. A minus "-" sign indicates the message was not modified in that particular version release of the Message Standards. TAG Version Release Progression PNRGOV 10.1 - 11.1 - 12.1 13.1 ACKRES 10.1 - 11.1 - 12.1 - GOVREQ - - - - 12.1 - 1.1.2 ERRATA An ERRATA sheet will be maintained for each release and will be stored on the IATA website along with the corresponding Implementation Guide.  Each entry in the Errata sheet will include a sequence number, date included in ERRATA, Implementation Guide paragraph reference, current text and/or problems description for charts, required change in text and/or change description for charts, reason for change, and who submitted the ERRATA item. .  Once an entry is made in Errata sheet, the PNRGOV group will receive a notification.  The Errata sheet is intended only for minor corrections. Issues which require debate by the group must be submitted, together with a proposed solution, as formal agenda items to a PNRGOV Working Group meeting.  Once changes are approved by the PNRGOV group, the group will notify WCO of changes made to the PNRGOV implementation guide. 1 PADIS EDIFACT Implementation Guide – PNRGOV Message 1.2. DOCUMENT STRUCTURE This document contains the following eight sections: Introduction Contains an overview and guidelines for use of the document. Message Relationships Describes the relationships between query messages and the expected response message for the different business functions listed. The function of a message can be modified, in some cases, by the use of data element 1225 in a MSG segment. This will be indicated as such in the message relationship section. Message Structure Shows in diagrammatic format each approved PADIS PNRGOV message. The diagrams show the construction of the message and the data segments used. The hierarchy of the segments is indicated by means of data levels. Service Segments Refer to the Architecture for IATA Interactive EDIFACT, and the ISO 9735 for United Nations Service Segments standards. For use in the PADIS Reservations environment, the service segments including the UNH have been described in greater detail in Section 4. Data Segments Lists in alphabetical order all data segments that are part of the messages contained in this document. For each segment there will be a list of the composites and data elements used to construct the segment and an indication of how these elements are commonly used. To cater for different business requirements, there may be multiple definitions of the same data segment. Examples For every business function listed there will be at least one example of the data to be transmitted. No response is anticipated except for an acknowledgement that the message has been received. States’ Legal Requirements Each States legal requirements will be listed separately including a mapping to the PNRGOV Message structure where the information is held. This information will be mapped out to segment and element level. The same information may be found in different places, depending on the structure and contents and how this is stored in different reservation systems. The IATA PNRGOV Principles Document contains a recap of the governments requirements. Additionally, IATA maintains a copy of the legislation on their API-PNR World Tracker extranet site. Use the following link to access this information: Link for already registered users: https://extranet2.iata.org/sites/facilitation/Lists/API%20World%20Tracker/By%20Country.aspx Link to register for access to the FAL extranet site containing the API-PNR World Tracker: http://www2.iata.org/registration/getemailpage.aspx?siteurl=facilitation Appendices As necessary, appendices will be added to the Implementation Guide. Appendix A – contains details concerning the UN CONTROL message (Syntax and Service Report). Appendix B – contains detailed business examples from a number of airlines. Appendix C – contains PADIS EDIFACT Message Processing - Background for PNRGOV Users 1.3. HOW TO USE THIS DOCUMENT The PNRGOV, ACKRES and GOVREQ messages are currently the only EDIFACT Message documented in this Implementation guide. The guide contains complete description of the Message Structure, segments and elements with notes and examples. 2 PADIS EDIFACT Implementation Guide – PNRGOV Message 1.4. GUIDELINES AND RULES For all implementation guide additions and updates to Section 5 (Segments), the following rules apply to the format and contents, including definitions of special notations: 1. Data segments appear for each business function in Section 5.0. 2. If the information is the same for multiple business functions, the data segment will not be repeated. 3. If an 'N/A' appears in the 'Mandatory/Conditional' column, it indicates that the composite element or data element is conditional in the PADIS Message Standards, but for this function no applicable use has been identified. In such cases, all columns of the chart are completed, except “Common Usage”, “Code Set” and “Comments”. “Common Usage” and “Code Set” columns are marked “--” and the “Comments” column is left blank. If a composite is conditional and all component data elements are N/A, the composite is shown as N/A. If the composite is N/A, then all the component data elements will be shown as N/A. 4. If a composite or data element is defined as conditional in the IATA approved message but must be mandatory to complete a business function, the composite or data element will be indicated with a M for mandatory along with an asterisk (*). The M* will indicate the status differs from the PADIS Message Standard. 5. All elements marked as “C” (conditional) or as “M” or “M*” (mandatory) will have all columns of the charts completed as appropriate. When an element has multiple occurrences and is marked as M or M*, the first occurrence is considered mandatory and subsequent occurrences are considered conditional. 6. Where a State’s requirements differ for “Conditional” fields from the standard implementation guide, a separate supplemental document will be provided by the State(s) detailing which “Conditional” fields are “Mandatory” for that State. Provisions in paragraphs 1.5.1 and 1.5.2 of the “Principles, Functional and Business Requirements PNRGOV” shall be respected. These differing requirements will not change the structure of the message. 7. Where a State’s requirements differ from the standard implementation guide, a separate supplemental document will be provided by the State(s). This will not change the structure of the message. 8. If an element is a coded value, “Yes” is indicated in the “Code Set” column. If it is not a coded value, the column is marked “--”. 9. In general, dates and times are expressed in local time except where specifically noted; such as, the UNB where the time will be expressed in Greenwich Mean Time (GMT) or Universal Time Coordinated (UTC). Where GMT is specified in the examples, UTC equally applies. However, due to different systems criteria, the subject of date/times in various fields from various sources (e.g., centralized reservations and DCS for local vs. centralized system) should be addressed in the bilateral discussions between governments/airlines/system providers. . 10. The ”Field Type” refers to the field length as defined within the message and should match the value indicated in the most current PADIS Message Standards document. 11. “Common Usage” refers to the length and characteristics typically used to define that data element. This information is used to show how a data element should be used for this segment within the travel industry. Because existing data elements were used to create certain elements, the ”Field Type” characteristics exceed the actual requirements of the data element. “Common Usage” exists to better define the characteristics of the data element. This column should be consistent with similar elements. 12. The “Comments” column will use consistent wording for the same elements across the segments if they are used in the same way. 13. Each segment is followed by “Notes” (if applicable) and by segment examples. However, “Notes” are only included if they are necessary to explain the usage. 3 PADIS EDIFACT Implementation Guide – PNRGOV Message 14. Each segment and message will have enough examples to show the standard usage as defined by the PADIS group. 15. For numeric fields, see reference Part 1 ISO 9735 Syntax Rules, Section 10. 16. The full stop ( period .) or the comma (,) is allowed to represent the decimal mark. Either is acceptable within the interchange but both cannot be used in the same interchange. 17. The length of a numeric data element value shall not include the minus sign (-), the decimal mark (.), or the exponent mark (E or e). 18. When a decimal mark is used, there shall be at least one digit after the decimal mark. 19. When a segment appears at more than one level, it is reflected only once, with composites and data elements conditional as applicable. 20. The first segment in a group is mandatory and is the segment that triggers the group. Some trigger segments may be exchanged without data. In such cases these are noted with a pound (#) sign in the message diagram segment list in Section 3.2 21. For the purpose of the PNRGOV documentation all Airlines are referred to as Carriers and all governments are referred to as States. 1.5. CODE SETS Codes used in codesets are used to define the values for the relevant business item. All codesets utilized in the PNRGOV message are defined in the PASSENGER AND AIRPORT DATA INTERCHANGE STANDARDS - Codeset Directory. If additional codes are required, requests should be submitted to the PADIS Reservation Sub-group for approval prior to them being submitted in the PADIS Board vote for inclusion in the standards. 1.6. REFERENCES The following documents may be used as additional references to the PNRGOV Iimplementation Guide:  IATA PNRGOV Principles Document  IATA PASSENGER AND AIRPORT DATA INTERCHANGE STANDARDS - MESSAGE STANDARDS DOCUMENT  IATA PADIS EDIFACT and XML Codeset  IATA Reservations Interline Message Procedures – Passenger (AIRIMP)  IATA Passenger Services Conference Resolutions Manual (PSCRM)  IATA Airline Coding Directory  ISO 9735 – Version 4  IATA SYSTEMS AND COMMUNICATIONS REFERENCE, VOLUME 6 – INTERACTIVE EDIFACT ARCHITECTURE Definitions of common terms used within the airline industry can be found on the IATA website by accessing the IATA website as follows: 1. Go to the home page www.iata.org 2. Do a search on the word “glossary” 3. Download the spreadsheet entitled “passenger-glossary-of-terms.xls” 4