getreservationrq v1.19.0 user guide - sabrefiles.developer.sabre.com/doc/providerdoc/pnr... · user...
TRANSCRIPT
© 2012-2019, Sabre Inc. All rights reserved.
This documentation is the confidential and proprietary intellectual
property 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 Travel Network and the Sabre Travel Network logo design are
trademarks and/or service marks of an affiliate of Sabre Inc. All other
trademarks, service marks, and trade names are owned by their
respective companies.
User Guide January 2019 Table of Contents iii
Table of Contents
1 G e t t i n g S t a r t e d 1 - 1
1.1 Introduction ............................................................................................................................................................1-1 1.2 About This Guide...................................................................................................................................................1-1 1.3 Availability ..............................................................................................................................................................1-1 1.4 High-level des ign ...................................................................................................................................................1-2 1.5 Key changes comparing to the previous version .................................................................................................1-3
2 G e t R e s e r v a t i o n R e q u e s t a n d R e s p o n s e S t r u c t u r e 2 - 1
2.1 Introduction ............................................................................................................................................................2-1 2.2 Processing Information .........................................................................................................................................2-1 2.3 Overview of Request and Response Updates .....................................................................................................2-2
2.3.1 Additional f ields in GetReservationRS .........................................................................................................2-3
2.3.1 New fields for storing additional information regarding PNR (for authorized users only) .........................2-4
2.3.1 Informational segment f lag inclusion............................................................................................................2-5
2.3.2 View s and subject areas: ..............................................................................................................................2-7
2.3.3 Ability to choose PQ (PriceQuoteServicesRQ) service version ...............................................................2-12
2.3.4 Ability to retrieve Pay Info from PNR...........................................................................................................2-13
2.4 Service version and Response formats .............................................................................................................2-15 2.5 Request and response structure ........................................................................................................................2-16
2.5.1 GetReservationRQ request message (RQ) ...............................................................................................2-16
2.5.2 Detailed description of parameters for GetReservationRQ ......................................................................2-18
2.5.3 GetReservationRS response message (RS) .............................................................................................2-25
2.6 View s....................................................................................................................................................................2-28 2.7 Subject Areas ......................................................................................................................................................2-29 2.8 Service Security ...................................................................................................................................................2-31
3 D o c u m e n t a t i o n U p d a t e s 3 - 33
3.1 Updated Design Documents ...............................................................................................................................3-33
4 E r r o r C o d e s 4 - 34
4.1 Introduction ..........................................................................................................................................................4-34 4.2 Fault Errors ..........................................................................................................................................................4-34
5 T e c h n i c a l S u p p o r t – T r a v e l A g e n c i e s a n d 3 r d p a r t y d e v e l o p e r s 5 - 37
5.1 Introduction ..........................................................................................................................................................5-37 5.2 Phone ...................................................................................................................................................................5-37
User Guide January 2019 iv Table of Contents
5.3 Email ....................................................................................................................................................................5-37
6 T e c h n i c a l S u p p o r t – S a b r e H o s t e d A i r l i n e s 6 - 38
6.1 Introduction ..........................................................................................................................................................6-38 6.2 Phone ...................................................................................................................................................................6-38 6.3 Email ....................................................................................................................................................................6-41
7 G l o s s a r y 1
User Guide January 2019 Introduction 1-1
1.1 I n t r o d u c t i o n
This guide is for architects and developers to learn how to compose XML formatted requests for
GetReservationRQ Web Service. This release covers the XML request and responses which allow client
applications to retrieve PNR data including Itinerary, Passenger information, etc. (details below).
GetReservationRS message can be returned in STL, respective details can be found in the WSDL file.
1.2 A b o u t T h i s G u i d e
The purpose of this document is to describe how the web service works and provide details how to
create a successful request transaction. This document also provides details on the response
transaction, including any errors. Each chapter is as follows:
• Chapter 1, “Getting Started” explains the purpose of the document, details critical information,
and provides a functional overview.
• Chapter 2, “GetReservationRead Request and Response structure” contains descriptions of the
attributes and elements in the response schema.
• Chapter 3, “Documentation Updates” contains the necessary filenames to run
GetReservationRQ.
• Chapter 4, “Error Codes” contains error codes and descriptions.
• Chapter 5, “Technical Support” contains information on where to get help.
• The Glossary provides a glossary of terms used in this document.
1.3 A v a i l a b i l i t y
This service can be used by:
• Sabre Dev Studio subscribers.
• Sabre Travel Network customers – travel agencies working on Sabre® Red Workspace™ and
other Sabre user interfaces.
• Airlines
• Third-party customers.
1 Getting Started 1
User Guide January 2019 1-2 High-level design
Both internal and external consumers can take benefits from GetReservationRQ as a part of Sabre
API. The service runs in 24x7 mode. In case of any planned maintenance windows, we send the wide
standard notifications in advance.
We offer the standard service functionalities to all the clients, but availability varies depending on
the type of request used:
• Stateless request can be used by airlines only
• Stateful request can be used by both airlines and travel agencies.
Specific service capabilities may require dedicated activations.
In case of any doubts, we recommend contacting our Technical Support. Please contact us also if
you plan to start using the service intensively with a high volume of requests, so that we will be able
to tune the service fit for your purposes and ensure the search process will always run smoothly.
1.4 H i g h - l e v e l d e s i g n
User Guide January 2019 Key changes comparing to the previous version 1-3
1.5 K e y c h a n g e s c o m p a r i n g t o t h e p r e v i o u s v e r s i o n
GetReservationRQ 1.19 User Guide introduced a couple of changes:
• New fields for storing additional information regarding PNR (for authorized users only)
Enables authorized users to mark PNRs as suspicious using UpdateReservationRQ API and
read that information using GetReservationRQ.
• Informational segment flag inclusion
Introduces new indicator to identify OA flights that are 3rd party booked.
• New capabilities for hotel content (CRUD)
The new Lodging Platform will enable customers to connect to different sources of content.
They will be able to provide rates from different suppliers for the same hotel and allow the
customer to choose which one to book.
Sabre integrates multiple sources of content including GDS (referenced as GDS properties)
and non-GDS sources such as aggregators (referenced later as aggregator properties).
In other words, a hotel booking can be done regardless of content source:
• Traditional hoteliers through the GDS path (Hilton, Marriott etc)
• Suppliers through a direct connect, mostly hotel aggregators (Expedia, Bedsonline, Booking.com, etc)
The details about Lodging functionality are available in document: PNRServices For Lodging User Guide.
• Views and subject areas:
• Default and Full views will now support adding SubjectAreas into the request
• New subject areas ACTIVE and HISTORICAL have been added to enable custom
views creation
• Ability to choose PQ (PriceQuoteServicesRQ) service version
Supports the ability to specify the PriceQuoteServicesRQ service version instead of
defaulting to the latest version in PROD
• Ability to retrieve PayInfo from PNR
PayInfo contains data in the PAY field in the PNR
User Guide January 2019 Introduction 2-1
2.1 I n t r o d u c t i o n
The Retrieve Itinerary (GetReservationRQ) API is used to retrieve and display a passenger name
record (PNR) and data that ae related to PNR.
This chapter includes the following:
• Processing Information (see this page).
• Overview of Request and Response Updates (see “Overview of Request and Response
Updates”).
• Service version and response formats (see “Service version and response formats “).
• Request and Response structure (see “Request and Response structure”).
• Views (see “Views”).
• Subject Areas (see “Subject Areas”).
• Service security (see “Service security”).
2.2 P r o c e s s i n g I n f o r m a t i o n
Once a PNR has been created on the Sabre Host, this Web Service offers capabilities allowing Airline
or Agency to retrieve PNR data using PNR Locator as a search criterion. It also enables retrieving PNR
from AAA session. Request payload can be further specified by using “ReturnOptions” which
determine response message content.
There are three types of requests available:
• Stateless: Full data provided at creation; ET at end with Locator
– A Sabre PNR will be returned in the XML response without a AAA being accessed from the
PNR Reservation Database.
– All necessary data is provided in RQ.
– After being created the PNR will be committed.
– It is required to provide “ReceivedFrom” element.
– “Locator” element will be returned in the RS.
• Stateful: Data provided at creation, NO ET at end, no Locator
2 GetReservation Request and Response Structure 2
User Guide January 2019 2-2 Ov erview of Request and Response Updates
– A Sabre PNR will be retrieved from the AAA session, if no Record Locator (Locator) was
present in the request.
– If a Record locator is present in the request, the Sabre PNR will be loaded into the AAA
session (if the current session does not contain changes to a previously unpacked Sabre PNR.)
– All necessary data is not provided in RQ.
– After being created PNR will not be committed.
– It is required to provide “ReceivedFrom” element in the RQ.
– Remaining details for completing the PNR are entered via Host Sabre via commands – or
using UpdateReservationRQ.
– After being updated the PNR will be committed.
• Trip – NO ET at end, no Locator
– A Sabre PNR will be returned in the XML response without a AAA being accessed from the
PNR Operational Data Store
“ReturnOptions” element can be used to specify which data elements will be present in response
payload, as well as how those will be formatted:
– XML “ResponseFormat” – the only available data format for client applications now is STL
– “SubjectAreas” – specifies what kind of information should be returned in response (Itinerary,
Pricing Information, etc.)
– “ViewName” – enables to use predefined set of Subject Areas
– “PriceQuoteServiceVersion” - is used to specify version of webservice used to obtain PQ
content. This attribute defines the version of the external webservice (PriceQuoteServicesRQ)
called using an PRICE_QUOTE Subject Area
When using pnrbuilder files on versions higher than v1.7.8 you will need to be specify the version
number in the namespace
<GetReservationRQ Version="1.19.0" xmlns="http://webservices.sabre.com/pnrbuilder/v1_19">
2.3 O v e r v i e w o f R e q u e s t a n d R e s p o n s e U p d a t e s
New schema version for v1.19 was introduced with the following main items included in the
response:
• Additional fields in GetReservationRS
• New fields for storing additional information regarding PNR (for authorized users only)
• Informational segment flag inclusion
User Guide January 2019 Ov erview of Request and Response Updates 2-3
• New capabilities for hotel content (CRUD)
• Views and subject areas
• Ability to choose PQ (PriceQuoteServicesRQ) service version
• Ability to retrieve PayInfo from PNR
2.3.1 A d d i t i o n a l f i e l d s i n G e t R e s e r v a t i o n R S
Additional fields are now added to GetReservationRQ as a result of aligning gaps between
TravelItineraryRead API GetReservation API.
This project enables GetReservationRS APIs to populate information:
o Meal codes within Air segment
This information is included in response only when DSS subject area is specified in RQ. This
SubjectArea is already a predefined in Default view and in ACTIVE Subject area (which is a set of
subject areas)
<stl19:Air id="138" sequence="1" segmentAssociationId="5" isPast="false" DayOfWeekInd="6"
CodeShare="false" SpecialMeal="false" StopQuantity="00" SmokingAllowed="false"
ResBookDesigCode="T" Code="UA">
<stl19:DepartureAirport>LAX</stl19:DepartureAirport>
<stl19:DepartureAirportCodeContext>IATA</stl19:DepartureAirportCodeContext>
<stl19:DepartureTerminalName>TERMINAL 7</stl19:DepartureTerminalName>
<stl19:DepartureTerminalCode>7</stl19:DepartureTerminalCode>
<stl19:ArrivalAirport>IAD</stl19:ArrivalAirport>
<stl19:ArrivalAirportCodeContext>IATA</stl19:ArrivalAirportCodeContext>
<stl19:OperatingAirlineCode>UA</stl19:OperatingAirlineCode>
<stl19:OperatingAirlineShortName>UNITED AIRLINES</stl19:OperatingAirlineShortName>
<stl19:OperatingFlightNumber>0324</stl19:OperatingFlightNumber>
<stl19:EquipmentType>739</stl19:EquipmentType>
<stl19:MarketingAirlineCode>UA</stl19:MarketingAirlineCode>
<stl19:MarketingFlightNumber>0324</stl19:MarketingFlightNumber>
<stl19:OperatingClassOfService>T</stl19:OperatingClassOfService>
<stl19:MarketingClassOfService>T</stl19:MarketingClassOfService>
<stl19:MarriageGrp>
<stl19:Ind>0</stl19:Ind>
<stl19:Group>2</stl19:Group>
<stl19:Sequence>1</stl19:Sequence>
</stl19:MarriageGrp>
<stl19:Meal Code="F"/>
<stl19:Seats/>
<stl19:AirlineRefId>DCUA*H2X3ME</stl19:AirlineRefId>
<stl19:Eticket>true</stl19:Eticket>
<stl19:DepartureDateTime>2018-10-06T08:28:00</stl19:DepartureDateTime>
<stl19:ArrivalDateTime>2018-10-06T16:25:00</stl19:ArrivalDateTime>
User Guide January 2019 2-4 Ov erview of Request and Response Updates
<stl19:FlightNumber>0324</stl19:FlightNumber>
<stl19:ClassOfService>T</stl19:ClassOfService>
<stl19:ActionCode>HK</stl19:ActionCode>
<stl19:NumberInParty>2</stl19:NumberInParty>
<stl19:SegmentSpecialRequests/>
<stl19:inboundConnection>false</stl19:inboundConnection>
<stl19:outboundConnection>true</stl19:outboundConnection>
<stl19:ScheduleChangeIndicator>false</stl19:ScheduleChangeIndicator>
<stl19:SegmentBookedDate>2018-01-19T19:55:00</stl19:SegmentBookedDate>
<stl19:ElapsedTime>04.57</stl19:ElapsedTime>
<stl19:AirMilesFlown>2288</stl19:AirMilesFlown>
<stl19:FunnelFlight>false</stl19:FunnelFlight>
<stl19:ChangeOfGauge>false</stl19:ChangeOfGauge>
<stl19:Cabin Code="Y" SabreCode="Y" Name="ECONOMY" ShortName="ECONOMY" Lang="EN"/>
<stl19:Banner>MARKETED BY UNITED AIRLINES</stl19:Banner>
<stl19:Informational>false</stl19:Informational>
</stl19:Air>
• PrimeHostID - an identification code for the prime host (global distribution system)
associated with the reservation
Sample GetReservationRQ:
ns7:GetReservationRQ xmlns:ns7 = "http://webservices.sabre.com/pnrbuilder/v1_19" Version = "1.19.0">
<ns7:Locator>TUTLPR</ns7:Locator>
<ns7:RequestType>Stateless</ns7:RequestType>
<ns7:ReturnOptions>
<ns7:ViewName>Full</ns7:ViewName>
<ns7:ResponseFormat>STL</ns7:ResponseFormat>
</ns7:ReturnOptions>
</ns7:GetReservationRQ>
Sample PrimeHostID element in GetReservationRS:
<stl19:POS AirExtras="true" InhibitCode="U">
<stl19:Source BookingSource="B4T0" AgentSine="VLZ" PseudoCityCode="B4T0" ISOCountry="US"
AgentDutyCode="*" AirlineVendorID="AA" HomePseudoCityCode="HDQ" PrimeHostID="1S"/>
</stl19:POS>
2.3.1 N e w f i e l d s f o r s t o r i n g a d d i t i o n a l i n f o r m a t i o n r e g a r d i n g P N R
( f o r a u t h o r i z e d u s e r s o n l y )
User Guide January 2019 Ov erview of Request and Response Updates 2-5
Sabre Travel Network (TN) have agencies that were suspected of making fraudulent PNR bookings.
This project enables authorized users to mark such PNRs as suspicious. That information can be
stored within PNR and later reviewed.
The functionality is designed for security reasons and the use is regulated through access control at
the level of specific entitlements. If you need the access o this functionality, please contact
helpdesk.
Sample GetReservationRQ:
<GetReservationRQ EchoToken="PXGPG18-PNRSVCPG03" Version="1.19.0"
xmlns="http://webservices.sabre.com/pnrbuilder/v1_19">
<Locator>FTAZPQ</Locator>
<RequestType>Stateful</RequestType>
<ReturnOptions>
<ViewName>FullWithOpenRes</ViewName>
<ResponseFormat>STL</ResponseFormat>
</ReturnOptions>
</GetReservationRQ>
Sample Review element in GetReservationRS
<or114:OpenReservationElement id="5" type="RV" displayIndex="2" elementId="pnr-or-5">
<or114:Review>
<or114:Candidate>true</or114:Candidate>
<or114:Reporter>TN</or114:Reporter>
<or114:Value>99</or114:Value>
<or114:Description>Money Fraud</or114:Description>
</or114:Review>
</or114:OpenReservationElement>
2.3.1 I n f o r m a t i o n a l s e g m e n t f l a g i n c l u s i o n
The project introduces new filed into GetReservationRQ that is used to display clear indicator in the
face of the PNR in Interact, identifying OA flights that are informational and 3rd party booked.
Sample GetReservationRQ:
<GetReservationRQ EchoToken="" xmlns:ns7 = "http://webservices.sabre.com/pnrbuilder/v1_19"
Version = "1.19.0">
<Locator>SPBIAP</Locator>
<RequestType>Stateless</RequestType>
User Guide January 2019 2-6 Ov erview of Request and Response Updates
<ReturnOptions>
<SubjectAreas>
<SubjectArea>AIR_CABIN</SubjectArea>
</SubjectAreas>
<ViewName>Simple</ViewName>
<ResponseFormat>STL</ResponseFormat>
</ReturnOptions>
</GetReservationRQ>
Sample Air segment element with informational flag inclusion in GetReservationRS:
<stl19:Air id="138" sequence="1" segmentAssociationId="5" isPast="false" DayOfWeekInd="6" CodeShare="false" SpecialMeal="false" SmokingAllowed="false" ResBookDesigCode="T">
<stl19:DepartureAirport>LAX</stl19:DepartureAirport> <stl19:DepartureAirportCodeContext>IATA</stl19:DepartureAirportCodeContext> <stl19:ArrivalAirport>IAD</stl19:ArrivalAirport> <stl19:ArrivalAirportCodeContext>IATA</stl19:ArrivalAirportCodeContext> <stl19:OperatingAirlineCode>UA</stl19:OperatingAirlineCode> <stl19:OperatingAirlineShortName>UNITED AIRLINES</stl19:OperatingAirlineShortName> <stl19:OperatingFlightNumber>0324</stl19:OperatingFlightNumber> <stl19:EquipmentType>320</stl19:EquipmentType> <stl19:MarketingAirlineCode>UA</stl19:MarketingAirlineCode> <stl19:MarketingFlightNumber>0324</stl19:MarketingFlightNumber> <stl19:OperatingClassOfService>T</stl19:OperatingClassOfService> <stl19:MarketingClassOfService>T</stl19:MarketingClassOfService> <stl19:MarriageGrp>
<stl19:Ind>0</stl19:Ind> <stl19:Group>2</stl19:Group> <stl19:Sequence>1</stl19:Sequence>
</stl19:MarriageGrp> <stl19:Seats/> <stl19:AirlineRefId>DCUA*H2X3ME</stl19:AirlineRefId> <stl19:Eticket>true</stl19:Eticket> <stl19:DepartureDateTime>2018-10-06T08:28:00</stl19:DepartureDateTime> <stl19:ArrivalDateTime>2018-10-06T16:25:00</stl19:ArrivalDateTime> <stl19:FlightNumber>0324</stl19:FlightNumber> <stl19:ClassOfService>T</stl19:ClassOfService> <stl19:ActionCode>HK</stl19:ActionCode> <stl19:NumberInParty>2</stl19:NumberInParty> <stl19:SegmentSpecialRequests/> <stl19:inboundConnection>false</stl19:inboundConnection> <stl19:outboundConnection>true</stl19:outboundConnection> <stl19:ScheduleChangeIndicator>false</stl19:ScheduleChangeIndicator> <stl19:SegmentBookedDate>2018-01-19T19:55:00</stl19:SegmentBookedDate> <stl19:Cabin Code="Y" SabreCode="Y" Name="ECONOMY" ShortName="ECONOMY" Lang="EN"/> <stl19:Banner>MARKETED BY UNITED AIRLINES</stl19:Banner> <stl19:Informational>false</stl19:Informational>
</stl19:Air>
User Guide January 2019 Ov erview of Request and Response Updates 2-7
2.3.2 V i e w s a n d s u b j e c t a r e a s :
STL is now in a transition mode to new model of views and subject areas. Few major changes were introduced in this area in order to make views more flexilble.
• Default and Full views will allow to add custom Subject areas to the request
• Full view will be enhanced to include also information stored in DSS and open systems by default
• New Subject areas are introduced to enable capabilities of views that were previously predefined in some specific views:
o ACTIVE - set of subject areas that include information about airline booking, o HISTORICAL
Those changes were made to enable customers to create a custom view using just Subject Areas without a need to extend the view that was previously custom-made.
Below you can see the mapping for Views that will no longer be available in GetRerservationRQ starting from 1.19 version.
View name Stateful and Stateless mode Stateless mode (simplified mapping)
AcsDefault HEADER, NAME, PROFILE HEADER, NAME, PROFILE
AebsoFullView FQTV, ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX, GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, TARGETMARKETING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION, CORPORATE_ID, ACCOUNTING_LINE, SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY, CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR, RECEIVED, PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA,
ACTIVE, STL_ADD_ARUNKS_OPENSEGMENTS, HISTORICAL
User Guide January 2019 2-8 Ov erview of Request and Response Updates
STL_ADD_ARUNKS_OPENSEGMENTS, HISTORICAL
Asv2DefaultWithSsr HEADER, NAME, ITINERARY, FQTV, ATR, OPEN, AFAX, GFAX, ADD_PARTNERSHIP_AIRLINES, ADD_POC, STL_ADD_ARUNKS_OPENSEGMENTS
HEADER, NAME, ITINERARY, FQTV, ATR, OPEN, AFAX, GFAX, ADD_PARTNERSHIP_AIRLINES, ADD_POC, STL_ADD_ARUNKS_OPENSEGMENTS
DefaultOpenResHistoryLimited
HEADER, NAME, ITINERARY, RECEIVED, PASSENGERDETAILS, AFAX, GFAX, REMARKS, FQTV, TICKETING, SUBSCRIPTION_CARD, LREC_11, ANCILLARY, OPENRESDATA, OPENRESHISTORY, PHONE, ACCOUNTING_LINE, ADD_PARTNERSHIP_AIRLINES, ADD_POC
HEADER, NAME, ITINERARY, RECEIVED, PASSENGERDETAILS, AFAX, GFAX, REMARKS, FQTV, TICKETING, SUBSCRIPTION_CARD, LREC_11, ANCILLARY, OPENRESDATA, OPENRESHISTORY, PHONE, ACCOUNTING_LINE, ADD_PARTNERSHIP_AIRLINES, ADD_POC
DefaultOpenResWithHistory
HEADER, NAME, ITINERARY, RECEIVED, PASSENGERDETAILS, AFAX, GFAX, REMARKS, FQTV, TICKETING, SUBSCRIPTION_CARD, LREC_11, ANCILLARY, OPENRESDATA, OPENRESHISTORY, PHONE, ACCOUNTING_LINE, ADD_PARTNERSHIP_AIRLINES, ADD_POC, HISTORICAL
HEADER, NAME, ITINERARY, RECEIVED, PASSENGERDETAILS, AFAX, GFAX, REMARKS, FQTV, TICKETING, SUBSCRIPTION_CARD, LREC_11, ANCILLARY, OPENRESDATA, OPENRESHISTORY, PHONE, ACCOUNTING_LINE, ADD_PARTNERSHIP_AIRLINES, ADD_POC, HISTORICAL
DefaultWithPq FQTV, ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX, GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, TARGETMARKETING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION, CORPORATE_ID, ACCOUNTING_LINE, SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY, CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR, RECEIVED,
ACTIVE, PRICING_INFORMATION, STL_ADD_ARUNKS_OPENSEGMENTS
User Guide January 2019 Ov erview of Request and Response Updates 2-9
PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA, PRICING_INFORMATION, STL_ADD_ARUNKS_OPENSEGMENTS
EmsDefault FQTV, ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX, GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, TARGETMARKETING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION, CORPORATE_ID, ACCOUNTING_LINE, SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY, CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR, RECEIVED, PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA, USE_RAW_CONTENT
ACTIVE, USE_RAW_CONTENT
FulfillmentDefault FQTV, ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX, GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, TARGETMARKETING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION, CORPORATE_ID, ACCOUNTING_LINE, SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY, CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR, RECEIVED,
ACTIVE, ITINERARY, PRICING_INFORMATION
User Guide January 2019 2-10 Ov erview of Request and Response Updates
PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA, PRICING_INFORMATION
InteractAll HEADER, ITINERARY, STL_ADD_ARUNKS_OPENSEGMENTS
HEADER, ITINERARY, STL_ADD_ARUNKS_OPENSEGMENTS
InteractDefault HEADER, ITINERARY HEADER, ITINERARY
OpenResHistoryOnly HEADER, NAME, OPENRESDATA, OPENRESHISTORY, HISTORICAL, ADD_PARTNERSHIP_AIRLINES
HEADER, NAME, OPENRESDATA, OPENRESHISTORY, HISTORICAL, ADD_PARTNERSHIP_AIRLINES
PssDisplay FQTV, ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX, GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, TARGETMARKETING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION, CORPORATE_ID, ACCOUNTING_LINE, SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY, CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR, RECEIVED, PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA, HISTORICAL, OPENRESHISTORY, STL_ADD_ARUNKS_OPENSEGMENTS, ADD_POC
ACTIVE, HISTORICAL, OPENRESDATA, OPENRESHISTORY, STL_ADD_ARUNKS_OPENSEGMENTS, ADD_POC
PssDisplayWithoutHistory FQTV, ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX, GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, TARGETMARKETING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION, CORPORATE_ID, ACCOUNTING_LINE,
ACTIVE, HISTORICAL, OPENRESDATA, STL_ADD_ARUNKS_OPENSEGMENTS
User Guide January 2019 Ov erview of Request and Response Updates 2-11
SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY, CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR, RECEIVED, PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA, HISTORICAL, STL_ADD_ARUNKS_OPENSEGMENTS
SimpleWithCvs HEADER HEADER
SswDefault FQTV, ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX, GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, TARGETMARKETING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION, CORPORATE_ID, ACCOUNTING_LINE, SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY, CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR, RECEIVED, PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA, USE_RAW_CONTENT, ADD_TKT_NAME_SEG_ASSOC
ACTIVE, USE_RAW_CONTENT, ADD_TKT_NAME_SEG_ASSOC
TktDefault FQTV, ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX, GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, TARGETMARKETING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION,
ACTIVE
User Guide January 2019 2-12 Ov erview of Request and Response Updates
CORPORATE_ID, ACCOUNTING_LINE, SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY, CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR, RECEIVED, PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA,
VaDefaultWithPq FQTV, ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX, GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, TARGETMARKETING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION, CORPORATE_ID, ACCOUNTING_LINE, SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY, CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR, RECEIVED, PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA, PRICING_INFORMATION, STL_ADD_ARUNKS_OPENSEGMENTS. DSS
ACTIVE, PRICING_INFORMATION, STL_ADD_ARUNKS_OPENSEGMENTS. DSS
2.3.3 A b i l i t y t o c h o o s e P Q ( P r i c e Q u o t e S e r v i c e s R Q ) s e r v i c e v e r s i o n
Customers have now the possibility to choose version of PriceQuoteServicesRQ API. This will only
apply when Subject Area PRICE_QUOTE is used in request. Default value for this service is set to
3.2.0.
User Guide January 2019 Ov erview of Request and Response Updates 2-13
<GetReservationRQ xmlns = "http://webservices.sabre.com/pnrbuilder/v1_19" Version = "1.19.0"> <Locator>IJKZUQ</Locator> <RequestType>Stateless</RequestType> <!—3.2.0 is default version for this service and could be changed → <ReturnOptions PriceQuoteServiceVersion="3.2.0"> <SubjectAreas> <SubjectArea>PRICE_QUOTE</SubjectArea> </SubjectAreas> <ViewName>Simple</ViewName> <ResponseFormat>STL</ResponseFormat> <PriceQuote> <Status>M</ Status> <!—PQ (Price Quote) is default option for thi s parameter and could be changed to PQR→ <!—PQR (Price Quote Reissue) this option is available from version 4.0.0 PriceQuoteServicesRQ→ <Type>PQ<Type/> < ResultType>S</ ResultType> </ns7:PriceQuote> </ReturnOptions> </GetReservationRQ>
2.3.4 A b i l i t y t o r e t r i e v e P a y I n f o f r o m P N R
PayInfo contains data in the PAY field in the PNR and can be additionally presented in response.
<stl19:PayInfos> <stl19:PayInfo fieldTagID="CC-CODE" linkSubkey="0001" sectionID="FOP" id="48"> <stl19:Text>VI</stl19:Text> </stl19:PayInfo>
<stl19:PayInfo fieldTagID="CC-NBR" linkSubkey="0001" sectionID="FOP" securityIndicator="M" id="49"> <stl19:Text>4XXXXXXXXXXX1111</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="EXP-DATE" linkSubkey="0001" sectionID="FOP" securityIndicator="M" id="50"> <stl19:Text>0119</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="CC-CODE" linkSubkey="0002" sectionID="FOP" id="56"> <stl19:Text>VI</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="CC-NBR" linkSubkey="0002" sectionID="FOP" securityIndicator="M" id="57"> <stl19:Text>4XXXXXXXXXXX1111</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="EXP-DATE" linkSubkey="0002" sectionID="FOP" securityIndicator="M" id="58"> <stl19:Text>0119</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="CC-CODE" linkSubkey="0003" sectionID="FOP" id="68">
User Guide January 2019 2-14 Ov erview of Request and Response Updates
<stl19:Text>VI</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="CC-NBR" linkSubkey="0003" sectionID="FOP" securityIndicator="M" id="69"> <stl19:Text>4XXXXXXXXXXX1111</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="EXP-DATE" linkSubkey="0003" sectionID="FOP" securityIndicator="M" id="70"> <stl19:Text>0119</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="CC-CODE" linkSubkey="0004" sectionID="FOP" id="82"> <stl19:Text>JT</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="CC-NBR" linkSubkey="0004" sectionID="FOP" securityIndicator="M" id="83"> <stl19:Text>8279003198058032</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="EXP-DATE" linkSubkey="0004" sectionID="FOP" securityIndicator="M" id="84"> <stl19:Text>0919</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="LOCATION" linkSubkey="0001" sectionID="TRN" id="51"> <stl19:Text>BOSLAX0287X08NOV</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="AWARD-POINTS" l inkSubkey="0001" sectionID="TRN" id="52"> <stl19:Text>AWP10000</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="AWARD-NUMBER" linkSubkey="0001" sectionID="TRN" id="53"> <stl19:Text>AWN709736324</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="DOCUMENT-NUMBER" linkSubkey="0001" sectionID="TRN" id="54"> <stl19:Text>2792107549361</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="FREQUENT-FLYER" linkSubkey="0001" sectionID="TRN" id="55"> <stl19:Text>3198058032</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="LOCATION" linkSubkey="0002" sectionID="TRN" id="59"> <stl19:Text>LAXBOS0688X16NOV</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="AWARD-POINTS" l inkSubkey="0002" sectionID="TRN" id="60"> <stl19:Text>AWP11800</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="AWARD-NUMBER" linkSubkey="0002" sectionID="TRN" id="61"> <stl19:Text>AWN709736324</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="DOCUMENT-NUMBER" linkSubkey="0002" sectionID="TRN" id="62"> <stl19:Text>2792107549361</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="FREQUENT-FLYER" linkSubkey="0002" sectionID="TRN" id="63"> <stl19:Text>3198058032</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="LOCATION" linkSubkey="0003" sectionID="TRN" id="71"> <stl19:Text>BOSBOS0287X08NOV</stl19:Text>
User Guide January 2019 Serv ice version and Response formats 2-15
</stl19:PayInfo> <stl19:PayInfo fieldTagID="DOCUMENT-NUMBER" linkSubkey="0003" sectionID="TRN" id="72"> <stl19:Text>2790610866790</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="TOTAL-AMOUNT" linkSubkey="0003" sectionID="TRN" id="73"> <stl19:Text>USD25.00</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="SSR-RFIC-CODE" linkSubkey="0004" sectionID="TRN" id="85"> <stl19:Text>APAY</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="LOCATION" linkSubkey="0004" sectionID="TRN" id="86"> <stl19:Text>BOSLAX0287X08NOV</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="DOCUMENT-NUMBER" linkSubkey="0004" sectionID="TRN" id="87"> <stl19:Text>2790610866791</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="TOTAL-AMOUNT" linkSubkey="0004" sectionID="TRN" id="88"> <stl19:Text>USD101.00</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="AWARD-POINTS" l inkSubkey="0004" sectionID="TRN" id="89"> <stl19:Text>AWP1200</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="AWARD-NUMBER" linkSubkey="0004" sectionID="TRN" id="90"> <stl19:Text>AWN709736325</stl19:Text> </stl19:PayInfo> <stl19:PayInfo fieldTagID="FREQUENT-FLYER" linkSubkey="0004" sectionID="TRN" id="91"> <stl19:Text>3198058032</stl19:Text> </stl19:PayInfo> </stl19:PayInfos>
2.4 S e r v i c e v e r s i o n a n d R e s p o n s e f o r m a t s
The correct GetReservationRQ request needs version (starting from version 1.7.8) and response
format provided (STL is now the only supported format).
<GetReservationRQ Version="{SupportedVersion}" ... >
...
<ReturnOptions ResponseFormat="STL” … />
</GetReservationRQ>
You should specify 1.19.0 as {SupportedVersion}. The version attribute value should not contain any
additional prefixes nor suffixes. Only digits and dots should be provided as version attribute value.
Please note that according to Sabre Versioning Policy only the last five versions of the service is
supported, so it is recommended to always use the most recent version.
User Guide January 2019 2-16 Request and response structure
2.5 R e q u e s t a n d r e s p o n s e s t r u c t u r e
PNR data will be returned depending on the ViewName and SubjectAreas selected. Each View, if
permitted, can be extended by Subject Areas. Information from Subject Areas will be provided in
response message if the data is present in the PNR.
For more details please review the following:
• View Names (see “View Names,” page 2-28).
• Subject Areas (see “Subject Areas,” page 2-19).
2.5.1 G e t R e s e r v a t i o n R Q r e q u e s t m e s s a g e ( R Q )
An overview on the GetReservationRQ service design, with the key XML sections highlighted, is
presented below. For more information please refer to next paragraphs as well as to the
corresponding WSDL and XSD files.
User Guide January 2019 Request and response structure 2-17
HEADER:
It contains e.g. BinarySecurityToken obtained when authorizing user’s web service session.
BODY:
<GetReservatiomRQ> required block, some its attributes like Version are required too.
<Version> is required attribute (starting from version 1.7.8)
< Locator > required block for stateless and trip calls;
<RequestType> required block;
<CreateDate> optional block; PNR creation date used to retrieve inactive PNR
<ReturnOptions> this element is used as a container for defining response message format and data range.
< UnmaskCreditCard > optional attribute for "Stateful" request; by default, the value of the attribute is
set to false.
< PriceQuoteServiceVersion > - optional attribute; by default, the value of the attribute is set to 3.2.0
< SubjectAreas > required block for stateless and Trip calls; optional for Steteful - "SubjectAreas" is
used as a container for "SubjectAreas" which can be used within “View”.
< ViewName > required block for stateless and Trip calls; optional for Steteful ; Each "View" includes
predefined list of "Subject Areas". If permitted, another "Subje ct Areas" can be added in the request.
< ResponseFormat > STL is set as default version and is the only available now
< POS >
< Source> Source holds details regarding the requestor. It may be repeated to also accommodate the
delivery system.;
<POC > optional block – default; Point of Commencement is the first point of departure amongst all of
segments present in the PNR.
"Poc" can be used to explicitly specify journey's Point of Commencement in case itinerary contains other
segments than air segments as well. Provided values will be present in the RS payload in case they are earlier
than those defined by the first air segment.
<ClientContext> ClientContext is required when calling the downline services: Web Check In; Web RES;
Interact Check In; Interact RES; Kiosk Check In; TTY; PRS; GSM; SSCI
If context is set in GetReservation request - master PNR is retrieved
Issuer identification number (IIN) information:
The prefixes and corresponding lengths were based on the following IIN ranges table in
http://en.wikipedia.org/wiki/Bank_card_number on 11/30/2010
BankCard and Diners Club enRoute were not considered since they are not Active
Issuing Network IIN Ranges Active Length Validation
American Express 34, 37 Yes 15 Luhn algorithm
Bankcard 5610, 560221-560225 No 16 Luhn algorithm
User Guide January 2019 2-18 Request and response structure
China UnionPay 62 Yes 16 unknown
Diners Club Carte
Blanche
300-305 Yes 14 Luhn algorithm
Diners Club
enRoute
2014, 2149 No 15 no validation
Diners Club
International
36 Yes 14 Luhn algorithm
Diners Club
United States &
Canada
54, 55 Yes 16 Luhn algorithm
Discover Card 6011, 622126-622925, 644-
649, 65
Yes 16 Luhn algorithm
InstaPayment 637-639 Yes 16 Luhn algorithm
JCB 3528-3589 Yes 16 Luhn algorithm
Laser 6304, 6706, 6771, 6709 Yes 16-19 Luhn algorithm
Maestro 5018, 5020, 5038, 6304, 6759,
6761, 6763
Yes 12-19 Luhn algorithm
MasterCard 51-55 Yes 16 Luhn algorithm
Solo 6334, 6767 Yes 16, 18, 19 Luhn algorithm
Switch 903, 4905, 4911, 4936, 564182,
633110, 6333, 6759
Yes 16, 18, 19 Luhn algorithm
Visa 4 Yes 16 Luhn algorithm
Visa Electron 4026, 417500, 4508, 4844,
4913, 4917
Yes 16 Luhn algorithm
2.5.2 D e t a i l e d d e s c r i p t i o n o f p a r a m e t e r s f o r G e t R e s e r v a t i o n R Q
The following descriptions contain basic information about particular elements, though primary
source of knowledge should be corresponding XSD files.
Following there is a list of request parameters (RQ) which can be combined to create a request
message. Mandatory elements are marked in red.
GetReservationRQ/Locator
User Guide January 2019 Request and response structure 2-19
Element Description
Locator Locator is used to identify a particular PNR.
Locator is optional only if RequestType is set to Stateful, in such case information is
taken from current user session (AAA).
Web Service design allows to process only one Locator per request. Request
containing multiple Locators will not be processed correctly.
GetReservationRQ/RequestType
Element Description
RequestType RequestType is used to define how PNR data will be retrieved. It can be set to:
Stateless, Trip, Stateful.
Stateful request mainly deals with PNRs that have not been committed; therefore,
Locator cannot be mandatory.
Stateless/Trip request deals with PNRs that have been committed and stored in
database. This request type requires PNR Locator.
GetReservationRQ/ReturnOptions
Element Element Attribute Description
ReturnOptions Return Options are used to define format and
data range of response payload.
UnmaskCreditCard ReturnOptions contains the attribute
UnmaskCreditCard and by default the value of
the attribute is false. When a request is made
with this attribute as true the user must have
the EPR keyword CCVIEW; credit card
information in the response will be presented
in unmasked format, else the credit card
information will always be in masked format.
PriceQuoteServiceVersion ReturnOptions contains the attribute
PriceQuoteServiceVersion and by default the
value of the attribute is set to 3.2.0. This
attribute defines the version of the external
webservice (PriceQuoteServicesRQ) called
using an PRICE_QUOTE Subject Area.
SubjectAreas "SubjectAreas" specifies particular information
to be included in response message if they are
stored in the PNR.
ViewName The PNR data present in the response payload depends on the specified View Name used in
the request (see “View Names and Subject
Areas,” page 2-28).
Number of data elements returned in each View can be further narrowed using the
User Guide January 2019 2-20 Request and response structure
optional values of RetrievePNR = true/false or
IncludeUpdateDetails = true/false.
ResponseFormat ResponseFormat enables to define how
response payload will be formatted and value
should be STL.
GetReservationRQ/ReturnOptions/SubjectAreas
Element Element Description
SubjectAreas SubjectArea "SubjectAreas" specifies particular information to be
included in response message if they are stored in the PNR
(see “View Names and Subject Areas ,” page 2-28).
GetReservationRQ/POS
Element Element Description
POS Source Source holds details regarding the requestor. It may be
repeated to also accommodate the delivery system.
GetReservationRQ/POS/Source
Element Attribute Element Description
Source This holds details regarding the requestor. It
may be repeated to also accommodate the
delivery systems.
BookingSource Identifies the booking source within the
requesting entity.
AgentSine Identifies the party within the requesting
entity.
PseudoCityCode An identification code assigned to an office
agency by a reservation system.
ISOCountry The country code of the requesting party.
ISOCurrency The currency of the country of the requesting
party.
AgentDutyCode An authority code assigned to a requestor.
AirlineVendorID The IATA assigned airline code.
AirportCode The IATA assigned airport code.
FirstDepartPoint The point of first departure in a trip.
SourceSystem e.g., CSS or CSI
User Guide January 2019 Request and response structure 2-21
TerminalID The electronic address of the device from which
information is entered.
HomePseudoCityCode An identification code assigned to the office/agency home city by a reservation
system.
RequestorID An identifier of the entity making the request
e.g., ATA/IATA/ID number, Electronic
Reservation Service Provider (ERSP),
Association of British Travel Agents (ABTA).
BookingChannel Specifies the booking channel type and whether it is the primary means of connectivity
of the source.
TTYRecordLocator Received via TeleType, the Locator is used to
identify a particular PNR.
OAC The Office Account Code defines the agency
PCC extension.
GetReservationRQ/POS/Source/RequestorID
Element Attribute Element Description
RequestorID An identifier of the entity making the request (e.g.
ATA/IATA/ID number, Electronic Reservation Service Provider (ERSP), Association of British Travel
Agents (ABTA)).
URL URL that identifies the location associated with the
record identified by the UniqueID.
Type A reference to the type of object defined by the
UniqueID element. Refer to OTA Code
List Unique ID Type (UIT).
Instance The identification of a record as it exists at a point
in time. An instance is used in update messages
where the sender must assure the server that the
update sent refers to the most recent modification
level of the object being updated.
ID A unique identifying value assigned by the creating system. The ID attribute may be used to reference a
primary-key value within a database or in a
particular implementation.
ID_Context Used to identify the source of the identifier (e.g.,
IATA, ABTA).
MessagePassword This password provides an additional level of
security that the recipient can use to validate the
sending party's authority to use the message.
CompanyName Identifies the company that is associated with the
UniqueID.
ArrangerDetails Contact information for the person that makes the
arrangements of the PNR.
User Guide January 2019 2-22 Request and response structure
GetReservationRQ/POS/Source/RequestorID/CompanyName
GetReservationRQ/POS/Source/BookingChannel/CompanyName
Element Attribute Description
CompanyName Identifies the company that is associated with the
UniqueID.
CompanyShortName Used to provide the company common name.
TravelSector Refers to OTA Code List Travel Sector (TVS).
Code Identifies a company by the company code.
CodeContext Identifies the context of the identifying code, such as
DUNS, IATA or internal code.
Division The division name or ID with which the contact is
associated.
Department The department name or ID with which the contact is
associated.
GetReservationRQ/POS/Source/RequestorID/ArrangerDetails
Element Element Description
ArrangerDetails Used to identify the details of the requestor.
PersonName Used to identify the contact name details of the requestor.
Telephone Used to identify the telephone number details of the
requestor.
Email Used to identify the email address details of the requestor.
GetReservationRQ/POS/Source/RequestorID/ArrangerDetails/PersonName
Element Element Description
PersonName Used to identify the contact name details of the
requestor.
Prefix A salutation of honorific e.g., Mr., Mrs., Ms., Miss., Dr.
Given The given name, first name or names.
Middle The middle name of the person name.
Surname The family name also known as last name
Suffix Holds various name suffixes and letters e.g., Jr., Sr., III.,
Ret., Esq.
Type Values include ADT or INF
User Guide January 2019 Request and response structure 2-23
Element Element Description
PreferredFirstName Any preferred name for first name used instead of the
Given Name.
PreferredSurname Any preferred names for last name used instead of
Surname.
GetReservationRQ/POS/Source/RequestorID/ArrangerDetails/Telephone
Element Element Description
Telephone Used to identify the telephone details of the requestor.
PhoneUseType Describes the type of telephone number, in the context of
its general use (e.g. Home, Business, Emergency Contact,
Travel Arranger, Day, Evening). Refer to OpenTravel Code
List
Phone Use Type (PUT).
PhoneCountryCode Describes the Country Code for the telephone number of
the requestor.
PhoneCountryName Describes the Country Name for the telephone number of
the requestor.
PhoneNumber Telephone number assigned to a single location.
GetReservationRQ/POS/Source/RequestorID/ArrangerDetails/Email
Element Description
Email Address of arranger, e.g. [email protected]
GetReservationRQ/POS/Source/BookingChannel
Element Attribute Element Description
Booking Channel Specifies the booking channel type and whether it is
the primary means of connectivity of the source.
Type The type of booking channel (e.g. Global Distribution
System (GDS), Alternative Distribution System (ADS),
Sales and Catering System (SCS), Property
Management System (PMS), Central Reservation
System (CRS), Tour Operator System (TOS), Internet
and ALL). Refer to OTA Code List Booking
Channel Type (BCT).
Primary Indicates whether the enumerated booking channel is
the primary means of connectivity used by the source.
CompanyName Identifies the company that is associated with the
booking channel.
User Guide January 2019 2-24 Request and response structure
GetReservationRQ/POS/Source/TTYRecordLocator
Element Element Description
TTYRecordLocator Received via TeleType, the Locator is used to identify a
particular PNR.
CRSLocator If the PNR was received from OAL (from CRS or OAL), the
Record Locator of the PNR in the creating system. Occurs
only for TTY created PNRs. Value for this optional field
can be populated if available. This optional field is used
for information and display purposes only.
CRSCode Airline Code of the RES System or CRS system that created
this PNR. This optional field is not used in any processing.
This optional field is used for information and display
purposes only.
RecordLocator Used to identify a particular PNR.
AgencyId The booking source arranger.
IataNumber The booking source location IATA number.
AgencyLocation The booking source agent location.
UserType Includes the values of A-Airline, E-ERSP, N-no user ID
assigned by IATA, T-user ID assigned by IATYA other than
ERSP.
CountryCode Describes the Country Code for the telephone number of
the requestor.
Currency The currency of the country of the requesting party.
DutyCode Duty code of the agent that issued a
ticket/refund/exchange /void.
ERSPUserId The Electronic Reservation Service Provider number.
FirstPointOfDeparture The first point of departure for the booking.
GetReservationRQ/POS/Source/OAC
Element Element Description
OAC Office Account Code. Defines agency PCC
extension.
PartitionId Default partition code from the OAC data
AccountingCityCode The personal account city code associated with the user AAA city during the original PNR create
session.
AccountingCode The personal account code associated with the
user AAA city during the original PNR create
session.
AccountingOfficeStationCode The station code from the OAC line used in this
PNR Create Session
User Guide January 2019 Request and response structure 2-25
GetReservationRQ/Poc
Element Element Description
Poc Point of Commencement is the first point of departure
amongst all of segments present in the PNR.
Poc can be used to explicitly specify journey's Point of
Commencement in case itinerary contains other
segments than air segments as well.
Provided values will be present in the RS payload in case
they are earlier than those defined by the first air
segment.
Airport Airport name.
Departure Date and Time of departure.
GetReservationRQ/ClientContext
Element Element Description
ClientContext It is required to provide ClientContext when calling the
downline services: Web Check In; Web RES; Interact Check
In; Interact RES; Kiosk Check In; TTY; PRS; GSM; SSCI
If context is set in GetReservation request - master PNR is
retrieved
Name Allows users to provide information about the caller to the
service.
This parameter is currently only available with
customization and it is not a standard service.
2.5.3 G e t R e s e r v a t i o n R S r e s p o n s e m e s s a g e ( R S )
The response message consists of elements and attributes, defined in the Schema.
The response is an XML file that contains data stored in PNRs that was requested. PNR data which
might be present in response message depends also on the security defined by viewership rules (for
more information please review Service Security).
Below you can find a sample of request and response corresponding.
Sample request:
<GetReservationRQ Version="1.19.0" xmlns="http://webservices.sabre.com/pnrbuilder/v1_19">
<RequestType>Stateful</RequestType>
<ReturnOptions>
<ViewName>Full</ViewName>
<ResponseFormat>STL</ResponseFormat>
</ReturnOptions>
</GetReservationRQ>
User Guide January 2019 2-26 Request and response structure
Sample response:
<ns4:GetReservationRS Version="1.19.0" xmlns:ns4="http://webservices.sabre.com/pnrbuilder/v1_19"
xmlns:ns2="http://services.sabre.com/res/or/v1_12" xmlns:ns3="http://tds.sabre.com/itinerary"
xmlns:ns5="http://webservices.sabre.com/pnrconn/ReaccSearch">
<ns4:Reservation numberInParty="1" numberOfInfants="0" NumberInSegment="1">
<ns4:BookingDetails>
<ns4:RecordLocator>GADLPQ</ns4:RecordLocator>
<ns4:CreationTimestamp>2015-09-16T13:36:00</ns4:CreationTimestamp>
<ns4:SystemCreationTimestamp>2015-09-16T13:36:00</ns4:SystemCreationTimestamp>
<ns4:CreationAgentID>DTZ</ns4:CreationAgentID>
<ns4:UpdateTimestamp>2015-09-16T13:36:51</ns4:UpdateTimestamp>
<ns4:PNRSequence>2</ns4:PNRSequence>
<ns4:FlightsRange Start="2015-10-15T10:25:00" End="2015-10-16T07:30:00"/>
<ns4:DivideSplitDetails/>
<ns4:EstimatedPurgeTimestamp>2015-10-15T00:00:00</ns4:EstimatedPurgeTimestamp>
<ns4:UpdateToken>-57b7e7b52c59dae59ff958e2a4b48683fe2ce5a822cfa248</ns4:UpdateToken>
</ns4:BookingDetails>
<ns4:POS>
<ns4:Source BookingSource="A0A0" AgentSine="DTZ" PseudoCityCode="HDQ" ISOCountry="US"
AgentDutyCode="5" AirlineVendorID="AA" HomePseudoCityCode="HDQ"/>
</ns4:POS>
<ns4:PassengerReservation>
<ns4:Passengers>
<ns4:Passenger id="3" nameType="S" nameId="01.01" nameAssocId="1">
<ns4:LastName>SBAQ</ns4:LastName>
<ns4:FirstName>RMQ</ns4:FirstName>
<ns4:Seats/>
</ns4:Passenger>
</ns4:Passengers>
<ns4:Segments>
<ns4:Poc>
<ns4:Airport>AUH</ns4:Airport>
<ns4:Departure>2015-10-15T10:25:00</ns4:Departure>
</ns4:Poc>
<ns4:Segment sequence="1" id="4">
<ns4:Air id="4" sequence="1" segmentAssociationId="2" isPast="false">
<ns4:DepartureAirport>AUH</ns4:DepartureAirport>
<ns4:DepartureAirportCodeContext>IATA</ns4:DepartureAirportCodeContext>
<ns4:ArrivalAirport>SYD</ns4:ArrivalAirport>
<ns4:ArrivalAirportCodeContext>IATA</ns4:ArrivalAirportCodeContext>
<ns4:OperatingAirlineCode>EY</ns4:OperatingAirlineCode>
<ns4:OperatingAirlineShortName>ETIHAD AIRWAYS</ns4:Operat ingAirlineShortName>
<ns4:EquipmentType>77W</ns4:EquipmentType>
<ns4:MarketingAirlineCode>EY</ns4:MarketingAirlineCode>
<ns4:MarketingFlightNumber>0450</ns4:MarketingFlightNumber>
<ns4:OperatingClassOfService>B</ns4:OperatingClassOfService>
<ns4:MarketingClassOfService>B</ns4:MarketingClassOfService>
<ns4:Seats/>
<ns4:AirlineRefId>RLEY*OCBVXG</ns4:AirlineRefId>
<ns4:Eticket>true</ns4:Eticket>
<ns4:DepartureDateTime>2015-10-15T10:25:00</ns4:DepartureDateTime>
User Guide January 2019 Request and response structure 2-27
<ns4:ArrivalDateTime>2015-10-16T07:30:00</ns4:ArrivalDateTime>
<ns4:FlightNumber>0450</ns4:FlightNumber>
<ns4:ClassOfService>B</ns4:ClassOfService>
<ns4:ActionCode>HK</ns4:ActionCode>
<ns4:NumberInParty>1</ns4:NumberInParty>
<ns4:SegmentSpecialRequests/>
<ns4:inboundConnection>false</ns4:inboundConnection>
<ns4:outboundConnection>false</ns4:outboundConne ction>
<ns4:ScheduleChangeIndicator>false</ns4:ScheduleChangeIndicator>
<ns4:SegmentBookedDate>2015-09-16T13:36:00</ns4:SegmentBookedDate>
</ns4:Air>
</ns4:Segment>
</ns4:Segments>
<ns4:TicketingInfo>
<ns4:FutureTicketing id="6" index="1">
<ns4:Code>TAW</ns4:Code>
<ns4:Comment>*</ns4:Comment>
</ns4:FutureTicketing>
</ns4:TicketingInfo>
<ns4:ItineraryPricing/>
</ns4:PassengerReservation>
<ns4:ReceivedFrom>
<ns4:Name>QA TESTING</ns4:Name>
</ns4:ReceivedFrom>
<ns4:PhoneNumbers>
<ns4:PhoneNumber id="5" index="1">
<ns4:CityCode>HDQ</ns4:CityCode>
<ns4:Number>1800123456</ns4:Number>
</ns4:PhoneNumber>
</ns4:PhoneNumbers>
<ns4:EmailAddresses/>
</ns4:Reservation>
</ns4:GetReservationRS>
The GetReservationRS service allows client applications can retrieve PNR data including the following:
1. Booking details (Header, Record Locator, Creation Timestamp, Update Timestamp, Flight
dates, Itinerary dates, Information about dividing and splitting booking (divided Record, Split
to record, split from record)
2. Point of Sale (POS)
a. Booking Source, Details about agency (PCC and HomePCC) and agent (Agent Duty
Code), Airport code, Airline VendorID Source system, TerminalID,
b. Information about requestor – ID, Company details, Arranger details
c. Booking channel – Company Name
d. TTY Record Locator (information about Central Reservation System CRS – Locator and
Code; Record Locator, Agency ID, IATA Number, Agency Location, User Type, Country
Code, Currency, Duty Code, ERSPUserID, First Point Of Departure),
e. Office Accounting Code (OAC) – Partition ID, Accounting Code, Accounting City Code,
Accounting Office Station Code
3. Passenger Reservation
User Guide January 2019 2-28 Views
a. Information about passengers, Information about Frequent Flyer, Email Address,
Profiles, Special Requests (Generic special request, Child request, APISRequest,
Emergency Contact Request, Special meal request, Passport info message, Seat
request, Unaccompanied Minor Message, wheelchair request, Ticketing request
b. Seats – Prereserved seats, Seat special requests
c. Prereserved seats
d. Accounting lines
e. Passenger Profile ID,
f. Ancillary services,
g. OSI,
h. Remarks,
i. Phone numbers,
j. Ticketing Info,
k. Frequent Traveler Upgrade Requests,
l. Open reservation elements
m. Segments (In GetReservationRS_v1.11 views (Simple, Default and Full) were adjusted
to provide full information about segments (with sequence and id) by default for all
segment type. It also allows to combine within one segment e.g. rail/hotel segment
and product corresponding to it. This logic will be used in all versions higher than
GetReservation _v1.11.)
n. Forms of payment
o. Ticketing information
p. Itinerary Pricing
q. BSG reservation
4. Reservation Value Score
5. DKNumbers
6. Corporated IDs
7. Received from
8. Reservation extensions\History
Possibility to retrieve information stored in PNR is regulated by viewership rules. For more
information please review Service Security.
2.6 V i e w s
The PNR data which will be present in the response payload depends on the View Name used in the
request. The number of data elements returned in each View can be further narrowed by Subject
Areas. If data elements corresponding to a specified Subject Area are not present in the PNR, then
those will not be returned in the response payload. The most common View Names and Subject Areas
are listed below. Custom made Views and Subject Areas may be developed if required.
View Description Allow Custom
Subject Areas3 History
User Guide January 2019 Subject Areas 2-29
Simple Always used, regardless of whether it is provided in the request.
Includes: HEADER (Booking and Point of Sale details).
Yes No
Default It contains PNR data specified by all ACTIVE1 SUBJECT AREAS.
Includes: SIMPLE VIEW; all PRIMARY SUBJECT AREAS
Yes No
Full
It contains PNR data spec
ified by all PRIMARY2 and HISTORY SUBJECT AREAS.
Includes: SIMPLE VIEW; all PRIMARY SUBJECT AREAS, DSS4, AIR_CABIN4, OPENRESDATA
Yes4 Yes
1Active Subject Areas – a set of subject areas that are predefined as default view
2Primary Subject Areas – a set of subject areas that are predefined as default view (without additional
information about the flight that are stored in DSS database
3Allow Custom Subject Areas – for selected views it is possible to determine what types of data are
presented in the web service response by defining SubjectAreas in the request.
4This functionality will be available starting from September release.
2.7 S u b j e c t A r e a s
Subject Areas define what parts of PNR data can be additionally presented in the web service
response. Provisioning of Subject Areas in the web service request is optional. Unless Subject Areas
are specified in the request, the default Subject Areas defined by the view that was chosen are
applied.
Simple view, can be extended by additional SubjectAreas. Information from SubjectAreas will be
provided in response message if they were stored in PNR. The most common SubjectAreas are listed
in the below.
Subject Areas Description
ACCOUNTING_LINE Agency accounting lines stored in the PNR.
ACTIVE This SA is an aggregator for a wide group of other Subject Areas: FQTV,
ADDRESS, DKNUMBER, VCR, PASSENGERDETAILS, PRERESERVEDSEAT, AFAX,
GFAX, REMARKS, MISC_TICKETING, BSGPROCESSING, FARETYPE, TICKETINGENTRIES, BAS_EXTENSION, CORPORATE_ID, ACCOUNTING_LINE,
SUBSCRIPTION_CARD, GROUP_PLANNER, TRAVEL_POLICY,
CUST_INSIGHT_PROFILE, TICKETING, TKT_ON_DEMAND, ITINERARY, DESCRIPTIVE_BILLING_INFO, EXT_FQTV, HEADER, NAME, RECORD_LOCATOR,
RECEIVED, PHONE, ANCILLARY, ORE_COUNT, EQD_DATA, DSS, OPENRESDATA
- Available only in stateless mode
ADDRESS Agency address data stored in the PNR.
User Guide January 2019 2-30 Subject Areas
ADD_SSR_RPH RPH attribute for particular SSR
AIR_CABIN Air Cabin supplements segment information with Air Cabin Class information
and adds Product nodes (Itinerary Products stored in Open Res)
AFAX AFAX allows to display hosted facts under GenericSpecialRequests and
OpenReservationElemets nodes (any SSR or OSI; DOCS, DOCO, WCHR, VGML,
PETC); All American Airlines facts (AFAX) excluding Pre-reserved seats
ANCILLARY Ancillary Items (Air Extra) stored in the PNR. Ancillaries are displayed in the
response only when NAME subject area is used in request.
BAS_EXTENSION BAS_EXTENSION supplements itinerary data with some additional data, mainly connected to Hotels and Cars e.g. confirmation number in Hotel,
credit card inf.
BSGPROCESSING Block Space Group data stored in the PNR.
CARRIER_INFORMATION_CALCULATE Using this Subject Area display of operating airline is chanaged in response:
information from DSS are used to recalculate the information of operating
airline.
CARRIER_INFORMATION_COMP ACT Using this Subject Area display of operating airline is chanaged in response: if operating Airline is equal marketing airline only marketing airline is
displayed.
CORPORATE_ID Agency ID for Corporate Client stored in the PNR.
CUST_INSIGHT_PROFILE Allows to display Profile information (Customer and Corporate)
DK_NUMBER Customer number stored in the PNR⎯agencies use DK number primarily as
an account reference identifier for billing purposes.
DSS DSS supplements segment information with data stored in DSS (those are
elapsed time, Air Miles Flown, Funnel Flight, Change of Gauge, Operating
Airline Code, Stop Quantity) and updates Equipment Type with current data.
EXT_FQTV External Frequent Traveler Number
FARETYPE Fare data stored in the PNR.
FQTV Frequent Flyer details stored in PNR.
GFAX GFAX allows to display general facts; All airline facts
HEADER PNR header data.
HISTORICAL - Displays history of the PNR
- Available only in stateless mode
- Allows to display PNR history
ITINERARY Itinerary data stored in the PNR including Air, Rail, Car, Hotel, etc. To display
full Itinerary information request should also include additional Subject
areas: DSS, AIR_CABIN, OPENRESDATA, BAS_EXTENSION
NAME Passenger Name stored in the PNR.
PASSENGERDETAILS Profile data, passenger type, email address, and other details stored in the
PNR.
PAY_INFO PayInfo contains data in the PAY field in the PNR
PHONE Phone data stored in the PNR.
User Guide January 2019 Serv ice Security 2-31
POPULATE_IS_PAST To determine if a particular segment is active or in past
PRICE_QUOTE1 PQ data received from PQ web service. The service is applicable for all price
quote users (basic and enhanced PQ).
PRERESERVEDSEAT Pre reserved seat data stored in the PNR.
PRICING_INFORMATION Itinerary pricing information stored in PNR. This subject area is used to
retrieve price quote information. This is a legacy way of retrieving those data
and is no longer recommended. The recommended way to obtain this
information is to use PRICE_QUOTE subject area.
RECEIVED Received From Field stored in the PNR.
RECORD_LOCATOR Allows to display TTY Record Locator
REMARKS Allows to display remark information (supported types: REG, HD, HS, CLIADR,
DELADR, INVOICE, ITINERARY, INTERFACE, CODED_A, PRTONTKT,
CORPORATE, FOP, QQ, FILLER, ITINSEGASSOC)
REMARK_ACTION_CODE GetRes will return ActionCode as a prefix in RemarkLine text for
types: SBUDIDS (INVOICE), SBPRINTONTICKET (PRTONTKT), SBCORPORATE
(CORPORATE), SBBILLING (INTERFACE) only when REMARK_ACTION_CODE
subject area is provided
TICKETING Ticketing information stored in the PNR.
VCR Virtual Coupon Record
*Active Subject Areas
1 For more information please go to:
https://developer.sabre.com/docs/soap_apis/air/fulfill/manage_price_quote_details/resources,
where you can read wide description of the PQ Web Service. The documentation mentioned above
is the most up-to date description that is available on dev studio. User Guide of PriceQuote Web
Service (linked above) provides information about types of operations that the service supports and
points out the ones that are not valid Price Quote Service requests. It also contains an explanation of
essential terms associated with the PriceQuote Web Service transactions
2.8 S e r v i c e S e c u r i t y
PNR related data retrieving options are available only to authorized users that provided a valid
token in the web service request. For most of service views, the getReservationRQ supports branch
access and global branch access rules in a consistent manner as the native Sabre application. Users
can retrieve data only from the partitions and/or PCCs they have access to. In a common case, it
means that a user of given Airline cannot access data of any other carrier unless it is allowed in the
native Sabre system.
Viewership rules suppress the display of PNR or specific information connected to the PNR. The data
viewership rules are based on:
User Guide January 2019 2-32 Serv ice Security
• PNR ownership
• Who is trying to view the data (Business Area AS / TN)
In addition, there are some limitations related to the type of Request used. Depending on whether it
was used Stateless, Stateful or Trip request viewership rules may differ. In particular, a stateless
request is not possible to receive history of the PNR.
As PNR viewership are controlled at a PCC level it is not the subject of this User Guide. For more
information about particular viewership rules please contact your Accounting manager.
User Guide January 2019 Updated Design Documents 3-33
Sabre Web Services are currently available on the Sabre Dev Studio site
https://developer.sabre.com.
GetReservationRQ will be stored in the Trip Management folder as Retrieve Itinerary.
Common schema files listed below are available on the Sabre Dev Studio site
https://developer.sabre.com/docs/read/soap_basics/development_patterns
3.1 U p d a t e d D e s i g n D o c u m e n t s
WSDL GetReservation_1.19.0.wsdl
Schema
GetReservationSTLRQ_v1.19.0.xsd
GetReservationSTLRS_v1.19.0.xsd
Ancillaries.1.14.0.xsd
Pricing.1.14.0
Lodging.1.14.0
PNRBuilderTypes_v1.19.0.xsd;
OpenReservation.1.14.0.xsd
Common Schemas
envelope.xsd;
msg-header-2_0.xsd;
wsse.xsd;
xlink.xsd;
xml.xsd;
xmldsig-core-schema.xsd
Payload Design
Documents GetReservationRQ_1.19.0_Design.xml
GetReservationRS_1.19.0_Design.xml
Additional
Documentation GetReservationRQ_1.19.0_User Guide.pdf
Sample XML
Payloads GetReservationListRQRS_SamplePayload_v1.19.xml
3 Documentation Updates 3
User Guide January 2019 4-34 Introduction
4.1 I n t r o d u c t i o n
This chapter contains the list of most common error codes and descriptions.
4.2 F a u l t E r r o r s
Message OTA Code
General PNR error 700001
Invalid PNR locator 700002
Invalid request 700003
Invalid request format 700004
Invalid request view 700005
No PNR was found with the specified record locator 700101
Viewership is restricted for the PNR 700102
No data for the PNR in DB 700103
Error parsing PNR 700104
PNR Connector unknown 700201
PNR Connector communication error 700202
PNR Connector communication timeout error 700203
JAXB marshalling error 700204
JAXB unmarshalling error 700205
Unexpected request type 700206
MOM messaging error 700207
PNRC service invocation error 700208
Error response from PNRC reaccomodation search service 700209
Unknown response format 700210
OTA parsing error 700211
Cannot unpack request from request root element 700212
4 Error Codes 4
User Guide January 2019 Fault Errors 4-35
Message OTA Code
Cannot pack response to response root element 700213
Error response from PNRC reaccomodation retrieve service 700214
TPFDF parsing exception 700215
No ATH 700216
Invalid ICE Session 700217
Broken ICE Session 700218
FIT parsing exception 700219
Invalid ICE credentials 700220
Access restricted to fl ight data 700221
Cannot search past fl ight data 700222
Access restricted to PNR data 700223
Flight not found 700224
Invalid search options 700225
PNR not found 700226
TVL version not supported 700227
PNR unknown error 700301
PNR communication error 700302
PNR communication timeout error 700303
Unable to read terminal 700404
Unable to Find AAA 700405
Agent not signed in 700406
PNR Locator error 700407
No PNR in AAA 700408
PNR Retrieval error 700409
PSS invalid request 700410
The PNR in the AAA has been modified 700411
Agent is active on a PNR queue 700412
Unable to process in PSS 700414
Parsing error 700415
Access restricted to fl ight data 700418
Access restricted to PNR data 700419
User Guide January 2019 4-36 Fault Errors
Message OTA Code
PSS Communication error 700420
PSS Communication timeout 700421
Access restricted to PNR data 700422
PNR Restricted 700423
PNR Not Found 700424
PNRC Timeout Error code 700425
PNR Database unavailable 700426
Link Down Error code 700427
Max message size exceeded 700428
System not in NORM state Error code 700429
Unable to Process error code 700430
Invalid subject area 700431
Reservation Orchestration Error 700432
User Guide January 2019 Introduction 5-37
5.1 I n t r o d u c t i o n
If you have any questions or need assistance, contact our Sabre Dev Studio Global Customer Support Center via any of the methods provided in this chapter.
5.2 P h o n e
When reporting production or other critical/time sensitive issues, contact us via telephone as follows:
Location Phone Number
USA 800-678-9460
Canada 682-605-5570
International 598-2-518-6020 or your regional Sabre Software help desk
5.3 E m a i l
Email is monitored 24 x 7 with a response within 24 hours or less. The email address is:
Caution Please include the Sabre Pseudo City Code (PCC) where the issue is occurring.
When reporting an issue with web services, input and output payloads are required. Please attach the payloads as separate files, and name them clearly. Samples of these files are available at:
https://developer.sabre.com
To help ensure that our environment is free of viruses, our policy mandates that all messages received by Sabre from external sources follow special file name guidelines. When sending zipped files please make a note of the following required file naming convention: File names must end in ".sabre.zip" or the zipped attachment will be removed by the email server (for example, “docs.zip” would need to be renamed to “docs.sabre.zip”).
If your correspondence is regarding a previously reported issue, please include the service incident (“SI”) number in the subject line of your message.
5 Technical Support – Travel Agencies and 3rd party developers
5
User Guide January 2019 6-38 Introduction
6.1 I n t r o d u c t i o n
If you have any questions or need assistance, contact our SabreSonic Helpdesk via any of the methods provided in this chapter.
6.2 P h o n e
When reporting production or other critical/time sensitive issues, contact us via telephone as follows:
Dial Option #1 for SabreSonic Select Web Services option
Country Toll free number
Antigua 888-832-4738
Argentina 0800-666-1664
Australia 1-800-081-993
Austria 800-291-705
Bahamas 1-800-389-0417
Bahrain 800-00-002 (WSC 5050)
Belarus 880-0114 PIN 375
Belgium 0800-77-029
Bolivia 800-10-0350
Brazil 0800-891-9210
Brunei 800-013 PIN 673
Canada 1-866-598-1706
Chile 800-412555
China 4001-202-315
Colombia 01-800-954-1326
Cyprus 800-96110
6 Technical Support – Sabre Hosted Airlines 6
User Guide January 2019 Phone 6-39
Czech Republic 800-700-117
Denmark 808-85884
Egypt - Cairo 7955-770 PIN 5670
El Salvador 800-0000-0011
Estonia 800-12-122 PIN 5047
Finland 0800-914-860
France 0800-909-657
Germany 0800-181-7245
Greece 00800-16-122-055-533
Hong Kong 800-908-742
Iceland 800-8667
India 000-800-100-6116
Indonesia 001-803-016-1722
Ireland 1-800-657-198
Israel 1-809-246-033
Italy 800-787-417
Jamaica 1-866-402-6835
Japan 0053-116-0811
Korea 0030-813-1943
Malaysia 1-800-813-609
Malta 800-90112 PIN 356
Mexico 01-800-123-8537
Netherlands 0800-023-2237
New Zealand 0800-450-960
Norway 800-18-798
Panama 00800-226-0662
Paraguay 009-800-598-1-0004
Peru 0800-52-226
Philippines 1-800-111-00338 or 1-800-111-00339
Poland 800-900-807
User Guide January 2019 6-40 Phone
Russia 810-800-240-31012
Saudi Arabia 1-800-11 PIN 5671
Singapore 800-101-1651
South Africa 0800-980-981
Spain 900-995-926
Sweden 0200-285-836
Switzerland 0800-894-354
Tahiti 888-832-4738
Thailand 1. Dial 001-999-111-11 (AT&T)
2. Wait for the recording asking for the number you are dialing.
3. Dial 888-832-4738.
Trinidad and Tobago 888-870-9002
UAE 800-035-702-569
UK 0800-0288446
Uruguay 2518-6642
USA 1-888-421-8889
Venezuela 0800-100-3851
Vietnam 1. Dial 1-201-0288 (AT&T Toll Free Number).
2. Wait for the recording asking for the number you are dialing.
3. Dial 866-947-8059.
User Guide January 2019 Email 6-41
6.3 E m a i l
Email is monitored 24 x 7 with a response within 24 hours or less. The email address is:
[email protected]:[email protected]
Caution Please include the Sabre Pseudo City Code (PCC) where the issue is occurring.
When reporting an issue with web services, input and output payloads are required. Please attach the payloads as separate files, and name them clearly. Samples of these files are available at:
https://developer.sabre.com
To help ensure that our environment is free of viruses, our policy mandates that all messages received by Sabre from external sources follow special file name guidelines. When sending zipped files please make a note of the following required file naming convention: File names must end in ".sabre.zip" or the zipped attachment will be removed by the email server (for example, “docs.zip” would need to be renamed to “docs.sabre.zip”).
If your correspondence is regarding a previously reported issue, please include the service incident (“SI”) number in the subject line of your message.
User Guide January 2019 Glossary 1
Following is a glossary of terms (listed in alphabetical order by term):
Term Description
AAA Agent Assembly Area - refers to the buffer in the Sabre system where content is retained
while a Sabre Host session is active
AS Sabre Airline Solutions
FOID Form Of Identification - is used to advise carrier what identification the passenger will
present upon check-in for e-ticket travel
GDS Code for the Global Distribution System. For example:
1S – Sabre
1B – Abacus
1J – Axess
1F – Infini
Locator PNR locator
OAC Office Accounting Code
OSI Other Supplementary Information - can be used when action or reply from carrier is not
required
PCC Pseudo City Code - uniquely identifies travel agency in the same way that a city code
identifies a city
PNR Passenger Name Record
POS Point of Sale
PSS Passenger Service System also known as Sabre Host
SAN Sabre Advance Notification
Segment Itinerary field of a Passenger Name Record holding actual booking (Air, Car, Rail, Hotel etc.)
SSR Special Service Request is used when action or response from carrier is required
STL Sabre XML format
TN Sabre Travel Network
7 Glossary