G&G Commission Tracker v9

Step 1 of 5

Voyage Setup

Select your vessel, configure voyage details and personnel

🚢

Select Your Vessel

Royal Caribbean International Fleet · A–Z

Vessel

📋

Voyage Details

Voyage Number

Sailing Date

End Date

👤

Personnel

Executive Housekeeper

HK Admin

Remarks

📊

Data Summary

📦 Guest Items

0

👥 Crew Members

0

📋 Deliveries Logged

0

📑 Amenities

—

🗺

Workflow Guide

1

Voyage Setup ← You are here

2

Import PCP & AS400 Item Lists

3

Import Crew Manifest

4

Log G&G Deliveries to Crew

5

Export Final Commission Report

Step 2 of 5

Total Item List

All G&G guest items — imported from PCP & AS400 reports or entered manually

Total Items

0

All types

PCP

0

Pre-Cruise

AS400

0

Pre-Cruise

Onboard

0

Manual

Total QTY

0

Units

↩ Refunded

0

Items cancelled

PCP

PCP Report

Hybris G&G Participation · Includes onboard sales & refunds

Col F Cabin Col K Item Col N QTY

📊

Drop PCP .xlsx here

or click to browse

No file imported

AS400

AS400 Report

Gift Amenities AS400 · Includes free & third-party items

Col E Cabin Col K Item Col M QTY

🗄

Drop AS400 .xlsx here

Non-G&G rows filtered automatically

No file imported

🔍

0 items

#	Type	Source	G&G Item Name	QTY	Stateroom	Status	Refund

Step 3 of 5

Crew Manifest

Import HK department crew — ID, Name and Position

Total Crew

0

In manifest

Stateroom Att.

0

SA

Bell Att.

0

Bell & Officer

Public Area

0

PAA

📥 Import Manifest

Excel: ID · Name · Position headers

👥

Drop crew .xlsx here

Headers matched by name

No file imported

ℹ Ensure headers: ID, Name, Position. Column order doesn't matter.

👤 By Position

No crew data

Crew Members

🔍

#	Crew ID	Name	Position

📋

Step 4 of 5

G&G Delivery Report

Assign delivered items to crew members — commission calculated automatically per tier

Total Entries

0

Deliveries logged

Total QTY

0

Units delivered

Valid

0

In catalogue

Invalid

0

Not in catalogue

Total Commission

$0.00

All crew combined

🚢

Active Voyage

—

✍

Log Single Delivery

Manual entry per item

1 Select Crew Member

2 Item & Details

Purchase Type

G&G Item Name *

Stateroom *

QTY

Delivery Date

💡 Tip — Bulk Assign

Use ⚡ Bulk Assign to auto-generate deliveries from your Total Item List in seconds. Assign one crew member to multiple items at once.

🔍

0 entries

#	Name	Position	Type	G&G Item	Qty	Cabin	Date	Tier	Comm.	Status

Step 5 of 5

Reports & Dashboard

Final summary — crew commissions, balance check, and export

⏳

Calculating…

Comparing item list vs delivery totals

Item List QTY

—

Delivery QTY

—

Total Items

0

Guest purchases

Deliveries

0

Assigned

Pre-Cruise

0

PCP + AS400

Onboard

0

Manual

Crew

0

In manifest

Tier 3 Deliveries

0

Room décor/pkg

↩ Refunded

0

Items · $0.00 lost

Total Commission

$0.00

All crew combined

🏆 Crew Leaderboard

Ranked by total QTY delivered

📊 By Category

Commission tier distribution

👤 By Position

Team contribution

⚡ Pre-Cruise vs Onboard

By purchase type

📋 Full Crew Commission Summary

Click any row to view full delivery details

🔍

Rank	Crew ID	Name	Position	Pre-Cruise QTY	Onboard QTY	Total QTY	Tier 1	Tier 2	Tier 3	Commission

Unassigned Items

Items in Total Item List with no matching delivery entry

Admin Only · Firebase

Amenities Catalogue

Master G&G item list with category assignments — drives all commission calculations

Admin Controls

Settings

Manage themes, administrators, and system preferences

Hyper Premium Themes

Choose your interface aesthetic — changes apply instantly for all users

Last changed: loading…

⬡ Abyssal Gold

Administrator Accounts

All users with Admin role can access this settings panel

⏳

Loading admins…

System Information

Application

G&G Tracker v9

Commission System

Backend

Firebase Firestore

Connected

Signed In As

—

Administrator

📖

Help & Reference

User Guide

Complete reference for Admins and HK Staff — workflow, features, commission tiers & FAQs

🚢

Voyage-Based

Each voyage is tracked independently — ship, dates, crew and deliveries stay scoped to that sailing.

☁️

Firebase Backed

Amenities catalogue & commission rates live in Firestore — always current for all users fleet-wide.

📊

Auto Commission

Commission is calculated automatically from the item tier — no manual math required.

◆ 5-Step Workflow

1

Voyage
Setup

2

Item
List

3

Crew
Manifest

4

Delivery
Report

5

Reports
& KPIs

💡

Browser Storage

Voyage data (items, crew, deliveries) is stored locally in your browser. Always export your report before clearing browser data or starting a new voyage.

✨

Autocomplete

Always use the G&G Item autocomplete when adding items — it assigns the tier & commission rate automatically and ensures the name matches exactly.

⚡

Bulk Assign

Use ⚡ Bulk Assign in the Delivery Report to assign multiple items to one crew member at once — essential for large ships like Oasis-class.

↩

Guest Cancellations

If a guest cancels or refunds an order during the voyage, mark it with the ↩ Refund button in the Total Item List. It is excluded from commission calculations automatically.

📊

Crew Detail Drawer

In Reports & KPIs, click any crew member row in the Full Commission Summary table to open a detailed delivery breakdown — items, cabins, tiers and commission per item.

🔄

New Voyage

Click Clear & Reset on the Voyage Setup banner to start fresh. Export your report first — this cannot be undone.

1

Voyage Setup

Configure your ship, voyage number, dates & personnel

Both Roles

Required Fields

* Select Vessel (from RCI fleet list)

◎ Voyage Number (e.g. 870)

◎ Sailing Date & End Date

◎ Executive Housekeeper Name

Key Actions

→ Click 💾 Save Voyage to store details

→ ＋ Add Ship if vessel not in list

→ Clear & Reset only after exporting the report

2

Total Item List

All G&G items for this voyage — including cancellation management

Both Roles

Import from PCP (Hybris G&G Participation report) and AS400 (Gift Amenities AS400 report) using the drop zones, or add Onboard items manually. Always use the G&G Item autocomplete — it assigns the correct commission tier automatically.

↩

Guest Cancellations / Refunds: If a guest cancels an order during the voyage, click the ↩ Refund button on that item row. The item is immediately excluded from the balance check, commission calculations, and Bulk Assign. Use the ↩ Refunded filter tab to view all cancelled items. Click ↩ Undo to reverse a refund.

⚠ Important: Only commission-eligible G&G items should appear in the item list. Do not include C&A amenities, complimentary items, or items not in the Amenities Catalogue — these will show as ⚠ Not in catalogue and will not generate commission.

3

Crew Manifest

Build your HK delivery team roster

Both Roles

Import your HK crew Excel file or add members manually. Each crew record requires a Crew ID, Name, and Position. Crew must be added here before they can receive deliveries in Step 4. The manifest supports Stateroom Attendants, Bell & Officer Attendants, and Public Area Attendants.

4

Delivery Report

Assign G&G items to crew — one by one or in bulk

Both Roles

Manual Delivery

1. Select crew member (search by name or ID)

2. Choose G&G Item from autocomplete

3. Enter QTY, Stateroom, Date

4. Click Log Delivery

⚡ Bulk Assign

1. Click ⚡ Bulk Assign button

2. Select a crew member

3. Check items from the list (already-assigned and refunded items are hidden)

4. Set delivery date → Assign

5

Reports & KPIs

Verify, review crew commissions, and export

Both Roles

Check the Balance Card at the top — green ✅ means Item List QTY matches Delivery QTY (refunded items excluded). If it shows an imbalance, use the Unassigned Items panel at the bottom to see exactly which cabins are missing a delivery.

📊 Crew Detail Drawer

Click any row in the Full Commission Summary table to slide open a detailed breakdown of every delivery, cabin, tier and commission for that crew member.

⟳ Recalc Rates

If commission rates changed after deliveries were logged, use the ⟳ Recalc Rates button to update all stored commission values to the current rates.

When ready, click ⬇ Export Excel — this generates a full 4-sheet workbook: Summary Dashboard, Crew Commission, Delivery Details, and Item List (with refunded rows clearly marked).

◆ Commission Formula

Total = (T1 qty × T1 rate) + (T2 qty × T2 rate) + (T3 qty × T3 rate)

↩ Refunded items are excluded from the formula. Only active (non-refunded) deliveries count toward commission.

◆ Tier Definitions

Tier	Category	Examples	Default Rate
Tier 1	Poncho & Towel Book	Poncho Sold on Gangway, Towel Book Sold in Cabin	$1.00 / item
Tier 2	Flowers & Merchandise	Flowers, Tote Bags, Branded Merchandise	$2.00 / item
Tier 3	Room Décor & Packages	Room Décor, Multi-item Packages, Celebration Sets	$3.00 / item

💰

Rates are set by Admin in the Amenities Catalogue → Commission Rates card. Defaults are T1=$1 / T2=$2 / T3=$3 per item. If rates are updated after deliveries are logged, use ⟳ Recalc Rates on the Reports page to apply the new values to all existing entries.

HK Staff

Standard Access

✓ View & configure Voyage Setup

✓ Import PCP & AS400 item lists

✓ Mark items as refunded / undo refund

✓ Import crew manifest & add manually

✓ Log individual deliveries

✓ Use Bulk Assign for fast entry

✓ View Reports & crew leaderboard

✓ Open crew detail drawer

✓ Export Excel commission report

✕ Cannot access Amenities Catalogue

✕ Cannot access Settings or user management

✕ Cannot change commission rates or themes

Administrator

Full Access

✓ Everything HK Staff can do

✓ Manage Amenities Catalogue (add/edit/delete items)

✓ Export Amenities Catalogue to Excel

✓ Bulk import amenities from Excel

✓ Set T1 / T2 / T3 commission rates

✓ Create & manage user accounts (Admin/Staff)

✓ Change UI themes (applies to all users)

✓ View all user accounts & roles

📑

Amenities Catalogue

The Amenities Catalogue is the master list of commission-eligible G&G items. Only items in this catalogue earn commission. Item names must exactly match the names in your PCP and AS400 reports — including capitalisation and spaces.

→

Add Item: Click ＋ Add Item → fill name, category, SKU → save to Firebase.

→

Bulk Import: Use ⬆ Bulk Import to upload an Excel file with columns: Name, Category, SKU. Existing items update automatically by name.

→

Export Catalogue: Click ⬇ Export Catalogue to download a premium Excel file with all items, tiers, rates — useful for verification and audits.

⚠ Do not add C&A amenities, free items, or package names that don't exist in AS400/PCP. These will cause commission to be paid on non-revenue items. Per the Fleet SOP, only revenue-generating items should appear here.

💰

Commission Rates

Rates are set per-tier in the Amenities Catalogue → Commission Rates card. They are stored in Firestore and apply globally to all users and ships.

→

Best practice: Set rates before the voyage begins and do not change them until the final report is exported.

→

Changed mid-voyage? Go to Reports → click ⟳ Recalc Rates to recalculate all stored commission values using the current rates. This updates every delivery entry in one step.

👤

User Management

→

Create User: Settings → ＋ Add Admin → enter Name, Email, Password (min 8 chars), Role → Save. The account is created immediately in Firebase Authentication and is ready to log in.

→

Change Role: Click the ✏ edit button on any user → change the Role dropdown → save. Takes effect on their next sign-in.

→

Remove User: Click the 🗑 button → confirms deletion of the Firestore user document. To fully block login access, also delete the account from the Firebase Console → Authentication.

🎨

Interface Themes

Settings → Hyper Premium Themes. Click any theme card to apply instantly. The selected theme is saved to Firestore and applies to all users simultaneously on their next page load.

Where is my voyage data stored?

Voyage data (items, crew, deliveries, refund flags) is stored in your browser's localStorage — local to your device and not synced to the cloud. The Amenities Catalogue and commission rates live in Firebase Firestore. Always export your Excel report before clearing browser data or starting a new voyage.

A guest cancelled their order — what do I do?

Go to the Total Item List and find the item. Click the ↩ Refund button on that row. The item is immediately excluded from commission calculations, the balance check, and Bulk Assign. It shows a strikethrough and a red ↩ Refunded badge. Use the ↩ Refunded filter tab to see all cancelled items. Click ↩ Undo to reverse it.

Reports shows an imbalance — what do I do?

The balance check compares active (non-refunded) Item List QTY against Delivery QTY. An imbalance means some items haven't been assigned to crew yet. Scroll down on the Reports page to the Unassigned Items panel — it lists every item and cabin that still needs a delivery entry. Note: refunded items do not count toward the imbalance.

The commission amount looks wrong — how do I verify?

Check: (1) the item has the correct tier in the Amenities Catalogue, (2) the item name exactly matches the catalogue (case-sensitive), (3) the QTY is correct, and (4) the current T1/T2/T3 rates in the Amenities Catalogue. If rates were changed after logging deliveries, click ⟳ Recalc Rates on the Reports page to update all commission values.

Why doesn't the G&G Item autocomplete show suggestions?

The autocomplete loads from the Firebase Amenities Catalogue on sign-in. If it's empty: the catalogue has no items yet (ask your Admin to populate it), or there was a Firestore connection issue (refresh the page and check your network connection).

How do I start a new voyage?

On the Voyage Setup page, click Clear & Reset on the active voyage banner. This permanently erases all local data — items, crew, deliveries, and refund flags. Export your Excel report first — this action cannot be undone.

[Admin] How do I create a new user account?

Go to Settings → ＋ Add Admin → enter the user's Name, Email, Password (minimum 8 characters), and Role (Admin or Staff) → click Save. The account is created immediately in Firebase Authentication — the user can log in straight away with the credentials you set.

[Admin] I updated commission rates mid-voyage — does it affect past records?

Commission values are stored on each delivery entry at the time it was logged — they are not automatically updated when rates change. To apply new rates to existing entries, go to Reports & KPIs → click ⟳ Recalc Rates. Best practice: set rates before the voyage starts and don't change them until the report is exported.

How do I view a crew member's individual delivery breakdown?

Go to Reports & KPIs → scroll to the Full Crew Commission Summary table → click any crew member's row. A drawer slides in from the right showing every delivery that crew member has, grouped by Pre-Cruise and Onboard, with item name, cabin, tier, date, and commission per entry.

What is the difference between PCP and AS400 sources?

PCP (Hybris G&G Participation report) captures pre-cruise purchases and includes the latest onboard sales and refunds — use this as your primary source. AS400 (Gift Amenities AS400 report) is a system extract that includes most free items; it is automatically filtered to show only commission-eligible G&G items. Do not add both sources for the same order — that would cause data duplication and double commission.