Cruise Pricing Configuration Guide¶
This guide covers configuring pricing for cruise products, including cabin charges, other fees, and pricing templates.
Prerequisites¶
Before configuring pricing: - Cruise instance is created (see Cruise Management Guide) - Cabin types are assigned to the ship - Charge types are defined (port fees, taxes, etc.)
Pricing Structure Overview¶
Cruise pricing consists of two components:
Cabin Charges¶
Base prices for each cabin type: - Price per cabin (not per person) - Currency and exchange rate - Availability toggle
Other Charges¶
Additional fees and taxes: - Port fees - Gratuities - Taxes - Insurance - Other mandatory or optional fees
Template-Based Pricing¶
TQPro uses a template system for efficient pricing management:
Itinerary Level (Templates) → Cruise Level (Instances)
────────────────────────────── ──────────────────────────
Cabin Price Templates Cabin Charges
(default prices) (editable per sailing)
Other Charge Templates Other Charges
(default fees) (editable per sailing)
When you create a cruise from an itinerary, prices are automatically copied from the templates. You can then adjust individual cruise pricing as needed.
Configuring Pricing Templates (Itinerary Level)¶
Accessing Pricing Templates¶
- Navigate to Cruise Management
- Select the Itineraries tab
- Click on an itinerary
- Scroll to the Pricing Template section
Initializing Cabin Price Templates¶
When first setting up an itinerary:
- Ensure the ship is selected for the itinerary
- Click Initialize Cabins
- System creates a price template for each cabin type on the ship
- All prices start at zero
Setting Default Cabin Prices¶
- In the Cabin Prices (Defaults) section, you'll see a row for each ship cabin
- Click on a cabin row to edit
- Enter the default pricing:
| Field | Description | Required |
|---|---|---|
| Amount | Base cabin price | Yes |
| Currency | Currency code (USD, EUR, etc.) | Yes |
| Exchange Rate | Rate to base currency | No |
- Click Save
- Repeat for all cabin types
Example Cabin Prices:
| Cabin Type | Amount | Currency |
|---|---|---|
| Interior Category A | 899.00 | USD |
| Interior Category B | 799.00 | USD |
| Ocean View Category A | 1099.00 | USD |
| Balcony Category A | 1499.00 | USD |
| Junior Suite | 2199.00 | USD |
Adding Other Charge Templates¶
- In the Other Charges (Defaults) section, click Add
- Enter the charge details:
| Field | Description | Required |
|---|---|---|
| Charge Type | Select from defined charge types | Yes |
| Amount | Default charge amount | Yes |
| Currency | Currency code | Yes |
| Mandatory | Whether charge is required | Yes |
| Passenger Type | all, adult, child, infant | Yes |
- Click Save
- Repeat for all standard charges
Example Other Charges:
| Charge Type | Amount | Mandatory | Per |
|---|---|---|---|
| Port Fees | 150.00 | Yes | all |
| Gratuities | 98.00 | Yes | adult |
| Government Taxes | 35.00 | Yes | all |
| Travel Insurance | 75.00 | No | all |
Editing Other Charge Templates¶
- Click on the charge row
- Modify the fields
- Click Save
Deleting Other Charge Templates¶
- Click the Delete button on the charge row
- Confirm the deletion
Configuring Cruise Pricing (Cruise Level)¶
Accessing Cruise Pricing¶
- Navigate to Cruise Management
- Select the Cruises tab
- Click on a cruise
- Navigate to the Cruise Pricing section
How Prices Are Initialized¶
When a cruise is created from an itinerary: - Cabin charges are copied from cabin price templates - Other charges are copied from other charge templates - All values are editable for the specific sailing
Editing Cabin Charges¶
- In the Cabin Prices section, click on a cabin row
- Modify the pricing:
| Field | Description |
|---|---|
| Amount | Price for this specific sailing |
| Currency | Currency code |
| Exchange Rate | Rate to base currency |
| Available | Whether this cabin is bookable |
- Click Save
Adjusting Prices for Specific Sailings¶
Common scenarios for price adjustments:
| Scenario | Action |
|---|---|
| Peak season sailing | Increase cabin prices |
| Last-minute sale | Reduce prices |
| Sold-out cabin type | Toggle availability off |
| Special promotion | Apply promotional pricing |
Managing Cabin Availability¶
To toggle cabin availability:
- Find the cabin in the Cabin Prices section
- Click the Available toggle or checkbox
- Unavailable cabins will not appear in search results
Use this for: - Sold-out cabin categories - Maintenance blocks - Reserved inventory
Adding Extra Charges¶
To add a charge not in the template:
- Click Add in the Other Charges section
- Select the charge type
- Enter the amount and currency
- Set mandatory flag
- Click Save
Editing Other Charges¶
- Click on the charge row
- Modify the amount or settings
- Click Save
Removing Other Charges¶
- Click Delete on the charge row
- Confirm the deletion
Note: Removing a mandatory charge may affect booking requirements.
Pricing Calculations¶
Cruise Total Price¶
The total cruise price for a cabin is calculated as:
Cabin Price
+ Port Fees (per person)
+ Taxes (per person)
+ Gratuities (per adult)
+ Other Mandatory Charges
─────────────────────────
= Total Cruise Fare
+ Optional Charges (if selected)
─────────────────────────
= Grand Total
Per-Person vs Per-Cabin¶
| Charge Type | Calculation |
|---|---|
| Cabin Price | Per cabin (total for all occupants) |
| Port Fees | Typically per person |
| Taxes | Typically per person |
| Gratuities | Often per person, per day |
| Insurance | Per person |
Currency Handling¶
When multiple currencies are involved: 1. Each charge has its own currency 2. Exchange rate converts to base currency 3. Totals are displayed in booking currency
Pricing Workflows¶
Setting Up a New Itinerary¶
- Create the itinerary with ship assignment
- Click Initialize Cabins to create price templates
- Set default cabin prices for each type
- Add standard other charge templates
- Save all templates
Creating Sailings with Pricing¶
- Create cruise from itinerary
- Prices are automatically populated from templates
- Review and adjust if needed:
- Increase for peak dates
- Decrease for slow periods
- Toggle availability as needed
Promotional Pricing¶
For a special promotion:
- Open the specific cruise
- Reduce cabin prices as required
- Note: Template prices are unchanged
- Future cruises still use template prices
Seasonal Adjustments¶
For ongoing seasonal pricing:
- Update the itinerary templates with new prices
- Create new cruises (they'll use updated templates)
- Existing cruises keep their current prices
Best Practices¶
Template Management¶
- Keep templates updated with current base pricing
- Review and update seasonally
- Use realistic "average" prices as templates
Per-Cruise Adjustments¶
- Document reasons for price changes
- Keep promotional periods limited
- Monitor availability across cabin types
Currency Consistency¶
- Use one base currency where possible
- Update exchange rates regularly
- Document currency policies
Audit Trail¶
- Note why prices were changed
- Track promotional periods
- Review pricing before activation
Verification Checklist¶
Before activating a cruise:
- [ ] All cabin types have prices set
- [ ] Prices are in correct currency
- [ ] Exchange rates are current
- [ ] Mandatory charges are configured
- [ ] Optional charges are set correctly
- [ ] Availability is correctly set for each cabin
Troubleshooting¶
| Issue | Solution |
|---|---|
| Cabin prices are zero | Initialize templates or check template values |
| Currency mismatch | Verify currency on each charge |
| Missing charges | Check that charge types exist in dimension data |
| Prices not copying | Verify templates are saved before creating cruise |
| Cannot edit prices | Check cruise status is DRAFT or ACTIVE |
Related Documentation¶
- Cruise API Specification - API endpoints for pricing
- Setup Guide - Charge type configuration
- Cruise Management Guide - Creating cruise instances