Cruise Management Setup Guide

This guide covers setting up the dimension data required for cruise management. Complete these steps before creating itineraries and cruises.

Prerequisites

• Administrator role access
• Access to the Cruise Management module

Setup Sequence

Set up dimension data in this order to ensure dependencies are met:

1. Cruise Companies
2. Cruise Areas
3. Cabin Types
4. Charge Types
5. Cruise Ports
6. Ships (requires Company)
7. Ship Cabins (requires Ship and Cabin Type)

Managing Cruise Companies

Cruise companies are the cruise line operators (e.g., Royal Caribbean, Carnival, MSC).

Viewing Companies

1. Navigate to Cruise Management
2. Select the Companies tab
3. The list displays all configured cruise companies

Creating a Company

1. Click Add New in the Companies section
2. Fill in the required fields:

Field	Description	Required
Company Code	Unique identifier (e.g., RCL, CCL)	Yes
Company Name	Full company name	Yes

1. Click Save

Editing a Company

1. Click on a company row to select it
2. Modify the fields as needed
3. Click Save

Deleting a Company

1. Select the company to delete
2. Click Delete
3. Confirm the deletion

Note: You cannot delete a company that has ships assigned to it. Remove or reassign ships first.

Managing Cruise Areas

Cruise areas define geographic regions (e.g., Caribbean, Mediterranean, Alaska).

Creating an Area

1. Navigate to the Areas tab
2. Click Add New
3. Fill in the fields:

Field	Description	Required
Area Code	Unique identifier (e.g., CARIB, MED)	Yes
Area Name	Full area name (e.g., Caribbean)	Yes

1. Click Save

Editing an Area

1. Select the area from the list
2. Update the fields
3. Click Save

Deleting an Area

Note: Cannot delete areas with associated itineraries.

Managing Cabin Types

Cabin types define the categories of accommodations available (e.g., Interior, Ocean View, Balcony, Suite).

Creating a Cabin Type

1. Navigate to the Cabin Types tab
2. Click Add New
3. Enter the details:

Field	Description	Required
Type Code	Unique code (e.g., INT, OV, BAL, STE)	Yes
Type Name	Display name (e.g., Interior Cabin)	Yes

1. Click Save

Standard Cabin Types

Consider creating these common cabin types:

Code	Name	Description
INT	Interior	No window
OV	Ocean View	Window with ocean view
BAL	Balcony	Private balcony
STE	Suite	Larger cabin with amenities
MST	Mini Suite	Smaller suite option

Managing Charge Types

Charge types define additional fees that can be applied to cruises (port fees, gratuities, taxes).

Creating a Charge Type

1. Navigate to the Charge Types tab
2. Click Add New
3. Enter the details:

Field	Description	Required
Charge Type Code	Unique code (e.g., PORT, GRAT, TAX)	Yes
Charge Type Name	Display name (e.g., Port Fees)	Yes

1. Click Save

Common Charge Types

Code	Name	Typical Use
PORT	Port Fees	Per-port charges
GRAT	Gratuities	Service charges
TAX	Taxes	Government taxes
FUEL	Fuel Surcharge	Fuel cost adjustment
INS	Insurance	Travel insurance

Managing Cruise Ports

Ports are embarkation, disembarkation, and call locations.

Creating a Port

1. Navigate to the Ports tab
2. Click Add New
3. Enter the details:

Field	Description	Required
Port Code	Unique code (e.g., MIA, NAS, CZM)	Yes
Port Name	Full name (e.g., Miami, Florida)	Yes
Country	Country name	No
Image URL	Port image for display	No

1. Click Save

Port Code Conventions

Use standard port codes when possible: - MIA - Miami - FLL - Fort Lauderdale - NAS - Nassau - CZM - Cozumel - SJU - San Juan - BCN - Barcelona - CIV - Civitavecchia (Rome)

Managing Ships

Ships belong to cruise companies and contain cabin assignments.

Creating a Ship

1. Navigate to the Ships tab
2. Click Add New
3. Enter the details:

Field	Description	Required
Company	Select the parent company	Yes
Ship Code	Unique code (e.g., OASIS)	Yes
Ship Name	Full name (e.g., Oasis of the Seas)	Yes
Description	Ship details	No
Document URL	Image or specification link	No

1. Click Save

Editing a Ship

1. Select the ship from the list
2. Modify fields as needed
3. Click Save

Assigning Cabin Types to Ships

After creating a ship, assign the available cabin types.

Adding Ship Cabins

1. Select a ship from the Ships list
2. Navigate to the Ship Cabins section
3. Click Add Cabin Type
4. Enter the details:

Field	Description	Required
Cabin Type	Select from defined cabin types	Yes
Cabin Code	Unique code for this ship (e.g., INT-01)	Yes
Cabin Name	Display name	Yes
Capacity	Number of passengers	No
Description	Cabin details	No

1. Click Save

Typical Ship Cabin Setup

For a standard ship, add cabin entries like:

Cabin Type	Code	Name	Capacity
Interior	INT-A	Interior Cabin Category A	2
Interior	INT-B	Interior Cabin Category B	4
Ocean View	OV-A	Ocean View Category A	2
Balcony	BAL-A	Balcony Cabin Category A	2
Suite	STE-A	Junior Suite	2
Suite	STE-B	Owner's Suite	4

Verification Checklist

Before proceeding to create itineraries, verify:

• [ ] At least one cruise company exists
• [ ] At least one cruise area exists
• [ ] Required cabin types are defined
• [ ] Charge types for fees and taxes exist
• [ ] All ports for planned itineraries exist
• [ ] Ships are created and assigned to companies
• [ ] Cabin types are assigned to ships

Next Steps

Once dimension data is configured: 1. Create Itineraries - Define cruise routes 2. Create Cruises - Create sailing instances 3. Configure Pricing - Set up cabin prices and charges

Troubleshooting

Issue	Solution
Cannot save company	Check that company code is unique
Cannot assign cabin to ship	Verify cabin type exists
Port code conflict	Use a different unique code
Ship not appearing	Refresh the ships list