Task: Finalize Cabin Selection

The Finalize Cabin Selection task is a request for the names of passengers residing in the cabin, insurance/waiver choices, and past passenger numbers. The response allows for the editing of the submitted data, as well as a display of the ports of call in the cruise itinerary, available features and options for the selected cabin and package, and transportation options.

Section 1: Short Answer

Transaction Name:

CruiseVerifyAndOptions_1_0

Can any other transactions perform this same task?

No other procedure can perform this same task.

Can this task be performed in a sessionless environment?

This task can be performed in a sessionless environment.

Are the request and response identical on both the Apollo and Galileo systems?

The request and response are allowed only on Apollo.

Industry-specific knowledge required to understand this task.

Understanding of cruise-industry concepts is required. Knowledge of Galileo's LeisureShopper product is helpful.

Special limits or distinct restrictions to the input data.

The Apollo CRS permits up to five passengers to be booked to one cabin. However, some vendors have a four-passenger limit for each cabin.

Note: For Galileo Web Services client applications only, this transaction must be submitted using the SubmitCruiseTransaction method.

Section 2: Detailed Description

Request

Unless otherwise specified, use ALL CAPS in any request data.

<CruiseConfigMods> is sent with the following child elements to request the names of passengers residing in the cabin, insurance/waiver choices, and past passenger numbers:

<PNRBFPrimaryBldChgMods>. Identifies required passenger name and contact information.
Note: An actual PNR is not created until the cruise segment is sold. However, the AAA is used to store passenger data during the selection process. A PNR is not created until the cruise data is end transacted to the AAA during booking.
<PNRBFSecondaryBldChgMods>. Identifies passenger descriptions such as gender and passport information.
<VendorRegionMods>. Identifies the selected vendor and cruise.
<SailingMods>. Identifies the selected ship name, ports, and cruise detail.
<CabinCategoryHoldMods>. Identifies cabin type, rate, and number.
<PastPassengerInfo>. Identifies insurance waiver information and past passenger numbers.

Prerequisite Tasks

Cabin and package selections are finalized after the available cabin has been held using CruiseCabinHold_1_0.

Expected Response

If the Cruise Name and Cabin Selection transaction completes successfully, the following elements are returned.

<PNRBFPrimaryBldChgMods>. Returns as an empty element because a PNR has not been created.
<PNRBFSecondaryBldChgMods>. Returns as an empty element because a PNR has not been created.
<CruiseConfigMods>. Returns the following child elements that provide additional options based on the selected cabin and cruise package. Depending on the vendor, the response includes multiple features, feature upgrades, and options.

<FeaturesAndOptions>. Returns specific features, options, or upgrades available for the specified cruise.
Features are included in the price of the package. A feature can include items such as land trips, waivers, greetings, and event tickets.
Upgrades are features available for an additional cost.
Options are a choice of features available for the entire cost of the item. An option's cost can be zero. Options can include items such as Dining Codes, Medical Codes, Pre- and Post-Cruise Packages, and Gifts.

<FeatureOptionLocation>. Returns associated locations and location description for feature/option.

<FeatureOptionDetail>. Allows the user to enter additional data required to book a feature or option (e.g., arrival and departure time for an airport transfer).

<CruiseItin>. Returns lists ports of call, dates and time of travel, dates and time of boarding, and status for each segment in the cruise itinerary.

<PassengerInfoErr>. Indicates invalid passenger data was entered in the PastPassengerInfo request.

<SailingSpecificDetail>. Returns cruise options such as dining and smoking preferences.

<TransportationDetail>. Returns transportation options available for the selected package to and from the cruise start and end ports of call.

<VendorChangedData>. Returns vendor-modified responses. Some vendors modify a selection, such as a rate code or category availability, based on the user's previous selections. For example, a user may select a category that corresponds to a rate code other than the initially selected rate code. In this case, the response includes any modified data.

<TextMsg>. Returns additional text messages from the vendor.

Error and Warning Responses

If cruise name and cabin selection transaction encounters an error, <CruiseConfigMods> with an <ErrText> element is returned. The following error messages may be received:

0002 – Transaction Not Allowed

0024 – Link Not Available

0042 - Invalid Destination

0045 – Invalid Vendor Code

0048 - Invalid Currency Code

0054 – LeisureShopper Not Available

0091 - Invalid Length

0245 - Invalid Ship Name

0256 – Invalid Waiver

0358 – Feature Option Not Compatible

0390 – System Error Occurred

1050 – Air City Not Supported

1051 – Invalid Air City

1052 – Cruise Line Air Unavailable

1053 – Name Change Not Allowed

1054 – Vendor Air Required

1055 – Vendor Air Not Supported

1056 – Waiver Required

1057 – Title Required

1058 – Age Required

1059 – Gender Required

1060 – Past Passenger Number Required

1061 – Travel Agent Name Required

1062 – Dining Room Preference Required

1063 – Booking Credit Required

1064 – Smoking Preference Required

1065 – Invalid Dining Preference

1068 – Invalid Booking Credit Number

1069 – Invalid Back-to-Back Confo

1070 – Air City Not Valid for Rate Code

1071 – No Features Exist for This PKG

1072 – No Options Exist for This PKG

1073 – Change Not Allowed by Vendor

1081 – Invalid Package ID

1092 – Invalid Embarkation Port

1333 – Uniglobe Not Allowed

1334 – Invalid Category Changed Indicator

1335 – Invalid Category

1340 – Invalid Vendor Confirmation Number

1341 – Invalid Number of Passengers

1342 – Invalid Rate Code

1343 – Invalid Rate Code Change Indicator

1344 – Invalid Vendor Record ID

1345 – Invalid Disembarkation Port

1346 – Invalid Departure Date

1347 – Invalid Departure City

1348 – Invalid Departure City Changed

1349 – Invalid Air Transportation

1350 – Invalid Air Transportation Change

1351 – Invalid Age

1357 – Invalid Past Passenger Number

1358 – Invalid Lowest Rate Code Indicator

Text Not Found for MSG NBR - #### (error message number)

For a complete list of cruise errors, see Cruise Error Messages.

Follow On Requests

Section 3: Tables

Request (Input) Tags

Terminal Equivalents:

Apollo: LSOM (Options Menu); LSFM (Features Menu); LSFO* (Features / Options Menu); LSTM (Transportation Menu)

Not available on Galileo.

Ordering	NWB	Min/Max	XML Tag
	2100	1-1	<PNRBFPrimaryBldChgMods>

Terminal Equivalents:

Apollo: LSOM (Options Menu); LSFM (Features Menu); LSFO* (Features / Options Menu); LSTM (Transportation Menu)

Not available on Galileo.

Ordering	NWB	Min/Max	XML Tag
	2110	1-?	<PNRBFSecondaryBldChgMods>

<CruiseConfigMods>

Terminal Equivalents:

Apollo: LSOM (Options Menu); LSFM (Features Menu); LSFO* (Features / Options Menu); LSTM (Transportation Menu)

Not available on Galileo.

Ordering	KLR	Min/Max	XML Tag
N/A	LCA0	1-1	<VendorRegionMods>
N/A	LCA1	1-1	<SailingMods>
N/A	LCCR	1-1	<CabinCategoryHoldMods>
N/A	LCPL	1-?	<PastPassengerInfo>

Response (Output) Tags

Ordering	NWB	Min/Max	XML Tag
	2101	N - N	<PNRBFPrimaryBldChg>

Ordering	NWB	Min/Max	XML Tag
	2111	N - N	<PNRBFSecondaryBldChg>

<CabinConfiguration>

Ordering	KLR	Min/Max	XML Tag
	LCFI	N - N	<FeaturesAndOptions>
	LCFL	N - N	<FeatureOptionLocation>
	LCFO	N - N	<FeatureOptionDetail>
	LCPC	N - N	<CruiseItin>
	LCPE	N - N	<PassengerInfoErr>
	LCSX	N - N	<SailingSpecificDetail>
	LCTR	N - N	<TransportationDetail>
	LCVV	N - N	<VendorChangedData>
	TEXT	N - N	<TextMsg>
	EROR	N - N	<ErrText>

Related Samples

CruiseVerifyAndOptions_1_0_1