Upload
hoangdiep
View
219
Download
1
Embed Size (px)
Citation preview
`
Developer Administration Guide
Revalidate Itinerary API
Action code: RevalidateItinRQ
Schema Version v3.3.0
Release 2017.09
(September 2017)
Schema version 3.3.0
Document Edition 1.0 (September 2017)
This documentation is the confidential and proprietary information
of Sabre Inc. Any unauthorized use, reproduction, preparation of
derivative works, performance, or display of this document, or
software represented by this document, without the express written
permission of Sabre Inc., is strictly prohibited.
Sabre and Sabre Dev Studio are trademarks and/or service marks
of an affiliate of Sabre Corporation. All other trademarks, service
marks, and trade names are the property of their respective
owners.
© 2017 Sabre Inc. All rights reserved.
Developer Administration Guide September 2017 Table of Contents iii
Table of Contents
1 G e t t i n g S t a r t e d
1.1 Introduction ......................................................................................................................................... 1-1 1.2 Summary of Changes ......................................................................................................................... 1-1 1.3 About This Guide ................................................................................................................................ 1-1
2 R e v a l i d a t e I t i n e r a r y F u n c t i o n a l i t y
2.1 Introduction ......................................................................................................................................... 2-1 2.2 New Schema Element ........................................................................................................................ 2-1 2.3 Product Usage and Example .............................................................................................................. 2-2 2.4 XML Examples .................................................................................................................................... 2-3 2.5 JSON Examples.................................................................................................................................. 2-7
3 E r r o r M e s s a g e s
3.1 Introduction ......................................................................................................................................... 3-1
G l o s s a r y
iv Table of Contents Developer Administration Guide September 2017
• • •
Developer Administration Guide September 2017 Getting Started 1-1
1.1 I n t r o d u c t i o n
The purpose of this guide is to describe the Revalidate Itinerary API, which enables the ability to
recheck availability and price for a specific itinerary option without booking the itinerary, so the up-
to-date content can be presented.
Possible outcomes with this solution:
• Same option is available at same price.
• Same option is available at a different price (higher or lower).
• The option is no longer available.
1.2 S u m m a r y o f C h a n g e s
The RevalidateItinRQ API is available via OTA XML and JSON REST technology, and the primary
use case is to re-validate pricing and availability for a given itinerary.
1.3 A b o u t T h i s G u i d e
This guide provides information on the Revalidate Itinerary API enhancements in the Schema
response. Each chapter is as follows:
• Chapter 1, “Getting Started” explains the purpose of the document and provides a summary of
the changes to the system.
• Chapter 2, “Revalidate Itinerary Functionality” describes the details of this capability and the
schema detail.
• Chapter 3, “Errors Messages” describes the error messages for Revalidate Itinerary API.
• Glossary, provides a glossary of terms used in this document.
1 Getting Started 1
1-2 About This Guide Developer Administration Guide September 2017
• • •
Developer Administration Guide September 2017 Revalidate Itinerary Functionality 2-1
2.1 I n t r o d u c t i o n
This chapter includes the following:
• New schema element (see this page).
• Product usage and example (see “Product Usage and Example,” page 2-2).
• XML examples (see “XML Examples,” page 2-3).
• JSON examples (see “JSON Examples,” page 2-7).
2.2 N e w S c h e m a E l e m e n t
The following flights attributes are required in the request when re-validating price and availability
for a given itinerary:
• Flight arrival date and time.
• Class of Service - This element in is required in the request, and will be used in conjunction with
any other optional fare qualifiers, to re-price the given itinerary.
• Flight departure date and time.
• Flight number.
• Flight type (optional). Valid values are:
– A – AIR
– K – ARUNK
– O – OPEN
• Flight origin location code.
• Flight destination location code.
• Marketing and operating carrier code.
– BookingDateTime (optional).
2 Revalidate Itinerary Functionality 2
2-2 Product Usage and Example Developer Administration Guide September 2017
The following attributes are returned in the RevalidateItinRS response.
• For Revalidate Itinerary, the Repriced attribute was added to the AirItineraryPricingInfo element
to define the fare returned from re-pricing a requested itinerary using the requested booking code.
This will be marked as “Repriced” in the RevalidateItinRS. The type is “Boolean,” so valid
values are: true or false.
When you re-price a requested itinerary using this new functionality, and if the price is validated
and fare is available, you will be able to identify the re-priced solution marked as
Repriced=”true” in the RevalidateItinRS.
RevalidateItinRS/PricedItineraries/PricedItinerary/AirItineraryPricingInfo@Repriced
2.2.1 D e f i n i n g t h e R e v a l i d a t e I t i n e r a r y A P I
Historically, to check pricing and availability of a specific itinerary segment(s), it was required to
either create a PNR to hold or open a new session to revalidate a previously booked itinerary. The
Itinerary Revalidation API enables the creation of a single itinerary option to be revalidated for price
and availability without booking the itinerary and decrementing airline inventory. The itinerary sell
process is separate from this API.
When re-pricing a given itinerary, there is no guarantee that the same fare as in any previous search
or price request will be returned. The same RBD will be used, but there might be multiple different
fares per RBD and, among the possibilities that exist, the system could select a different price.
The functionality allows for any applicable Air Shopping qualifiers to replicate and revalidate the
price.
2.3 P r o d u c t U s a g e a n d E x a m p l e
This section includes instructions for how to use this feature as well as a sample with flight
information in the request.
2.3.1 F l i g h t I n f o r m a t i o n R e q u i r e d i n t h e R e q u e s t
This section shows the information should be included in TPA Extensions. Following is an example:
<OriginDestinationInformation RPH="1"> <DepartureDateTime>2017-10-22T11:27:00</DepartureDateTime>
<OriginLocation LocationCode="ATL"/>
<DestinationLocation LocationCode="BOS"/>
<TPA_Extensions>
<Flight ArrivalDateTime="2017-10-22T13:58:00" ClassOfService="C"
DepartureDateTime="2017-10-22T11:27:00" Number="1200" Type="O">
<OriginLocation LocationCode="ATL"/>
<DestinationLocation LocationCode="BOS"/>
<Airline Marketing="K0" Operating="K0"/>
<BookingDateTime>2017-08-21T09:37:55</BookingDateTime>
</Flight>
<SegmentType Code="O"/>
</TPA_Extensions>
Developer Administration Guide September 2017 Revalidate Itinerary Functionality 2-3
</OriginDestinationInformation>
2.4 X M L E x a m p l e s
This section includes three examples:
• Repriced attribute set to true in the response (see this page).
• OTA XML full request (see this page).
• OTA XML full response (see “OTA XML Full Response,” page 2-4).
2.4.1 R e p r i c e d A t t r i b u t e S e t t o T r u e
The Repriced attribute set to “true” in the RevalidateItinRS is to identify which is the re-priced
itinerary.
<AirItineraryPricingInfo PricingSource="WPNI1_ITIN" PricingSubSource="MIP"
Repriced="true" FareReturned="true" LastTicketDate="2017-08-18">
<ItinTotalFare>
<BaseFare Amount="947.91" CurrencyCode="USD" DecimalPlaces="2"/>
<FareConstruction Amount="947.91" CurrencyCode="USD" DecimalPlaces="2"/>
<EquivFare Amount="1210.00" CurrencyCode="AUD" DecimalPlaces="2"/>
<Taxes>
<Tax TaxCode="TOTALTAX" Amount="109.10" CurrencyCode="AUD" DecimalPlaces="2"/>
2.4.2 O T A X M L F u l l R e q u e s t
<OTA_AirLowFareSearchRQ xmlns:xs="http://www.w3.org/2001/XMLSchema"
Target="Production" Version="3.3.0" xmlns="http://www.opentravel.org/OTA/2003/05"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ResponseType="OTA">
<POS>
<Source PseudoCityCode="XXXX">
<RequestorID Type="0.AAA.X" ID="REQ.ID">
<CompanyName Code="TN"/>
</RequestorID>
</Source>
</POS>
<OriginDestinationInformation RPH="1">
<DepartureDateTime>2018-02-10T00:00:00</DepartureDateTime>
<OriginLocation LocationCode="LAX"/>
<DestinationLocation LocationCode="JFK"/>
<TPA_Extensions>
<Flight Number="1908" ClassOfService="P"
DepartureDateTime="2018-02-10T22:50:00" ArrivalDateTime="2018-02-11T07:00:00"
Type="A">
<OriginLocation LocationCode="LAX"/>
<DestinationLocation LocationCode="JFK"/>
<Airline Marketing="K0" Operating="K0"/>
</Flight>
</TPA_Extensions>
</OriginDestinationInformation>
<OriginDestinationInformation RPH="2">
2-4 XML Examples Developer Administration Guide September 2017
<DepartureDateTime>2018-02-16T00:00:00</DepartureDateTime>
<OriginLocation LocationCode="JFK"/>
<DestinationLocation LocationCode="LAX"/>
<TPA_Extensions>
<Flight Number="472" ClassOfService="P"
DepartureDateTime="2018-02-16T07:00:00" ArrivalDateTime="2018-02-16T09:56:00"
Type="A">
<OriginLocation LocationCode="JFK"/>
<DestinationLocation LocationCode="LAX"/>
<Airline Marketing="K0" Operating="K0"/>
</Flight>
</TPA_Extensions>
</OriginDestinationInformation>
<TravelPreferences>
<TPA_Extensions>
</TPA_Extensions>
</TravelPreferences>
<TravelerInfoSummary>
<SeatsRequested>1</SeatsRequested>
<AirTravelerAvail>
<PassengerTypeQuantity Code="ADT" Quantity="1"/>
</AirTravelerAvail>
<PriceRequestInformation>
<TPA_Extensions>
</TPA_Extensions>
</PriceRequestInformation>
</TravelerInfoSummary>
<TPA_Extensions>
<IntelliSellTransaction>
</IntelliSellTransaction>
</TPA_Extensions>
</OTA_AirLowFareSearchRQ>
2.4.3 O T A X M L F u l l R e s p o n s e
<OTA_AirLowFareSearchRS xmlns="http://www.opentravel.org/OTA/2003/05"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="3.3.0"
PricedItinCount="1" BrandedOneWayItinCount="0" SimpleOneWayItinCount="0"
DepartedItinCount="0" SoldOutItinCount="0" AvailableItinCount="0">
<Success/>
<Warnings>
<Warning Type="WORKERTHREAD" Code="TRANSACTIONID" MessageClass="I"
ShortText="8762765362989207685"/>
<Warning Type="SERVER" Code="TTFHLC850" MessageClass="I" ShortText="27031"/>
<Warning Type="DEFAULT" Code="RULEID" MessageClass="I" ShortText="25956"/>
<Warning Type="DRE" Code="RULEID" MessageClass="I" ShortText="25957"/>
</Warnings>
<PricedItineraries>
<PricedItinerary SequenceNumber="1">
<AirItinerary DirectionInd="Return">
<OriginDestinationOptions>
<OriginDestinationOption ElapsedTime="310">
<FlightSegment DepartureDateTime="2018-02-10T22:50:00"
ArrivalDateTime="2018-02-11T07:00:00" StopQuantity="0" FlightNumber="1908"
ResBookDesigCode="P" ElapsedTime="310">
<DepartureAirport LocationCode="LAX" TerminalID="2"/>
<ArrivalAirport LocationCode="JFK" TerminalID="4"/>
<OperatingAirline Code="K0" FlightNumber="1908"/>
<Equipment AirEquipType="76W"/>
Developer Administration Guide September 2017 Revalidate Itinerary Functionality 2-5
<MarketingAirline Code="K0"/>
<MarriageGrp>O</MarriageGrp>
<DepartureTimeZone GMTOffset="-8"/>
<ArrivalTimeZone GMTOffset="-5"/>
<OnTimePerformance Level="9"/>
<TPA_Extensions>
<eTicket Ind="true"/>
<Mileage Amount="2475"/>
</TPA_Extensions>
</FlightSegment>
</OriginDestinationOption>
<OriginDestinationOption ElapsedTime="356">
<FlightSegment DepartureDateTime="2018-02-16T07:00:00"
ArrivalDateTime="2018-02-16T09:56:00" StopQuantity="0" FlightNumber="472"
ResBookDesigCode="P" ElapsedTime="356">
<DepartureAirport LocationCode="JFK" TerminalID="4"/>
<ArrivalAirport LocationCode="LAX" TerminalID="2"/>
<OperatingAirline Code="K0" FlightNumber="472"/>
<Equipment AirEquipType="764"/>
<MarketingAirline Code="K0"/>
<MarriageGrp>O</MarriageGrp>
<DepartureTimeZone GMTOffset="-5"/>
<ArrivalTimeZone GMTOffset="-8"/>
<OnTimePerformance Level="8"/>
<TPA_Extensions>
<eTicket Ind="true"/>
<Mileage Amount="2475"/>
</TPA_Extensions>
</FlightSegment>
</OriginDestinationOption>
</OriginDestinationOptions>
</AirItinerary>
<AirItineraryPricingInfo PricingSource="WPNI1_ITIN" PricingSubSource="MIP"
Repriced="true" FareReturned="true" LastTicketDate="2017-09-16">
<ItinTotalFare>
<BaseFare Amount="2906.04" CurrencyCode="USD" DecimalPlaces="2"/>
<FareConstruction Amount="2906.04" CurrencyCode="USD"
DecimalPlaces="2"/>
<EquivFare Amount="23238" CurrencyCode="SEK" DecimalPlaces="0"/>
<Taxes>
<Tax TaxCode="TOTALTAX" Amount="1971" CurrencyCode="SEK"
DecimalPlaces="0"/>
</Taxes>
<TotalFare Amount="25209" CurrencyCode="SEK" DecimalPlaces="0"/>
</ItinTotalFare>
<PTC_FareBreakdowns>
<PTC_FareBreakdown>
<PassengerTypeQuantity Code="ADT" Quantity="1"/>
<FareBasisCodes>
<FareBasisCode BookingCode="P" AvailabilityBreak="true"
DepartureAirportCode="LAX" ArrivalAirportCode="JFK"
FareComponentBeginAirport="LAX" FareComponentEndAirport="JFK"
FareComponentDirectionality="FROM" FareComponentVendorCode="ATP"
GovCarrier="K0">MAWIA0DQ</FareBasisCode>
<FareBasisCode BookingCode="P" AvailabilityBreak="true"
DepartureAirportCode="JFK" ArrivalAirportCode="LAX"
FareComponentBeginAirport="JFK" FareComponentEndAirport="LAX"
FareComponentDirectionality="FROM" FareComponentVendorCode="ATP"
GovCarrier="K0">MAWIA0DQ</FareBasisCode>
</FareBasisCodes>
<PassengerFare>
2-6 XML Examples Developer Administration Guide September 2017
<BaseFare Amount="2906.04" CurrencyCode="USD"/>
<FareConstruction Amount="2906.04" CurrencyCode="USD"
DecimalPlaces="2"/>
<EquivFare Amount="23238" CurrencyCode="SEK" DecimalPlaces="0"/>
<Taxes>
<Tax TaxCode="AY" Amount="45" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<Tax TaxCode="AY" Amount="45" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<Tax TaxCode="US1" Amount="1743" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<Tax TaxCode="ZP" Amount="33" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<Tax TaxCode="ZP" Amount="33" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<Tax TaxCode="XF" Amount="36" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<Tax TaxCode="XF" Amount="36" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<TaxSummary TaxCode="US1" Amount="1743" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<TaxSummary TaxCode="ZP" Amount="66" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<TaxSummary TaxCode="AY" Amount="90" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<TaxSummary TaxCode="XF" Amount="72" CurrencyCode="SEK"
DecimalPlaces="0" CountryCode="US"/>
<TotalTax Amount="1971" CurrencyCode="SEK" DecimalPlaces="0"/>
</Taxes>
<TotalFare Amount="25209" CurrencyCode="SEK"/>
<TPA_Extensions>
<Messages>
<Message AirlineCode="K0" Type="N" FailCode="0"
Info="NONREF/PENALTY APPLIES"/>
<Message Type="W" FailCode="0" Info="VALIDATING CARRIER - K0"/>
</Messages>
</TPA_Extensions>
</PassengerFare>
<Endorsements NonRefundableIndicator="true"/>
<TPA_Extensions>
<FareCalcLine Info="LAX K0 NYC1453.02K0 LAX1453.02USD2906.04END
ZPLAXJFK XFLAX4.5JFK4.5"/>
</TPA_Extensions>
<FareInfos>
<FareInfo>
<FareReference>P</FareReference>
<TPA_Extensions>
<SeatsRemaining Number="1" BelowMin="false"/>
<Cabin Cabin="F"/>
</TPA_Extensions>
</FareInfo>
<FareInfo>
<FareReference>P</FareReference>
<TPA_Extensions>
<SeatsRemaining Number="1" BelowMin="false"/>
<Cabin Cabin="F"/>
</TPA_Extensions>
</FareInfo>
</FareInfos>
</PTC_FareBreakdown>
</PTC_FareBreakdowns>
Developer Administration Guide September 2017 Revalidate Itinerary Functionality 2-7
<FareInfos>
<FareInfo>
<FareReference>P</FareReference>
<TPA_Extensions>
<SeatsRemaining Number="1" BelowMin="false"/>
<Cabin Cabin="F"/>
</TPA_Extensions>
</FareInfo>
<FareInfo>
<FareReference>P</FareReference>
<TPA_Extensions>
<SeatsRemaining Number="1" BelowMin="false"/>
<Cabin Cabin="F"/>
</TPA_Extensions>
</FareInfo>
</FareInfos>
<TPA_Extensions>
<DivideInParty Indicator="false"/>
<ValidatingCarrier SettlementMethod="BSP" NewVcxProcess="true">
<Default Code="K0"/>
</ValidatingCarrier>
</TPA_Extensions>
</AirItineraryPricingInfo>
<TicketingInfo TicketType="eTicket"/>
<TPA_Extensions>
<ValidatingCarrier Code="K0"/>
</TPA_Extensions>
</PricedItinerary>
</PricedItineraries>
<TPA_Extensions>
<AirlineOrderList>
<AirlineOrder SequenceNumber="1" Code="K0"/>
</AirlineOrderList>
</TPA_Extensions>
</OTA_AirLowFareSearchRS>
2.5 J S O N E x a m p l e s
This section includes three examples:
• Repriced attribute set to true in the response (see this page).
• JSON full request (see “JSON Full Request,” page 2-8).
• JSON full response (see “JSON Full Response,” page 2-9).
2.5.1 R e p r i c e d A t t r i b u t e S e t t o T r u e i n t h e R e s p o n s e
The Repriced attribute set to “true” in the response is to identify which is the re-priced itinerary.
2-8 JSON Examples Developer Administration Guide September 2017
"AirItineraryPricingInfo": [
{
"LastTicketDate": "2017-05-17",
"PricingSource": "WPNI1_ITIN",
"PricingSubSource": "MIP",
"FareReturned": true,
"Repriced": true,
"ItinTotalFare": {
"BaseFare": {
"Amount": 990.7,
"CurrencyCode": "USD",
"DecimalPlaces": 2
},
"FareConstruction": {
"Amount": 990.7,
"CurrencyCode": "USD",
"DecimalPlaces": 2
},
"EquivFare": {
"Amount": 990.7,
"CurrencyCode": "USD",
"DecimalPlaces": 2
}
2.5.2 J S O N F u l l R e q u e s t
{
"OTA_AirLowFareSearchRQ": {
"Target": "Production",
"POS": {
"Source": [
{
"PseudoCityCode": "XXXX",
"RequestorID": {
"Type": "0.AAA.X",
"ID": "REQ.ID",
"CompanyName": {}
}
}
]
},
"OriginDestinationInformation": [
{
"RPH": "1",
"DepartureDateTime": "2018-02-10T00:00:00",
"OriginLocation": {
"LocationCode": "LAX"
},
"DestinationLocation": {
"LocationCode": "JFK"
},
"TPA_Extensions": {
"Flight": [
{
"Number": 1908,
"DepartureDateTime": "2018-02-10T22:50:00",
"ArrivalDateTime": "2018-02-11T07:00:00",
Developer Administration Guide September 2017 Revalidate Itinerary Functionality 2-9
"Type": "A",
"ClassOfService": "P",
"OriginLocation": {
"LocationCode": "LAX"
},
"DestinationLocation": {
"LocationCode": "JFK"
},
"Airline": {
"Operating": "K0",
"Marketing": "K0"
}
}
]
}
},
{
"RPH": "2",
"DepartureDateTime": "2018-02-16T00:00:00",
"OriginLocation": {
"LocationCode": "JFK"
},
"DestinationLocation": {
"LocationCode": "LAX"
},
"TPA_Extensions": {
"Flight": [
{
"Number": 472,
"DepartureDateTime": "2018-02-16T07:00:00",
"ArrivalDateTime": "2018-02-16T09:56:00",
"Type": "A",
"ClassOfService": "P",
"OriginLocation": {
"LocationCode": "JFK"
},
"DestinationLocation": {
"LocationCode": "LAX"
},
"Airline": {
"Operating": "K0",
"Marketing": "K0"
}
}
]
}
}
2.5.3 J S O N F u l l R e s p o n s e
" OTA_AirLowFareSearchRS": {
"PricedItinCount": 1,
"BrandedOneWayItinCount": 0,
"SimpleOneWayItinCount": 0,
"DepartedItinCount": 0,
"SoldOutItinCount": 0,
"AvailableItinCount": 0,
"Version": "3.3.0",
2-10 JSON Examples Developer Administration Guide September 2017
"Success": {},
"Warnings": {
"Warning": [
{
"Type": "WORKERTHREAD",
"ShortText": "8762765362989207685",
"Code": "TRANSACTIONID",
"MessageClass": "I"
},
{
"Type": "SERVER",
"ShortText": "27031",
"Code": "TTFHLC850",
"MessageClass": "I"
},
{
"Type": "DEFAULT",
"ShortText": "25956",
"Code": "RULEID",
"MessageClass": "I"
},
{
"Type": "DRE",
"ShortText": "25957",
"Code": "RULEID",
"MessageClass": "I"
}
]
},
"PricedItineraries": {
"PricedItinerary": [
{
"SequenceNumber": 1,
"AirItinerary": {
"DirectionInd": "Return",
"OriginDestinationOptions": {
"OriginDestinationOption": [
{
"ElapsedTime": 310,
"FlightSegment": [
{
"DepartureDateTime": "2018-02-
10T22:50:00",
"ArrivalDateTime": "2018-02-
11T07:00:00",
"StopQuantity": 0,
"FlightNumber": "1908",
"ResBookDesigCode": "P",
"ElapsedTime": 310,
"DepartureAirport": {
"LocationCode": "LAX",
"TerminalID": "2"
},
"ArrivalAirport": {
"LocationCode": "JFK",
"TerminalID": "4"
},
"OperatingAirline": {
"Code": "K0",
"FlightNumber": "1908"
},
Developer Administration Guide September 2017 Revalidate Itinerary Functionality 2-11
"Equipment": [
{
"AirEquipType": "76W"
}
],
"MarketingAirline": {
"Code": "K0"
},
"MarriageGrp": "O",
"DepartureTimeZone": {
"GMTOffset": -8
},
"ArrivalTimeZone": {
"GMTOffset": -5
},
"OnTimePerformance": {
"Level": "9"
},
"TPA_Extensions": {
"eTicket": {
"Ind": true
},
"Mileage": {
"Amount": 2475
}
}
}
]
},
{
"ElapsedTime": 356,
"FlightSegment": [
{
"DepartureDateTime": "2018-02-
16T07:00:00",
"ArrivalDateTime": "2018-02-
16T09:56:00",
"StopQuantity": 0,
"FlightNumber": "472",
"ResBookDesigCode": "P",
"ElapsedTime": 356,
"DepartureAirport": {
"LocationCode": "JFK",
"TerminalID": "4"
},
"ArrivalAirport": {
"LocationCode": "LAX",
"TerminalID": "2"
},
"OperatingAirline": {
"Code": "K0",
"FlightNumber": "472"
},
"Equipment": [
{
"AirEquipType": "764"
}
],
"MarketingAirline": {
"Code": "K0"
},
2-12 JSON Examples Developer Administration Guide September 2017
"MarriageGrp": "O",
"DepartureTimeZone": {
"GMTOffset": -5
},
"ArrivalTimeZone": {
"GMTOffset": -8
},
"OnTimePerformance": {
"Level": "8"
},
"TPA_Extensions": {
"eTicket": {
"Ind": true
},
"Mileage": {
"Amount": 2475
}
}
}
]
}
]
}
},
"AirItineraryPricingInfo": [
{
"LastTicketDate": "2017-09-16",
"PricingSource": "WPNI1_ITIN",
"PricingSubSource": "MIP",
"FareReturned": true,
"Repriced": true,
"ItinTotalFare": {
"BaseFare": {
"Amount": 2906.04,
"CurrencyCode": "USD",
"DecimalPlaces": 2
},
"FareConstruction": {
"Amount": 2906.04,
"CurrencyCode": "USD",
"DecimalPlaces": 2
},
"EquivFare": {
"Amount": 23238,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
"Taxes": {
"Tax": [
{
"TaxCode": "TOTALTAX",
"Amount": 1971,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
}
]
},
"TotalFare": {
"Amount": 25209,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
Developer Administration Guide September 2017 Revalidate Itinerary Functionality 2-13
}
},
"PTC_FareBreakdowns": {
"PTC_FareBreakdown": [
{
"PassengerTypeQuantity": {
"Code": "ADT",
"Quantity": 1
},
"FareBasisCodes": {
"FareBasisCode": [
{
"BookingCode": "P",
"AvailabilityBreak": true,
"DepartureAirportCode":
"LAX",
"ArrivalAirportCode": "JFK",
"FareComponentBeginAirport":
"LAX",
"FareComponentEndAirport":
"JFK",
"FareComponentDirectionality": "FROM",
"FareComponentVendorCode":
"ATP",
"GovCarrier": "K0",
"content": "MAWIA0DQ"
},
{
"BookingCode": "P",
"AvailabilityBreak": true,
"DepartureAirportCode":
"JFK",
"ArrivalAirportCode": "LAX",
"FareComponentBeginAirport":
"JFK",
"FareComponentEndAirport":
"LAX",
"FareComponentDirectionality": "FROM",
"FareComponentVendorCode":
"ATP",
"GovCarrier": "K0",
"content": "MAWIA0DQ"
}
]
},
"PassengerFare": {
"BaseFare": {
"Amount": 2906.04,
"CurrencyCode": "USD"
},
"FareConstruction": {
"Amount": 2906.04,
"CurrencyCode": "USD",
"DecimalPlaces": 2
},
"EquivFare": {
"Amount": 23238,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
2-14 JSON Examples Developer Administration Guide September 2017
},
"Taxes": {
"Tax": [
{
"TaxCode": "AY",
"CountryCode": "US",
"Amount": 45,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
{
"TaxCode": "AY",
"CountryCode": "US",
"Amount": 45,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
{
"TaxCode": "US1",
"CountryCode": "US",
"Amount": 1743,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
{
"TaxCode": "ZP",
"CountryCode": "US",
"Amount": 33,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
{
"TaxCode": "ZP",
"CountryCode": "US",
"Amount": 33,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
{
"TaxCode": "XF",
"CountryCode": "US",
"Amount": 36,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
{
"TaxCode": "XF",
"CountryCode": "US",
"Amount": 36,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
}
],
"TaxSummary": [
{
"TaxCode": "US1",
"CountryCode": "US",
"Amount": 1743,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
Developer Administration Guide September 2017 Revalidate Itinerary Functionality 2-15
{
"TaxCode": "ZP",
"CountryCode": "US",
"Amount": 66,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
{
"TaxCode": "AY",
"CountryCode": "US",
"Amount": 90,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
},
{
"TaxCode": "XF",
"CountryCode": "US",
"Amount": 72,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
}
],
"TotalTax": {
"Amount": 1971,
"CurrencyCode": "SEK",
"DecimalPlaces": 0
}
},
"TotalFare": {
"Amount": 25209,
"CurrencyCode": "SEK"
},
"TPA_Extensions": {
"Messages": {
"Message": [
{
"AirlineCode": "K0",
"Type": "N",
"FailCode": 0,
"Info":
"NONREF/PENALTY APPLIES"
},
{
"Type": "W",
"FailCode": 0,
"Info": "VALIDATING
CARRIER - K0"
}
]
}
}
},
"Endorsements": {
"NonRefundableIndicator": true
},
"TPA_Extensions": {
"FareCalcLine": {
"Info": "LAX K0 NYC1453.02K0
LAX1453.02USD2906.04END ZPLAXJFK XFLAX4.5JFK4.5"
}
},
2-16 JSON Examples Developer Administration Guide September 2017
"FareInfos": {
"FareInfo": [
{
"FareReference": "P",
"TPA_Extensions": {
"SeatsRemaining": {
"Number": 1,
"BelowMin": false
},
"Cabin": {
"Cabin": "F"
}
}
},
{
"FareReference": "P",
"TPA_Extensions": {
"SeatsRemaining": {
"Number": 1,
"BelowMin": false
},
"Cabin": {
"Cabin": "F"
}
}
}
]
}
}
]
},
"FareInfos": {
"FareInfo": [
{
"FareReference": "P",
"TPA_Extensions": {
"SeatsRemaining": {
"Number": 1,
"BelowMin": false
},
"Cabin": {
"Cabin": "F"
}
}
},
{
"FareReference": "P",
"TPA_Extensions": {
"SeatsRemaining": {
"Number": 1,
"BelowMin": false
},
"Cabin": {
"Cabin": "F"
}
}
}
]
},
"TPA_Extensions": {
"DivideInParty": {
Developer Administration Guide September 2017 Revalidate Itinerary Functionality 2-17
"Indicator": false
},
"ValidatingCarrier": [
{
"SettlementMethod": "BSP",
"NewVcxProcess": true,
"Default": {
"Code": "K0"
}
}
]
}
}
],
"TicketingInfo": {
"TicketType": "eTicket"
},
"TPA_Extensions": {
"ValidatingCarrier": {
"Code": "K0"
}
}
}
]
},
"TPA_Extensions": {
"AirlineOrderList": {
"AirlineOrder": [
{
"Code": "K0",
"SequenceNumber": 1
}
]
}
}
}
}
2-18 JSON Examples Developer Administration Guide September 2017
• • •
Developer Administration Guide September 2017 Error Messages 3-1
3.1 I n t r o d u c t i o n
There are no new error messages to be implemented in the Revalidate Itinerary API, however, if the
customer combine shopping or pricing qualifiers not supported with this functionality, the system
might return an error in the response. The error messages returned might differ as well the reason
why the option is no longer available.
The most common error messages returned are the following:
No Fare:
• NO COMBINABLE FARES FOR CLASS USED
• NO FARE FOR CLASS USED
No schedules:
• NO FLIGHT SCHEDULES FOR QUALIFIERS USED
• NO SUCH FLIGHT
No availability:
• NO AVAILABILITY
3 Error Messages 3
3-2 Introduction Developer Administration Guide September 2017
• • •
Developer Administration Guide September 2017 Glossary 1
Glossary
Term Description
PNR Passenger Name Record
RBD Reservation Booking Designator
2 Glossary Developer Administration Guide September 2017
• • •