Transcript (Version 01) Galileo Web Services (GWS) Update Releases
Developer Advisory
Developer Advisory Number: Version: Load To Production: High Level Description: Impact Summary: Reason For Issue:
Galileo Web Services (GWS) Update Releases
447 01 Available Now First Notification Galileo Web Services (GWS) Overview – updates have been made to help system, transactions, and XML samples. GWS customers must review the Archived Transactions section in the release notes prior to upgrading their systems.
Customer Impact:
Internal Only Agency Customers eCommerce Customers Developers Airline Customers Car, Hotel, Rail or Cruise Customers
System: Load To Copy: Web Services: (API and Messaging) Issue History:
Galileo Apollo Worldspan Available Now These changes are loaded to Web Services. Samples and help files are also updated. Additionally, the GWS Help System has been updated with the associated changes. http://testws.galileo.com/GWSSample/Help/GWSHelp/gws.htm
Version 01 January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 1
Developer Advisory Galileo Web Services (GWS) Update Releases
Overview
The following sections describe the details of the Galileo Web Services (GWS) release.
Customer Benefit
Varies based on technology consumed Recommended upgrade to the latest XML Transactions
What’s New in GWS Release
The following information is a summary of the changes made to GWS since the previous release.
Transactions
The following categories show the transactions that have never before been released and existing transactions that have been updated with new functionality.
New Transactions
(No prior version of these transactions have ever been released).
None.
Replacement Transactions
(New versions of released transactions).
AgencyInfoDisplay_9
AgencyInfoDisplay returns information about the requested Pseudo City Code (PCC) Information on up to nine different PCCs can be requested in one request. This transaction was modified to incorporate the new field ‘Agency Account Number’ in the response. This transaction can also be used to request agency information. Returned data includes the PCC, agency name, and agency address. See the Data Record Changes section to review detailed changes: 1430
Note
: AgencyInfoDisplay_8 was also released as an archived transaction. January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 2
Developer Advisory Galileo Web Services (GWS) Update Releases
AirAvailability_14
AirAvailability supplies scheduled flights between a given city pair on a given day, and indicates whether seats are available on those flights. AirAvailability can also provide availability for carriers or flights. Various qualifiers are available to narrow the search criteria. AirAvailability also offers a timetable option, which shows flight schedules for the specified date range. See the Data Record Changes section to review detailed changes: 1000
AirAvailabilityByTariff_25
AirAvailabilityByTariff returns a list of available flights that fulfil the rule requirements for a specified tariff. The typical activities for this feature include: The user requests a specific tariff fare and preferred carrier availability. The transaction searches for available flights that fulfil the fare quote rules for that fare. After fares rules have been retrieved for the given city pair, a selection of valid dates is returned that satisfy the fare rules. The user selects a specific date from the valid dates. Availability for the selected date, origin, and destination is retrieved. A grouping of up to 48 flights that satisfy the request is returned.
Note
: AirAvailabilityByTariff_24 was also released as an archived transaction. See the Data Record Changes section to review detailed changes: 1000
AirAvailabilityWithCabin_6
AirAvailabilityWithCabin supplies scheduled flights between a given city pair on a given day, and indicates whether seats are available on those flights. What differentiates this transaction from AirAvailability is the inclusion of AAB1
AutoRefundExchange_13
AutoRefundExchange is used to confirm the refund price or the new price for a changed (exchanged) itinerary. To confirm this data, the PNR must contain stored fare data in an ATFQ. See the Data Record Changes section to review detailed changes: 2025
Developer Advisory Galileo Web Services (GWS) Update Releases
ETicketRetrieval_8
ETicketRetrieval is used to retrieve the itinerary and the fare construction from the original ticket. See the Data Record Changes section to review detailed changes. 2025
FareQuoteCalendarDates_22
FareQuoteCalendarDates corresponds to the Calendar Shop feature, which combines three functions within one transaction. A tariff display function returns available tariff fares. A second structured rule transaction returns calendar/time restraints for the tariffs (only dates that are valid for that tariff display as available). A third transaction validates a selected tariff fare against the rules. For the user, a Calendar Shop feature might involve entering an itinerary and receiving fares associated with those segments. The user can then select a fare and view which dates are applicable to that fare. This fare quote function is best suited to fare-driven travellers who are flexible about the dates and times of their itinerary. See the Data Record Changes section to review detailed changes: 1424
FareQuoteFlexShop_10
FareQuoteFlexShop serves as a fare shopper tool for users who want to check prices for a general itinerary. It is best suited for fare- and schedule-driven travellers. This transaction mirrors the FareQuoteSuperBB transaction, except for the additional flexible shopping feature. The flexible shopping feature encompasses: Flex Airport. Flex Origin and Destination. Flex One Day. Flex More Days. Flex Weekend. See the Data Record Changes section to review detailed changes: 1000
FareQuoteMultiDisplay_22
FareQuoteMultiDisplay allows a user to request tariff displays, rules display (follow-on), currency conversions, ticketing point mileage, and faring functions. See the Data Record Changes section to review detailed changes: 1424
Developer Advisory Galileo Web Services (GWS) Update Releases
FareScheduleDisplay_2
The FareScheduleDisplay transaction allows the agent to make both an availability and a fare display request in one entry. The request applies to flight availability, plus normal and excursion fare options within the U.S., Canada, Puerto Rico and the U.S. Virgin Islands. The response includes the available flights and the best fare options for those flights, the fare basis code, and also indicates whether the fare is roundtrip See the Data Record Changes section to review detailed changes: 1000
FareQuoteSuperBB_29
FareQuoteSuperBB serves as a fare shopper tool for users who want to check prices for a general itinerary. This transaction: Allows a user to find the best price options for a proposed journey, using origin/destination and date information, without requiring a booked itinerary. Combines air availability and a fare quote request. This transaction allows users to enter criteria to limit the shopping request, such as time period, specific carriers to include or exclude, private fare modifiers, and passenger types. See the Data Record Changes section to review detailed changes: 1000
PNRBFDivide_9
The PNRBFDivide transaction allows you to divide or split booking into two different bookings, which, up until now, has only been available to terminal emulation users. Dividing bookings is a method for users to manage their bookings with fewer keystrokes, and to handle unique booking situations. See the Data Record Changes section to review detailed changes: 2025
PNRBFManagement_31
PNRBFManagement allows users to manage most aspects of the PNR or BF creation and modification. See the Data Record Changes section to review detailed changes: 1060
Developer Advisory Galileo Web Services (GWS) Update Releases
PricingRefundExchange_5
This transaction allows the user to retrieve the refund or exchange price for a ticketed booking. To retrieve this data, the PNR must be ticketed.
Note
: PricingRefundExchange_3 was also released as an archived transaction. See the Data Record Changes section to review detailed changes: 4084
QueueProcessing_9
QueueProcessing provides the functionality to list, view, and manipulate PNRs or BFs on a queue. See the Data Record Changes section to review detailed changes: 2025
TicketInfoDisplay_12
This transaction is used to obtain information on valid tickets for the passenger. Valid tickets are tickets which were issued, used, but not voided, refunded or exchanged. Tickets can be requested by type: paper, electronic or both. Canned remarks information from PNR/BF. Pseudo city information. See the Data Record Changes section to review detailed changes: 1425
Modified Transactions
(Previously released transactions that have been changed in some way).
DocProdFareManipulation_14
The DocProdFareManipulation transaction controls the manipulation and redisplay of stored fares. It also allows MCOs and tickets to be issued for a specified fare within a PNR or BF. See the Data Record Changes section to review detailed changes: 1425
FareQuoteBestBuyCompare_23
A basic fare quote provides airfare quotes based on the itinerary and class of service booked. This transaction is used to compare the fare for a booked itinerary, and the best buy fare returned by the FareQuoteBestBuyCompare request. See the Data Record Changes section to review detailed changes: 1425
Developer Advisory Galileo Web Services (GWS) Update Releases
FareQuoteBestBuyRegardless_21
A basic fare quote provides airfare quotes based on the itinerary and class of service booked. This transaction is used to search for the best buy fare, regardless of availability. See the Data Record Changes section to review detailed changes: 1425
FareQuoteClassSpecific_25
FareQuoteClassSpecific obtains a fare quote for an itinerary supplied by the requestor, taking into consideration all appropriate fare rules and fare construction principles. Up to eight segments can be supplied by the requestor. See the Data Record Changes section to review detailed changes: 1425
FareQuoteDollarSaver_25
FareQuoteDollarSaver (Fare Quote Best Buy Dollar Saver) finds the best price for a booked itinerary, including all classes that are currently available on the flights that itinerary. See the Data Record Changes section to review detailed changes: 1425
FareQuoteFinder_24
FareQuoteFinder (Fare Quote Finder - Best Buy Quote) prices the current itinerary at the lowest available fare. This transaction uses the origin/destination and date information from a booked itinerary to find the best price options for a proposed journey. See the Data Record Changes section to review detailed changes: 1425
FareQuoteFlightSpecific_25
FareQuoteFlightSpecific finds the lowest price for an itinerary specified in the request, including all classes that are currently available on the flights in that itinerary. See the Data Record Changes section to review detailed changes: 1425
FareQuoteStandard_25
FareQuoteStandard transaction finds the lowest price for the booked itinerary. See the Data Record Changes section to review detailed changes: 1425
Retired Transactions
(Retired versions of previously released transactions). None. January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 7
Developer Advisory Galileo Web Services (GWS) Update Releases
Help System Changes
The following descriptions highlight the enhancements to the XML Select Help system.
Transaction and Task Documentation
Galileo by Travelport is in the process of updating all Transaction documentation to provide standardized field descriptions that are more complete and less ambiguous. Some transactions have been updated for this release, while others will be updated in future releases. This effort is an ongoing process. New and updated transactions have associated task documentation. The task documentation describes how to use the transactions to perform specific business functions. This documentation displays in the How To section of the individual transactions. Task documents have been either updated or added to new and existing transactions, and related samples are linked with the task document. The XML API and GWS Technical Communications and Development staff have been diligently working on updating KLR and NWB documentation to make the description for all fields and nodes in the XML transactions more legible and easier to understand. Although the process is not complete, we strive for more completion with every release. Click the data record links in each transaction listed above to see a specific list of updated KLRs and NWBs.
Linear Display Changes for Surcharges
This project is to provide the functionality to enable Travelport 360Fares™on the Apollo™ by Travelport™, Galileo™ by Travelport™ and Worldspan™ by Travelport™ Pricing systems to process and provide the new industry defined Q surcharge formats in a fare calculation ladder for all pricing/shopping responses. This development is in response to IATA Resolution Manual 32 (Resolution 722.3.16.7) changes that were effective 01JUN2012. In the following transactions, the response may now include the text "3I=Alternate (4B) Expanded Surcharge." AirAvailabilityByTariff_25 DocProdFareManipulation_14 FareQuoteBestBuyCompare_23 FareQuoteBestBuyRegardless_21 FareQuoteCalendarDates_21 FareQuoteClassSpecific_25 FareQuoteDollarSaver_25 FareQuoteFinder_24 FareQuoteFlexShop_9 FareQuoteFlightSpecific_25 FareQuoteMultiDisplay_21 FareQuoteStandard_25 FareQuoteSuperBB_27 PNRBFManagement_30
Furthest Point Definition Changes using Global Direction for Baggage and Ticketing Fees
Some Service Fees are based on the Turnaround Point of the journey and current Data Application notes that to determine the furthest point subscribers should use TPM (Ticketed Point Mileage), MPM (Maximum Permitted Mileage), or in the absence of both, GCM (Great Circle Mileage). If there is more than one TPM or MPM for the points being measured, data application specifies to use the highest value to ensure consistency regardless of January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 8
Developer Advisory Galileo Web Services (GWS) Update Releases Global Direction (GD). In 2012, ATPCO proposed a revision to the YQ/YR Service Fees Data Application to include Global direction as criteria for determining the applicable TPM or MPM to be used for turnaround point resolution. Travelport™ implemented this industry standard per customer demand. The following Service Fees product’s Data Application will likewise be changed to ensure consistency and create standardized processing across systems. Baggage Allowance and Charges Ticketing Fees The revised definition for furthest point determination will apply to Travelport pricing, shopping and standalone type entries. These changes are reflected in the following transactions: AirAvailabilityByTariff_25 FareQuoteCalendarDates_22 FareQuoteMultiDisplay_22
New Passive Hotel Booking Reason Codes in MIR
New passive hotel booking reason codes for Optional MIR Label A16O1D Data Identifier /BC- (Booking Reason Code) for Bed and Breakfast Lodging (B), Customer Rate (C) and passive segments created by Travelport Rooms and More™ (T). These changes are reflected in the following Help System Documents: Hotel MK Passive Sell Optional Field Data document B - Bed and Breakfast Lodging C - Customer Rate
ARNE Exchange Enhancements
ARNE calculates the new fare for a revised itinerary using historical and current fares and rules data filed by airlines in ATPCO Category 31 (Voluntary Changes) and displays the results, including any additional collections, refunds and penalty fee amounts. These changes are reflected in the following transactions: PricingRefundExchange_5 Task Exchange Pricing PricingRefundExchange_5_s3.xml
Apollo and Galileo Air Status Codes
Air Status Codes were updated with the following values: GK - Group confirmed manually/verbally confirmed. No message sent GL - Group waitlisted, no message sent GN- Group request, message sent
Help Feedback
Each page in the help system, as well as the help pages associated with the transaction files, now has a feedback link. Click the Submit feedback on this page link at the bottom to send an email to GAP-Falcon [email protected]. This feedback will allow the XML Select documentation team to respond to page specific documentation issues. January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 9
Developer Advisory Galileo Web Services (GWS) Update Releases
Archived Transactions
Older versions of transactions become archived. Archived transactions retain their functionality and are documented in the Archived Transaction book of the Help. However, it is strongly encouraged that the latest versions of the transactions be used for increased functionality and stability. Refer to Archived Transactions for a complete list of transactions that have been archived, as well as the newest replacement transactions.
Data Record Changes
The following data records have been modified with new or updated elements or values.
1000
This record has the following modification: AAJD
1001
This record has the following modification: AAFI
1060
This record has the following modification: SQS1
1400
This record has the following modification: FLTR
NOTE
: If GFQA (FlightItemRef) is included in this request then the GFQA will be returned regardless of the shop module being used. For example, GFXI (FlightItemCrossRef) will not return if GFQA (FlightItemRef) is requested: they are mutually exclusive. GFNP
1424
This record has the following modification: FLTR
NOTE
: If GFQA (FlightItemRef) is included in this request then the GFQA will be returned regardless of the shop module being used. For example, GFXI (FlightItemCrossRef) will not return if GFQA (FlightItemRef) is requested: they are mutually exclusive. January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 10
Developer Advisory Galileo Web Services (GWS) Update Releases •GFOP
1425
This record has the following modification: GFIS
1430
This is a new data record that returns the GRAA
1431
This is a new data record with the following element: GRAA
2025
This record has the following modification: BP49
2100
This record has the following modification:
4015
This record has the following modification: The following KLRs, in the /
Developer Advisory Galileo Web Services (GWS) Update Releases o o GFS4
4038
This record has the following modification: In the DPRT 1.0
4084
This record has the following modification: DP15
Developer Advisory Galileo Web Services (GWS) Update Releases Travelport provides this document for information purposes only and does not guarantee that the information contained in this document is accurate, current or complete. This document and the products listed herein are subject to change without notice. © 2014 Travelport. All rights reserved. All other trademarks are the property of their respective owners. January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 13