25
OVERVIEW GetThere ERP WebServices USER GUIDE

OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

  • Upload
    others

  • View
    14

  • Download
    0

Embed Size (px)

Citation preview

Page 1: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

OVERVIEW

GetThere ERP WebServices

USER GUIDE

Page 2: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

DOCUMENT REVISION INFORMATION

The following information is to be included with all versions of the document.

Project Name GetThere ERP Web Services Feature ID

Prepared by Chris Simiele Date Prepared March 10, 2009

Revised by Andrew Smillie Date Revised September 25

Revision Summary Updates Revision Control No.

Revised by Andrew Smillie Date Revised August 6, 2015

Revision Summary Updates to Itinerary Services Revision Control No.

Revised by Andrew Smillie Date Revised November 18, 2015

Revision Summary Added ConnectionIndicator explanation Revision Control No.

Revised by Date Revised

Revision Summary Revision Control No.

Revised by Date Revised

Revision Summary Revision Control No.

Revised by Date Revised

Revision Summary Revision Control No.

Revised by Date Revised

Revision Summary Revision Control No.

Revised by Date Revised

Revision Summary Revision Control No.

Revised by Date Revised

Revision Summary Revision Control No.

Revised by Date Revised

Revision Summary Revision Control No.

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved i

Page 3: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document. 1 I n t r o d u c t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Objective ........................................................................................................................... 2

1 I t i n e r a r y D a t a W e b S e r v i c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.1 Features/Functions ........................................................................................................ 3 1.1.1 Retrieve List of Itinerary Locators ................................................................................... 3 1.1.1.1 Retrieve List of Itinerary Locators Data Elements ............................................................ 3 1.1.2 Retrieve Itinerary Data ................................................................................................. 4 1.1.2.1 Retrieve Itinerary Data Elements ................................................................................. 5 1.2 Process Flow ................................................................................................................ 5 1.3 Itinerary Status.............................................................................................................. 6 1.3 Features/Functions Is/Is Not ............................................................................................ 8 1.4 Assumptions and Constraints (includes external dependencies) .............................................. 8 1.5 Dependencies .............................................................................................................. 8

2 T r a v e l e r P r o f i l e S y n c h r o n i z a t i o n S e r v i c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.1 Features/Functions ........................................................................................................ 9 2.1.1 UDUT – Bulk Uploads .................................................................................................. 9 2.1.2 Profile Synchronization Web Service ............................................................................... 9 2.1.3 Data Examples ........................................................................................................... 9 2.1.4 Sample Web Service Data Examples ............................................................................ 11 2.1 Features/Functions Is/Is Not .......................................................................................... 16 2.2 Assumptions and Constraints (includes external dependencies) ............................................ 16 2.3 Dependencies ............................................................................................................ 16

A p p e n d i x 1 I t i n e r a r y D a t a W e b S e r v i c e F l o w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 A p p e n d i x 2 D a t a F i e l d L i s t f o r T r a v e l I t i n e r a r y R e a d . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 A p p e n d i x 3 B o o k i n g D a t a S e r v i c e U R L ’ s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2 G l o s s a r y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 3 STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Introduction 1

Page 4: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

1 Introduction

O b j e c t i v e

This document will describe the following features: Itinerary Data Web Service – allow read-only access to itinerary data from the GetThere Database. Traveler Profile Synchronization Service – allow the synchronization of Travel Profiles between a customer ERP installation and the GetThere Booking Tool/User Profile.

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Introduction 2

Page 5: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

1 Itinerary Data Web Service

This section will describe the Itinerary Data Web Service and the work flow for accessing itinerary detail data in a pseudo-batch mode.

1.1 F e a t u r e s / F u n c t i o n s

The Itinerary Data Web Service will allow read-only access to itinerary data. The GetThere database is the source for the itinerary data.

There will be two web services. Retrieve List of Itinerary Locators will allow the customer ERP installation to

get a list of itinerary locators for itineraries created or updated in a time window. Retrieve Itinerary Data will

get itinerary detail information.

New bookings made online (through the GetThere Booking Tool) and offline bookings made in Sabre, Apollo,

Galileo, Amadeus or Worldspan (if acquired by GetThere) will be supported. The EmployeeNumber will only be

supported for offline bookings (if acquired by GetThere) for Apollo and Sabre GDS customers.

The login credentials required for each customer ERP installation to authenticate with the Itinerary Data Web

Service must be requested from GetThere prior to implementation. As the credentials assigned will allow access

to the appropriate main or subsite, GetThere will determine the User ID.

1 . 1 . 1 R e t r i e v e L i s t o f I t i n e r a r y L o c a t o r s

The customer ERP installation sends a request to read a list of itinerary locators through a GetThere Web

Service. The request contains the site information and start time in a WSDL provided by GetThere. Itinerary

locators for bookings created/updated up to 1 hour after the requested start time or the current time (whichever

comes first) will be returned. The customer ERP installation must track the time start returned by the last

request. The LocatorRead response XML will increment the timestamp passed in the request by one hour and

return that to the provider in the field NextStartTime.

1 . 1 . 1 . 1 R e t r i e v e L i s t o f I t i n e r a r y L o c a t o r s D a t a E l e m e n t s

The following are data elements in the web service request.

Note: Please refer to the XML schema for GT_ERP_TravelItinerarayLocatorReadRQ

Field Name Required Maximum Data Type Maximum Description

Quantity Length

SubSiteName N 1 Alpha / 32 The unique subsite name assigned to numeric the customer.

SystemID N 1 Alpha / 8 External system identifier. numeric

ClientID N 1 Alpha / 3 External client identifier.

numeric

IncludeSubSite N 1 Boolean true or Include all bookings made in the

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Itinerary Data Web Service 3

Page 6: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

false subsite.

UtcTime Yes 1 Timestam Time zone of the timestamp is in

p Coordinated Universal Time (UTC).

The following are data elements in the web service response.

Note: Please refer to the XML schema for GT_ERP_TravelItinerarayLocatorReadRS

Note: Itinerary locators for the booking created/updated in the next hour from startTime will be sorted by time.

Field Name Quantity Data Type Maximum Description

Length

UtcTime 1 Timestamp Time zone of the timestamp is in Coordinated Universal Time (UTC).The

start time for the next request. This will be

equal to the startTime in the request plus

one hour.

Count 1 Numeric Number of itinerary locators in the response.

ID 0 to many Alpha / 32 The GetThere assigned record locators for

numeric and the trips.

a slash (/)

SubSiteName 0 to 1 Alpha / 32 The unique subsite name assigned to the numeric customer.

SystemID 1 Alpha / 8 External system identifier.

numeric

ClientID 1 Alpha / 3 External client identifier.

numeric

1 . 1 . 2 R e t r i e v e I t i n e r a r y D a t a

The customer ERP installation sends a request to retrieve itinerary data through a Sabre Web Service interface. The request contains the itinerary locator(s) in a WSDL provided by GetThere.

The following are data elements in the web service request.

Note: Please refer to the XML schema for GT_ERP_TravelItinerarayReadRQ

Note: The number of locators allowed in the request is 10 STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Itinerary Data Web Service 4

Page 7: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Field Name Required Maximum Data Type Maximum Description

Quantity Length

ID Yes 1 to 10 Alpha / 32 The GetThere assigned record locator

numeric for the trip.

1 . 1 . 2 . 1 R e t r i e v e I t i n e r a r y D a t a E l e m e n t s

For data elements in the web service response, please see the XML schema for

GT_ERP_TravelItinerarayReadRS. The Sabre version of the OTA schema has been used as the basis of itinerary

data.

The GetThere database will serve as the master source of the itinerary data. Itinerary data elements include, but are not limited to:

Itinerary Identifier

Air Segments

Car Segments – including approximate total price and currency

Hotel Segments – including hotel room rate and currency

Rail Segments

Passenger Information

Pricing – including base air fare, total taxes, total fare and currency

Travel Policy Compliance

1.1.1.1 ConnectionIndicator

Air Segments are returned in chronological order. As they are processed, when you come across your first

“ConnectionIndicator=O” means you are at the start of a connecting flight. The next value you should see for the

next flight is a ConnectionIndicator=I. The value “I” also indicates that the previous segment is married to it and

it represents the final stop for that segment.

If it’s a nonstop flight you will not see any value for ConnectionIndicator regardless of whether that non stop is a oneway or embedded in a roundtrip or multi-destination.

If it’s a mulit-destination flight again you will see a ConnectionIndicator=O and ConnectionIndicator=I if the flight segment is not a non-stop.

If there is a leg with multi-segments (multi-stops), you will see ConnectionIndicator=I, ConnectionIndicator=IO, and ConnectionIndicator=I.

Oneway with no stops:

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Itinerary Data Web Service 5

Page 8: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

No ConnectionIndicator returned Oneway with 1 stop ConnectionIndicator=I, ConnectionIndicator=O Roundtrip with no stops: No ConnectionIndicator returned Roundtrip with 1 stop (either way): ConnectionIndicator=I, ConnectionIndicator=O MultiDestination ConnectionIndicator=I, ConnectionIndicator=O with a leg with 1 stop No connectionindicator if the leg is a non stop If there are 2 stops, ConnectionIndicator=I, ConnectionIndicator=IO, and ConnectionIndicator=I. How do I know where my destination is? If you process Air Items in the XML when you receive an Arrival Airport with no ConnectionIndicator that is the

Destination. If you receive an Arrival Airport with a ConnectionIndicator=O then that is a stop on the inevitable

destination. You will usually receive another Arrival Airport right after with a ConnectionIndicator=I and that

will be the final stop. If you receive an ConnectionIndicator=IO then there will be another Connection = I to

finalize the trip. Multi-Destinations are just that; trips with multi destinations. The traveler has more than destination in the trip. So the same rules apply as above.

1 . 2 P r o c e s s F l o w

The Itinerary Data Web Service process flow is shown in Appendix 1.

1 . 3 I t i n e r a r y S t a t u s

Itinerary status will be returned in the GT_ERP_TravelItineraryRead field called “ItineraryStatus”. The list of

status that can be obtained are below. It is important for the provider to note that PNR’s with either “Past Date”,

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Itinerary Data Web Service 6

Page 9: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Cancelled, Queued, or Archived status will return XML with very little trip data. The reason for that is that GetThere has moved the data to a “historical” table in its database. PNR’s with the status’s of Past Date,

Queued, or Archived can be ignored by the integrating system. PNR’s with a status of Cancelled should be taken

note of as the status is important to be aware of.

Status Meaning

Active A trip that has been “reserved” with the supplier

but not yet ticketed/confirmed.

On Hold A trip that has been placed on hold via the

applicable GT Feature - Hold Trips

Suspended A trip that has been placed on Suspend via the

applicable GT Feature - Suspended Bookings

Ticketed A trip that has been ticketed - based on the

ticketing field in GDS

Queued We are not able to access the PNR successfully.

Archived we can no longer access this PNR in the GDS.

How soon a PNR is archived varies from GDS to

GDS, but definitely after the last departure date.

For these two statuses, no trip detail will be

displayed:

Cancelled A trip that has been cancelled . It could have

been cancelled before or after the PNR was

ticketed

Past Date A trip whose travel dates have passed.

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Itinerary Data Web Service 7

Page 10: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

1 . 3 F e a t u r e s / F u n c t i o n s I s / I s N o t

IS IS NOT

A Web Service to retrieve booking data from A web service to update itineraries.

the GetThere Database.

A way to retrieve data from a GDS.

1 . 4 A s s u m p t i o n s a n d C o n s t r a i n t s ( i n c l u d e s e x t e r n a l d e p e n

d e n c i e s )

A1. Support will be for single passenger itineraries only. C1. None identified at this time.

1 . 5 D e p e n d e n c i e s

D1. None identified at this time.

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Itinerary Data Web Service 8

Page 11: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

2 Traveler Profile Synchronization

Service This section will describe the GetThere Traveler Profile Synchronization Service.

2 . 1 F e a t u r e s / F u n c t i o n s

The Traveler Profile Synchronization Service will allow the synchronization of Traveler Profiles between a

customer ERP installation and the GetThere Booking Tool/User Profile. When used in conjunction with GetThere

Profile Synchronization, the updates can be sent to profiles in the GDS. The customer ERP installation is

considered the master record for the profiles. There are two processes. The GetThere Traveler Profile Web Service allows the customer ERP installation to

place incremental traveler profile changes into the GetThere Booking Tool User Profile. The GetThere User

Data Upload Tool (UDUT) will allow large batch updates or the initial load during a customer implementation.

Both processes offer add, update and delete functionality. No profile updates are pushed from the GetThere Booking Tool User Profile to the customer ERP installation.

2 . 1 . 1 U D U T – B u l k U p l o a d s

The UDUT (User Data Upload Tool) is available to administrators of a GetThere site who have a security level of SubSite Administrator or higher. The tool is accessible from the GetThere site’s administrative pages. The administrator creates a CSV file, accesses the UDUT through the Site Administration pages of the GetThere

site and uploads the file. The file is processed and an e-mail sent to advise the upload has completed and if any

validation errors were found. Processing times vary depending on the size of the file. Complete instructions and sample templates are available in the Database Uploads section of site’s administrative pages.

2 . 1 . 2 P r o f i l e S y n c h r o n i z a t i o n W e b S e r v i c e

The customer ERP installation can send incremental updates to the GetThere Booking Tool through Sabre Web Services. The request contains the profile data in a WSDL provided by GetThere. The login credentials required for each customer ERP installation to authenticate with the Profile

Synchronization Web Service must be requested from GetThere prior to implementation. As the credentials

assigned will allow access to the appropriate main or subsite, GetThere will determine the User ID.

2 . 1 . 3 D a t a E x a m p l e s

The following are required data fields. STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved 2 Traveler Profile Synchronization Service 9

Page 12: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Web Service UDUT Maximum Range Data Type Maximum Description

Field Name Field Quantity of “n” Length

Name

siteName 1 Alpha / 32 Unique main site name for

numeric the customer

subSiteName sub_site 1 Alpha / 32 Unique subsite to which the

numeric traveler is assigned

LoginID user 1 Alpha / 40 The GetThere user id of the

numeric traveler.

PasswordHash pwd 1 Alpha / 64 The password field is

numeric required by the UDUT to

create/add new users.

However, the web service

will accept an empty string.

UniqueID This 1 0 Alpha / 32 The unique customer

will be numeric identifier.

the CFE

created

on the

site.

Examples of how these fields apply to GetThere: Site/SubSite: Widget Inc. is a corporation with offices in the US, Canada and the UK. They create a main site – widget. Due

to different settings or requirements for different countries, they create three subsites named widgetus, widgetca

and widgetuk. This means there are four sites that can be logged into by a user from one URL. http://wx1.getthere.net/ssologin.act?sitename=widget 1. widget 2. widget: widgetus 3. widget: widgetca 4. widget: widgetuk Upon login the traveler will be directed to the main site or subsite to which they were assigned when their user ID was created. The site name does not have to include the name of the corporation. Widget could have used any name they wanted, provided it is not already in use by another site.

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved 2 Traveler Profile Synchronization Service 10

Page 13: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

2 . 1 . 4 S a m p l e W e b S e r v i c e D a t a E x a m p l e s

Incremental Profile changes after an implementation take place using a GetThere provided web service. The login

credentials required for each customer ERP installation to authenticate with the Profile Synchronization Web

Service must be requested from GetThere prior to implementation. The web service passes a standard SOAP

envelope over HTTPS which contains a Traveler Profile Document Upload request. The format of the Traveler

Profile Document Upload request is detailed in a separate WSDL. The following name convention and assignments will be used in the SessionCreate request.

Field Assign

Domain GetThere

Organization The main site name as it appears in the database.

The main site name as it appears in the database if they want

access to bookings or profiles on the main site.

Username

The subsite name as it appears in the database if they want

access to bookings or profiles on the subsite.

GtItineraryListUser – if the Corporate Expense system will be

using the Itinerary Data Web Services.

GtProfileUpdateUser – if the Corporate Expense system will

Security Attributes be using the Traveler Profile Synchronization Service.

USGSessionUser – always assign.

Password Assign a secure password

Profile Service Requests are stateless and do not require the customer ERP installation to create and maintain a session. All action takes place within one request. Example: Widget Inc. wants to send a request to add a new employee’s Travel Profile to the GetThere Booking tool. Frederic Finc is a new employee. His address of 3153 Primus St., Anytown, CA 98000 along with other information is sent to GetThere. SOAP Header (with authentication): <soapenv:Envelope xmlns:soapenv=” http://schemas.xmlsoap.org/soap/envelope/”

xmlns:xsd=” http://www.w3.org/2001/XMLSchema” xmlns:xsi=”

http://www.w3.org/2001/XMLSchema-instance”> <soapenv:Header>

<ns1:MessageHeader xmlns:ns1=” http://www.ebxml.org/namespaces/messageHeader”>

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved 2 Traveler Profile Synchronization Service 11

Page 14: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

<ns1:From>

<ns1:PartyId>

org.ebxml.www.namespaces.messageHeader.PartyId@1

</ns1:PartyId>

</ns1:From>

<ns1:To>

<ns1:PartyId>

org.ebxml.www.namespaces.messageHeader.PartyId@1</ns1:PartyId>

</ns1:To>

<ns1:CPAId></ns1:CPAId>

<ns1:ConversationId>SampleSession</ns1:ConversationId>

<ns1:Service>org.ebxml.www.namespaces.messageHeader.Service@1</ns1:Service>

<ns1:Action>SessionCreateRQ</ns1:Action>

<ns1:MessageData>

<ns1:MessageId> mid:20001209-133003-

[email protected]</ns1:MessageId>

<ns1:Timestamp>0108-10-03T09:27:23</ns1:Timestamp>

</ns1:MessageData>

</ns1:MessageHeader>

<ns2:Security xmlns:ns2=” http://schemas.xmlsoap.org/ws/2002/12/secext”>

<ns2:UsernameToken>

<ns2:Username>WidgetID</ns2:Username>

<ns2:Password>WidgetPassword</ns2:Password>

<Organization> Widget </Organization>

<Domain>GetThere</Domain></ns2:UsernameToken>

</ns2:Security> </soapenv:Header> <soapenv:Body>

<SessionCreateRQ xmlns=” http://www.opentravel.org/OTA/2002/11”> <POS> <Source PseudoCityCode="Widget"/> </POS> </SessionCreateRQ>

</soapenv:Body> </soapenv:Envelope>

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved 2 Traveler Profile Synchronization Service 12

Page 15: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

SOAP Body (with payload):

<soapenv:Envelope xmlns:soapenv=http://schemas.xmlsoap.org/soap/envelope/ xmlns:xsd=http://www.w3.org/2001/XMLSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soapenv:Header>

<ns1:MessageHeader

xmlns:ns1="http://www.ebxml.org/namespaces/messageHeader">

<ns1:From>

<ns1:PartyId>org.ebxml.www.namespaces.messageHeader.PartyId@1</ns1:PartyId>

</ns1:From>

<ns1:To>

<ns1:PartyId>org.ebxml.www.namespaces.messageHeader.PartyId@1</ns1:PartyId>

</ns1:To>

<ns1:CPAId> </ns1:CPAId>

<ns1:ConversationId> </ns1:ConversationId>

<ns1:Service ns1:type="OTA">

org.ebxml.www.namespaces.messageHeader.Service@132fd</ns1:Service>

<ns1:Action>EPS_ProfileUpdateRQ</ns1:Action>

<ns1:MessageData>

<ns1:MessageId>mid:[email protected]</ns1:MessageId>

<ns1:Timestamp>0108-10-03T09:40:22</ns1:Timestamp>

</ns1:MessageData>

</ns1:MessageHeader>

<ns2:Security xmlns:ns2="http://schemas.xmlsoap.org/ws/2002/12/secext">

<ns2:BinarySecurityToken>Shared/IDL:IceSess\/SessMgr:1\.0.IDL/Common/!ICESMS\/ STSB!ICESMSLB\/STS.LB!-4372486512836087744!1099129!0</ns2:BinarySecurityToken>

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved 2 Traveler Profile Synchronization Service 13

Page 16: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

</ns2:Security>

</soapenv:Header>

<soapenv:Body>

<Sabre_OTA_ProfileUpdateRQ IgnoreDataErrors="Y"

UpdateByDataSourceInfo="Y"

Version="1"

xmlns="http://www.sabre.com/eps/schemas">

<ProfileInfo>

<Profile CreateDateTime="2008-11-19T15:40:27.959Z"

UpdateDateTime="2008-11-19T15:40:27.959Z">

<Traveler>

<Customer>

<PersonName>

<GivenName>Frederick</GivenName>

<MiddleName>P</MiddleName>

<SurName>Fink</SurName>

<DataSource PrimaryDS="GT" />

</PersonName>

<Telephone DeviceTypeCode="VC" PurposeCode="ALL">

<FullPhoneNumber>555-232-3232</FullPhoneNumber>

<DataSource PrimaryDS="GT" />

</Telephone>

<Telephone DeviceTypeCode="VC" PurposeCode="ALL">

<FullPhoneNumber>555-232-4242</FullPhoneNumber>

<DataSource PrimaryDS="GT" />

</Telephone>

<Telephone DeviceTypeCode="FX" PurposeCode="ALL">

<FullPhoneNumber>555-323-5252</FullPhoneNumber>

<DataSource PrimaryDS="GT" />

</Telephone>

<Email EmailAddress="[email protected]" EmailTypeCode="BUS">

<DataSource PrimaryDS="GT" />

</Email>

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved 2 Traveler Profile Synchronization Service 14

Page 17: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

<Address>

<AddressLine>3153 Primus St</AddressLine>

<CityName>Anytown</CityName>

<PostalCd>98000</PostalCd>

<StateCode>CA</StateCode>

<CountryCode>US</CountryCode>

<DataSource PrimaryDS="GT" />

</Address>

<Document DocID="6161661661616" DocIssueCountryCode="US" DocTypeCode="PSPT">

<DocHolderName>Frederick Fink</DocHolderName>

<DataSource PrimaryDS="GT" />

</Document>

<CustLoyalty MembershipID="4141441441414" VendorCode="HL" VendorTypeCode="HL">

<DataSource PrimaryDS="GT" />

</CustLoyalty>

<EmploymentInfo>

<EmployeeInfo Company="Bahne Industries" />

</EmploymentInfo>

</Customer>

<TPA_Extensions

/> </Traveler>

</Profile>

</ProfileInfo>

</Sabre_OTA_ProfileUpdateRQ>

</soapenv:Body>

</soapenv:Envelope>

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved 2 Traveler Profile Synchronization Service 15

Page 18: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

2 . 1 F e a t u r e s / F u n c t i o n s I s / I s N o t

IS IS NOT

The ability for a customer ERP installation to The ability for profile updates made in the

send profile updates to GetThere. GetThere Online Profile to be sent to the customer

ERP installation.

The ability to prohibit or turn off sections of the

GetThere Online Profile.

Any changes to the GetThere User Data Upload

Tool (UDUT).

Any changes to the processing times of the User

Data Upload Tool (UDUT).

Providing Profile Updates from SSO login.

2 . 2 A s s u m p t i o n s a n d C o n s t r a i n t s ( i n c l u d e s e x t e r n a l d e p e n

d e n c i e s )

A1.None identified at this time. C1. None identified at this time.

2 . 3 D e p e n d e n c i e s

D1. None identified at this time.

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved 2 Traveler Profile Synchronization Service 16

Page 19: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Appendix 1 Itinerary Data Web Service Flow

Expense System GetThere

Create Session

Request: Read list of itinerary locators

(1 Request)

Request: Read itinerary data

(Multiple requests until itinerary data

for all itinerary locators returned

previously are all retrieved)

Response:

1. Start time for next batch process.

2. Number of itinerary locators in the request.

3. List of itinerary locators for itinerary created/updated in the next hour starts from startTime in the request.

Response:

Itinerary Data.

Close Session STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Appendix 1 Itinerary Data Web Service Flow 17

Page 20: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Appendix 2 Data Field List for

TravelItineraryRead

Section Field Data

General ItineraryRef PNR

General OtherSystemID SAP TAN

General Site SystemID SAP SID

General Client ID SAP CID

General GetThereTripID ITN_Number

General FirstName Firstname

General LastName Lastname

General CustomerIdentifier SAP PID/GERS Country Code

General EmployeeInfo Employee Number

Air ArrivalDateTime Arrival Date/Time

Air DepartureDateTime Departure Date/Time

Air FlightNumber Flight Number

Air NumberinParty Number in Party

Air ResBookDesigCode Booking Code for the Flight

Air StopQuantity # of Stops

Air DepartureAirportCode Departure Airport Code

Air CountryCode Departure Country Code

Air CountryName Departure Country Name

Air AirportName Departure Airport Name

Air CityName Departure City Name

Air StateName Departure State Name

Air StateCode Departure State Code

Air ArrivalAirportCode Arrival Airport Code

Air CountryCode Arrival Country Code

Air CountryName Arrival Country Code

Air AirportName Arrival Airport Name

Air CityName Arrival City Name

Air StateName Arrival State Name

Air State Code Arrival State Code

Air Operating Airline Code Airline IATA Code

Air Company Short Name Airline Name

Air AirEquipType Airline Equipment Type

Air MarketingAirlineCode Marketing Airline Code

Air AirLineRefID Airline Conf Number

Air TravelPolicyViolation Text of Violation

Air FareClass will decode into the cabin

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Appendix 2 Data Field List for TravelItineraryRead 18

Page 21: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Vehicle ConfID ConfirmationID

Vehicle Vendor Code Vendor Code

Vehicle Vendor Name Vendor Name

Vehicle PickUpDateTime PickUpDateTime

Vehicle ReturnDateTime ReturnDateTime

Vehicle PickUp LocationCode PickUp LocationCode

Vehicle PickUp LocationName PickUp LocationName

Vehicle Return Location Code Return Location Code

Vehicle Approximate Total Charge Amount with Currency Code

Vehicle Approximate Total Amount

Vehicle Currency Code Currency Code

Vehicle EquipType Type of Vehicle

Vehicle TravelPolicyViolationText Text of Violation

Vehicle PickUpCityName PickUpCityName

Vehicle PickUpCountryCode PickUpCountryCode

Vehicle PickUpCountryName PickUpCountryName

Vehicle PickUpStateCode PickUpStateCode

Vehicle PickUpStateName PickUpStateName

Vehicle DropOffCityName DropOffCityName

Vehicle DropOffCountryCode DropOffCountryCode

Vehicle DropOffCountryName DropOffCountryName

Vehicle DropOffStateCode DropOffStateCode

Vehicle DropOffStateName DropOffStateName

Hotel RoomTypeCode Room Type

Hotel NumberofUnits Number of Rooms

Hotel AmountBeforeTax Amount Before Tax

Hotel CurrencyCode CurrencyCode

Hotel Guest Count Guest Count

Hotel Start Check In

Hotel end Check Out

Hotel ChainCode ChainCode

Hotel HotelCode GDS Property ID

Hotel HotelCityCode HotelCityCode

Hotel HotelName HotelName

Hotel ConfirmationNumber ConfirmationNumber

Hotel HotelAddress HotelAddress

Hotel CountryCode CountryCode

Hotel PhoneNumber PhoneNumber

Hotel TravelPolicyViolationText Text of Violation

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Appendix 2 Data Field List for TravelItineraryRead 19

Page 22: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Hotel CityName City Name

Hotel StateCode State Code

Hotel StateName State Name

Hotel CountryCode Country Code

Hotel CountryName Country Name

Rail VendorCode VendorCode

Rail TrainNumber TrainNumber

Rail ResBookDesigCode ResBookDesigCode

Rail LocationCode Departure Location Code

Rail LocationName Departure Location Name

Rail StateCode Departure State Code

Rail StateName Departure State Name

Rail CountryCode Departure Country Code

Rail CountryName Departure Country Name

Rail DepartureTime DepartureTime

Rail LocationCode Arrival Location Code

Rail Point Point

Rail StateCode Arrival State Code

Rail StateName Arrival State Name

Rail CountryCode Arrival Country Code

Rail CountryName Arrival Country Name

Rail ArrivalTime ArrivalTime

Rail ConfirmationNumber ConfirmationNumber

Rail TravelPolicyViolation TravelPolicyViolation

Ticketing TicketTimeLimit TicketTimeLimit

Itinerary BaseFareAmount BaseFareAmount

Itinerary BaseFareCurrency BaseFareCurrency

Itinerary Decimal Places Decimal Places

Itinerary TaxesAmount TaxesAmount

Itinerary TaxesCurrency TaxesCurrency

Itinerary TaxesDecimal TaxesDecimal

Itinerary LowerFareAmount AirFare Lower Fare Amount

Itinerary LowerFareCurrency AirFare LowerFareCurrency

Itinerary LowerFareDecimal AirFare LowerFareDecimal

Itinerary CreateDateTime TimeStamp of the Itin

Itinerary ItineraryStatus Booked,Ticketed, Cancelled

Policy - Air TravelPolicyJustification AirTravelPolicyJustificationText

Policy - Air TravelPolicyJustificationCode AirTravelPolicyJustificationCode

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Appendix 2 Data Field List for TravelItineraryRead 20

Page 23: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Policy -

Vehicle TravelPolicyJustification VehicleTravelPolicyJustificationText

Policy -

Vehicle TravelPolicyJustificationCode VehicleTravelPolicyJustificationCode

Policy - Hotel TravelPolicyJustification HotelPolicyJustificationText

Policy - Hotel TravelPolicyJustificationCode HotelPolicyJustificationCode

Policy - Rail TravelPolicyJustification RailPolicyJustificationText

Policy - Rail TravelPolicyJustificationCode RailPolicyJustificationCode

Error ErrorsCode

Error ErrorSeverity

Error ErrorMessage STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Appendix 2 Data Field List for TravelItineraryRead 21

Page 24: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Appendix 3 Booking Data Service URL’s

SessionCreate http://webservices.sabre.com/wsdl/sabreXML1.0.00/usg/SessionCreateRQ.wsdl http://webservices.sabre.com/wsdl/sabreXML1.0.00/usg/SessionCreateRQ.xsd http://webservices.sabre.com/wsdl/sabreXML1.0.00/usg/SessionCreateRQRS.xsd http://webservices.sabre.com/wsdl/sabreXML1.0.00/usg/SessionCreateRS.xsd http://webservices.sabre.com/wsdl/sabreXML1.0.00/usg/xmldsig-core-schema.xsd GT Locator Read Definitions: This service will download all the PNR Record Locators since your last request:

http://webservices.sabre.com/wsdl/sabreXML1.0.00/GetThere/GT_ERP_TravelItineraryLocatorRead1.0.0RQ.xsd http://webservices.sabre.com/wsdl/sabreXML1.0.00/GetThere/GT_ERP_TravelItineraryLocatorRead1.0.0RQRS.xs

d http://webservices.sabre.com/wsdl/sabreXML1.0.00/GetThere/GT_ERP_TravelItineraryLocatorRead1.0.0RS.xsd

http://webservices.sabre.com/wsdl/sabreXML1.0.00/GetThere/GT_ERP_TravelItineraryLocatorRead1.0.0RQ.wsdl

GT Itinerary Read: This service will download the contents of the booking.

http://webservices.sabre.com/wsdl/sabreXML1.0.00/GetThere/GT_ERP_TravelItineraryRead1.0.0RQ.wsdl

http://webservices.sabre.com/wsdl/sabreXML1.0.00/GetThere/GT_ERP_TravelItineraryRead1.0.0RQRS.xsd

http://webservices.sabre.com/wsdl/sabreXML1.0.00/GetThere/GT_ERP_TravelItineraryRead1.0.0RQ.xsd

http://webservices.sabre.com/wsdl/sabreXML1.0.00/GetThere/GT_ERP_TravelItineraryRead1.0.0RS.xsd

SessionClose http://webservices.sabre.com/wsdl/sabreXML1.0.00/usg/SessionCloseRQ.wsdl http://webservices.sabre.com/wsdl/sabreXML1.0.00/usg/SessionCloseRQ.xsd http://webservices.sabre.com/wsdl/sabreXML1.0.00/usg/SessionCloseRQRS.xsd

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Appendix 3 Booking Data 22Service URL’s

Page 25: OVERVIEW - Sabrefiles.developer.sabre.com/doc/providerdoc/GetThere/... · 1 Itinerary Data Web Service This section will describe the Itinerary Data Web Service and the work flow

GetThere ERP WebServices – Overview – Error! No text of specified style in document.

Glossary

ACS – Authentication Control System CSV – Comma Separated Values ERP – Enterprises Resource Planning HTTPS - Hypertext Transfer Protocol over Secure Socket Layer ICE – Integrated Computing Environment LCARS – Library Computer Access and Retrieval System MOM – Message Oriented Middleware RPC – Remote Procedure Call SAML – Security Assertion Markup Language SOAP – Simple Object Access Protocol SSO – Single Sign On UDUT – User Database Upload Tool (GetThere tool) USG – Universal Services Gateway UTC – Coordinated Universal Time XSD - XML Schema Definition XSLT – Extensible Stylesheet Language Transformations WSDL – Web Service Definition Language

STUDENT GUIDE GetThere, L.P. Confidential | All Rights Reserved Glossary 23