HandyCafe Docs
owner

How to Set Up Cashier Roles and Permissions

This guide covers creating cashier accounts, defining custom roles with granular permissions, and assigning those roles to your staff. Properly configured roles ensure that each staff member can only access the features they need for their job.

Everything on this page happens in Settings > Staff. The Cashiers tab holds the accounts and the Roles & Permissions tab holds the roles. For the full list of permissions, see Cashier Roles & Permissions.

What You Will Need

  • Admin access to the HandyCafe Server (only admins can manage cashier accounts and roles).
  • A plan for which staff members need which level of access.

Built-in Roles

HandyCafe ships with three roles. You can create accounts right away:

  • Admin -- Full access. Read-only in the permission matrix.
  • Manager and Cashier -- Built-in roles whose permissions you can edit. They cannot be deleted.

Create a custom role only when neither built-in role fits.


How to Create a Custom Role

  1. Open Settings, then Staff, then the Roles & Permissions tab.
  2. Click Add Role.
  3. Enter a name for the new role (e.g., "Day Shift Cashier").
  4. The new role appears as a column in the permission matrix. It starts with the built-in Cashier permissions, which include remote management, screenshot and file transfer.
  5. Go down the column and check or uncheck permissions. The rows are grouped into 11 groups: Computer Management, Members, Consoles, Logs, Logs Page Tabs, Reporting, Sales, Stock & Payments, Bills, Orders, Stock and Page Visibility.
  6. Use Search permission or the Granted, Differences and Flagged filters to find rows quickly.
  7. Click Save at the bottom of the page.

Expected result: The new role is saved with its permissions. It is now available for cashier accounts with the Custom role type.

Note: There is no role level. Roles differ only by their permissions. Some rows are locked until the row they depend on is on, for example the Orders actions need Orders Page.


Practical Example: Day Shift Cashier Role

This example creates a restricted role suitable for a regular cashier working a daytime shift.

  1. Open Settings > Staff > Roles & Permissions and click Add Role.
  2. Name: "Day Shift Cashier".
  3. Computer Management: keep Manage Computers, Pause / resume session and Add time. Turn off Run command on computer, Delete Files on Client and Remote management if they are on.
  4. Members: enable View, Add and Load money. Disable Delete, Refund / cancel purchase and Change password.
  5. Logs: enable View and Show Today's Logs. Disable Show Full Logs and Delete.
  6. Reporting: enable View and Show Today's Reports. Disable Show Full Reports.
  7. Sales, Stock & Payments: leave Add, Delete and Update off.
  8. Bills and Orders: enable the page rows and collection, leave the cancel-without-collecting rows off.
  9. Click Save.

Expected result: The "Day Shift Cashier" role can run sessions, create members, load money, and view today's logs and reports. It cannot delete members, refund purchases, change payment methods or view historical reports.


Practical Example: Shift Manager

For a trusted shift manager, start from the built-in Manager role instead of creating a new one. Review its column and turn off anything you want to keep for yourself, for example the Delete row under Sales, Stock & Payments. If you change a built-in role that is already assigned to staff, HandyCafe asks whether to apply the change to every cashier using it.


How to Create a Cashier Account

  1. Open Settings, then Staff, then the Cashiers tab.
  2. Click Add Cashier.
  3. Enter a Username. This is what the cashier will type to log in. It must be unique.
  4. Enter a Password. Use a strong password.
  5. Optionally fill in Display Name, Email and Mobile for record-keeping.
  6. Choose the role type: Admin, Manager, Cashier or Custom. For Custom, pick the role in Custom Role.
  7. Click Save.

Expected result: The new cashier account appears in the Cashiers list. The cashier can now log in to the HandyCafe Server using their username and password. Their access is restricted to the permissions defined by their assigned role.


How to Change a Cashier's Role

  1. Open Settings > Staff > Cashiers.
  2. Click the edit button on the cashier's row to open Edit Cashier.
  3. Choose a different role type or a different Custom Role.
  4. Click Save.

Expected result: The cashier's permissions change. The next time they perform an action, the system checks against their new role.


How to Restrict a Cashier to Today's Reports Only

This is a common requirement: you want cashiers to see the current shift's numbers but not historical data.

  1. Open Settings > Staff > Roles & Permissions and find the role's column.
  2. Under Reporting, enable View and Show Today's Reports. Disable Show Full Reports.
  3. Under Logs, enable View and Show Today's Logs. Disable Show Full Logs.
  4. Click Save.

Expected result: The cashier can open the Reports page but only sees data from the current day.


How to Deactivate a Cashier Account

When a staff member leaves, deactivate their account rather than deleting it. This preserves the audit trail.

  1. Open Settings > Staff > Cashiers.
  2. Find the cashier's row.
  3. Turn off the switch in the Status column.

Expected result: The account is marked Disabled and is no longer listed on the cashier login screen. All their historical actions (sessions started, transactions recorded, logs) remain in the system. Turn the switch back on to reactivate the account. The last Admin cannot be deactivated.


Common Mistakes to Avoid

  • Assigning the wrong role. Always double-check the role dropdown when creating a cashier. A cashier with a Manager role has far more access than intended for a regular shift worker.
  • Not testing the role after creation. Log in as the cashier (or use a test account with the role) and verify that restricted features are actually hidden or disabled. Do not rely on the permission checkboxes alone.
  • Forgetting that roles are enforced in the backend. Even if a UI element is visible, the backend will reject unauthorized actions based on the role's permission settings. However, for a clean user experience, the UI should also hide unauthorized features.
  • Forgetting that a new role copies the Cashier permissions. A new custom role starts with remote management, screenshot and file transfer turned on. Review its column before saving.
  • Sharing cashier accounts. Each staff member should have their own account. Shared accounts make it impossible to trace who performed a specific action in the logs.
  • Deleting a cashier account instead of deactivating. Deletion removes the cashier reference from transactions and logs (set to NULL). Always deactivate instead to preserve the audit trail.
  • Leaving default payment method permissions enabled. Most cashiers should not be able to add or remove payment methods. This is a configuration change that should be restricted to owners or admins.