SWS Developer Guide

  • View
    128

  • Download
    3

Embed Size (px)

DESCRIPTION

SWS Developer Guide

Transcript

  • 1

    Sabre Web Services

    Guide to Accessing and Consuming Services

    October 18, 2013 v1.38

  • Sabre Web Services - Guide to Accessing and Consuming Services, v1.38 Page 2 Sabre Holdings Inc. Confidential

    Sabre Web Services: Guide to Accessing and Consuming Services, October 30, 2012 v1.37

    2003-2012 Sabre Holdings Inc. All rights reserved.

    This documentation is the confidential and proprietary information of Sabre Inc. Any unauthorized use,

    reproduction, preparation of derivative works, performance, or display of this document, or software

    represented by this document, without the express written permission of Sabre Inc., is strictly prohibited.

    Sabre, Sabre Holdings, Sabre Travel Network, and Sabre Web Services are trademarks and/or service

    marks of an affiliate of Sabre Holdings Corporation. All other trademarks, service marks, and trade names

    are the property of their respective owners.

    Disclaimer of Warranty and Limitation of Liability

    This software and any compiled programs created using this software are furnished as is without

    warranty of any kind, including but not limited to the implied warranties of merchantability and fitness for a

    particular purpose. No oral or written information or advice given by Sabre, its agents or employees shall

    create a warranty or in any way increase the scope of this warranty and you may not rely on any such

    information or advice.

    Sabre does not warrant, guarantee, or make any representations regarding the use, or the results of the

    use, of this software, compiled programs created using this software, or written materials in terms of

    correctness, accuracy, reliability, currentness, or otherwise. The entire risk as to the results and

    performance of this software and any compiled applications created using this software is assumed by

    you. Neither Sabre nor anyone else who has been involved in the creation, production or delivery of this

    software shall be liable for any direct, indirect, consequential, or incidental damages (including damages

    for loss of business profits, business interruption, loss of business information, and the like) arising out of

    the use of or inability to use such product even if Sabre has been advised of the possibility of such

    damages.

    Sabre Holdings Inc. 3150 Sabre Drive, Southlake, TX 76092 Tel: 682 605 1000 www.sabre-holdings.com

  • Sabre Web Services - Guide to Accessing and Consuming Services, v1.38 Page 3 Sabre Holdings Inc. Confidential

    Table of Contents

    Preface ...................................................................................................................................................... 5

    Sabre Web Services Resources ........................................................................................................................... 9

    Sabre Web Services Usage Requirements ....................................................................................................... 11

    External Resources ............................................................................................................................................... 14

    Technical Support .................................................................................................................................................. 16

    Chapter 1: Introduction to Sabre Web Services ....................................................................................... 17

    About Sabre Web Services .................................................................................................................................. 18

    Types of Web Services ......................................................................................................................................... 18

    Standards and Specifications .............................................................................................................................. 22

    Requesting Payload Content ............................................................................................................................... 26

    Security ................................................................................................................................................................... 26

    Network Connectivity ............................................................................................................................................ 28

    Sabre Web Services Connections ...................................................................................................................... 28

    Errors ....................................................................................................................................................................... 29

    Chapter 2: SOAP Formats/Requirements ................................................................................................ 30

    SOAP Message Overview .................................................................................................................................... 30

    SOAP Message Sequence and Format ............................................................................................................. 34

    Chapter 3: Sabre XML ............................................................................................................................. 55

    WSDL Documents for Sabre XML ...................................................................................................................... 55

    Sabre XML Schemas ............................................................................................................................................ 62

    Technologies for Working with Web Services ................................................................................................... 66

    Versioning of Sabre XML Schema and WSDL Documents ............................................................................ 69

    Chapter 4: Connection Management ....................................................................................................... 73

    Sabre Web Services Connections ...................................................................................................................... 73

    Connection Management Messages .................................................................................................................. 74

    Chapter 5: Business and Application Logic .............................................................................................. 97

    Maintaining Session State .................................................................................................................................... 97

    Sabre Web Services Workflows ........................................................................................................................ 101

  • Sabre Web Services - Guide to Accessing and Consuming Services, v1.38 Page 4 Sabre Holdings Inc. Confidential

    Minimizing Scans ................................................................................................................................................. 103

    Chapter 6: Sabre Web Services Environments ...................................................................................... 104

    Chapter 7: Common Error Responses/Corrective Actions ..................................................................... 106

    Appendix A: SOAP Field Size Quick Reference .................................................................................... 112

    Appendix B: Identifying Documents for Sabre Web Services ................................................................. 114

    Appendix C: Sample Travel Workflows .................................................................................................. 118

    Glossary ................................................................................................................................................ 122

  • Sabre Web Services - Guide to Accessing and Consuming Services, v1.38 Page 5 Sabre Holdings Inc. Confidential

    Preface

    About This Guide

    This document provides guidance in developing, accessing, and consuming Sabre Web

    Services.

    Caution

    When a client or solution books travel arrangements utilizing a URL that resolves to

    the back-end production system, the transactions are recorded in the live, production

    Sabre system, and real-time inventory is decremented. This applies to the following

    URL:

    https://webservices.sabre.com/websvc

    Please be sure to cancel any bookings created for test purposes. If these bookings

    are not canceled, you and possibly your customers will be billed by suppliers or other

    vendors for all associated fees.

    Scan charges may apply whenever a client application interacts with any of the

    environments established for Sabre Web Services. Please consult your contract for a

    description of these charges. For tips on minimizing scans please refer to the section

    of this document titled, Minimizing Scans.

    Advisories

    To assist with capacity planning, advanced notification is required for the following

    activities.

    Performance and heavy load testing. These types of tests require notification a

    minimum of 5 business days before conducting the tests.

    Planned production dates and projected volumes. Notification must be a minimum of 120 business days p