(Version 01) Galileo Web Services (GWS) Update Releases

Download Report

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  1431

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  1001

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  1001   1424 1425

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 / element. The element displays the cabin to which the booking code belongs. See the Data Record Changes section to review detailed changes:  1000  1001

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 January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 3

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  1425

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  1001  1400  1425

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  1425 January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 4

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  1001

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  1001  1400  1425

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  1425    2025 2100 4015 January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 5

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  2025  4038

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  4015

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 January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 6

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 was added.

1001

This record has the following modification:  AAFI / field has updated values, and the following new values: o T - Cache Data Push o X - Reusing Availability data from Customer Cache o Y - Avail Data from another System o Z - E-Streamed data in Customer Cache

1060

This record has the following modification:  SQS1 / field has updated values, and the following new values: o T - Cache Data Push o X - Reusing Availability data from Customer Cache o o Y - Avail Data from another System Z - E-Streamed data in Customer Cache

1400

This record has the following modification:  FLTR /KlrIDAry>/ field was updated with the following text:

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 field descriptions were updated.

1424

This record has the following modification:  FLTR /KlrIDAry>/ field was updated with the following text:

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 was versioned with the fields: o o

1425

This record has the following modification:  GFIS / field has updated values, and the following new values: o T - Cache Data Push o X - Reusing Availability data from Customer Cache o Y - Avail Data from another System o Z - E-Streamed data in Customer Cache  The following KLRs, in the / field, have the new value:"3I=Alternate (4B) Expanded Surcharge text" added: o GFS2 o GFS3 o GFS4 o GFSF  GFTD / field was updated with the following text: The Advance Purchase (AP) and Advance Purchase End Item (APEndItem) fields work together. When there is a non-zero restriction, such that it can be accommodated in 3 bytes, these fields display the data as such: e.g. 14 days is 14|, 100 days is ||. For values other than day, these fields display the unit as can be accommodated in 3 bytes, e.g. 6 months is 6M|.

1430

This is a new data record that returns the GRAA KLR.

1431

This is a new data record with the following element:  GRAA

2025

This record has the following modification:  BP49 was added.  BP50 was added.

2100

This record has the following modification:  / / DataBlkInd> updated with: MC - Frequent Flyer Cross Accrual Numbers. Apollo (1V) only.

4015

This record has the following modification:  The following KLRs, in the / field, have the new value:"3I=Alternate (4B) Expanded Surcharge text" added: o GFS2 o GFS3 January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 11

Developer Advisory Galileo Web Services (GWS) Update Releases o o GFS4 GFSF  The DPP9 / / / field has the new value: 9 - Exchange Ticket Number

4038

This record has the following modification:  In the DPRT 1.0 / field, the following value was added: o A - all valid tickets, including OPEN, RFND, VOID, EXCH

4084

This record has the following modification:  DP15 was added. January 27, 2014 TRAVELPORT CONFIDENTIAL INFORMATION Page 12

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