36
Multiple Fares Per Itinerary Travel Agencies and Developer Administration Guide December 2016

Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

  • Upload
    others

  • View
    4

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Multiple Fares

Per Itinerary

Travel Agencies and Developer

Administration Guide

December 2016

Page 2: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

© 2012-2016, Sabre Inc. All rights reserved.

This documentation is the confidential and proprietary intellectual

property of Sabre. 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 the Sabre logo design and Sabre Travel Network and

the Sabre Travel Network logo design are trademarks and/or

service marks of an affiliate of Sabre. All other trademarks, service

marks, and trade names are owned by their respective

companies.

Page 3: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

D O C U M E N T R E V I S I O N I N F O R M A T I O N

The following information is to be included with all versions of the document.

Project Name Multiple Fares Per Itinerary

Project

Number

Prepared by Victoria Stalcup Date Prepared Dec 2016

Revised by Date Revised

Revision

Reason

Edition No.

Page 4: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

• • •

Page 5: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Table of Contents v

Table of Contents

1 G e t t i n g S t a r t e d

1.1 Introduction ....................................................................................................................................... 1 1.2 Summary of Functionality ................................................................................................................. 1 1.3 About This Guide .............................................................................................................................. 3

2 M u l t i p l e F a r e s P e r I t i n e r a r y

2.1 Introduction ....................................................................................................................................... 5 2.2 Sabre Low Fare Search Via WPNI and JR ....................................................................................... 5

2.2.1 Request Format JR and WPNI ................................................................................................ 6 2.2.2 Low Fare Search – Follow-Up Display Entry........................................................................... 7 2.2.3 Low Fare Search - Sell Format ............................................................................................... 8 2.2.4 Corporate ID/Account Code .................................................................................................... 9 2.2.5 Cabin – Expand Jump Cabin Logic - XJ ............................................................................... 10 2.2.6 Cabin – Disable Jump Cabin – DJC ...................................................................................... 11 2.2.7 Force Passenger Type Code - XO ........................................................................................ 11 2.2.8 Multiple Passenger Types ..................................................................................................... 12 2.2.9 Filtering Capabilities by Change Fee/Refund Information/Maximum Penalty........................ 13 2.2.10 Low Fare Search – Additional Examples ............................................................................ 17 2.2.11 Low Fare Search via WPNI Linear Command .................................................................... 18 2.2.12 Low Fare Search via WPNI Linear Command with Branded Fare Detail ............................ 19 2.2.13 Low Fare Search via WPNI Linear Command with Multiple Cabins .................................... 19

2.3 Bargain Finder Max ........................................................................................................................ 20 2.3.1 Bargain Finder Max – Request ............................................................................................. 20 2.3.2 Bargain Finder Max – Response ........................................................................................... 23 2.3.3 Bargain Finder Max – Corporate ID/Account Code ............................................................... 23 2.3.4 Bargain Finder Max – Expand Jump Cabin........................................................................... 24 2.3.5 Bargain Finder Max – Disable Jump Cabin ........................................................................... 25 2.3.6 Passenger Type – XO Qualifier ............................................................................................ 26 2.3.7 Multiple Passenger Types ..................................................................................................... 27 2.3.8 Filtering Capabilities by Change Fee/Refund Information/Maximum Penalty........................ 28

Page 6: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

vi Table of Contents Developer Administration Guide December 2016

• • •

Page 7: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Introduction 1

1.1 I n t r o d u c t i o n

Sabre is pleased to announce the Multiple Fares Per Itinerary enhancement to Bargain FinderSM

Max

and Sabre’s Low Fare Search capabilities. This feature aids in quickly offering customers multiple

fare choices per itinerary in a single entry to best match their needs. Multiple Fares Per Itinerary

(MFPI) allows you to define and search multiple fare rule attributes per group. The response includes

applicable fares per the user-defined group.

1.2 S u m m a r y o f F u n c t i o n a l i t y

Following is a summary of the Multiple Fares Per Itinerary functionality, which also includes

enhancements. The enhancements increase the flexibility in creating the MFPI group.

• Applicable for use with Bargain Finder Max and Low Fare Search capabilities (WPNI and JR

Linear entries).

• Applicable for use with WPNI web service – OTA_BargainFinderPlusLLSRQ.

• Up to 10 user-defined groups.

• Accepted fare attributes:

– Fares without restrictions.

– Exclude fares with advance purchase.

– Exclude fares with min/max stay.

– Passenger Type Code

• If a passenger type is not specified, then the ADT passenger type code will be used as the

default passenger type code.

• Ability to force the specified passenger type on all segments within the MFPI group

request.

• Functionality to support up to four passenger types within the MFPI group request.

– Cabin

• Ability to use Expand Jump Cabin functionality within the MFPI group request.

• Ability to use disable jump cabin functionality within the MFPI group request.

1 Getting Started 1

Page 8: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

2 Summary of Functionality Developer Administration Guide December 2016

– Corporate ID/Account Code

• Allow the user within each MFPI group to force the usage of the Corporate ID/Account

Code.

– Public Fare

– Private Fare

• All Multiple Fares Per Itinerary fare attributes are optional.

• A mix of attributes per group is allowed.

• The lowest fare for the itinerary booked will be returned along with the lowest fare per applicable

Multiple Fares Per Itinerary group(s).

• If no fare is available for the defined Multiple Fares Per Itinerary group, then shopping will not

return a fared for the group.

• Each Multiple Fare group and its attributes are considered completely independent from one

another.

• Applicable to one-way, round-trip and multi-destination itinerary requests.

• Only one cabin will be allowed per group.

• Multiple restrictions per group are allowed in a single request; all must be applicable for a

solution to be returned.

• If the fare returned in the group has a branded fare association, branded fare details will be

returned.

• As with existing functionality, Multiple Fares Per Itinerary will not allow the combination of the

fares without restrictions qualifier with the following parameters:

– Exclude fares with advance purchase.

– Exclude fares with penalty.

– Exclude fares with min/max stay.

• Filtering Capabilities by Change Fee/Refund Information/Maximum Penalty

– Users requesting a MFPI request can use optional Max Penalty qualifiers to filter by fare

flexibility and maximum penalty amounts.

– Existing Max Penalty qualifier with all its combinations will be added to MFPI groups as

additional optional filtering criteria.

• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time

window, and preferred carrier).

• The Branded Fares BRALL entry is not combinable with Multiple Fares Per Itinerary.

Page 9: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 About This Guide 3

1.3 A b o u t T h i s G u i d e

This guide provides information on the Multiple Fares Per Itinerary. Each chapter is as follows:

• Chapter 1, “Getting Started” explains the purpose of the document and provides a functional

overview and a description of the changes to the system.

• Chapter 2, “Multiple Fares Per Itinerary,” explains the updates to Sabre Low Fare Search and

Bargain Finder Max.

Page 10: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

4 About This Guide Developer Administration Guide December 2016

• • •

Page 11: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Introduction 5

2.1 I n t r o d u c t i o n

Multiple Fares Per Itinerary allows you to request multiple fares within one shopping request. The

functionality is available with Bargain Finder Max and Sabre’s Low Fare Search capabilities.

This chapter includes the following:

• Sabre Low Fare Search Via WPNI and JR (see this page).

• Bargain Finder Max (see “Bargain Finder Max,” page 20).

2.2 S a b r e L o w F a r e S e a r c h V i a W P N I a n d J R

The following information explains how to build the Multiple Fare Per Itinerary request, display the

group information, and sell the preferred option.

This section includes the following:

• Request Format JR and WPNI (see “Request Format JR and WPNI,” page 6).

• Low Fare Search – Follow Up (see “Low Fare Search – Follow Up Display Entry,” page 7).

• Low Fare Search – Sell Format (see “Low Fare Search - Sell Format,” page 8).

• Corporate ID/Account Code (see “Corporate ID/Account Code,” page 9).

• Cabin – Expand Jump Cabin Logic (see “Cabin – Expand Jump Cabin Logic - XJ,” page 10).

• Cabin – Disable Jump Cabin DJC (see “Cabin – Disable Jump Cabin - DJC,” page 11).

• Force Passenger Type Code XO (see “Force Passenger Type Code - XO,” page 11).

• Multiple Passenger Types (see “Multiple Passenger Types,” page 12).

• Filtering Capabilities by Change Fee/Refund Information/Maximum Penalty (see “Filtering

Capabilities by Change Fee/Refund Information/Maximum Penalty,” page 13).

• Low Fare Search – Additional Examples (see “Low Fare Search – Additional Examples,” page

17).

• Low Fare Search via WPNI Linear Command (see “Low Fare Search via WPNI Linear

Command,” page 18).

• Low Fare Search via WPNI Linear Command with Branded Fare Detail (see “Low Fare Search

via WPNI Linear Command with Branded Fare Detail,” page 19).

• Low Fare Search via WPNI Linear Command with Multiple Cabins (see “Low Fare Search via

WPNI Linear Command with Multiple Cabins,” page 19).

2 Multiple Fares Per Itinerary 2

Page 12: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

6 Sabre Low Fare Search Via WPNI and JR Developer Administration Guide December 2016

2.2.1 R e q u e s t F o r m a t J R a n d W P N I

JR WPNI Sample entries

Group Delimiter ¤MF1 ¤MF1 • JR.LAX/S-OYDFW10JUN¤MF1/P-MIL¤MF2/P-JCB

• WPNI¤MF1‡PADT¤MF2‡PJCB

Passenger type /P-ADT ‡PJCB • JR.LAX/S-OYDFW10JUN¤MF1/P-MIL¤MF2/P-JCB

• WPNI¤MF1‡PADT¤MF2‡PJCB

Cabin -Y

*See note

2

N/A today -Y

*See note 3

• JR.LAX/S-OYDFW10JUN¤MF1-Y¤MF2-F

• WPNI¤MF1-Y¤MF2-F

Notes

• For groups, only one cabin per group is permitted for the whole journey/itinerary.

• Must follow MF1(MF1-Y) similar to JR-DFW/S-OYLAS29JUN0900

• There is not a way to request a new cabin/class in WPNI. It uses the class from the itinerary and (internally) the system maps the class to the cabin. WPNI will follow the JR entry format WPNI¤MF1-Y¤MF2-F, where –Y must follow MF1 (MF1-Y).

Type of Fare

Public or private

/Q-PL

/Q-PV

‡PL

‡PV • JR.LAX/S-OYDFW10JUN¤MF1/Q-PL¤MF2/Q-PV

• WPNI¤MF1‡PV¤MF2‡PV

Exclusions:

XA (no advance

purchase)

XP (no penalty)

XS (no min/max

stay)

XR (no

restrictions)

n/a

See Note

‡XA • WPNI¤MF1‡XA‡XP‡XS¤MF2‡XR

• JR.LAX/S-OYDFW10JUN/I-

YYNYN¤MF1/XA/XP/XS¤MF2/XR

Note JR will follow the WPNI format. You will separately type exclusion in parameter groups in a JR request. You will use the existing format (/I-YYNYN) for group 0.

• JR does not accept XA, XP, XS or XR qualifiers. For JR to exclude these, there is a qualifier /I-, where there are several exclusions and you must type a Y or N in the proper order if you want them included or not. /I-YYNYN. (exclude Stored Fares is in this /I- which is not in scope for this project). Also, for JR, there is no equivalent for XR

Account Code /AC*nnn ‡AC*nnn • JR.LAX/S-OYDFW10JUN¤MF1/AC*nnn¤MF2/AC*yyy

• WPNI¤MF1‡AC*nnn¤MF2‡AC*yyy

Corporate ID /N-nnn ‡Innnnn • JR.LAX/S-OYDFW10JUN¤MF1/N-nnn¤MF2/N-yyy

• WPNI¤MF1‡Innnnn¤MF2‡Iyyyyy

Page 13: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Sabre Low Fare Search Via WPNI and JR 7

JR WPNI Sample entries

Sample of

combined

qualifiers

Note All qualifiers with a / as the delimiter must be entered before the qualifiers with a ‡ delimiter

Qualifiers used defined after each JR

Qualifiers used defined after each WPNI

• JR.LAX/S-OYDFW10JUN0700/P-2ADT¤MF1-Y/N-

nnnnn/AC*nnnnn/AC*nnnnn¤MF2-F/N-nnnnn/Q-

PV/P-JCB/N-nnnnn

Qualifiers used on JR above:

MF1 - Cabin, Corp ID, Account Code, Account Code

MF2 – Cabin, Corp ID, Private Fare, Passenger Type, Corp ID

• JR.LAX/S-OYDFW10JUN0700/P-2ADT¤MF1-C¤MF2-F

Qualifiers used on JR above:

MF1 – Cabin

MF2 – Cabin

• WPNI¤MF1-Y‡AC*nnnnn‡XA¤MF2-

F‡XA‡AC*nnnnn‡PL‡PJCB

Qualifiers used on WPNI above:

MF1 – Cabin, Account Code, Exclusion Min/Max Penalty

MF2 – Cabin, Exclusion Min/Max Penalty, Account Code, Public Fare, Passenger Type

• WPNI¤MF1-C¤MF2-F

Qualifiers used on WPNI above:

MF1 – Cabin

MF2 – Cabin

2.2.2 L o w F a r e S e a r c h – F o l l o w - U p D i s p l a y E n t r y

The follow-up entries can be used to display the fare attribute qualifiers used within the MFPI group.

2.2.2.1 JR

Qualifier Display Entry – JR

Sample Request:

JR.DFW/S-OYLGA20OCT0700/P-1ADT¤MF1-F¤MF2/P-TIM¤MF3/P-PRO«

ITINERARY OPTION 4

1 XX 1080 N 20OCT Q DFW LGA 0915 1347 738 0 /E

BR1-4 1ADT 130.10 130.10

TOTAL FARE - USD 130.10

MF1-4 1ADT 289.10 289.10 *BR

MF2-4 1TIM 210.10 210.10 *BR

MF3-4 1PRO 159.10 159.10 *BR

* TO SEE ADDITIONAL BRAND DETAILS - USE JR04*BRxx

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE JR04*MFxx

Page 14: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

8 Sabre Low Fare Search Via WPNI and JR Developer Administration Guide December 2016

To display qualifiers for each group:

Entry Response

JR04*MF1 MF1 1ADT F JR04*MF2 MF2 1TIM JR04*MF3 MF3 1PRO

To display qualifiers for an entire group using a single entry:

Entry Response

JR04*MFALL MF1 1ADT F

MF2 1TIM

MF3 1PRO

2.2.2.2 WPNI

Qualifier Display Entry - WPNI

OPTION 2

1 VX 710 S 20OCT Q DAL LGA 1330 1740 319 0 /E

1ADT 121.21 121.21

TOTAL FARE - USD 121.21 CAT35 /

MF2-2 1PRO 110.51 110.51

MF3-2 1ADT 121.21 121.21

To display qualifiers for each group:

Entry Response

WC*2MF2 MF2 1PRO WC*2MF3 MF3 1ADT F

To display qualifiers for an entire group using a single entry:

Entry Response

WC*1MFALL MF2 1PRO

MF3 1ADT Y

2.2.3 L o w F a r e S e a r c h - S e l l F o r m a t

You can sell from the MFPI response using the following entries.

Page 15: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Sabre Low Fare Search Via WPNI and JR 9

Today From MFPI Option

JR Sell

JR01 JR01-MF1

WC Sell

WC‡3

WC‡3-MF1

WC sell w/cancel itinerary

WC‡3X

WC‡3-MF1X

2.2.4 C o r p o r a t e I D / A c c o u n t C o d e

When you use a Corporate ID/Account Code within a MFPI group, the Corporate ID/Account Code

must only apply to one segment for a fare to be returned for the group. This will be the default logic

when defining a Corporate ID/Account Code within the MFPI group.

You will be able to include the XC qualifier in the request on the MFPI group level. When it is

included, the Corporate ID/Account Code must be applicable on all segments for a fare to be returned

for the MFPI group.

The following examples show the entry when including the XC qualifier at the user-defined group

level. The XC qualifier at the group level is optional.

2.2.4.1 WPNI – Request Example

• WPNI¤MF1-F‡PADT‡AC*123‡XC¤MF2-C‡PADT‡AC*123‡XC¤MF3-Y‡AC*123‡XC

• WPNI¤MF1-F‡PADT‡AC*123‡XC¤MF2-C‡PADT¤MF3-Y‡AC*123

• WPNI¤MF1-F‡PADT‡AC*123‡AC*456‡XC¤MF2-C‡PADT¤MF3-Y‡AC*123

• WPNI¤MF1-F‡PADT‡AC*123‡XC‡AC*456‡XC¤MF2-C‡PADT¤MF3-Y‡AC*123

2.2.4.2 WPNI - Error Messages

Error message when XC is used in the user-defined group without a Corporate ID/Account Code:

WPNI¤MF1-F‡PADT‡XC«

XC QUALIFIER REQUIRES ACCOUNT CODE OR CORP ID

Error message when the format to add the XC is invalid:

WPNI¤MF1-F‡PMIL/XC«

‡FORMAT‡

Page 16: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

10 Sabre Low Fare Search Via WPNI and JR Developer Administration Guide December 2016

2.2.4.3 JR – Request Example

• JR.JFK/S-OYLHR12MAY0000¤MF1-F/P-ADT/AC*123/XC¤MF2-C/P-

ADT/AC*123/XC¤MF3-Y/AC*123/XC

• JR.JFK/S-OYLHR12MAY0000¤MF1-F/P-ADT/AC*123/XC¤MF2-C/P-ADT¤MF3-

Y/AC*123

• JR.JFK/S-OYLHR12MAY0000¤MF1-F/P-ADT/AC*123/AC*456/XC¤MF2-C/P-

ADT/AC*123/XC¤MF3-Y/AC*123/XC

• JR.JFK/S-OYLHR12MAY0000¤MF1-F/P-ADT/AC*123/XC/AC*456/XC¤MF2-C/P-

ADT/AC*123/XC¤MF3-Y/AC*123/XC

2.2.4.4 JR - Error Messages

Error message when XC is used in the user-defined group without a Corporate ID/Account Code:

JR.JFK/S-OYLHR20JUN0000¤MF1-F/P-ADT/XC«

XC QUALIFIER REQUIRES ACCOUNT CODE OR CORP ID

Error message when the format to add the XC is invalid:

JR.JFK/S-OYLHR20JUN0000¤MF1-F/P-ADT/AC*12345‡XC«

‡FORMAT‡

2.2.5 C a b i n – E x p a n d J u m p C a b i n L o g i c - X J

XJ is an optional qualifier that you can use within the Shopping request to have at least one segment

booked in the requested cabin.

Shopping will provide users the functionality to specify XJ qualifier in the MFPI group. If you do not

specify XJ in a group, then shopping (by default) will apply the existing jump cabin logic.

XJ can be specified in the main entry as well as in MFPI groups. Per current functionality, if a

qualifier can be specified in the MFPI groups, then this qualifier will not cross over from the main

group.

The following examples show the entry when including the XJ qualifier at the user-defined MFPI

group level. The XJ qualifier at the group level is optional.

2.2.5.1 Example – WPNI

• WPNI‡PADT/XJ¤MF1-F/XJ‡PADT¤MF2-F‡PADT¤MF3-Y/XJ

Page 17: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Sabre Low Fare Search Via WPNI and JR 11

2.2.5.2 Example – JR

• JR.JFK/S-OYLHR12MAY0000/XJ¤MF1-F/P-ADT/XJ¤MF2-C/P-ADT¤MF3-Y/XJ

2.2.6 C a b i n – D i s a b l e J u m p C a b i n – D J C

DJC is an optional qualifier that you can use within the shopping request to force all flight segments

to be booked only in the requested cabin.

If you specify DJC in the group, then shopping will disable jump cabin logic. If DJC is not specified

in a group, then shopping will allow existing jump cabin logic. XJ and DJC are not combinable in a

single MFPI group.

DJC can be specified in main as well as in MFPI groups. Per current functionality, if a qualifier can

be specified in the MFPI groups, then this qualifier will not cross over from the main group.

The following examples show the new entry when including the DJC qualifier at the user-defined

group level. The DJC qualifier at the group level is optional.

2.2.6.1 WPNI – Request Example

• WPNI/DJC¤MF1-F/DJC‡PADT¤MF2-F‡PADT¤MF3-Y/DJC

2.2.6.2 JR – Request Example

• JR.JFK/S-OYLHR12MAY0000/DJC¤MF1-F/P-ADT/DJC¤MF2-C/P-ADT¤MF3-Y/XJ

2.2.7 F o r c e P a s s e n g e r T y p e C o d e - X O

You will be able to specify the XO qualifier as an optional qualifier in the MFPI group. If you do not

specify XO in a group, then shopping will return a fare solution where a passenger type fare applies

to at least one fare on any leg.

XO can be specified in main as well as in MFPI groups. Per current functionality, if a qualifier can be

specified in the MFPI groups then this qualifier will not cross over from main group.

2.2.7.1 WPNI – Example

• WPNI‡P3ADTXO¤MF1-F‡PADTMILCNN‡XO¤MF2-F‡P3ADT

2.2.7.2 JR – Example

• JR.JFK/S-OYLHR12MAY0000/P-3ADTXO¤MF1-F/P-ADTMILCNN/XO¤MF2-F/P-

4ADT

Page 18: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

12 Sabre Low Fare Search Via WPNI and JR Developer Administration Guide December 2016

2.2.7.3 Request Validations

• JR.JFK/S-OYLHR12MAY0000¤MF1-F/P-ADTXO Invalid request return existing error

“PASSENGER TYPE”.

• JR.JFK/S-OYLHR12MAY0000/P-ADTXO¤MF1-F/P-ADT/XO Valid request

• WPNI¤MF1-F‡PADTXO Invalid request return existing “FORMAT” error

• WPNI¤MF1-F‡PADT‡XO Valid request

• JR.JFK/S-OYLHR12MAY0000/P-ADTXO¤MF1-F/XO Invalid request return existing

error “PASSENGER TYPE”

• WPNI¤MF1-F‡XO Invalid request return existing error “PASSENGER TYPE”

2.2.8 M u l t i p l e P a s s e n g e r T y p e s

You can define up to four passenger types per group along with other available optional qualifiers.

The number of passenger types specified must be the same for all MFPI groups including the main

portion of the shopping request. All valid passenger type codes (PTCs) can be used within the MFPI

group. If an infant passenger type is used, it does count toward the passenger type code count as one

of the four PTCs. It does not count toward the actual seat availability count.

2.2.8.1 WPNI - Example

By default, shopping takes the number of passengers and passenger types from the itinerary, but you

can also specify a number of passengers and types for the main group. In both cases, the number of

passengers among the main group and MFPI groups must be equal.

WPNI¤MF1-F‡PADT/MIL/INF/CNN¤MF2-C‡PADT/MIL/INF/CNN¤MF3-Y‡PADT/MIL/INF/CNN

or

WPNI‡N1.1/2.1/1.2/3.1¤MF1-F‡PADT/MIL/INF/CNN¤MF2-C‡PADT/MIL/INF/CNN¤MF3-

Y‡PADT/MIL/INF/CNN

or

WPNI‡P4ADT¤MF1-F‡PADT/MIL/INF/CNN¤MF2-C‡PADT/MIL/INF/CNN¤MF3-Y‡PADT/MIL/INF/CNN

WPNI/ADL‡P4ADT¤MF1-F‡PADT/MIL/INF/CNN¤MF2-C‡PADT/MIL/INF/CNN¤MF3-

Y‡PADT/MIL/INF/CNN

CURRENT ITINERARY-LOWER AVAIL CLASS OF SERVICE FOUND

1 K0 924 S 20NOV F ATL LAX 0729A 0930A 73H 0 /E

2 K0 929 S 24NOV T LAX ATL 0530A 1234P 75W 0 /E

4ADT 3688.12 3688.12

TOTAL FARE - USD 3688.12

* TO SEE AGENCY MANAGED COMMISSION - USE WC*00COMM

VALIDATING CARRIER - K0

CAT 15 SALES RESTRICTIONS FREE TEXT FOUND - VERIFY RULES

MF1-0 1ADT 2088.40 2088.40

MF1-0 1MIL 1980.30 1980.30

MF1-0 1INF 588.60 588.60

Page 19: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Sabre Low Fare Search Via WPNI and JR 13

MF1-0 1CNN 1430.70 1430.70

MF2-0 1ADT 1288.40 1288.40

MF2-0 1MIL 1126.40 1126.40

MF2-0 1INF 388.40 388.40

MF2-0 1CNN 926.40 926.40

MF3-0 1ADT 688.12 688.12

MF3-0 1MIL 576.40 576.40

MF3-0 1INF 88.40 88.40

MF3-0 1CNN 426.40 426.40

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE WC*0MFxx

VALIDATING CARRIER - K0

CAT 15 SALES RESTRICTIONS FREE TEXT FOUND - VERIFY RULES

2.2.8.2 JR - Example

JR.JFK/S-OYLHR12MAY0000/P-4ADT¤MF1-F/PADTMILINFCNN¤MF2-F/P-ADTMILINFCNN/XR¤MF3-

C/P-1ADTMILINFCNN¤MF4-C/P-ADTMILINFCNN/XR¤MF5-Y/P-3ADTMIL/XR¤MF6-Y/P-3ADTMIL

ITINERARY OPTION 1

1 FI 612 S 12MAY Q JFK KEF 0210P 1140P 75W 0

1 FI 450 S 13MAY F KEF LHR 0740A 1145A 76W 0

4ADT 2226.40 2226.40

TOTAL FARE - USD 2226.40

* TO SEE AGENCY MANAGED COMMISSION - USE JR01*COMM VALIDATING CARRIER - FI

MF1-1 1ADT 588.40 588.40

MF1-1 1MIL 480.30 480.30

MF1-1 1INF 188.60 188.60

MF1-1 1CNN 430.70 430.70

MF2-1 1ADT 988.40 988.40

MF2-1 1ADT 988.40 988.40 MIL fare request, but ADT returned MF2-1 1INF 288.40 288.40

MF2-1 1CNN 826.40 826.40

MF3-1 1ADT 688.12 688.12

MF3-1 1MIL 576.40 576.40

MF3-1 1INF 88.40 88.40

MF3-1 1CNN 326.40 326.40

MF4-1 1ADT 788.12 788.12

MF4-1 1MIL 676.40 676.40

MF4-1 1INF 188.40 188.40

MF4-1 1CNN 376.40 376.40

MF5-1 3ADT 406.60 1219.80

MF5-1 1MIL 376.40 376.40

MF6-1 3ADT 306.60 919.80

MF6-1 1MIL 276.40 276.40

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE JR01*MF01

VALIDATING CARRIER - FI

CAT 15 SALES RESTRICTIONS FREE TEXT FOUND - VERIFY RULES

2.2.9 F i l t e r i n g C a p a b i l i t i e s b y C h a n g e F e e / R e f u n d

I n f o r m a t i o n / M a x i m u m P e n a l t y

MFPI allows you to exclude restrictions such as No Restrictions (XR), No Min/Max Stay (XS), No

Advanced Purchase (XA), and No Penalty (XP). The new feature will enhance MFPI groups by

adding the ability to use the optional Specify Max Penalty features. By adding this functionality,

users requesting an MFPI request can use an optional Max Penalty qualifier to filter by fare flexibility

and maximum penalty amounts.

Page 20: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

14 Sabre Low Fare Search Via WPNI and JR Developer Administration Guide December 2016

The existing Max Penalty qualifier with all of its combinations will be added to MFPI groups as

additional optional filtering criteria.

2.2.9.1 Maximum Penalty Filtering Features

Filtering Capabilities New secondary action

codes (WP/JR/WPNI/W#)

New BFM schema elements in the

request

Request Information –

Information will be returned to the User advising whether the fare is refundable and/or changeable, or not, with or without penalty, and amounts.

WPMP-I,

WPNI‡MP-I,

JR.../MP-I

<VoluntaryChanges Match="Info"/>

Refundable – Considers

any fare that is refundable to be returned. Excludes non-refundable fares.

WPMPR-ANY,

WPNI‡MPR-ANY,

JR.../MPR-ANY

<VoluntaryChanges Match="All">

<Penalty Type="Refund">

</VoluntaryChanges>

Changeable – Considers

any fare that is changeable to be returned. Excludes non-changeable fares.

WPMPC-ANY,

WPNI‡MPC-ANY,

JR.../MPC-ANY

<VoluntaryChanges Match="All">

<Penalty Type="Exchange">

</VoluntaryChanges>

Either Changeable or Refundable – Considers

any fare that is either changeable or refundable to be returned. Excludes fares that are both non-changeable and non-refundable.

WPMP-ANY,

WPNI‡MP-ANY,

JR.../MP-ANY

<VoluntaryChanges Match="Any">

<Penalty Type="Exchange">

<Penalty Type="Refund">

</VoluntaryChanges>

Specify Maximum Penalty Amounts – Filtering

meeting criteria of max penalty amount defined in the request.

If you specify a maximum penalty of 0, changeable or refundable fares without any penalties will be returned. Exclude fares with Penalty (same as XP) = MP-0.

MP-nnn (MP-0 or MP-100

or MP-USD100)

WPMP-0,

WPNI‡MP-100,

JR.../MP-USD100

WPMPR-0,

WPNI‡MPC-100,

JR.../MPR-USD100

<VoluntaryChanges Match="Any">

<Penalty Type="Exchange”

Amount="100" CurrencyCode="USD"/>

<Penalty Type="Refund"

Amount="100" CurrencyCode="USD"/>

</VoluntaryChanges>

Changeable and Refundable – Considers

any fare that is both changeable and refundable to be returned. Excludes any fare that is either non-changeable or non-refundable.

WPMPC-ANY‡MPR-ANY,

WPNI‡MPC-ANY‡MPR-ANY,

JR.../MPC-ANY/MPR-ANY

<VoluntaryChanges Match="All">

<Penalty Type="Exchange">

<Penalty Type="Refund">

</VoluntaryChanges>

Page 21: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Sabre Low Fare Search Via WPNI and JR 15

Filtering Capabilities New secondary action

codes (WP/JR/WPNI/W#)

New BFM schema elements in the

request

Changeable (with max penalty) and Refundable

Example specifying max penalty amount to the change fee only.

WPMPC-100‡MPR-ANY,

WPNI‡MPC-100‡MPR-ANY,

JR.../MPC-100/MPR-ANY

<VoluntaryChanges Match="All">

<Penalty Type="Exchange”

Amount="100" CurrencyCode="EUR"/>

<Penalty Type="Refund"

</VoluntaryChanges>

Changeable (with max penalty) and Refundable (with max penalty)

Example specifying max penalty amount to both change and refund fee.

WPMPC-200‡MPR-100,

WPNI‡MPC-200‡MPR-100,

JR.../MPC-200/MPR-100

<VoluntaryChanges Match="All">

<Penalty Type="Exchange”

Amount="100"/>

<Penalty Type="Refund"

Amount="200"/>

</VoluntaryChanges>

Non Refundable

Excludes refundable fares.

WPMPR-N,

WPNI‡MPR-N,

JR.../MPR-N

<VoluntaryChanges Match="All">

<Penalty Type="Refund"

Exclude="True"

</VoluntaryChanges>

Non Changeable

Excludes changeable fares.

WPMPC-N,

WPNI‡MPC-N,

JR.../MPC-N

<VoluntaryChanges Match="All">

<Penalty Type="Exchange"

Exclude="True"

</VoluntaryChanges>

Either Non Changeable or Non Refundable

Only non-changeable OR non-refundable (exclude if BOTH changeable AND refundable).

WPMP-N,

WPNI‡MP-N,

JR.../MP-N

<VoluntaryChanges Match="All">

<Penalty Type="Exchange"

Exclude="True"

<Penalty Type="Refund"

</VoluntaryChanges>

Specify AFTER/BEFORE Departure

Filtering meeting criteria of after and before departure defined in the request. Add “BEFDEP” or “AFTDEP” suffix to the qualifier on the input.

WPMPC-100/BEFDEP

WPNI‡ MPC-100/BEFDEP

JR... /MPR-ANY/AFTDEP

<VoluntaryChanges Match="Any">

<Penalty Type="Exchange"

Application=”Before” Amount="100"

Currency="EUR"/>

<Penalty Type="Refund"

Application=”After” Amount="200"

Currenct="EUR"/>

</VoluntaryChanges>

• You cannot combine XR and XP parameters with the Max Penalty feature. If you combine the

Max-Penalty qualifier with XR or XP, the error response of “Max Penalty is not combinable with

XR” or “Max Penalty is not combinable with XP” will be returned.

• Max Penalty is an optional qualifier and can be used in any or all groups including main group.

• Different Max Penalty filters in different groups can be used.

2.2.9.2 JR Example

The Max Penalty qualifier will be an optional qualifier in the MFPI groups. New information will be

made available in the responding screen display.

JR.JFK/S-OYLHR12MAY0000/MP-300¤MF1-C/P-ADT/MP-200¤MF2-Y/P-ADT/MP-100«

ITINERARY OPTION 1

1 SU 101 T 12MAY Q JFK SVO 0220P 0625A 77W 0 /E

1 SU 2578 T 13MAY F SVO LHR 1005A 1205P 333 0 /E

Page 22: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

16 Sabre Low Fare Search Via WPNI and JR Developer Administration Guide December 2016

1ADT 529.50 529.50

TOTAL FARE - USD 529.50

MF1-1 1ADT 3831.10 3831.10

MF2-1 1ADT 529.50 529.50

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE JR01*MFxx

VALIDATING CARRIER - SU

CHANGE AND REFUND INFORMATION

ADT - CHG BEF DEP UP TO USD100.00/CHG AFT DEP UP TO USD100.00/N

ON-REF BEF DEP/NON-REF AFT DEP/OTHERWISE NON-CHG/SEE RULES

MFPI penalty information is available in the follow up JR01*MFxx entry.

JR01*MFALL

MF1 1ADT C MP-300

CHANGE AND REFUND INFORMATION

ADT - CHG BEF DEP UP TO USD50.00/CHG AFT DEP UP TO USD50.00/REF B

EF DEP UP TO USD0.00/REF AFT DEP UP TO USD0.00/SEE RULES

CHANGE AND REFUND INFORMATION

MF2 1ADT Y MP-200

CHANGE AND REFUND INFORMATION

ADT - CHG BEF DEP UP TO USD0.00/CHG AFT DEP UP TO USD0.00/N

ON-REF BEF DEP/NON-REF AFT DEP/OTHERWISE NON-CHG/SEE RULES

2.2.9.3 WPNI Example

The Max Penalty qualifier will be an optional qualifier in the MFPI groups. New information will be

made available in the responding screen display.

WPNI‡MP-300¤MF1-C‡PADT‡MP-200¤MF2-Y‡PADT‡MP-100

BARGAIN FINDER PLUS IN PROGRESS PLEASE WAIT

WPNI‡MP-300¤MF1-C‡PADT‡MP-200¤MF2-Y‡PADT‡MP-100

CURRENT ITINERARY-LOWER AVAIL CLASS OF SERVICE FOUND

1 K0 924 Q 20NOV F ATL LAX 0729A 0930A 73H 0 /E

2 K0 929 S 24NOV T LAX ATL 0530A 1234P 75W 0 /E

1ADT 200.00 200.00

TOTAL FARE - AUD 200.00

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE WC*0MF00

VALIDATING CARRIER - K0

MF1-0 1ADT 388.10 388.10

VALIDATING CARRIER - K0

MF2-0 1ADT 198.10 198.10

CHANGE AND REFUND INFORMATION

ADT - CHG BEF DEP UP TO USD100.00/CHG AFT DEP UP TO USD100.00/N

ON-REF BEF DEP/NON-REF AFT DEP/OTHERWISE NON-CHG/SEE RULES

MFPI penalty trailers in the follow up WC*xxMFxx entry.

WC*00xMFALL

MF1 1ADT C MP-300

CHANGE AND REFUND INFORMATION

ADT - CHG BEF DEP UP TO USD50.00/CHG AFT DEP UP TO USD50.00/REF B

EF DEP UP TO USD0.00/REF AFT DEP UP TO USD0.00/SEE RULES

MF2 1ADT Y MP-200

CHANGE AND REFUND INFORMATION

Page 23: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Sabre Low Fare Search Via WPNI and JR 17

ADT - CHG BEF DEP UP TO USD0.00/CHG AFT DEP UP TO USD0.00/N

ON-REF BEF DEP/NON-REF AFT DEP/OTHERWISE NON-CHG/SEE RULES

2.2.9.4 Specify Maximum Penalty – WPNI/JR Error Messages

The XR and XP parameters are not combinable with the Max Penalty feature. If combined with the

Max-Penalty qualifier, then one of the follow error messages will be displayed. This is applicable to

both WPNI and JR entries.

JR.JFK/S-OYLHR12MAY0000/MP-300¤MF1-C/P-ADT/XR/MP-200

Max Penalty is not combinable with XR

JR.JFK/S-OYLHR12MAY0000/MP-300¤MF1-C/P-ADT/XP/MP-200

Max Penalty is not combinable with XP

2.2.10 L o w F a r e S e a r c h – A d d i t i o n a l E x a m p l e s

In the following example, you will see multiple ways to use Multiple Fare Per Itinerary via WPNI

and JR.

2.2.10.1 Low Fare Search via JR Linear Command

Fare solutions will only be returned for a group where a fare is offered and available based on the

qualifiers within the specific group. Due to this, there is the potential of fares not returning for each

defined group.

The following example has nine groups defined in the JR entry. Option 1 only has fares available for

groups 1, 2, 3, 4, 5, 6, and 9.

JR.ATL/S-OYLAX23MAY0700/S-OYATL25MAY0700¤MF1-Y/P-GVT¤MF2/N-LIB15¤MF3/Q-

PL¤MF4/XP/XA/XS¤MF5/Q-PV¤MF6/XR/N-LIB04¤MF7/AC*L

IBERTY¤MF8-B/P-CNN/N-LIB04¤MF9/P-MIL«

ITINERARY OPTION 1

1 K0 1555 Y 23MAY M ATL LAX 1050 1240 739 0 /E

2 K0 101 Y 25MAY W LAX ATL 1045 1800 739 0 /E

1ADT 243.20 243.20 LIB15

TOTAL FARE - USD 243.20

MF1-1 1GVT 508.20 508.20 *BR

MF2-1 1ADT 243.20 243.20 LIB15

MF3-1 1ADT 558.08 558.08 *BR

MF4-1 1ADT 243.20 243.20 LIB15

MF5-1 1ADT 243.20 243.20 LIB15

MF6-1 1ADT 350.70 350.70 LIB04

MF9-1 1MIL 345.60 345.60 *BR

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE JR01*MFxx

VALIDATING CARRIER - K0

CAT 15 SALES RESTRICTIONS FREE TEXT FOUND - VERIFY RULES

ITINERARY OPTION 2

1 XX 1315 Q 23MAY M ATL DFW 0615 0725 738 0 /E

1 XX 2442 Q 23MAY M DFW LAX 0838 1000 757 0 /E

2 YY /XX 1200 T 25MAY W LAX ATL 2230 0549 319 0 /E

OPERATED BY AMERICAN AIRLINES

Page 24: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

18 Sabre Low Fare Search Via WPNI and JR Developer Administration Guide December 2016

1ADT 337.98 337.98

TOTAL FARE - USD 337.98

MF3-2 1ADT 337.98 337.98

MF4-2 1ADT 337.98 337.98

MF6-2 1ADT 337.98 337.98 LIB04

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE JR02*MFxx

VALIDATING CARRIER - XX

ALTERNATE VALIDATING CARRIER/S - YY

ITINERARY OPTION 3

1 YY /XX 1182 H 23MAY M ATL LAX 0700 0841 319 0 /E

OPERATED BY AMERICAN AIRLINES

2 YY /XX 1200 T 25MAY W LAX ATL 2230 0549 319 0 /E

OPERATED BY AMERICAN AIRLINES

1ADT 366.29 366.29

TOTAL FARE - USD 366.29

MF3-3 1ADT 366.29 366.29

MF4-3 1ADT 366.29 366.29

MF6-3 1ADT 366.29 366.29 LIB04

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE JR03*MFxx

VALIDATING CARRIER - YY

2.2.11 L o w F a r e S e a r c h v i a W P N I L i n e a r C o m m a n d

WPNI¤MF1-L‡PGVT¤MF2-Q‡PMIL¤MF3‡ILIB04¤MF4‡ILIB15

BARGAIN FINDER PLUS IN PROGRESS PLEASE WAIT

WPNI¤MF1-L‡PGVT¤MF2-Q‡PMIL¤MF3‡ILIB04¤MF4‡ILIB15

CURRENT ITINERARY-ALREADY BOOKED AT LOWEST AVAIL FARE

1 K0 2277 Y 20OCT T ATL LAX 0725A 0920A 73H 0 /E

2 K0 2222 Y 24OCT J LAX ATL 0645A 0158P 752 0 /E

2ADT 243.20 486.40 LIB15

TOTAL FARE - USD 486.40

MF1-0 2GVT 508.20 1016.40 *BR

MF3-0 2ADT 350.70 701.40 LIB04

MF4-0 2ADT 243.20 486.40 LIB15

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE WC*0MFxx

VALIDATING CARRIER - K0

CAT 15 SALES RESTRICTIONS FREE TEXT FOUND - VERIFY RULES

BARGAIN FINDER PLUS ITINERARY OPTIONS

OPTION 1

1 XX 2437 O 20OCT T ATL LAX 1230P 0220P 319 0 /E

2 XX 1249 O 24OCT J LAX ATL 1000A 0521P 319 0 /E

2ADT 166.20 332.40

TOTAL FARE - USD 332.40

MF1-1 2GVT 348.20 696.40

MF2-1 2MIL 413.40 826.80

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE WC*1MFxx ‡

2.2.11.1 Examples of Entry and Response to Display Multiple Fare Group Details

Note Display specific group details: (based on Itinerary Option 1 above)

WC*1MF01«

MF1 2GVT L

Page 25: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Sabre Low Fare Search Via WPNI and JR 19

WC*1MF02«

MF2 2MIL Q

Display details for all groups for specific itinerary option:

WC*1MFALL«

MF1 2GVT L

MF2 2MIL Q

2.2.12 L o w F a r e S e a r c h v i a W P N I L i n e a r C o m m a n d w i t h B r a n d e d

F a r e D e t a i l

When a Branded Fare is the lowest fare for the MFPI group, it will be returned. The details of the

Branded Fare can be displayed.

WPNI¤MF1-F‡PGVT¤MF2-V«

BARGAIN FINDER PLUS IN PROGRESS PLEASE WAIT

WPNI¤MF1-F‡PGVT¤MF2-V

CURRENT ITINERARY-LOWER AVAIL CLASS OF SERVICE FOUND

1 XX /K0 5009 M 12DEC J LHR AUH 1405 0120 388 0 /E

OPERATED BY ETIHAD AIRWAYS

1ADT 2749.60 2749.60

TOTAL FARE - USD 2749.60

MF2-0 1ADT 2749.60 2749.60

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE WC*0MFxx

VALIDATING CARRIER - XX

CAT 15 SALES RESTRICTIONS FREE TEXT FOUND - VERIFY RULES

REBOOK TO OBTAIN ABOVE FARE-USE WPNCB

BARGAIN FINDER PLUS ITINERARY OPTIONS

OPTION 1

1 K0 /EI 7925 V 12DEC J LHR DUB 1620 1740 320 0 /E ‡

OPERATED BY AER LINGUS LIMITED

1 K0 5965 V 12DEC J DUB AUH 1900 0400 333 0 /E

BR1-1 1ADT 625.70 625.70

TOTAL FARE - USD 625.70

VALIDATING CARRIER - K0

MF2-1 1ADT 625.70 625.70 *BR

VALIDATING CARRIER - K0

* TO SEE ADDITIONAL BRAND DETAILS - USE WC*1BRxx

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE WC*1MFxx

WC*1MF02«

MF2 1ADT V

TOTAL FARE - USD 625.70

BR /ECONOMY SAVER-YS-K0-A/ECONOMY SAVER-YS-K0-A

2.2.13 L o w F a r e S e a r c h v i a W P N I L i n e a r C o m m a n d w i t h M u l t i p l e

C a b i n s

WPNI¤MF1-F¤MF2-V«

BARGAIN FINDER PLUS IN PROGRESS PLEASE WAIT

WPNI¤MF1-F¤MF2-V

Page 26: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

20 Bargain Finder Max Developer Administration Guide December 2016

CURRENT ITINERARY-LOWER AVAIL CLASS OF SERVICE FOUND

1 K0 1219 T 12DEC J ATL LAX 1340 1547 752 0 /E

2 K0 101 Q 17DEC Q LAX ATL 1230 1945 753 0 /E

1ADT 584.20 584.20

TOTAL FARE - USD 584.20

/MAIN CABIN-D2-K0-B/MAIN CABIN-D2-K0-B

VALIDATING CARRIER - K0

MF2-0 1ADT 584.20 584.20 *BR

/MAIN CABIN-D2-K0-B/MAIN CABIN-D2-K0-B

VALIDATING CARRIER - K0

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE WC*0MFxx

REBOOK TO OBTAIN ABOVE FARE-USE WPNCB

BARGAIN FINDER PLUS ITINERARY OPTIONS

OPTION 1

1 XX 2437 O 12DEC J ATL LAX 1230 1430 319 0 /E

2 XX 2513 O 17DEC Q LAX ATL 1600 2315 319 0 /E

1ADT 151.20 151.20

TOTAL FARE - USD 151.20

MF1-1 1ADT 826.20 826.20

MF2-1 1ADT 151.20 151.20

* TO SEE ADDITIONAL MULTIPLE FARE DETAILS - USE WC*1MFxx

VALIDATING CARRIER - XX

WC*1MF01«

MF1 1ADT F

WC*1MF02«

MF2 1ADT V

2.3 B a r g a i n F i n d e r M a x

The appropriate Bargain Finder Max schema version is required to use the Multiple Fares Per

Itinerary functionality. New request and response elements are available.

2.3.1 B a r g a i n F i n d e r M a x – R e q u e s t

The Multiple Fares Per Itinerary group definition path:

OTA_AirLowFareSearchRQ/TravelPreferences/TPA_Extensions/FlexibleFares

<FlexibleFares> is the Multiple Fares Per Itinerary group creation tag.

2.3.1.1 SOAP Request

<OTA_AirLowFareSearchRQ>

<TravelPreferences>

<TPA_Extensions>

<TripType Value="OneWay"/>

<FlexibleFares>

<FareParameters>

<ExcludeRestricted Ind="true"/>

<PublicFare Ind="true"/>

<Cabin Type="Y"/>

</FareParameters>

<FareParameters>

<ResTicketing Ind="true"/>

Page 27: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Bargain Finder Max 21

<PassengerType Code="ADT"/>

</FareParameters>

<FareParameters>

<RefundPenalty Ind="true"/>

</FareParameters>

<FareParameters>

<MinMaxStay Ind="true"/>

</FareParameters>

<FareParameters>

<PrivateFare Ind="true"/>

</FareParameters>

<FareParameters>

<Cabin Type="Y"/>

<PassengerType Code="ADT"/>

</FareParameters>

<FareParameters>

<RefundPenalty Ind="true"/>

<Cabin Type="Y"/>

</FareParameters>

<FareParameters>

<Cabin Type="C"/>

</FareParameters>

<FareParameters>

<ExcludeRestricted Ind="true"/>

<Cabin Type="F"/>

</FareParameters>

<FareParameters>

<Cabin Type="F"/>

<PassengerType Code="CNN"/>

</FareParameters>

</FlexibleFares>

</TPA_Extensions>

</TravelPreferences>

</OTA_AirLowFareSearchRQ>

2.3.1.2 REST Request

{

"OTA_AirLowFareSearchRQ": {

"TravelPreferences": {

"TPA_Extensions": {

"TripType": {

"Value": "OneWay"

},

"FlexibleFares": {

"FareParameters": [{

"ExcludeRestricted": {

"Ind": true

},

"PublicFare": {

"Ind": true

},

"Cabin": {

"Type": "Y"

}

}, {

"ResTicketing": {

"Ind": true

},

Page 28: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

22 Bargain Finder Max Developer Administration Guide December 2016

"PassengerType": {

"Code": "ADT"

}

}, {

"RefundPenalty": {

"Ind": true

}

}, {

"MinMaxStay": {

"Ind": true

}

}, {

"PrivateFare": {

"Ind": true

}

}, {

"Cabin": {

"Type": "Y"

},

"PassengerType": {

"Code": "ADT"

}

}, {

"RefundPenalty": {

"Ind": true

},

"Cabin": {

"Type": "Y"

}

}, {

"Cabin": {

"Type": "C"

}

}, {

"ExcludeRestricted": {

"Ind": true

},

"Cabin": {

"Type": "F"

}

}, {

"Cabin": {

"Type": "F"

},

"PassengerType": {

"Code": "CNN"

}

}],

}

}

}

}

}

Page 29: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Bargain Finder Max 23

2.3.2 B a r g a i n F i n d e r M a x – R e s p o n s e

The information for the MFPI solutions returned in the Bargain Finder Max response will be found in

the following path.

OTA_AirLowFareSearchRS/PricedItineraries/TPA_Extensions/AdditionalFares

The MFPI associated group number will be provided as FlexibleFareID= as in the following

response.

2.3.2.1 SOAP Response

<OTA_AirLowFareSearchRS>

<PricedItineraries>

<TPA_Extensions>

<AdditionalFares>

<AirItineraryPricingInfo PricingSource="ADVJR1"

PricingSubSource="MIP" FlexibleFareID="1">

2.3.2.2 REST Response

"TPA_Extensions": {

"AdditionalFares": [

{

"AirItineraryPricingInfo": {

"LastTicketDate": "2016-11-16",

"FlexibleFareID": 1,

"PricingSource": "ADVJR1",

"PricingSubSource": "MIP",

"FareReturned": true,

"ItinTotalFare": {

2.3.3 B a r g a i n F i n d e r M a x – C o r p o r a t e I D / A c c o u n t C o d e

The new schema element NegotiatedFaresOnly with the attribute @Ind was added into the OTA Flex

Fare Group Definition in following path:

OTA_AirLowFareSearchRQ/TravelPreferences/TPA_Extensions/FlexibleFares/FareParameter

s/NegotiatedFaresOnly/@Ind

NegotiatedFaresOnly/@Ind set to “true” indicates the returned fares must match Corporate ID/

Account Code specified in the Fare Group definition on all fare components.

2.3.3.1 Soap Request – Corporate ID/Account Code Example

Following is a snippet from the OTA request with the new element in the MFPI group:

Page 30: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

24 Bargain Finder Max Developer Administration Guide December 2016

<OTA_AirLowFareSearchRQ>

<TravelPreferences>

<TPA_Extensions>

<FlexibleFares>

<FareParameters>

<PassengerType Code="NEG"/>

<NegotiatedFaresOnly Ind="true"/>

<AccountCode Code="LLL10"/>

</FareParameters>

</FlexibleFares>

</TPA_Extensions>

</TravelPreferences>

</OTA_AirLowFareSearchRQ>

Note There is no change in the response.

2.3.3.2 REST Request – Corporate ID/Account Code Example

Following is a snippet from the request with the new element in the MFPI group:

{

"OTA_AirLowFareSearchRQ": {

"TravelPreferences": {

"TPA_Extensions": {

"FlexibleFares": {

"FareParameters": [{

"PassengerType": {

"Code": "NEG"

},

"NegotiatedFaresOnly": {

"Ind": true

},

"AccountCode": [{

"Code": "LLL10"

}],

}],

}

}

}

}

2.3.4 B a r g a i n F i n d e r M a x – E x p a n d J u m p C a b i n

The new optional element JumpCabinLogic with the attribute Disabled was added in the path:

OTA_AirLowFareSearchRQ/TravelPreferences/TPA_Extensions/FlexibleFares/FareParameter

s/JumpCabinLogic/@Disabled

JumpCabinLogic/@Disabled set to “true” triggers the Expand Jump Cabin logic in shopping.

2.3.4.1 Soap Request – Expand Jump Cabin Example

Following is a snippet from the OTA request with the new element in the MFPI group:

Page 31: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Bargain Finder Max 25

<TravelPreferences>

<TPA_Extensions>

<FlexibleFares>

<FareParameters>

<Cabin Type="C"/>

<JumpCabinLogic Disabled="true"/>

</FareParameters>

</FlexibleFares>

</TPA_Extensions>

</TravelPreferences>

2.3.4.2 REST Request – Expand Jump Cabin Example

Following is a snippet from the request with the new element in the MFPI group:

{

"OTA_AirLowFareSearchRQ": {

"TravelPreferences": {

"TPA_Extensions": {

"FlexibleFares": {

"FareParameters": [{

"JumpCabinLogic": {

"Disabled": true

},

}

}],

}

}

}

}

}

2.3.5 B a r g a i n F i n d e r M a x – D i s a b l e J u m p C a b i n

The new optional element KeepSameCabin with attribute Enabled was added in the path:

OTA_AirLowFareSearchRQ/TravelPreferences/TPA_Extensions/FlexibleFares/FareParameter

s/KeepSameCabin/@Enabled

When the value of KeepSameCabin/@Enabled is set to “true,” it will trigger the Disable Jump Cabin

logic in shopping.

2.3.5.1 Soap Request – Disable Jump Cabin Example

Following is a snippet from the OTA request with the new element in the MFPI group:

Page 32: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

26 Bargain Finder Max Developer Administration Guide December 2016

<TravelPreferences>

<TPA_Extensions>

<FlexibleFares>

<FareParameters>

<Cabin Type="S"/>

<KeepSameCabin Enabled="true"/>

</FareParameters>

</FlexibleFares>

</TPA_Extensions>

</TravelPreferences>

2.3.5.2 REST Request – Disable Jump Cabin Example

Following is a snippet from the request with the new element in the MFPI group:

{

"OTA_AirLowFareSearchRQ": {

"TravelPreferences": {

"TPA_Extensions": {

"FlexibleFares": {

"FareParameters": [{

"KeepSameCabin": {

"Enabled": true

}

}],

}

}

}

}

2.3.6 P a s s e n g e r T y p e – X O Q u a l i f i e r

The new optional element XOFares with attribute Ind was added in the path:

OTA_AirLowFareSearchRQ/TravelPreferences/TPA_Extensions/FlexibleFares/

FareParameters/XOFares/@Ind

When XOFares/@Ind is set to “true,” then only the fares matching the requested passenger type will

be returned on all fare components. Otherwise, the fare matching specified passenger type will be

returned on at least one leg.

2.3.6.1 SOAP Request – Example

Excerpt from OTA request with new element in MFPI group:

<TravelPreferences>

<TPA_Extensions>

<FlexibleFares>

<FareParameters>

<XOFares Ind="true"/>

<PassengerTypeQuantity Code="SEA" Quantity="1"/>

</FareParameters>

</FlexibleFares>

</TPA_Extensions>

Page 33: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Bargain Finder Max 27

</TravelPreferences>

2.3.6.2 REST Request – Example

Following is a snippet from the request with the new element in the MFPI group:

{

"OTA_AirLowFareSearchRQ": {

"TravelPreferences": {

"TPA_Extensions": {

"FlexibleFares": {

"FareParameters": [{

"XOFares": {

"Ind": true

},

"PassengerTypeQuantity": [

}

}

}

}

}

2.3.7 M u l t i p l e P a s s e n g e r T y p e s

The new optional element PassengerTypeQuantity was added in the path.

OTA_AirLowFareSearchRQ/TravelPreferences/TPA_Extensions/FlexibleFares/

FareParameters/PassengerTypeQuantity

The new element includes two attributes:

• @Code – to specify the requested passenger code.

• @Quantity – to specify the number of the given passenger types.

Up to four PassengerTypeQuantity elements with different Passenger Types Codes can be added in a

single Multiple Fares Group. The number of the passengers must be the same across all groups

including the main group.

2.3.7.1 SOAP Request - Example

Following is a snippet from the OTA request with the new element in the MFPI group:

<TravelPreferences>

<TPA_Extensions>

<FlexibleFares>

<FareParameters>

<PassengerTypeQuantity Code="SEA" Quantity="1"/>

<PassengerTypeQuantity Code="MIL" Quantity="1"/>

</FareParameters>

<FareParameters>

</FareParameters>

</FlexibleFares>

</TPA_Extensions>

</TravelPreferences>

<TravelerInfoSummary>

Page 34: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

28 Bargain Finder Max Developer Administration Guide December 2016

<SeatsRequested>2</SeatsRequested>

<AirTravelerAvail>

<PassengerTypeQuantity Code="ADT" Quantity="2"/>

</AirTravelerAvail>

</TravelerInfoSummary>

2.3.7.2 REST Request - Example

Following is a snippet from the request with the new element in the MFPI group:

{

"OTA_AirLowFareSearchRQ": {

"TravelPreferences": {

"TPA_Extensions": {

"FlexibleFares": {

"FareParameters": [{

"PassengerTypeQuantity": [

{

"Code": "ADT",

"Quantity": 1

}

}

2.3.8 F i l t e r i n g C a p a b i l i t i e s b y C h a n g e F e e / R e f u n d

I n f o r m a t i o n / M a x i m u m P e n a l t y

The Specify Max Penalty functionality has been made available in the MFPI group level. This will

introduce new request schema elements within the group.

The new optional element VoluntaryChanges was added in the path.

OTA_AirLowFareSearchRQ/TravelPreferences/TPA_Extensions/FlexibleFares/FareParameter

s/VoluntaryChanges

The new element includes two attributes:

• @Type- to specify the type of penalty, with a value “Exchange” or “Refund.”

• @Amount – to specify the penalty amount.

Specific Max Penalty (SMP) in the flex fare group will be validated in same way as it does now for

the main fare.

MFPI group definition will be ignored when:

• There is more than one penalty definition.

• Refund penalty indicator is set to false, and SMP is defined but not in info mode.

• There is no more than one refund or one exchange.

2.3.8.1 Soap Request - Example

Following is a snippet from the OTA request with the Max Penalty specified in the MFPI group:

Page 35: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

Developer Administration Guide December 2016 Bargain Finder Max 29

<FlexibleFares>

<FareParameters>

<VoluntaryChanges Match="Any Info">

<Penalty Type="Refund|Exchange"

Application="After|Before" Exclude="true|false" Amount="" CurrencyCode=""/>

<Penalty Type="Refund|Exchange"

Application="After|Before" Exclude="true|false" Amount="" CurrencyCode=""/>

</VoluntaryChanges>

</FareParameters>

</FlexibleFares>

2.3.8.2 REST Request - Example

Excerpt from request with Max Penalty specified in MFPI group:

{

"OTA_AirLowFareSearchRQ": {

"TravelPreferences": {

"TPA_Extensions": {

"FlexibleFares": {

"FareParameters": [

{

"RefundPenalty": {

"Ind": true

} }

}

}

}

2.3.8.3 SOAP Response - Example

<PenaltiesInfo>

<Penalty Type="Exchange" Applicability="Before" Changeable="true"

ConditionsApply="true" Amount="150.00" DecimalPlaces="2" CurrencyCode="USD"/>

<Penalty Type="Exchange" Applicability="After" Changeable="false"/>

<Penalty Type="Refund" Applicability="Before" Refundable="false"

Cat16Info="true"/>

<Penalty Type="Refund" Applicability="After" Refundable="false"

Cat16Info="true"/>

</PenaltiesInfo>

<TPA_Extensions>

Page 36: Multiple Fares Per Itineraryfiles.developer.sabre.com/doc/providerdoc/shopping/...• Combinable with applicable Air Shopping search qualifiers (for example, Air Extras, time window,

30 Bargain Finder Max Developer Administration Guide December 2016

• • •