OpenTravel Alliance Message Users Guide 2016A, Version 1, June 2016 The OpenTravel Alliance (OpenTravel) offers this publication for use at the discretion of the individual or com- pany. Each individual or company that uses this material does so at its own risk and with the acknowledgment that the individual or company is solely and fully responsible for its use of this material. Intellectual Property Statement: OpenTravel is a travel industry community effort to develop voluntary XML-based communications specifications and thereby facilitate the use of electronic commerce in our industry. These specifications are developed through a consensus building process that encourages the active participation of all Member Companies’ representatives. Suggestions made at OpenTravel meetings are therefore likely to be included in OpenTravel specifications. Member companies and potential member companies should be aware of this and closely review the membership agreement. OpenTravel is the owner of OpenTravel specifications, and each member company grants the OpenTravel Alliance the right to sublicense to other member companies, their affiliates, and end users, a non-exclusive, royalty-free license as defined in the membership agreement. --------------------------------------------------------------------------- © 2016, OpenTravel Alliance. All rights reserved. OpenTravel is a trademark of the OpenTravel Alliance. Contents Introduction and Getting Started with the OpenTravel Specification ..................................................... 21 Introducing the OpenTravel Alliance ................................................................................................................. 21 OpenTravel Alliance Resources ........................................................................................................................ 21 OpenTravel Specification Components ............................................................................................................. 22 Basic OpenTravel Schema Concepts ......................................................................................................... 23 OpenTravel Schema Design Best Practices ..................................................................................................... 23 OpenTravel Message Exchange Patterns......................................................................................................... 23 Request/Response Pattern ........................................................................................................................... 23 Notif Pattern .................................................................................................................................................. 23 Generic Messages ........................................................................................................................................ 24 Payload Transaction Management .................................................................................................................... 24 OpenTravel File Naming Conventions .............................................................................................................. 26 OpenTravel Code Lists and Enumerations ....................................................................................................... 26 External Code Lists ........................................................................................................................................... 27 External Codes Lists & Other References in OpenTravel Schema .............................................................. 27 OpenTravel Message Success, Warnings & Errors Elements .......................................................................... 28 Schema Architecture ......................................................................................................................................... 29 Understanding OpenTravel Schema Architecture......................................................................................... 29 OpenTravel Message Level Schema ............................................................................................................ 30 OpenTravel Industry Common Types Schema ............................................................................................. 30 OpenTravel Common Types Schema ........................................................................................................... 30 OpenTravel Simple Types Schema............................................................................................................... 30 OpenTravel Message Transport .................................................................................................................. 31 Introduction ........................................................................................................................................................ 31 Definitions & Conventions ................................................................................................................................. 31 State Maintenance ............................................................................................................................................. 31 SOAP Messaging .............................................................................................................................................. 32 Purpose ......................................................................................................................................................... 32 The SOAP Transport Protocol ...................................................................................................................... 32 The Need for Interoperability ........................................................................................................................ 33 Guidelines for OpenTravel Documents & Messages ........................................................................................ 35 SOAP Version 1.1 and 1.2 ............................................................................................................................ 35 SOAP Messaging and SOAP RPC ................................................................................................................... 36 Differences between SOAP Messaging and SOAP RPC ............................................................................. 36 WSDL Document/ Literal Binding ................................................................................................................. 36 --------------------------------------------------------------------------- © 2016, OpenTravel Alliance. All rights reserved. OpenTravel is a trademark of the OpenTravel Alliance. SOAP Messaging Benefits ............................................................................................................................ 37 SOAP Messaging vs. RPC Guidelines ......................................................................................................... 37 SOAP Action URI .......................................................................................................................................... 37 SOAP Messaging and the SOAP Action URI................................................................................................ 37 SOAP Intermediaries .................................................................................................................................... 37 SOAP Action URI Guidelines ........................................................................................................................ 38 SOAP Envelope Content .............................................................................................................................. 38 SOAP Header Content .................................................................................................................................. 38 SOAP Body Content ..................................................................................................................................... 39 SOAP Attachments ....................................................................................................................................... 39 SOAP Fault vs. OpenTravel Error ................................................................................................................. 39 Examples ...................................................................................................................................................... 40 HTTP Messaging ............................................................................................................................................... 50 Background ................................................................................................................................................... 50 The Need for Interoperability ........................................................................................................................ 50 GENERIC MESSAGES .................................................................................................................................. 56 Messages Overview .......................................................................................................................................... 56 Messages List ................................................................................................................................................... 56