💰 Staff

My Commissions

My Commissions is a personal, self-service view where any staff member with a commission rule can see exactly what they have earned from their own sales — per-sale amounts, running totals, and payment status.

📍 Menu path: Staff → My Commissions

👤 Who uses it: All staff with a commission rule assigned

🏷️ Plan tier: advanced+

Overview

Every commission line ties back to a specific sale, showing the sale amount alongside the commission calculated from it, so you can verify the commission matches your agreed rule.

Commissions move through a lifecycle of statuses: Pending (calculated but not yet approved), Approved (confirmed, awaiting payout), Paid (settled), or Cancelled.

This page only shows the logged-in user's own commissions — the equivalent page for viewing every staff member's commissions at once is Commission Report, restricted to managers.

Before You Start

Requires the Commissions feature on the Advanced plan tier or above.
A Commission Rule must already be configured for you (by a manager, on Commission Rules) — with no matching rule, no commissions will ever be calculated on your sales.

Step-by-Step Guide

1 Check your commission summary

Open My Commissions from the Staff section of the sidebar.
Read the four summary cards at the top: Total Commission (with transaction count), Paid, Pending, and Average (per transaction) for the selected date range.
By default the date range is the 1st of the current month through today — change it in the filters if you want to review a different period.

2 Filter and search your commission list

Use the Status dropdown to narrow the list to Pending, Approved, Paid, or Cancelled commissions.
Adjust the From and To date fields to change the reporting period.
Click the refresh icon to re-pull the list and summary with the current filters.
Use the search box in the data grid toolbar to find a specific invoice or sale number.
Switch between table and card view, sort any column (Date, Invoice, Sale Amount, Commission, Type, Status, Paid Date), and change the page size (20/50/100 rows) using the data grid controls.

3 Export your commission history

With your desired filters applied, use the export control in the data grid toolbar.
The exported file is named using your selected date range, e.g. commission-tracking-2026-07-01-2026-07-06.

Every Field & Button, Explained

Field / Button	What it does
`Total Commission (summary card)`	Sum of all commission amounts in the selected period, with the count of transactions underneath.
`Paid (summary card)`	Sum of commissions that have reached Paid status in the period.
`Pending (summary card)`	Sum of commissions still awaiting approval/payout in the period.
`Average (summary card)`	Total commission divided by transaction count — average earned per sale.
`Status filter`	Pending, Approved, Paid, or Cancelled — filters the list and summary together.
`From / To`	Date range applied to both the commission list and the summary cards; defaults to month-to-date.
`Date (column)`	The sale date the commission is based on (falls back to the record's created date).
`Invoice (column)`	Invoice number and sale number for the underlying sale.
`Sale Amount (column)`	The total value of the sale that generated this commission.
`Commission (column)`	The commission amount earned from that sale, shown in green.
`Type (column)`	Shows the percentage rate for percentage-based rules, or the commission type label (e.g. "FIXED PER SALE") for flat-amount rules.
`Status (column)`	Pending (amber), Approved (blue), Paid (green), or Cancelled (red) badge.
`Paid Date (column)`	The date the commission was actually paid out, or "—" if unpaid.

Tips & Best Practices

Set the date range to a full pay period (e.g. the 1st to the last day of the month) before checking your totals, since the default only goes up to today.
If a commission looks wrong, check the Type column first — percentage-based commissions scale with sale amount, while fixed commissions do not, and mixing them up is the most common source of confusion.
Export your commission history at the end of each pay period so you have your own record independent of what payroll later confirms.

Troubleshooting & FAQ

The page is empty / "No commissions found".

This means no commission rule is currently assigned to you, or you have no qualifying sales in the selected date range. Ask a manager to check Commission Rules for a rule tied to your account.

My commission amount does not match what I expected.

Check the Type column for the exact rule applied (percentage of Total/Subtotal/Margin, or a fixed amount per sale/item) — commission rules can apply to different bases, which changes the result even at the "same" rate.

A commission is stuck on Pending for a long time.

Pending commissions require manager approval before moving to Approved and eventually Paid. Follow up with your manager if a Pending item has been sitting for longer than your usual pay cycle.

I do not see this page in my sidebar at all.

My Commissions requires the Commissions feature at the Advanced plan tier — ask your Admin to confirm the plan tier if you believe you should have access.

🧑‍💻 Developer Notes

Source component(s):

frontend-app/packages/pos-react-lib/src/pages/CommissionTrackingPage.jsx

Backend endpoints used:

GET /staff-commissions
GET /staff-commissions/summary

Related tables (db-core repositories):

StaffCommission

Redux slices:

scope (selectCurrentScope / getScopeQueryParams)

Feature flag key: commissions (requires advanced plan tier or above)

Route is mounted at /my-commissions in frontend-app/pos-app/src/App.js pointing at CommissionTrackingPage — confirmed directly from the route table (navKey="my-commissions"), so no correction was needed versus the page named in the task. List uses a shared DataGrid component (search, sort, pagination, card/table toggle, CSV export) rather than a bespoke table. The backend implicitly scopes results to the logged-in user — the frontend does not pass a userId filter itself, unlike Commission Report which lets a manager pick any staff member.