Skip to content

Roles & people · Role manual

Administrator

For the system administrator — user accounts, roles, terminals and devices, staff records and PINs, stores, the menu's structure, security, the audit trail and the system's health.

10 min read

On this page

You keep JupitaPos working for everyone else: the right people can sign in, each with the right role; every till is approved and set up; staff records and PINs are correct; and nothing suspicious goes unnoticed. You do not sell, take money or handle stock — those screens are not in your menu.

Who this manual is for

  • System role: Administrator (administrator) — users, roles, terminals, settings, staff records, the menu’s structure, security and the audit trail. Not sales or cash.
  • In the pictures: Irene Admin, the administrator of Jupita Restaurant Demo, working for both branches. Grace is the owner and Moses the branch manager at Kampala — Kololo.
  • Where you work: in the office at a laptop, and at the tills when you set up a new device. Most of what you do is sensitive: sign in with your e-mail and password (never a PIN) and use two-step sign-in.

A day at work

  1. Sign in with your password and two-step code — Sign in, your name › Active Sessions.
  2. Read your notifications and the security alerts — Read notifications, Work a security alert.
  3. Approve any new till that is waiting — Approve a new till, Approve, restrict and revoke a till.
  4. Set up the new starters: staff record, PIN, user account and role — Add an employee, Set an employee’s PIN, Add a user and give them a role.
  5. Close the accounts of leavers — Suspend a user, Change an employee’s status.
  6. Help people who cannot sign in — Require two-step sign-in and reset it, See and end sign-in sessions.
  7. Correct missed punches and decide leave, if your business gives you that job — Correct attendance, Approve leave.
  8. Check the system’s health and the background jobs — Read the System status page, Retry or discard a failed job (in the Help Center inside JupitaPos).
  9. Look through the audit trail for anything unusual — Search the audit trail.

Guides you will use

Accounts and roles

Tills and devices

Staff records

The business’s set-up

Practising in training mode

Security and audit

The system

  • Read the System status page and the Background jobs screen (in the Help Center inside JupitaPos).
  • Retry or discard a failed job (in the Help Center inside JupitaPos).
  • Understand “busy” and what to check (in the Help Center inside JupitaPos).
  • The server itself — backups, recovery, upgrades, Redis and DirectAdmin (in the Help Center inside JupitaPos) — is the job of the person who runs your server; you can read their manuals.

Your own time

Rooms, if your business has them

Quick reference

I need to… Where Guide
Create a login User accounts → New account Add a user
Make a custom role Roles & permissions → Custom role Create a custom role
Approve a till Terminals → Approve Approve a new till
Revoke a lost tablet Terminals → the device Approve, restrict and revoke a till
Add a new starter Team › Employees → Add staff Add an employee
Set a PIN The person’s profile → Set PIN Set an employee’s PIN
Block a leaver User accounts → the person → Suspend Suspend a user
Reset two-step sign-in User accounts → the person Two-step sign-in
Sign someone out everywhere User accounts → the person → Sessions Sign-in sessions
Check an alert Security alerts (/security/alerts) Work a security alert
Who did what Audit trail (/audit) Search the audit trail
Is the system healthy? System status System status (in the Help Center inside JupitaPos)
A job failed Background jobs Retry a failed job (in the Help Center inside JupitaPos)

Getting help

  • The owner decides who may have which role, approves custom roles that carry money or accounts permissions you do not hold, and grants the Auditor role.
  • The branch manager tells you what a new starter needs and where they work.
  • Your JupitaPos provider (or whoever runs the server) handles the server, backups, upgrades, and the business name, currency, time zone and branches.
  • The Help Center: Help & Training › Role-Based Manuals in the menu, with a search box; the ? button, Help for this screen, opens the manual for the screen you are on. See Find help: the Help Center.
  • Troubleshooting you will need most: in Add a user, Approve a new till, Sign in with your PIN (what staff run into), Set an employee’s PIN and Retry a failed job (in the Help Center inside JupitaPos).

Manuals you can also read

  • None: the other role manuals are for jobs with permissions this role does not hold.

What you can do

These are the Administrator role’s permissions. Almost all of them are sensitive (●): sign in with your password to use them. You can only grant a role, or put a permission in a custom role, if you hold it yourself.

Area What you may do
approvals Configure approval workflows (approvals.configure) ●
approvals View approval requests (approvals.view)
attachments Upload and remove attachments (attachments.manage)
attendance Clock in and out and take breaks at the time clock (attendance.clock)
attendance Register biometric devices and map their users to employees (attendance.devices) ●
attendance Correct punches and timecards, enter missed punches, decide overtime (attendance.manage) ●
attendance See the team’s attendance, timesheets and who is on (attendance.view)
audit Verify audit log integrity (audit.verify)
audit View the audit trail (audit.view)
auth Sign other users out of their sessions (auth.sessions.revoke) ●
auth View sign-in history and sessions of other users (auth.sessions.view)
branches Create and edit branches (branches.manage) ●
branches View branches (branches.view)
business Change business profile and settings (business.manage) ●
business View business profile and settings (business.view)
dashboard View the dashboard (dashboard.view)
departments Create and edit departments (departments.manage)
departments View departments (departments.view)
employees Create and edit employees, positions and departments, set PINs, change status (employees.manage) ●
employees See and edit personal details: phone, e-mail, address, date of birth, national ID, emergency contact (employees.personal) ●
employees View the staff directory: names, photos, numbers, positions, branches, status (employees.view)
finance setup View currencies, taxes and service charges (finance_setup.view)
leave Approve or reject leave requests (leave.approve) ●
leave Set up leave types and adjust balances (leave.manage) ●
leave Request leave and see your own balance (leave.request)
leave See the team’s leave and the leave calendar (leave.view)
menu Create and edit menus, categories, items, variants, modifiers and combos (menu.manage)
menu View menus, items, modifiers, combos and prices (menu.view)
notifications Send notifications to other staff (notifications.broadcast)
notifications Receive and view own notifications (notifications.view)
organization View the organization and its businesses (organization.view)
outlets Create and edit outlets, dining areas and production stations (outlets.manage) ●
outlets View outlets, dining areas and production stations (outlets.view)
roles Assign roles and permission overrides to users (roles.assign) ●
roles Create roles and change permissions (roles.manage) ●
roles View roles and permissions (roles.view)
security Acknowledge and resolve alerts and set the alert rules (security.alerts.manage) ●
security See security and audit alerts (discounts, refunds, voids, sign-ins, terminals…) (security.alerts.view)
settings Change business, branch, outlet and terminal settings (settings.manage) ●
settings View settings (settings.view)
shifts View shifts and rosters (shifts.view)
stock locations Create and edit stores and warehouses (stock_locations.manage) ●
stock locations View stores and warehouses (stock_locations.view)
system Retry or discard failed background jobs (system.jobs.retry) ●
system View system health, queues and realtime status (system.status)
terminals Approve pending terminals and set their branch and role restrictions (terminals.approve) ●
terminals Edit terminal settings, printers and paired devices (terminals.manage) ●
terminals Register this installation as a terminal (terminals.register)
terminals Revoke or retire terminals (terminals.revoke) ●
terminals View terminals and devices (terminals.view)
training See training sessions and clear training data (training.manage)
units Create units and conversions (units.manage)
units View units of measure (units.view)
users Create and edit user accounts (users.manage) ●
users Issue password reset links and reset two-factor authentication (users.reset_credentials) ●
users Suspend and reinstate user accounts (users.suspend) ●
users View staff user accounts (users.view)