Agent Commission Settings
Argonautas tracks commissions earned by your reservations agents — the staff members who handle direct bookings. When a booking attributed to an agent is checked out, a commission record is automatically created based on the rates you configure here.
How Agent Commissions Work
At checkout, the system looks up the booking's Reservations Agent and Booking Source, applies the matching commission rate to the company's revenue share from that booking, and records an immutable ledger entry. The ledger is the source of truth for agent payroll calculations.
OTA bookings (Airbnb, Booking.com, VRBO) are not commissionable by default — the OTA already charges a commission, so agents typically do not earn on top of that. Direct-channel bookings (phone, email, referral, repeat, etc.) are commissionable.
Configuring Commission Settings
Navigate to Settings > Agent Commissions to access two configuration panels.
Commission Base Toggle
The Include Fees in Base toggle controls what dollar amount the commission percentage is applied to:
- Off (default) -- Commission is calculated on the accommodation revenue only (base nightly rate, excluding cleaning fees, service fees, and taxes).
- On -- Commission is calculated on the full company revenue including fees.
Toggle this setting to match your internal payroll agreements. Changes take effect on the next checkout.
Rate Configuration
The rates table lists every booking source, grouped into OTA Channels and Direct Channels. For each source you can:
- Toggle commissionable -- Enable or disable commission earning for that source.
- Set the rate -- Enter a percentage (e.g.
5.0). The rate is applied to the commission base (accommodation or full revenue, per the toggle above).
Click away from the rate input field to save. Changes are saved immediately per row.
Default rates seeded at setup:
| Group | Source | Commissionable | Default Rate |
|---|---|---|---|
| OTA Channels | Airbnb | No | — |
| OTA Channels | Booking.com | No | — |
| OTA Channels | VRBO | No | — |
| Direct Channels | Direct | Yes | 5% |
| Direct Channels | Phone | Yes | 5% |
| Direct Channels | Yes | 5% | |
| Direct Channels | Referral | Yes | 5% |
| Direct Channels | Repeat Guest | Yes | 5% |
| Direct Channels | Manual Entry | Yes | 5% |
| Direct Channels | Other | Yes | 5% |
You can adjust any rate or toggle any source on or off at any time.
Viewing the Agent Commission Ledger
Navigate to Commissions > Agent Commissions to view the commission ledger. This page is available to admins and property managers.
Summary Cards
At the top, summary cards show each agent's total commission earned and booking count for the selected period. Each card also breaks down earnings by source (e.g. "Direct: $240.00, Phone: $80.00").
Filters
- Agent -- Filter to a specific reservations agent, or view all agents combined (admins and managers only).
- Date range -- Set a start and end date to narrow the results.
Click Apply to refresh the view.
Booking Lines Table
Below the summary cards, a paginated table lists each individual commission record with:
| Column | Description |
|---|---|
| Date | The date the commission was earned (checkout date) |
| Agent | The reservations agent credited |
| Booking | Booking confirmation code, linked to the booking detail view |
| Property | The property the booking was for |
| Source | The booking source (Direct, Phone, etc.) |
| Base | The dollar amount the commission rate was applied to |
| Rate | The commission rate percentage used |
| Amount | The commission earned (Base × Rate) |
Results are paginated at 50 rows per page.
Exporting
Click Export CSV to download the filtered ledger as a CSV file suitable for payroll processing or accounting review.
Key Concepts
- Reservations Agent -- A staff member assigned to a booking at the time of creation or editing. This is distinct from the freetext "Booking Agent" note field; the Reservations Agent field links to a real user account and drives commission calculations.
- Commission Base -- The dollar figure the rate is applied to. Controlled by the "Include Fees" toggle in settings.
- Immutable Ledger -- Commission records are written at checkout and are not edited. If a booking is modified after checkout, the original commission record stands. This preserves a clean audit trail.
- Idempotent Calculation -- Running checkout on the same booking twice does not create duplicate commission records. The system skips if a record already exists.
Common Questions
A booking was checked out but no commission record appeared — why? Commission records are only created when the booking has a Reservations Agent assigned and the booking's source is configured as commissionable in Settings. Check both the booking's agent field and the rate configuration for that source.
Can I set different rates for different agents? The settings page configures default rates by source that apply to all agents equally. Per-agent rate overrides are not currently available through the UI; contact support if you need per-agent arrangements.
Does changing a rate affect past commissions? No. Rate changes only affect commissions generated at future checkouts. Existing ledger entries use the rate that was in effect at the time of checkout.
Can I reverse or delete a commission record? Commission records are immutable by design. If a booking is cancelled after checkout, the commission record remains in the ledger as a historical record.
Related
- Booking Lifecycle -- How to assign a reservations agent when creating or editing a booking.
- Settings Overview -- General settings and configuration.
- Reporting Guide -- System-wide financial reporting.