Royalty fees transaction history
The Royalty fees transaction history report lists every royalty fee calculation, adjustment, and transfer for your organization across periods. Use it to track royalty status, audit calculations, manage adjustments, and re-initiate failed transfers.
Audience: Corporate franchise administrators who track and act on royalty transfers, and franchise center managers who review their own center's royalty history.
Important β corporate vs franchisee. Action affordances on this report (Reinitiate, Waive, Approve) are restricted to corporate-org users. Franchisee centers can view their own rows but cannot act on them.
On this page
- What this report covers
- Royalty transaction statuses
- Actions
- How calculations are produced
- Payment mechanism β how money moves
- Per-transaction royalty mode
- Troubleshooting
Before you begin
Permission: Manage Business Payments (under Payments) β Required to view the report and (for corporate-org users) to act on rows.
Who can do this. Corporate-org users for full access (view + Reinitiate + Waive + Approve). Franchisee center users for view-only access on their own rows.
- Royalty payments must be configured. See Configure royalty payments.
- The report shows historical royalty transactions; it does not run new calculations. To start a new calculation, use Calculate and transfer royalties.
What this report covers
This report is the per-transaction audit trail for royalty fees. For each period and center, it shows:
- The calculated royalty amount.
- Any manual adjustments (with reason notes).
- The current royalty transaction status.
- Action buttons available to corporate users (Reinitiate, Waive, Approve).
This complements the Calculate and transfer royalties workflow (which handles new calculations) and the Royalty Net Settlement report (which shows aggregate per-center transfer summaries).
Steps
Open the report
The navigation path to this report is unusually deep β bookmark it after you find it.
- Open Configuration > Payments > Business payments.
- Select the Set up section.
- Open Reports.
- Click Royalty fees transaction history.
The report opens with rows for the current period; use filters to navigate to other periods or centers.
Read the transaction list
Each row represents a royalty calculation for a center in a specific period.
| Column | Description |
|---|---|
| Period | The settlement period the calculation applies to (e.g., March 2026 for monthly settlement, week of 2026-03-04 for weekly). |
| Center | The center that owes the royalty fee. |
| Calculated | The total royalty amount calculated from the configured rules and categories for the period. To verify how this number was derived, drill into the calculation view (Calculate and transfer royalties). |
| Adjustment | Any manual adjustment made to the calculated amount. Positive or negative; signed in the period total. |
| Notes | The reason captured when the adjustment was made. Free text β treat it as the audit trail. |
| Status | The current royalty transaction status. See Royalty transaction statuses. |
| Action | Available actions for this row (corporate-only). See Actions. |
Adjust a calculated amount
Adjustments to the Calculated amount are made inline on the row. There is no separate adjustment screen.
- Find the row to adjust.
- Click the row or open the drill-down.
- Update the Adjustment field (positive or negative).
- Capture a reason in Notes (free-text β treat it as the audit trail).
- Save.
The adjustment is reflected in that center's period total and in the exported report, along with the note you recorded.
Worked example. For the March 2026 period, the Downtown center shows Calculated $4,250.00 with Status Processing. Corporate agreed to credit $300.00 because one service category was counted twice. On the Downtown row, enter
-300.00in Adjustment, recordDuplicate facial category β credit approved by regional directorin Notes, and save. The period total for Downtown becomes $3,950.00, and both the adjustment and the note appear in the export.
Note β adjustments are a financial control. Manual adjustments are visible to all users with Manage Business Payments permission. There is no enforced approval workflow on adjustments at the platform level. If your franchise operations require dual-control on adjustments, implement it through your role administration (e.g., one role can adjust, a separate role can initiate transfers).
Reinitiate a failed transfer
Use this when a transfer was returned by the bank and the row shows Reversed.
Important: Resolve the underlying cause (closed account, insufficient funds, unauthorized debit) before you re-submit. Re-initiating against an unresolved account produces another reversal.
- Find the row in Reversed status.
- Confirm the account used for royalty debits is active and verified. See Configure royalty payments β Configure bank accounts and Bank account linking.
- Click Reinitiate on the row.
Zenoti validates the funding account status before resubmitting the transfer. If the funding account is not in a valid state, the transfer is not resubmitted β correct the account and try again.
Waive a royalty fee
Use this when corporate has agreed to forgive the royalty fee for a specific center and period.
- Find the row for the center and period.
- Click Waive.
The row moves to Waived. The amount remains on the report for audit, but no transfer occurs. Record the business reason for the waiver in your franchise records β the waiver itself does not capture a reason.
Approve a calculated amount
Use this for rows that are pending approval between calculation and initiation.
- Review the Calculated amount and any Adjustment and Notes values on the row.
- Click Approve.
After approval, the row transitions to Processing when the transfer is initiated. For the end-to-end calculation and initiation sequence, see Calculate and transfer royalties.
Export the transaction history
- Set the period and center filters for the view you need.
- Click the export action to download the current view.
The export includes one row per period per center with the following columns: Period, Center, Calculated, Adjustment, Notes, Status (one of: Processing / Settled / Reversed / Waived), and Action (available actions: Reinitiate / Waive / Approve depending on current status).
For more comprehensive accounting export, also see the Royalty Net Settlement report.
Royalty transaction statuses
The Status column reflects one of four values. There are exactly four royalty transaction statuses.
| Status | What it means | Typical next step |
|---|---|---|
| Processing | The royalty transaction is currently in flight β the bank transfer has been initiated and is awaiting acknowledgment. | Wait. Processing typically completes within the bank's settlement window (1β3 business days for standard ACH). If a row stays in Processing for more than 5 business days, escalate to Zenoti Support. |
| Settled | The royalty transaction completed successfully β funds have been transferred to the corporate royalty account. | No action. Use the row for accounting reconciliation. |
| Reversed | A previously initiated royalty transfer was reversed β the funds were returned to the originating center's account, typically due to a bank rejection (account closed, insufficient funds, unauthorized debit). | Investigate the reversal reason; resolve at the bank-account level if needed; Reinitiate the row when ready. |
| Waived | Corporate has waived the royalty fee for this row. The amount is recorded for audit but no transfer occurs. | Audit-only. Document the waiver reason in your franchise records. |
Note β pre-Processing state. Rows where corporate has approved the calculation but not yet initiated the transfer remain in the calculation view until initiated. Once initiated, they move to Processing. There is no separate status for a row that is waiting to be initiated.
Actions
Action affordances vary by status and by user type. Only corporate-org users see the action buttons; franchisee users see the Status column only.
| Action | When available | What it does |
|---|---|---|
| Reinitiate | A row in Reversed status (transfer failed). | Re-submits the transfer to the bank. Resolve the underlying reason (account error, insufficient funds, authorization issue) before re-initiating. |
| Waive | A row in Processing or pre-initiation. | Cancels the transfer and marks the row Waived. Use when corporate has agreed to forgive the fee for a specific period (e.g., goodwill, dispute, franchise concession). |
| Approve | A row pending approval (between calculation and initiation). | Approves the calculated amount for transfer. After approval, the row transitions to Processing when initiation is invoked. |
Note β reversed and pending block new submissions. A center with one or more rows in Reversed or pre-initiation states blocks new transfers for subsequent periods. Resolve older rows before submitting newer periods. See Re-initiate failed transfers for the resolution flow.
How calculations are produced
The Calculated amount is derived from:
- The center's revenue in the period (cash-collected, per the Modified Cash accounting model).
- The royalty rules and categories configured for the center's group.
- Any adjustments captured for the period.
To audit a specific calculation, drill into the Calculate and transfer royalties view for the period and center, where revenue totals, applied rates, and per-category breakdowns are visible.
For the rule schema and configuration, see Configure royalty payments β Royalty rule schema.
Payment mechanism β how money moves
When a row settles, royalty fees are transferred via bank ACH (or local ACH equivalent) from the center's debit account to the corporate royalty account. The funds are not deducted from the center's Zenoti Wallet, and they are not netted against the center's payouts; they are a separate bank transfer.
For the bank-account configuration on each side (corporate royalty-receipt account and per-center debit account), see Configure royalty payments β Configure bank accounts.
Per-transaction royalty mode
In addition to the periodic batch settlement documented above, the system supports a per-transaction royalty deduction mode in which royalty fees are deducted from each invoice rather than accumulated and transferred periodically.
Availability: Per-transaction royalty deduction is enabled per organization by Zenoti and is not configurable through the standard royalty screens.
Per-transaction mode is enabled per organization by Zenoti staff. To request enablement, contact Zenoti Support. The transaction-history report continues to function in this mode, but rows reflect per-invoice deductions rather than period batches.
Tips
- Bookmark the report after your first visit β the path is four levels deep, and you will return to it every settlement cycle.
- Write Notes in a consistent format (reason plus approver or ticket reference). The note travels into the export, so a disciplined format makes the export usable as an audit record without follow-up.
- Clear Reversed rows before the next settlement period closes. Unresolved rows block new transfers for that center, which turns one failed transfer into a backlog.
- Export the report each month and reconcile it against the Royalty Net Settlement report so per-transaction detail and per-center totals agree before you close the books.
- When a franchisee questions a charge, filter to that single center and period first, then drill into the calculation. Working from the filtered row keeps the conversation on one number.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| A row stays in Processing for more than five business days. | The bank has not acknowledged the transfer. | Confirm both the corporate royalty-receipt account and the center's debit account are active. If both are valid, contact Zenoti Support with the period and center. |
| Reinitiate does not resubmit the transfer. | The funding account is not in a valid state, so validation stops the retry. | Check the account linked for royalty debits, correct or re-verify it, then reinitiate. See Bank account linking. |
| A new period cannot be initiated for a center. | The center has rows in Reversed or pre-initiation states. | Resolve the older rows first β Reinitiate them after fixing the bank issue, or Waive them if corporate has forgiven the fee. |
| The Calculated amount does not match what you expected. | Royalty rules or categories changed part-way through the period, or cash-collected revenue differs from booked revenue. | Drill into the calculation for that period and center, review the applied rate per category, and check whether an Adjustment is already recorded on the row. |
| Action buttons do not appear on any row. | You are signed in as a franchise center user. | Action affordances are corporate-only. Ask your corporate administrator to act on the row; center users retain view access. |
| A row shows Waived but no one recorded why. | Waiving a row does not capture a reason. | Track waiver approvals outside the report in your franchise records, and use the Notes field on adjustments where a reason must stay with the transaction. |