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
- Sign in with your password and two-step code — Sign in, your name › Active Sessions.
- Read your notifications and the security alerts — Read notifications, Work a security alert.
- Approve any new till that is waiting — Approve a new till, Approve, restrict and revoke a till.
- 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.
- Close the accounts of leavers — Suspend a user, Change an employee’s status.
- Help people who cannot sign in — Require two-step sign-in and reset it, See and end sign-in sessions.
- Correct missed punches and decide leave, if your business gives you that job — Correct attendance, Approve leave.
- 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).
- Look through the audit trail for anything unusual — Search the audit trail.
Guides you will use
Accounts and roles
- Add a user and give them a role — you can only grant roles whose permissions you hold.
- Create a custom role — for a job no system role fits.
- Work in a branch and give people access to it.
- Suspend a user.
- Require two-step sign-in and reset it.
- See and end someone’s sign-in sessions.
- Reset a forgotten password — what the person does themselves.
Tills and devices
- Install JupitaPos on a Windows till or laptop, on Android, on an iPad or iPhone.
- Register this device as a till and approve a new till.
- Approve, restrict and revoke a till — branch and role restrictions.
- Prepare a till for offline use.
- Update to a new version.
- Receipt and kitchen printers — how printing works on each device.
- Connect a fingerprint or card clock.
Staff records
- Find a member of staff and read their profile.
- Add an employee — personal details yes; pay rates belong to those with pay permission.
- Set an employee’s PIN.
- Change an employee’s status or archive them.
- Set up positions, departments, leave types and rules.
- Correct attendance and approve overtime.
- Approve or reject leave.
The business’s set-up
- Find the business settings — what is changed where.
- See the outlets and production stations.
- Taxes and service charges — you can read them; the owner or accountant changes them.
- Add a store, units and conversions, see the stores, which store an outlet uses.
- Add a menu item, organise the categories, create a modifier group, build a meal deal, schedule a menu — prices are set by a manager.
Practising in training mode
- See who practised and clear the practice — the Training page: sessions, orders and Clear training data (practice older than the retention days is cleared every night).
Security and audit
- Work a security alert and set the alert rules.
- Search the audit trail, read an audit record, verify its integrity.
- Give an auditor access to the audit trail — the owner grants the Auditor role.
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
- Switch rooms and room service on or off — in Modules; switching off is refused while stays are going on.
- Pause new room bookings — stop new bookings for a pilot or a closure without touching guests in house.
- The front office’s roles — Front Office Manager, Receptionist, Housekeeping Supervisor, Housekeeper — hold room permissions you do not hold, so the owner or a general manager gives them (Add a user and give them a role); you create the accounts. The role manuals: Receptionist and front office, Housekeeper and housekeeping supervisor, Room-service attendant and runner.
- Troubleshoot the rooms module — what the desk will ask you about.
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) |