WorldSpan - 9I05 SecuRate Air Linear Entries Technical Guide

7/31/2019 WorldSpan - 9I05 SecuRate Air Linear Entries Technical Guide

1/45

SecuRate Air

Linear Entries

Technical GuideVersion 1.0


2/45

Section One Fare Item EntriesSecuRate Air Linear Entries

Technical Guide

10/11/2001

I:\Terri K\16388 tech guide.doc


3/45


Technical Guide

10/11/2001


Table Of Contents

1 SECTION ONE FARE ITEM ENTRIES......................................................... 1.1

FLAT RATE FARE ITEM CREATE ENTRY LAYOUT .................................................... 1.2IELD DESCRIPTIONS....................................................................................................... 1.2

DISCOUNTED PUBLISHED FARE ITEM CREATE ENTRY LAYOUT............................... 1.5FIELD DESCRIPTIONS..................................................................................................... 1.5

NET/NET FARE ITEM CREATE ENTRY LAYOUT........................................................ 1.8FIELD DESCRIPTIONS..................................................................................................... 1.8

CHANGE ENTRY FOR SINGLE FARE ITEM - LAYOUT ................................................. 1.11FIELD DESCRIPTIONS................................................................................................... 1.11

CHANGE ENTRY FOR A RANGE OF FARE ITEMS - LAYOUT ........................................ 1.11FIELD DESCRIPTIONS................................................................................................... 1.11

CHANGE ENTRY FOR A MULTIPLE FARE ITEMS - LAYOUT........................................ 1.12FIELD DESCRIPTIONS................................................................................................... 1.12

DELETE ENTRY FOR A SINGLE FARE ITEM LAYOUT............................................... 1.13FIELD DESCRIPTIONS................................................................................................... 1.13

DELETE ENTRY FOR A RANGE OF FARE ITEMS LAYOUT......................................... 1.13FIELD DESCRIPTIONS................................................................................................... 1.13

DELETE ENTRY FOR MULTIPLE FARE ITEMS LAYOUT ........................................... 1.13FIELD DESCRIPTIONS................................................................................................... 1.13

DELETE ENTRY FOR ALL FARE ITEMS LAYOUT ..................................................... 1.14FIELD DESCRIPTION .................................................................................................... 1.14

DELETE ENTRY FOR FIELD(S) WITHIN A SINGLE FARE ITEM LAYOUT ..................1.15

FIELD DESCRIPTIONS................................................................................................... 1.15DELETE ENTRY FOR FIELD(S) WITHIN A RANGE OF FARE ITEMS LAYOUT ............. 1.15FIELD DESCRIPTIONS................................................................................................... 1.15

DELETE ENTRY FOR FIELD(S) WITHIN MULTIPLE FARE ITEMS LAYOUT................ 1.16FIELD DESCRIPTIONS................................................................................................... 1.16

DELETE ENTRY FOR FIELD(S) WITHIN MULTIPLE FARE ITEMS LAYOUT ............... 1.16FIELD DESCRIPTIONS................................................................................................... 1.16

2 SECTION TWO: FIELD IDENTIFIERS........................................................... 2.1

CXR............................................................................................................................. 2.1BAG ............................................................................................................................ 2.2BKG ............................................................................................................................ 2.2

CAR............................................................................................................................. 2.3CMP ............................................................................................................................ 2.3

CMU............................................................................................................................ 2.4COM............................................................................................................................ 2.4

CON ............................................................................................................................ 2.4


4/45


Technical Guide

10/11/2001


CUR............................................................................................................................. 2.5DIR.............................................................................................................................. 2.5

DST ............................................................................................................................. 2.6PCT ............................................................................................................................. 2.7

MST............................................................................................................................. 2.8NET............................................................................................................................. 2.8

NON............................................................................................................................ 2.9ORG .......................................................................................................................... 2.10

PFB............................................................................................................................2.11RTG........................................................................................................................... 2.12

SCA........................................................................................................................... 2.12SEL............................................................................................................................2.13

TDC........................................................................................................................... 2.13TFB ........................................................................................................................... 2.13

TVL........................................................................................................................... 2.14

UPG........................................................................................................................... 2.14VAL...........................................................................................................................2.14

3 SECTION THREE: DESCRIPTORS ................................................................. 3.1

DESCRIPTOR CREATE ENTRY LAYOUT..................................................................... 3.2FIELD DESCRIPTION ...................................................................................................... 3.2

DESCRIPTOR DELETE ENTRY LAYOUT ..................................................................... 3.2FIELD DESCRIPTION ...................................................................................................... 3.2

DESCRIPTOR RULE MODIFICATION ENTRY LAYOUT................................................ 3.2FIELD DESCRIPTIONS..................................................................................................... 3.2

DESCRIPTOR DISPLAY ENTRY LAYOUT .................................................................... 3.3FIELD DESCRIPTIONS..................................................................................................... 3.3

APPLYING A DESCRIPTOR .............................................................................................. 3.3

4 SECTION FOUR: AGREEMENT LEVEL RULES (UNDER DEVELOPMENT) ..4.1

5 SECTION FIVE: FARE ITEM LEVEL RULES (UNDER DEVELOPMENT) ....... 5.1

6 SECTION SIX: ERROR CONDITIONS SPECIFIC TO LINEAR ENTRIES 6.1

7 SECTION SEVEN: INPUT/OUTPUT ................................................................ 7.1


5/45


Technical Guide

10/11/2001


Introduction:

This document provides SecuRate Air users with the technical information necessary to

interface with Worldspans SecuRate Air Database. Using Linear Entries, users canadminister SecuRate Air without using templates. Linear Entries provide manualtemplate users with some desirable shortcuts. In addition, Linear Entries provide third

party users and robotics the necessary medium to more easily add, delete, and modifyinformation within the SecuRate Air Database.

The Linear Entries in this document are broken down into separate components for ease

of application. This allows users to start taking advantage of Linear Entries while somecomponents are still in development. At the initial release of the Technical Guide,

several components of Linear Entries are still in development and those sections will becompleted as products are released. Another reason for the sectional approach to the

guide is to allow users to choose the component of the product that most specificallymeets their most pressing business need, allowing them to tailor their adoption of Linear

Entries to their business.

Following is a list of the sections and what they cover:

Section DescriptionSection One:Fare Item Entries

This section covers all the entries required to create, delete,and modify individual or multiple fare items. Mandatory

fields are identified and format examples are included foroptional fields.

Section Two:

Field Identifiers

This section lists all of the mandatory and optional fields

available for Fare Item entries. Field definitions, technicalspecifications and requirements are described for each

individual field.

Section Three:Descriptors

This section covers the entries used to create, change, anddelete descriptors.

Section Four:

Agreement Level Rules

The Linear Entries for agreement level rules are currently

under development and will be added as they are completed

and released. In general, the agreement level rules are onerule per agreement that is applied for the whole agreement.These rules are found on the 4F- menu of the template

product.


6/45


Technical Guide

10/11/2001


Section Five:

Fare Item Level Rules

The Linear Entries for fare item level rules are currently

under development and will be added as they are completed

and released. These rules are designed to be applied to

individual fare items. These rules are found on the 4F-Gmenu of the template product.

Section Six:

Error Conditions

This section identifies error conditions and responses that are

specific to the Linear Entry product. New errors will beadded to this section as development continues. Please Note:

The Linear product uses standard error responses wherepossible. For more information on SecuRate Air error

responses see the SecuRate Air Manual.

Section Seven:

Input/Output

Designed specifically for robotics and third party users, this

section provides character placement specifications for entriesand responses. New entries and responses will be added tothis section as they are released.

Once each component of linear entries is utilized to interface with the SecuRate Airdatabase, they may be combined resulting in an environment where all phases of the

database is manageable using Linear Entries.


7/45


Technical Guide

10/11/2001

I:\Terri K\16388 tech guide.doc 1.1

1 Section One Fare Item Entries

SecuRate Air Linear Entries may be used to create, modify, or deleteFlat Rate, Discounted Published, or Net/Net fare items. In almost all

cases, linear entries are completely compatible with the templateproduct. Fare Items built using the template product can be changed or

deleted using linear entries and fare items built with linear entries maybe changed or deleted using templates. In a few instances, the user has

additional functionality when using linear entries. Once the additionalfunctionality has been taken advantage of, the user is required to

continue to use linear entries to make changes to those fare items.Those instances will be identified through out this document, when

they apply.


8/45


Technical Guide

10/11/2001


Flat Rate Fare

Item Create

Entry Layout

4F-F/FR/CXR-AA/DIR-B/TFB-CCCCCCCC/AMT-

DDDDDDDD/BKG-EE*EE/DESC-FFFF

Please Note: This entry includes all mandatory fields. Additionaloptional fields may also be added. For a comprehensive list of allfields and their description, please see the Field Identifier Chart in

Section Two.

Field Descriptions Field

4F-F

/FR/

CXR-AA

/DIR-

B/

TFB-CCCCCCC

/AMT-

DDDDDDDD

/BKG-EE*EE

/DESC-

FFFF

Description

Function Identifier

Field SeparatorIndicates Flat RateField Separator

Airline Carrier Code Field IdentifierAirline Carrier Code

Field SeparatorDirection of Travel Field Identifier

Direction of TravelField Separator

Ticketed Fare Basis Code Field IdentifierTicketed Fare Basis Code

Field SeparatorFare Amount Field Identifier

Amount of Fare

Field SeparatorBooking Class Field IdentifierBooking Class

Field SeparatorDescriptor Field Identifier

Descriptor Number (see Section Three)

Please Note: For a comprehensive list of allfields and their description please see the Field

Identifier Chart in Section Two.

Max

4

121

42

14

11

48

14

8

14

29

15

4


9/45


Technical Guide

10/11/2001


Example of Linear Entry using the mandatory fields to create a Flat Rate Fare:Entry:

4F-F/FR/CXR-DL/DIR-B/TFB-TEST/AMT-100.00/BKG-Y/DESC-0005

Response:

>4F-F/FR/CXR-XX/DIR-B/TFB-TEST/AMT-100.00/BKG-Y/DESC-0005 (

OK - FARE ITEM CREATED

** Please Note: The input message is redisplayed with the confirmation message, allowing the

user to check his work.

Function Identifier

Designates this as a Flat Rate Fare

Airline Carrier Code

Direction of Travel

Ticketing Fare Basis

Amount of Fare

Booking Class

Rule Descriptor


10/45


Technical Guide

10/11/2001


The following fare item is created:

Entry:

4F-U*F/SIDAGR

Response:

SECURATE FARE ITEMS AGREEMENT SIDAGR

001 ANYWHERE - ANYWHERE A/L-XX DIR-B

TVL-000 RTG-0000 BKG-Y TKT DSG-UNASSIGNED

CUR-USD TKT FBC-TEST PUBL FBC-N/A UPGRADE-N

FARE AMT- 100.00 SCALED-N/A COMB-P/U

DESC-0005 RULES-Z05C

**END**

>

If any of the mandatory fields have not been added in the creation entry SecuRate AIR willreturn an error message identifying the field that must be added.

CONDITION ERROR RESPONSE

Missing or invalid Flat Rate Fareindicator

INVALID FARE TYPE

Missing Airline Carrier Code INVALID AIRLINE CODE

Invalid or missing Direction of

Travel

INVALID DIRECTION-MUST BE O

D B

Invalid or missing Ticketing FareBasis Code

INVALID TICKETED FARE BASIS

Invalid or missing Amount of Fare INVALID AMOUNT / CURRENCY

Invalid or missing Booking Class INVALID BOOKING CODE

If a rule descriptor with a B isattached

B RULE INVLD FOR THIS FARE

TYPE

Missing descriptor INVALID DESCRIPTOR NUMBER


11/45


Technical Guide

10/11/2001


Discounted

Published Fare

Item Create

Entry Layout

4F-F/DP/CXR-XX/DIR-B/TFB-CCCCCCCC/PFB-DDDDDDDD/PCT-EE/BKG-F

Please Note: This entry includes all mandatory fields. Additional

optional fields may also be added. For a comprehensive list of allfields and their description, please see the Field Identifier Chart in

Section Two.


4F-F/

DP/

CXR-

AA/DIR-

B/

TFB-CCCCCCCC

/PFB-

DDDDDDDD/

PCT-EEE

/BKG-

FF*FF

Description

Function IdentifierField Separator

Indicates Discounted PublishedField Separator

Airline Carrier Code Field Identifier

Airline Carrier CodeField SeparatorDirection of Travel Field Identifier


Ticketed Fare Basis Code Field IdentifierTicketed Fare Basis

Field SeparatorPublished Fare Basis Code Field Identifier

Published Fare Basis CodeField Separator

Percent Field IdentifierDiscount Percent

Field SeparatorBooking Code Field Identifier

Booking Code

Please Note: For a comprehensive list of allfields and their description please see the Field

Identifier Chart in Section Two.

Max

41

21

4

214

11

48

14

81

43

14

29


12/45


Technical Guide

10/11/2001


Example of Linear Entry using the mandatory fields to create a Discounted Published

Fare:

Entry:

4F-F/DP/CXR-XX/DIR-B/TFB-TEST/PFB-YPUB/PCT-40/BKG-Y

**Please Note: Either the Discount Percent (PCT) -OR- the Discount Amount field (AMT) is

required

Function Identifier

Designates Discount Published


Direction of Travel

Ticketing Fare Basis Code

Published Fare Basis Code

Discount Percent **

Booking Class


13/45


Technical Guide

10/11/2001


Response:

>4F-F/DP/CXR-XX/DIR-B/TFB-TEST/PFB-YPUB/PCT-40/BKG-Y (


** Please Note: The input message is redisplayed with the OK message allowing the user to check

his work.

The following fare item is created:

Entry:

4F-U*F/SIDAGR

Response:

SECURATE FARE ITEMS AGREEMENT SIDAGR

001 ANYWHERE - ANYWHERE A/L-XX DIR-BTVL-000 RTG-0000 BKG-Y TKT DSG- SIDAGR

CUR-N/A TKT FBC-TEST PUBL FBC-YPUB UPGRADE-N

FARE AMT-N/A SCALED-N/A DISC PCT- 40 COMB-P/U

MUST STOP-N CONNEX-N NONSTOP-N FBC-I

**END**

>

If any of the mandatory fields have not been added in the creation entry SecuRate AIR will returnan error message identifying the field that must be added.


Missing or invalid Flat Rate Fareindicator

INVALID FARE TYPE


Invalid or missing Direction of

Travel

INVALID DIRECTION-MUST BE O D B

Invalid or missing Ticketing Fare

Basis Code

INVALID TICKETED FARE BASIS

Invalid or missing Amount of Fare INVALID AMOUNT / CURRENCY

Invalid or missing Booking Class INVALID BOOKING CODE

If a rule descriptor with a B isattached

B RULE INVLD FOR THIS FARE TYPE

Missing descriptor INVALID DESCRIPTOR NUMBER


14/45


Technical Guide

10/11/2001


Net/Net Fare Item

Create Entry

Layout

4F-F/NN/CXR-AA/DIR-B/TFB-CCCCCCCC/NET-

DDDDDDDDD/CUR-EEE/BKG-FF*FF/DESC-GGGG

Please Note: This entry includes all mandatory fields. Additionaloptional fields may also be added. For a comprehensive list of allfields and their description please see the Field Identifier Chart in

Section Two.


4F-F

/NN/

CXR-AA

/DIR-

B/

TFB-CCCCCCCC

/NET-

DDDDDDDDD

/CUR-EEE

/BKG-

FF*FF/

DESC-GGGG

Description

Function Identifier

Field SeparatorIndicates Net/NetField Separator

Airline Carrier Code Field IdentifierAirline Carrier Code

Field SeparatorDirection of Travel Field Identifier


Ticketed Fare Basis Code Field IdentifierTicketed Fare Basis Code

Field SeparatorNet Fare Amount Field Identifier

Net Fare Amount

Field SeparatorCurrency Code Field IdentifierCurrency Code

Field SeparatorBooking Code Field Identifier

Booking CodeField Separator

Descriptor Field IdentifierDescriptor Number

Max

4

121

42

14

11

48

49

1

431

44

291

54


15/45


Technical Guide

10/11/2001


Example of Linear Entry using the mandatory fields to create a Net/Net Fare:

Entry:4F-F/NN/CXR-XX/DIR-B/TFB-TEST/NET-50.00/CUR-USD/BKG-Y/DESC-0005

Response:

>4F-F/NN/CXR-XX/DIR-B/TFB-TEST/AMT-100.00/CUR-USD/BKG-Y/DESC-0005 (


** Please Note: The input message is redisplayed with the OK message allowing the user to

check his work.

Function Identifier

Designates this as a Net/Net Fare


Direction of Travel

Ticketing Fare Basis Code

Booking Class

Rule Descriptor

Currency

Net Amount of Fare


16/45


Technical Guide

10/11/2001


The following fare item is created.

Entry:

>4F-U*F/SIDAGR

001 ANYWHERE - ANYWHERE A/L-NW DIR-B

TVL-000 RTG-0000 BKG-Y TKT DSG-UNASSIGNED

CUR-USD TKT FBC-TEST PUBL FBC-N/A COMB-Y

NET- 50.00 SELL-N/A PLUS UP-N/A AMT-N/A

BAGGAGE-N/A COMM-N/A

DESC-0005 RULES-Z05C

C.A.R-N/A VALUE CODE-N/A

**END**

>

If any of the mandatory fields have not been added in the creation entry SecuRate AIR will return

an error message identifying the field that must be added


Designates this as a Net/Net Fare INVALID FARE TYPE


Invalid or missing Direction of Travel INVALID DIRECTION-MUST BE O D B

Missing Ticketing Fare Basis Code INVALID TICKETED FARE BASIS

Missing Net Amount of Fare NET FARE RQRD

Invalid or missing currency INVALID CURRENCY CODE

Decimal placement of amount does

not match currency

INVALID NET FARE / CURRENCY

Invalid or missing booking class INVALID BOOKING CODE

Missing Rule Descriptor INVALID DESCRIPTOR NUMBER


17/45


Technical Guide

10/11/2001


Change Entry for

Single Fare Item -

Layout

4F-F/C/AAAA/BBB-


4F-F

/

C

/

AAAA

/

BBB-

Description


Indicates Change EntryField Separator

Fare Item NumberField Separator

Field Identifier of field(s)to be changed

Please Note: For a comprehensive list of allfields and their description please see the

Field Identifier Chart in Section Two.

Max

41

11

41

4

Change Entry for

a Range of Fare

Items - Layout

4F-F/C/AAAA-BBBB/CCC-


4F-F

/C

/

AAAA

-

BBBB

/

CCC-

Description

Function Identifier

Field SeparatorIndicates Change EntryField Separator

Beginning Fare Item NumberField Separator

Ending Fare Item NumberField Separator

Field Identifier(s) to be Changed


Field Identifier Chart in Section Two.

Max

4

111

41

41

4


18/45


Technical Guide

10/11/2001


Change Entry for

a Multiple Fare

Items - Layout

4F-F/C/AAAA/AAAA/AAAA/AAAA/AAAA/AAAA/BBB-


4F-F

/C

/AAAA

/BBB-

Description

Function Identifier

Field SeparatorIndicates Change

Field SeparatorFare Item Number (Maximum of 6)

Field SeparatorField Identifier(s) to be Changed

Please Note: For a comprehensive list of allfields and their description please see theField Identifier Chart in Section Two.

Max

4

11

14

14

Example of Linear Entry using the mandatory fields to change a fare:

Entry:

4F-F/C/0005/ORG-MCI*C/DST-ATL*C

Response:

>4F-F/C/0005/ORG-MCI*C/DST-ATL*C(

OK FARE ITEM CHANGED


19/45


Technical Guide

10/11/2001


Delete Entry for a

Single Fare Item

Layout

4F-F/D/AAAA


4F-F

/

D

/

AAAA

Description

Function Identifier

Field SeparatorIndicates Delete

Field SeparatorFare Item Number

Max

4

11

14

Delete Entry for a

Range of FareItems Layout

4F-F/D/AAAA-BBBB


4F-F

/

D

/

AAAA

-

BBBB

Description


Indicates DeleteField Separator

Beginning Fare Item NumberField Separator

Ending Fare Item Number

Max

41

14

14

4

Delete Entry for

Multiple Fare

Items Layout

4F-F/D/AAAA/AAAA/AAAA/AAAA


4F-F

/

D

/

AAAA

Description



Fare Item Number (Maximum of 6)

Max

41

11

4


20/45


Technical Guide

10/11/2001


Delete Entry for

All Fare Items

Layout

4F-F/D/ALL

Field Description Field

4F-F

/

D

/

ALL

Description



Indicates All

Max

41

11

4

Example:

Entry to delete a single Fare Item:

4F-F/D/0001

Response:

>4F-F/D/0001 (

OK AGREEMENT UPDATED


21/45


Technical Guide

10/11/2001


Delete Entry for

Field(s) within a

Single Fare Item Layout

4F-F/D/AAAA/BBB-


4F-F

/

D

/

AAAA

/

BBB-

Description

Function Identifier


Field SeparatorFare Item Number

Field Separator

Field Identifier to be Deleted

Please Note: For a comprehensive list of all

fields and their description please see theField Identifier Chart in Section Two

Max

4

11

14

1

4

Delete Entry for

field(s) within a

Range of Fare

Items Layout

4F-F/D/AAAA-BBBB/CCC-


4F-F

/

D

/

AAAA

-

BBBB

/

CCC-

Description

Function IdentifierField SeparatorIndicates Delete

Field SeparatorBeginning Fare Item Number

Field SeparatorEnding Fare Item Number

Field SeparatorField Identifier(s) to be Deleted

Please Note: For a comprehensive list of allfields and their description please see theField Identifier Chart in Section Two

Max

411

41

44

14


22/45


Technical Guide

10/11/2001


Delete Entry for

field(s) within

Multiple Fare

Items Layout

4F-F/D/AAAA/AAAA/AAAA/AAAA/BBB-


4F-F

/

D

/

AAAA

/

BBB-

Description



Fare Item Number (Maximum of 6)Field Separator

Field Identifier(s) to be Deleted


Field Identifier Chart in Section Two

Max

41

11

41

4

Delete Entry for

Field(s) within

Multiple Fare

Items Layout

4F-F/D/ALL/AAA


4F-F

/D/

ALL/

AAA

Description

Function Identifier

Field SeparatorIndicates DeleteField Separator

Indicates AllField Separator

Field Identifier(s) to be deleted

Please Note: For a comprehensive list of all

fields and their description please see theField Identifier Chart in Section Two

Max

4

111

31

3


23/45


Technical Guide

10/11/2001


Example of a delete entry used to delete a field:

Entry:

4F-F/D/0001/XXX

Response:

>4F-F/D/0001/XXX (

OK - FIELDS DELETED

The following fields may be deleted in any combination or order:

Field Field Identifier

Origin and Origin type ORG

Destination and Destination type DST

Travel/Ticket Item Number TVL

Routing RTG

Ticket Designator TDC

Baggage BAG

Car Code CAR

Value Code VAL

Descriptor Code (Discounted Published FareOnly)

DESC

** Please Note: Any field not listed above is not eligible for the delete entry, a change

entry is required.


24/45

Section Two: Field Identifiers

SecuRate Air Linear Entries

Technical Guide

10/11/2001


2 Section Two: Field Identifiers

Following is a list consisting of all field identifiers for use in Discounted Published, Flat Rate, and Net/Net fares, and their definitions.

Example: Flat Rate DiscountedPublished

Net/NetFieldIdentifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

CXR /CXR-DL/ Airline Carrier Code If used, this field must consist of 2 characters

Applicable to Discounted Published, Flat

Rate and Net/Net Fares

M O N/A M O N/A M O N/A

AMT /AMT-247.50/

Amount

Use this field in a Flat Rate fare to indicate a

one way base fare.

Use this field in a Discounted Published entry

to replace the published base fare.

Use this field in a Net/Net fare to designate

the plus up amount.

Maximum of 8 characters including the

decimal point (depending on the currencyused).



M O N/A O O1 N/A2 O O O

1 The Discounted Published Fare Item may only have an amount or discount percent. If the fare item has a discount percent and a change entry is made to add anamount, the amount is added and the percent field is automatically deleted by the system.2 The Discounted Published rule must have either an amount or a discount percent. The amount field is automatically deleted when a discount percent is added.


25/45



Technical Guide

10/11/2001


Example: Flat Rate Discounted

Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

BAG /BAG-1PC/ BaggageExample:40K (40 Kilos)1PC (1 piece)

NO (No baggage allowed)

20L (20 Pounds)

Maximum of 3 characters

Applicable to Net/Net, Flat Rate and

Discount Published Fares

O

3

O O O

3

O O O O O

BKG /BKG-Y*YN/ Booking Class A maximum of 10 classes of service may be

entered (Maximum of 2 will display in faredisplay and all will display in 4F.R entry).

Each class of service entered has a maximum

of 2 characters, if 2 classes of service are

added they are separated by a asterisk (*)




3 The baggage field is applicable to Flat Rate And Discounted Published Fare Items using linear entries only. Once a baggage field is applied to a Flat Rate orDiscounted Published fare that Fare Item is no longer compatible with the template product, and can only be changed or deleted using linear entries. If the userattempts to use the template product to change or delete the Fare Item, he will receive an error response.


26/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

CAR /CAR-DISCOUNT/ C.A.R Code Commercial Agreement Reference Maximum of 15 alphanumeric characters

Applicable to the Net/Net Fare

N/A N/A N/A N/A N/A N/A O O O

CMP /CMP-Y Combine Published Use this field to designate whether the fare

item is combinable with published fares.

If this field is not entered in the creation

entry, SecuRate AIR will default to yes

(/CMP-Y/).

Enter /CMP-N/ to designate that the fare is

not combinable with other published fares.

Applicable to Discounted Published and Flat

Rate Fares

O O CH O O CH N/A N/A N/A


27/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

CMU /CMU-Y/ Combine Unpublished Use this field to designate whether the fare

item is combinable with other unpublished

fares.


entry, SecuRate AIR will default to yes

(/CMU-Y).

Enter /CMU-N/ to designate that the fare is

not combinable with other unpublished fares.

Applicable to Flat Rate Fares

O O CH N/A N/A N/A N/A N/A N/A

COM /COM-10/ Commission Enter the commission percent.

Applicable to Net/Net

N/A N/A N/A N/A N/A N/A O O O4

CON /CON-Y/ Connection - Y or N Use this field to designate whether the

negotiated fare requires a connecting flight. If this field is not entered during creation,

SecuRate AIR will default to no (/CON-N/).

Enter /CON-Y/ to designate that the fare does

require a connection to qualify.

Applicable to Discounted Published Fares

(Net/Net and Flat Rate will be address in afuture product for the general rule)


4 Currently This Field is deleted by using the existing expert entry to change the commission amount to 0%. The current entry is: 4F-F/C/xxxx/CCOM-yy.yy


28/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

CUR /CUR-USD/ Currency The currency will default to USD if no

Currency code is entered in the creation entry

on Flat Rate or Discounted Published fares

This is a mandatory field in the creation of a

Net/Net fare.

Currency is only a valid field on a

Discounted Published fare when a flat

amount has been entered. The currency codeof the published fare is used when a

percentage discount is taken.

If used, this field must contain 3 characters.


Rate, and Net/Net Fares.

O O O O O O M O N/A

DIR /DIR-B/ Direction of TravelFor travel valid from Enter

point of origin only O

destination only D

both origin and destination B


Rate, and Net/Net Fares.



29/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

DST /DST-MCI*C/ Destination The City, Airport, or Zone Code for the

destination of the fare item.

If this field is not entered when creating a

fare SecuRate AIR assumes that the fare isvalid to any destination.

If used, this field may consist of 2 or 3

characters


Rate and Net/Net FaresFollow by - Location Code of Destination

If a Destination is entered, the Location Code

of the Destination is mandatory.

If this field is not entered, along with the

destination code, when creating a fare

SecuRate AIR assumes that the fare item isvalid to any destination.

Any one of the following location codes may

be used:

A - AirportC - City

U - Country

S - StateB - Subcontinent

K - Continent

T - region

Z - Zone

If used, this field must consist of one

character.

O O O O O O O O O


30/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

PCT /PCT-50/ Percent Percentage to be subtracted from the

published amount on a Discounted Published

Fare.

Either discount percent or amount is required

for all Discounted Published Fares, but both

may not be entered in the same fare item.

When used with a Net/Net Fare, SecuRate

AIR will add this amount to the net fare toobtain the sell fare.

Decimal points apply consistent with the

currency code of the fare item.

If both a plus up percent and amount are

entered on a Net/Net fare, SecuRate AIR will

add the plus up percent first then the plusamount to obtain the sell fare.

Applicable to Discounted Published and

Net/Net Fares

N/A N/A N/A O

5

O O

5

O O O

6

5 The Discounted Published Fare Item may only have an amount or discount percent. If the fare item has an amount and a change entry is made to add a discountpercent, the percent is added and the amount field is automatically deleted by the system.

6 Currently this Field is deleted by using the existing expert entry to change the amount to 0. The entry is: 4F-F/C/xxxx/CAMT-yyy.yy


31/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

MST /MST-Y/ Must Stop This field designates whether flights must

stop to qualify for the fare.

If this field is not entered on a creation entry,

SecuRate AIR will default to no (/MST-N/).

Enter /MST-Y/ to designate that the fare does

require a stop to qualify.

Applicable to Discounted Published (Net/Net

and Flat Rate will be address in a future

product for the general rule)

N/A N/A N/A O O CH N/A N/A N/A

NET /NET-100.00/ Net Fare If used, this field contains a maximum of 9

numerics.

This is a mandatory field for the creation of

Net/Net fares

Applicable to Net/Net Fares

N/A N/A N/A N/A N/A N/A M O N/A


32/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

NON /NON-N/ Nonstop This field designates whether flights must be

nonstop to qualify for the fare.


entry, SecuRate AIR will default to no(/NON-N/).

Enter /NON-Y/ to designate that the fare does

require a nonstop to qualify.

Applicable to Discounted Published Fares

(Net/Net and Flat Rate will be address in afuture product for the general rule)

N/A N/A N/A O O CH N/A N/A N/A


33/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

ORG /ORG-ATL*C/ Origin The City, Airport, or Zone Code for theorigin of the fare item.

If this field is not entered when creating a

fare SecuRate AIR assumes that the fare isvalid to any origin.

If used, this field may consist of 2 or 3

characters


Rate and Net/Net FaresFollowed by - Origin Type

If an origin is entered, the Location Code of

the origin is mandatory.

If this field is not entered, along with the

origin code, when creating a fare SecuRate

AIR assumes that the fare item is valid to any

origin.

Any one of the following location codes may

be used:

A - AirportC - City

U - Country

S - StateB - Subcontinent

K - Continent

T - region

Z - Zone

If used, this field must consist of one

character.

O O O O O O O O O


34/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

PFB /PFB-KR21NR/ Published Fare Basis Mandatory for creation of DiscountedPublished fares.

To apply a discount to all fare basis codes

within a booking class enter a single asterisk(e.g. /PFB-*/) on a Discounted Published

Fare.

To exclude a published fare basis code from a

Discount Published Fare item, follow thatcode with *E (e.g. PFB-YUP*E).

If used, this field contains a maximum of 8

characters (excluding *E if used).

Applicable to Net/Net and Discounted

Published Fares

N/A N/A N/A M O N/A O O O


35/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

RTG /RTG-104/ Routing Number If a routing number is entered, this is the only

routing number used by the system.

SecuRate AIR defaults to any valid published

routing if this field is not entered.


numerics.



O O O O O O O O O

SCA /SCA-Y/ Scaled Amount/Mileage Add this field if this is a scaled discount.

If this field is not added, SecuRate AIR will

default to no (/SCA-N/).

Enter /SCA-Y/ to apply the scaled discount to

the fare item.

Complete the Scaled Amount template toapply to Discounted Published Fares.

Complete the Scaled Mileage template to

apply to Flat Rate Fares.

Applicable to Flat Rate And Discounted

Published Fares.

O O7

N/A O O8

ON/A N/A N/A N/A

7 Flat Rate Fare Items may not have an amount listed and a scaled amount used at the same time. If the fare item has an amount and a change entry is made toapply a scaled mileage template, the amount field is automatically deleted by the system.8 Discounted Published Fare Items may not have an amount or percent and a scaled amount used at the same time. If the Fare Item has an amount or percentused and a change entry is made to apply a scaled amount template item, the amount or percent field is automatically deleted by the system.


36/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

SEL /SEL-200.00/ Sell Fare Enter a sell amount only if no plus up percent

or amount exist. SecuRate AIR will not

accept a plus up percent/amount and a sellfare for the same fare item.

Maximum of 9 numerics.


N/A N/A N/A N/A N/A N/A O O

9

N/A

TDC /TDC-SHOW/ Ticket Designator Use this field only if the Agreement Control

template shows N specifying that the

agreement number is not the ticket

designator.


characters.



O O O O O O O O O

TFB /TFB-KDISC/ Ticketed Fare Basis Code A ticketed fare basis code is mandatory to

create a fare.

Maximum of 8 characters.



M O N/A O O N/A O O N/A

9 If the user attempts to change a SEL field when the sell fare has been calculated by adding a plus up amount and/or percent to the Net fare they will receive anerror response.


37/45



Technical Guide

10/11/2001



Published

Net/NetField

Identifier

Definition

Create

Change

Delete

Create

Change

Delete

Create

Change

Delete

TVL /TVL-002/ Travel/Ticket Item Number Enter the applicable item number from the

Travel and Ticketing Dates (4F-D) template.

Maximum of 3 numerics



O O O O O O O O O

UPG /UPG-Y/ Upgrade Enter this field if a passenger can pay to

upgrade to the next cabin.

Use the UPG field in conjunction with a

discount rule indicating the upgrade.

Applicable to Flat Rate Fares


VAL /VAL-COMPANY/

Value Code

Maximum of 15 alphanumeric characters


N/A N/A N/A N/A N/A N/A O O O

Key:M = Mandatory

O = Optional

CH = Field may not be Deleted Must be Changed

N/A = Not Applicable


38/45

Section Three: DescriptorsSecuRate Air Linear Entries

Technical Guide

10/11/2001


3 Section Three: Descriptors

Groups of SecuRate Air Fare Item level rules are defined by the system as Descriptors.

The following linear entries provide functionality to create/add/change/delete descriptors.

Once the descriptors are created they the user will be able to append the descriptor

number to the fare item being created with the SecuRate AIR linear entry.

Unlike the template product, unlimited rules may be associated to one descriptor number.


39/45


Technical Guide

10/11/2001


Descriptor Create

Entry Layout

4F-R/CREATE/DESC/AAAA/AAAA/AAAA


4F-R/

CREATE/

DESC/

AAAA

Description


Indicates CreateField Separator

Indicates DescriptorField Separator

Rule Number

Max

41

61

41

4

Descriptor Delete

Entry Layout

4F-R/DELETE/DESC/0001


4F-R

/DELETE

/DESC

/AAAA

Description

Function Identifier


Field SeparatorIndicates Descriptor

Field SeparatorRule Number

Max

4

16

14

14

Descriptor Rule

Modification

Entry Layout

4F-R/DESC/AAAA/B-CCCC/B-CCCC/B-CCCC


4F-R

/DESC

/

AAAA/B

-CCCC

Description

Function Identifier

Field SeparatorIndicates Descriptor Entry

Field Separator

Descriptor NumberField SeparatorA Indicates Add / D Indicates Delete

10

Field SeparatorRule Number

Max

4

14

1

411

14

10SecuRate Air will accept multiple adds and deletes in the same entry.


40/45


Technical Guide

10/11/2001


Descriptor

Display Entry

Layout

4F-G*D


4F-G

*

D

Description


Indicates Descriptor

Max

41

1

Applying a Descriptor

The descriptor is then associated to a fare item using the field identifier DESC- and the

number of the desired descriptor in any of the create entries described in section one.

Following is an example of a Discounted Published fare item create entry with a

descriptor attached.

Entry:

>4F-F/DP/CXR-XX/DIR-B/TFB-TEST/PFB-YPUB/PCT-40/BKG-Y/DESC-

0005

Response:

>4F-F/DP/CXR-XX/DIR-B/TFB-TEST/PFB-YPUB/PCT-40/BKG-Y/ DESC-0005

OK FARE ITEM CREATED

The DESC- field identifier is also valid in the change entry as in the following example:

Entry:

4F-F/C/0003/DESC-0008

Response:

>4F-F/C/0003/DESC-0008(

OK FARE ITEM CHANGED


41/45

Section Four: Agreement Level RulesSecuRate Air Linear Entries

Technical Guide

10/11/2001


4 Section Four: Agreement Level Rules (Under Development)

Linear Entries for Agreement Level Rules are currently in development and will be

documented here as they are released on line.


42/45

Section Five: Fare Item Level RulesSecuRate Air Linear Entries

Technical Guide

10/11/2001


5 Section Five: Fare Item Level Rules (Under Development)

Linear Entries for Fare Item Level Rules are currently in development and will be

documented here as they are released on line.


43/45

Section Six: Error Conditions Specific to Linear EntriesSecuRate Air Linear Entries

Technical Guide

10/11/2001


6 Section Six: Error Conditions Specific to LinearEntries

CONDITION ERROR RESPONSEIf the user tries to delete a field that is

not eligible for deletion.XXX = field identifier

CAN NOT DELETE XXX

The user requested a descriptor that

hasn't been built yet.

DESCRIPTOR DOES NOT EXIST

The user tries to attach a descriptor to a

fare and the descriptor has already beendeleted.

DESCRIPTOR HAS BEEN DELETED

User attempted to change SCA field toN. Enter an amount in the AMT field

for a Flat Rate Fare or the AMT or PctField for a Discounted Published Field

INVALID AMOUNT / CURRENCY

Displayed if the user doesn't enter valid

numeric data in the create entry afterDESC-, or the user enters zero.

INVALID DESCRIPTOR NUMBER

Linear entry begins with 4F-F/ and onecharacter other than C or D

INVALID OPTION

Linear entry begins with 4F-F/ and twoor more characters other than DP, FR or

NN

INVALID FARE TYPE SELECTED

An entry is made and the user is not in

update mode

NO AGREEMENT IN FOREGROUND

User attempted to include SEL Field

with Plus Up AMT or PCT field on aNet/Net fare, either by putting all of

them in the original entry or by trying tochange the SEL field where the sell

price was established by a Plus Upamount or percent.

PLUS UP NOT VALID WITH SELL

Anytime a create or change entry is

made using a field that is valid only

once more than once.

XXX FIELD CANNOT BE ENTERED TWICE

Any time a create, change or deleteentry is made specifying a field that is

not compatible with the fare type.XXX = field identifier

XXX FIELD INVALID WITH FARE TYPE

SELECTED

Linear entry begins with 4F-F/ and onecharacter other than C or D

INVLD TRANS - CK FORMAT


44/45

Section Seven: Input/OutputSecuRate Air Linear Entries

Technical Guide

10/11/2001


7 Section Seven: Input/Output

When a SecuRate Air Linear Entry is entered successfully, the first line of the response is

always a reiteration of the entry preceded by a start of message indicator (e.g. > ) andfollowed by a tab (e.g. ( ). This allows the manual user to reuse the original entry to

make an additional, similar entry. The line after the redisplay of the input is blank andthe following line of the response to a successful entry begins with OK and is

followed by a descriptive statement defining the action taken by the system.

Example Input:

1234567890123456789012345678901234567890123456789012345678901234

1

2

3

45

6

7

8

9

10

11

12

13

4F-F/DP/CXR-DL/DIR-B/TFB-TEST/PFB-BPUB/PCT-40/BKG-Y

Example Output:

1234567890123456789012345678901234567890123456789012345678901234

1

2

3

4

5

6

7

8

9

1011

12

13

>4F-F/DP/CXR-DL/DIR-B/TFB-TEST/PFB-BPUB/PCT-40/BKG-Y(

OK FARE ITEM CREATED

Original InputBlank Line

OK Descriptive Message


45/45

Section Seven: Input/OutputSecuRate Air Linear Entries

Technical Guide

10/11/2001

The descriptive message will vary depending on the task the system has completed.

Below is a list of messages and the circumstances under which the system will displaythem.

Descriptive Message Displayed When:FARE ITEM CREATED Used when a Flat Rate, Discounted

Published, or Net/Net Fare Item is created

using a linear entry.

FARE ITEM(s) DELETED Used when a Flat Rate, Discounted

Published or Net/Net Fare Item is deletedusing a linear entry

FIELD(S) DELETED Used when field(s) have been deleted froma Fare Item(s).

FARE ITEM(S) CHANGED Used when field(s) have been changed

within a Fare Item(s)

WorldSpan - 9I05 SecuRate Air Linear Entries Technical Guide

Documents

Transcript of WorldSpan - 9I05 SecuRate Air Linear Entries Technical Guide