AER Web Service Introductory Guide - Sabre

2y ago
36 Views
4 Downloads
3.77 MB
556 Pages
Last View : 4d ago
Last Download : 3m ago
Upload by : Allyson Cromer
Transcription

Introductory GuideAutomated Exchange and Refunds (AER)Via the Web ServiceDecember 18, 2015Final

Software version 2012Document Edition 1.0This documentation is the confidential and proprietary intellectualproperty of the Sabre Airline Solution business. Any unauthorizeduse, reproduction, preparation of derivative works, performance ordisplay of this document or software represented by thisdocument, without the express written permission of Sabre AirlineSolutions is strictly prohibited.Sabre Airline Solutions, the Sabre Airline Solutions logo, SabreHoldings, the Sabre Holdings logo, Sabre Travel Network, theSabre Travel Network logo, AirCentre, AirCommerce, AirVision,ASx, MyFares, Qik, Sabre, SabreSonic, Service360 and VirtuallyThere are trademarks and/or service marks of an affiliate of SabreHoldings Corp. All other trademarks, service marks and tradenames are the property of their respective owners. 2012 Sabre Inc. All rights reserved. 02 2012

Document Revision InformationProject NameAER Web Service Introductory GuideProject NumberPrepared byDavid Priddy / Denise BowenDate Prepared11 May 2012Revised byDenise Bowen / Bartosz WieczorekDate Revised20 June 2012Revision Reason Added Troubleshooting sectionRevision Control No.Revised byDate RevisedDenise BowenRevision Reason Moved Set-up web service call section to Appendix.Also added Important Note about Web Services inthis Guide section under 1.2 Purpose of this GuideRevision Control No.Revised byDate RevisedShelly NicholsRevision Reason Added section for Multiple Currency ProcessingRevision Control No.Revised byDate RevisedLP OttRevision Reason Added section for exchanging with a Tour CodeRevision Control No.Revised byDate RevisedLP OttRevision Reason Added section for Non Refundable Fares. Section2.9Revision Control No.Revised byDate RevisedLP OttRevision Reason Replaced DRC with Sabre Dev StudiosRevision Control No.Revised byDate RevisedLP OttRevision Reason Added exmaples for MFOR. Section 2.11.5AER Web Service28 December 2015iii10 Sept 201223 June 201416 July 201429 Sept 201420 Nov. 201424 Nov. 2014Revision Control No.Table of ContentsConfidential and Proprietary Sabre Airline Solutions

Revised byDate RevisedMaria RonijRevision Reason Added section for Agent Pricing with Airline TicketingFees (R and T Types) 2.12Revision Control No.Revised byDate RevisedPawel KowalkeRevision Reason Added no penalty fare qualifier for AER and Manualpricing. Section 2.13Revision Control No.Revised byLouis OttDate RevisedModified. Section 1.2.1Revision Control No.Prerna SonthaliaDate RevisedRevised byRevision Reason Added Exchange with Spanish Resident Discount.Section 2.14Revision Control No.Revised byDate RevisedLouis OttRevision Reason Added section 2.1.4 Pre-Ticketing ValidationRevision Control No.Revised byDate RevisedGarry HarvieRevision Reason Added section 2.15 Manual Pricing with AppliedTicket DesignatorAER Web Service28 December 2015iv18 Feb. 201426 Feb. 201506 Mar 201512 Mar. 20154 June 201518 Dec. 2015Revision Control No.Table of ContentsConfidential and Proprietary Sabre Airline Solutions

Table of Contents1Introduction1.1 Overview. 21.2 Purpose of this Guide . 21.2.1 Important Note About Web Services in this Guide: . 21.2.2 Essential Terminology . 31.3 XML Version In Guide vs. Production or Test Environments . 31.4 Sabre Dev Studio . 41.5 WSDL Files in this Guide . 51.6 End Points . 51.7 AER Web Service Transactions . 61.7.1 Price Exchange and Retain . 61.7.2 Ticket Retain . 61.8 AER Web Services Diagram. 72Exchange Scenarios2.1 Exchange with an Add Collect . 82.1.1 Pricing the Exchange . 82.1.1.1 Display the PNR . 82.1.1.2 Pricing with ZED Fares. 152.1.1.3 Cancel the Itinerary . 172.1.1.4 Display Availability for New Flight . 202.1.1.5 Sell New Seat. 202.1.1.6 Price the Exchange . 222.1.2 Decision Point . 322.1.2.1 Decision Scenarios . 322.1.2.2 Terminal Address Pool Scenarios . 332.1.3 Complete the Exchange - Ticket the Retained Price Quote Record. 352.1.3.1 End and Redisplay the PNR with Retained Reissue . 352.1.3.2 Complete the Exchange . 382.1.3.3 End and Retrieve PNR . 492.1.4 Pre-Ticketing Validation . 532.1.4.1 Native Sabre . 532.1.4.2 Original Ticket Xml Request (RQ) and Response (RS) . 552.1.4.3 Exchange with Additional Collection Xml Request (RQ) and Response (RS) . 572.2 Exchange with a Refund . 652.2.1 Pricing the Exchange . 652.2.1.1 Display the PNR . 652.2.1.2 Cancel the Return Flight Segment . 65AER Web Service28 December 2015vTable of ContentsConfidential and Proprietary Sabre Airline Solutions

2.2.1.3 Display Availability . 682.2.1.4 Sell a New Seat. 682.2.1.5 Price the Return Segment . 692.2.1.6 Price the Exchange and Retain the Transaction . 742.2.2 Decision Point . 862.2.3 Complete the Exchange - Ticketing the Price Quote Record . 872.2.3.1 End and Redisplay PNR. 872.2.3.2 Complete the Exchange . 902.2.3.3 End and Redisplay PNR. 1042.3 Exchange with Add Collect Manual Price . 1082.3.1 Price the Exchange . 1082.3.1.1 Display PNR . 1082.3.1.2 Display Availability . 1092.3.1.3 Sell New Seat. 1092.3.1.4 Price the Exchange . 1092.3.2 Decision Point . 1232.3.3 Complete the Exchange . 1232.3.3.1 End and Retrieve PNR . 1362.4 Exchange with an Add Collect – First Segment Flown . 1382.4.1 Set up Flown VCR Coupon . 1382.4.1.1 Set Duty Code 8 . 1382.4.1.2 Display the VCR . 1402.4.1.3 Mark First Coupon as USED . 1462.4.1.4 Reset Duty Code 5 . 1482.4.2 Price the Exchange . 1512.4.2.1 Display PNR . 1512.4.2.2 Display VCR . 1522.4.2.3 Cancel Itinerary . 1572.4.2.4 Display Availability . 1602.4.2.5 Sell New Seat. 1602.4.2.6 Price and Rebook for Lowest Fare . 1612.4.2.7 Price the Exchange . 1652.4.3 Decision Point . 1782.4.4 Complete the Exchange – Ticket the Retained Price Quote Record . 1782.4.4.1 End and Redisplay PNR. 1782.4.4.2 Ticket the Retained Reissue . 1802.4.4.3 End and Redisplay the PNR. 1932.5 Exchange with Add Collect – First Coupon CKIN Status . 1962.5.1 Set-Up . 1962.5.1.1 Set Duty Code 8 . 1962.5.1.2 Display the VCR . 1982.5.1.3 Change Coupon 1 to CKIN Status . 2022.5.1.4 Reset Duty Code 5 . 2042.5.2 Price the Exchange . 207AER Web Service28 December 2015viTable of ContentsConfidential and Proprietary Sabre Airline Solutions

2.5.2.1 Display the PNR . 2072.5.2.2 Cancel Return Segment . 2142.5.2.3 Display Availability . 2172.5.2.4 Sell New Flight . 2302.5.2.5 Price the Exchange . 2342.5.3 Decision Point . 2472.5.4 Complete the Exchange – Ticket the Retained Price Quote Record . 2482.5.4.1 End and Redisplay the PNR. 2482.5.4.2 Ticket the Retained Exchange . 2512.5.4.3 End and Redisplay the PNR. 2632.5.4.4 Examples of Old and New VCR . 2662.6 Exchange - Schedule Change Irregular Operations . 2682.6.1 Complete the Exchange . 2682.6.1.1 Display the PNR . 2682.6.1.2 Cancel Return Segment . 2682.6.1.3 Check Availability . 2692.6.1.4 Sell Seat from Availability . 2692.6.1.5 Begin the Exchange . 2692.6.1.6 End and Retrieve PNR . 2812.6.1.7 Ticket Retained PQR . 2812.6.1.8 End and Retrieve PNR . 2932.7 Even Exchange using a Tour Code . 2962.7.1 End and Retrieve PNR . 3032.7.2 Ticket Retain with Tour code . 3052.7.3 End and Retrieve PNR . 3122.8 Exchange – Mixed Currencies . 3152.8.1 Exchange and Retain . 3152.8.2 Ticket Retained . 3262.9 Exchange using Non-Refundable Fares . 3352.10 Full Refund . 3392.10.1 Pricing The Refund . 3392.10.1.1 Display the PNR . 3392.10.1.2 Price the Refund . 3392.10.2 Decision Point . 3482.10.3 Ticket Retained Price Quote Record . 3482.10.3.1 End and Retrieve PNR . 3572.11 Partial Refund . 3602.11.1 Set up Flown VCR Coupon . 3602.11.1.1 Set Duty Code 8 . 3602.11.1.2 Display the VCR . 3622.11.1.3 Mark First Coupon as USED . 3682.11.1.4 Reset Duty Code 5 . 3702.11.2 Price the Refund . 3732.11.2.1 Display the PNR . 373AER Web Service28 December 2015viiTable of ContentsConfidential and Proprietary Sabre Airline Solutions

2.11.2.2 Display the VCR . 3742.11.2.3 Start the Refund Process . 3742.11.3 Decision Point . 3872.11.4 Ticket Retained Price Quote Record . 3872.11.4.1 End and Retrieve PNR . 3992.11.4.2 Display the VCR . 4022.11.5 Multiple Forms of Refund (MFOR) . 4032.12 Agent Pricing with Airline Ticketing Fees (OB Fee T and R Types) . 4132.13 Exchange with No Penalty (XP) . 4192.13.1 Exchanging for a ticket with No Penalty . 4192.13.1.1 Exchange to a penalty fare fails . 4192.13.1.2 Exchange to a no penalty fare succeeds . 4252.13.2 Manual pricing with No Penalty . 4382.13.2.1 Pricing the exchange with No Penalty . 4382.14 Exchange with Spanish Resident Discount . 4422.14.1 Exchange with Island Resident Discount . 4432.14.2 Exchange with Large Family Discount . 4532.15 Manual Pricing with Applied Ticket Designator . 4653Troubleshooting3.1 AER Web Service Communication Points . 4743.2 XML Error Message Types . 4743.3 Common Error Responses, Causes and Solutions . 4753.3.1 USG Authorization Failed . 4753.3.2 Failed to Validate XML Request Against Schema . 4753.3.3 ICE Session Exception Occurred . 4763.3.4 Timeout . 4763.3.5 PSS Processing Issues . 4774Appendix - Set-Up Web Service Calls4.1 Set Up as Robotic Agent – Session Create . 4804.2 Designate Printer . 4834.3 Building a Reservation . 4864.3.1 Display Flight Availability . 4864.3.2 Sell Seat From Availability. 5084.3.3 Add Name, Phone, Ticketing Time Limit to PNR . 5114.3.4 Add Form of Identification (FOID) . 5154.3.5 Add Secure Flight Documentation - Date of Birth, Gender . 5174.3.6 Price for Lowest Fare and Retain Price Quote . 5204.3.7 End and Retrieve PNR . 5254.4 Issue Ticket . 5284.4.1 End and Retrieve PNR . 531AER Web Service28 December 2015viiiTable of ContentsConfidential and Proprietary Sabre Airline Solutions

4.5 Display a PNR . 5344.6 Cancel the Itinerary . 5414.7 Cancel Return Segment . 5434.8 Session Close. 546AER Web Service28 December 2015ixTable of ContentsConfidential and Proprietary Sabre Airline Solutions

1Introduction1.1OverviewThe Automated Exchange and Refunds (AER) Web Service (AERRQ) allows an airline toprocess exchanges and refunds through XML based web sites, internet booking engines, front endGUI web services, kiosk web services, etc.The AER Web Service: Prices exchanges and refunds. Prices itineraries based on varying degrees of manual pricing criteria. Retains the pricing result and fulfills the exchange or refund.NoteFor information on the full functionality of the AER product, refer to the AER User Guide onthe Community Portal.1.2Purpose of this GuideThe purpose of this guide is to introduce how the web service processes AER transactions. It is notintended to be a complete reference tool for XML design. Developers should refer to Sabre DevStudio. for the most complete information. You can find instructions on how to access Sabre DevStudio later in this document.This introductory guide provides: Examples of calls to AERRQ. Examples of calls to other web services that are part of various typical business scenariosinvolving AERRQ. Ways to simulate typical business scenarios. Translation between what you see in Native Sabre and what is expected in an XML request.This document focuses on the ticketing transaction beginning with the exchange or refund. However,an Appendix is available to provide XML examples for Set-Up Web Service Calls on page 480.1.2.1Important Note About Web Services in this Guide:The purpose of the XML examples provided in this document is to present the possible content ofthe request and response (RQ/RS). The XML responses contain a limited number of solutions inorder to save room, but at the same time provide a good sampling of responses.AER Web Service28 December 20152IntroductionConfidential and Proprietary Sabre Airline Solutions

Always refer to the Sabre Dev Studio. for the lastest version and examples of any of these webservices.For comparison purposes, corresponding InterAct and Green Screen (Native Sabre) examples areincluded. They will contain minimal explanation. For detailed description of the fields or foradditional examples, please refer to the AER User Guide which can be found on the CommunityPortal.In addition, the process used to complete each transaction may not be the method your airline wishesto use. Consult with your Sabre contacts when designing your web service.Note Examples1.2.2other than AERRQ are for illustrative purposes only.Essential TerminologyYou will see many terms used and explained throughout this document, but it is important tounderstand the following two concepts as they apply to AER:Exchange: The exchange of one or more documents (flight or non-flight, unused or partially used)for a new flight document. There are three types of exchanges: Exchange with an additional collection – the customer owes money Exchange with a refund – a refund is due to the customer Even Exchange – there is no addition money owed from or due to the customerRefund: A document (flight or non-flight, unused or partially used) is refunded to the customer. Thetransaction does not generate a new flight document.1.3XML Version In Guide vs. Production or Test EnvironmentsThe initial examples created for this guide use version 1.1.13. The general AER web servicephilosophy is to maintain backward compatibility between XML versions as much as possible. So,the XML in the examples listed in this guide are largely compatible with 1.1.15, 1.1.14, 1.1.10 and1.1.6.As of January 2012, the original XML version 1.0.3 is still supported and is largely compatible withthese examples as well.The difference between versions 1.0.3 and 1.1.x involves how to tell the web service to retain theprice quote record. In version 1.0.3, you set the Action attribute to “ExchangeRetain” or “RefundRetain” toretain the price quote record when pricing the exchange or refund respectively. In version 1.1.x, you set the Action attribute to “Exchange” or “Refund” to price theexchange or the refund respectively and the SubAction element should contain a Retainattribute set to “true” to retain the resulting price quote record.AER Web Service28 December 20153IntroductionConfidential and Proprietary Sabre Airline Solutions

1.4Sabre Dev StudioThe Sabre repository for all web service information can be found at Sabre Dev Studio.It is available to airlines and has documentation including schemas, WSDL files, code samples,workflows, and Sabre Web Services related information.It is the most comprehen

Sabre Airline Solutions, the Sabre Airline Solutions logo, Sabre Holdings, the Sabre Holdings logo, Sabre Travel Network, the Sabre Travel Network logo, AirCentre, AirCommerce, AirVision, ASx, MyFares, Qik, Sabre, SabreSonic, Service360 and Virtually There are trademarks and/or service marks of an affiliate of Sabre Holdings Corp.

Related Documents:

Aerospace Engineering 2 *Technical electives can be chosen from the following list. At least three credit hours must come from either AER/ME 501 OR AER/ME 590. AER 380 Topics in Aerospace Engineering (Variable Topics) AER/ME 530 Gas Dynamics AER/ME 531 Fluid Dynamics I AER/ME 532 Advanced Strength of Materials AER 545 Aircraft Control and .

Active Duty AER Request Packet Army Community Service (ACS) Army Emergency Relief (AER) TEL: (719) 526-4590 Use the two part checklist below to prepare AER requests. You can also contact your unit Command Financial NCO (CFNCO), 1SG or Commander; all can assist. Attach copies of supporting documents; do not attach originals. Requests

oilfield waste generator or oilfield waste receiver. Each AER requirement that is unique to this directive is numbered. Information on compliance and enforcement can be found on the AER website. 1) All documentation required under this directive must be provided to the AER upon request to confirm compliance.

The Aer X oxygen concentrator device is used on a prescriptive basis by patients requiring supplemental oxygen. It supplies a high concentration of oxygen and is used with a nasal cannula to channel oxygen from the concentrator to the patient. The 3B Aer X may be used in home, institution, vehicle and various mobile environments. The Aer X is not

XX. Introductory Physics, High School. 411 High School Introductory Physics Test The spring 2018 high school Introductory Physics test was based on learning standards in the Introductory Physics content strand of the October 2006 version of the Massachusetts Science and Technology/Engineering Curriculum Framework. These learning

Site metadata and soil characteristics web service Catalog of data sets and service metadata CRN web service - NCDC ArcServer (does not include soil moisture) SCAN web service - AWDB SOAP OK Mesonet web service West TX Mesonet web service NLDAS web service - USGS Geo Data Portal Algor

Changes to terms used in ADP 6-22 are addressed in introductory tables 1 and 2. The logic map for ADP 6-22 is shown in introductory figure 1. Introductory table 1. New Army terms . Term Remarks counterproductive leadership New term. ADP 6-22 is the proponent publication. Introductory table 2. Modified Army terms and acronyms . Term RemarksFile Size: 3MB

ADVANCED BOOKKEEPING KAPLAN PUBLISHING Introduction When a capital asset or non-current asset is disposed of there are a variety of accounting calculations and entries that need to be made. Firstly, the asset being disposed of must be removed from the accounting records as it is no longer controlled. In most cases the asset will be disposed of for either more or less than its carrying value .