Nestus AI Docs

System Documentation · Version 1.0

Nestus AI
Documentation

A comprehensive guide to the AI-native workforce, payroll, and financial management platform built for modern African organisations — where the base modules manage your data, and the AI layer makes that data work for you.

HRFinanceCompensationSuper AdminAI-PoweredNASSIT CompliantNRA / PAYE Ready

Introduction

The problem with disconnected systems

Running a business means managing people, money, and compliance simultaneously — often across disconnected spreadsheets, manual processes, and tools that were never designed to work together. When payroll takes days to calculate, when a salary change in HR does not reflect in Finance, or when NASSIT contributions are computed by hand and reconciled at month-end, the cost is not just time. It is accuracy, trust, and the energy of your best people.

Errors in payroll erode employee trust. Manual statutory filings create compliance risk. Siloed financial records make it impossible to understand where money is actually going. And as an organisation grows, these problems do not stay manageable — they compound.

Nestus AI was built to end that fragmentation.

“When every part of your business lives in one connected system, and an AI layer watches it all, you stop managing data and start running your organisation.”

What is Nestus AI

An AI-native platform for your organisation

Nestus AI is a unified workforce and financial management platform that brings HR operations, payroll processing, and financial accounting into a single, intelligent system. Designed for organisations operating in Sierra Leone and across the West African region, Nestus AI is built around the compliance rules and operational realities your business actually faces — including NASSIT contributions, NRA PAYE calculations, and structured financial ledgers.

Every action in Nestus AI is connected. When HR onboards a new employee, that employee is immediately available in payroll. When a payroll run is closed, expense entries flow automatically into the Finance ledger — dated to the correct period, categorised under the right accounts, ready for audit. When a salary changes, the platform offers to propagate it across all relevant open payroll runs.

But connection is the floor, not the ceiling. The “AI” in Nestus AI is not a chatbot added as an afterthought — it is the intelligence layer that runs across every module. An AI assistant already lives in every sidebar, ready to answer questions and take actions in plain language. The roadmap builds from there: proactive insight emails, push notifications that surface anomalies before you think to look, income and expense forecasting from your own ledger history, and trend detection that tells you what is changing in your payroll, attendance, and finances before it becomes a problem.

The base modules in this documentation manage your data. The AI layer is what makes that data work for you.

Who It's For

Built for every role in your organisation

Business Owners

Get a real-time view of your organisation's headcount, payroll costs, and financial position — without chasing reports across three different tools. AI will proactively surface what changed, what to watch, and what is likely coming next.

HR Teams

Manage employee profiles, departments, attendance, documents, and policies in one place. AI monitors attendance patterns in real time, flags unexcused absences the moment they occur, and will send email and push notifications to the right people automatically.

Payroll Admins

Run compliant, accurate payroll in minutes. NASSIT and NRA calculations happen automatically. Payslips are generated and filed per employee. AI will flag anomalies — new additions, salary changes, unusual deductions — before you close the run.

Finance Teams

Maintain a structured, period-based financial ledger with automatic entries from payroll. AI detects income and expense trends, flags unusual movements against historical patterns, and will forecast future cashflow from your actual data.

Accountants & Auditors

Access a clean, ledger-backed financial record that precisely matches every payroll run. Statutory liabilities are posted as separate approved entries. AI-generated financial summaries and anomaly flags will make period-end reviews faster and more complete.

Super Admins

Maintain visibility and control across all modules. Approve, override, reopen payroll runs, and report across the entire organisation from a single dashboard. AI will deliver cross-module insight briefings — by email, push notification, or in-app — so nothing slips past.


Platform Structure

Four modules, one connected platform, one AI layer

Nestus AI is organised into four integrated modules. Each handles a distinct domain of your business while sharing data seamlessly with the others. Sitting across all four modules is the AI intelligence layer — the system that turns the data your team records every day into insights, forecasts, alerts, and actions.

Module 01

HR

The foundation of your workforce. Employee profiles, departments, attendance records, document storage, and leave management — all in one place. HR is the source of truth every other module draws from. AI monitors attendance patterns, flags anomalies, and will proactively alert managers before issues escalate.

Module 02

Finance

Your organisation's financial ledger. Record income and expenses across a structured account hierarchy, manage period-based ledgers, and maintain a complete, auditable financial history. AI analyses your income and expense trends, detects unusual movements, and will forecast future cashflow based on your historical patterns.

Module 03

Compensation

The engine of your payroll. Create runs, calculate gross and net pay with automatic NASSIT and NRA deductions, manage allowances and bonuses per employee, generate payslips, and disburse salaries. AI surfaces payroll anomalies — salary outliers, unexpected deductions, headcount shifts — and will flag them before a run is closed.

Module 04

Super Admin

The control room. Full visibility across all modules, approval workflows, and organisation-wide reporting. AI synthesises data from HR, Finance, and Compensation into unified insights — and will deliver them as scheduled briefings, email digests, and push notifications directly to Super Admin accounts.

AI Layer — Cross-module

Intelligence

The AI layer runs across all four modules. It is not a fifth module — it is the system that watches your data and makes it actionable. Chat assistant, anomaly detection, trend analysis, income and expense forecasting, proactive insight emails, and push notifications. Built progressively on top of the base platform.

Integration

How the modules work together

The power of Nestus AI is not in any single module — it is in the connections between them. The lifecycle of a single payroll run shows how data flows across the entire platform without any manual handoffs.

The Payroll Lifecycle — End to End
01

Employee is onboarded in HR

A new hire is added with their role, department, employment type, and base salary. Their profile is immediately available to the Compensation module — no transfer, no duplication.

02

A payroll run is created for the month

The payroll administrator seeds payroll lines for all active employees. Each line pulls the employee's current salary from HR and applies the frozen NASSIT and NRA rates for this run.

03

Allowances, deductions, and bonuses are applied

Each employee's line can have individual allowances (housing, transport, medical), deductions (loans, insurance), and bonuses. Gross and net pay recalculate automatically with every change.

04

Payroll is reviewed and closed

The Super Admin closes the run. At this moment, a payslip is generated for every employee and stored in their HR document folder — without any manual step from HR.

05

Expense entries are automatically posted to Finance

Four approved expense entries are created in the Finance ledger, always dated to the payroll period month: Net Salary, NASSIT Remittance, NRA Remittance, and Employer NASSIT Contribution.

06

Salaries are disbursed directly

With the Nestus Wallet integration, net salaries are disbursed to employee accounts directly from the platform. Each disbursement is logged against its payroll item.

AI & Intelligence

The AI layer — what it does and what is coming

The name Nestus AI is not branding. AI is the operating principle of the platform — not a feature that was added to a conventional HR tool, but the layer that will make every part of the system smarter over time. The base features documented in this guide are the foundation. AI is what gets built on top of them.

AI Assistant — Chat, Ask, Act

Live now

Every module sidebar has an always-available AI assistant (the Sparkles button). Ask it anything about your HR data, payroll figures, or financial records — in plain language. The assistant can answer questions, surface summaries, and take actions on your behalf: looking up an employee record, summarising a payroll run, or explaining a financial entry. This is already live.

Attendance Anomaly Detection

Coming

The AI monitors attendance patterns across your organisation in real time. It surfaces unexcused absences, late-arrival spikes, and unusual absence clusters as Key Alerts on the HR Dashboard the moment they are detected — not at the end of the week when the damage is already done.

Insight Emails & Push Notifications

Coming

The AI layer will proactively push insights to the people who need them. Business owners and Super Admins will receive scheduled briefings — a weekly financial summary, a monthly payroll digest, a compliance alert when document expirations are approaching. Push notifications will surface time-sensitive signals: a payroll run ready to close, an approval queue building up, an unusual expense entry flagged for review.

Income & Expense Forecasting

Coming

Based on your historical Finance ledger data, the AI will project future income and expense patterns — showing you expected cashflow for the next month or quarter before you commit to spending. Forecasts will appear alongside actuals in the Finance Dashboard and Performances pages so you can compare what is happening to what the model expects.

Trend Detection

Coming

The AI continuously compares current period data against historical baselines. In Finance, it detects whether an expense category is running materially higher than the same period last year. In Compensation, it flags payroll runs where gross pay deviated from the prior month beyond a threshold. In HR, it identifies whether absence rates are trending upward before they become a business problem.

More Coming

AI is the core of Nestus AI — not a feature bolted on the side. As more data accumulates in your ledgers, payroll records, and HR system, the intelligence layer will compound: smarter recommendations, more accurate forecasts, tighter anomaly detection. Every module in this documentation is being built with AI augmentation as the next layer, not an optional add-on.

Compliance

Built for Sierra Leone. Ready for the region.

Nestus AI ships with Sierra Leone's statutory compliance requirements built into the core — not as an afterthought, but as first-class features.

Sierra Leone Statutory Compliance

NASSIT — National Social Security and Insurance Trust

Employee and employer contribution rates are configurable and frozen per payroll run, so historical records remain accurate even after rates change. Employment type eligibility is fully configurable — full-time, part-time, intern, and volunteer staff can each carry different NASSIT obligations.

NRA — National Revenue Authority (PAYE)

A five-tier PAYE tax bracket system, fully configurable per tenant, applied per employee based on gross income. Rates are frozen per payroll run — updating today's NRA configuration will never affect historical payroll records.

Run Rate Snapshots

When a payroll run is created, the current NASSIT and NRA configuration is frozen onto that run. A rate correction today does not silently alter last month's payroll — every historical run is a permanent, accurate record.

Key Capabilities

Everything your organisation needs, in one place

AI assistant in every module — chat, ask questions, and take actions
AI-powered anomaly detection across attendance, payroll, and finances
AI income and expense trend detection and cashflow forecasting
Proactive insight emails and push notifications from the AI layer
Multi-tenant architecture with role-based access control
Automatic NASSIT and NRA/PAYE calculation per payroll run
Per-run rate snapshots — accurate historical records always
Automatic payslip generation filed in employee documents
Direct salary disbursement via Nestus Wallet integration
Finance ledger entries auto-posted on every payroll close
Bulk import of income and expense data via CSV / XLSX
Period-locked payrolls with Super Admin reopen capability
Per-employee allowances, deductions, and bonus management
Per-item base salary override with automatic recalculation
Departmental structure and employee assignment
Attendance tracking and company policy management
Employee document storage with folder organisation
Structured account hierarchy for financial categorisation

The first four capabilities are part of the AI layer — some live now, others being built. All remaining capabilities are live in the current platform.

Chapter One

The HR Module

Everything in Nestus AI begins in HR. This module is your organisation's source of truth — the central record of who works for you, how they are organised, and what their employment terms are. When you add an employee here, they become available in payroll. When payroll generates a payslip, it files it automatically into the employee's HR document folder.

The HR module has ten pages: Dashboard, Employees, Employee Profile, Departments & Job Titles, Attendance, Documents, Leaves & Holidays, Reports, Settings, and Assets. Job titles are managed from inside Departments. Admin role assignments live on each employee's profile. Platform user creation is handled in Settings.

Recommended Setup Order — Do This First
01

Configure Settings

Set your working week, attendance rules, and leave policy. These feed into attendance tracking and the Compensation module's NASSIT/NRA eligibility rules.

02

Create your Departments and Job Titles

Departments must exist before you add employees. Job titles are created inside each department so every hire can be assigned the right position from day one.

03

Add your Employees

Once departments and job titles are in place, add all active staff with their employment type, base salary, and start date. They will be available in Compensation immediately.

04

Assign Admins

Once users are on the platform, assign the right admin roles (HR Admin, Finance Admin, Comps Admin) from each person's employee profile.

05

Upload Documents and set Policies

Employment contracts, offer letters, and company policies can be uploaded per employee or organisation-wide before or after payroll setup.

Page 1.1

Dashboard

The HR module home page — today's attendance snapshot, active key alerts, a 7-day attendance trend chart, and document compliance status at a glance.

The HR Dashboard is the first page you see when you open the HR module. It gives you an immediate read on what is happening in the organisation today — who is in, who is out, who is late, and whether any compliance or attendance alerts need your attention. All data refreshes in real time; there is nothing to configure and nothing to click to trigger an update.

Attendance KPI cards

Four cards across the top of the page show today's attendance figures, each with a percentage change vs. yesterday so you can see at a glance whether attendance is trending up or down:

Present TodayEmployees clocked in as Present today. A green arrow means more people are in than yesterday; red means fewer.
Absent TodayEmployees who were scheduled to work but did not clock in. A green arrow here means fewer absences than yesterday (the number went down), which is a positive signal.
LateEmployees who clocked in but past the late threshold set in Settings → Workspace. A green arrow means fewer late arrivals than yesterday.
On LeaveEmployees currently on approved leave. A green arrow means fewer people on leave than yesterday.

Key Alerts

The Key Alerts panel sits below the KPI cards. It shows active alerts that need HR attention — flagged in two severity levels:

Unexcused Absences (red)

Employees who were absent without an authorised leave record. These are the highest-priority alerts — unexcused absences without follow-up can lead to disciplinary issues and payroll disputes.

Other Alerts (amber)

Warnings that need attention but are less urgent — for example, employees approaching the end of their leave balance, documents expiring soon, or other HR flags the system has detected.

Zero alerts is the goalA Key Alerts panel that shows “No active alerts” means attendance is clean and no immediate HR action is required. The count badge in the panel header tells you how many alerts are currently open — work to keep that number at zero before the end of each week.
AI & Key AlertsThe AI layer powers Key Alerts detection. Unexcused absences and anomalous attendance patterns are surfaced the moment they occur — not at the end of the week. As the AI layer matures, Key Alerts will be pushed proactively as email notifications and push alerts to HR Admins and managers, so nothing goes unnoticed even when you are not looking at the dashboard.

Attendance Trend chart

The larger panel on the left side of the bottom section shows the attendance trend for the last 7 days. Three mini-stats sit above the chart — total Present, total Absent, and total Late across the period, each with a percentage change vs the previous 7 days. Below them is a line chart with three colour-coded lines: green for Present, red for Absent, and purple (brand colour) for Late. Hover over any date to see the exact counts.

Document Compliance Status

The smaller panel on the right shows how many employee documents across the organisation are Valid, Expiring Soon, or Expired — both as a count and as a percentage of total documents. This is a quick compliance health check. If the Expired count is growing, navigate to HR Documents or the Reports → Compliance & Audit tab to identify which employees need updated paperwork.

Page 1.2

Employees

The master list of everyone in your organisation — your headcount at a glance, searchable and filterable, with a direct path into any individual's full profile.

The Employees page is the starting point for all people management in Nestus AI. From here you can see your entire workforce in one view, search by name, filter by department or employment type, add new staff, and navigate into any employee's profile for full details.

What you can do here

View all employeesSearch by nameFilter by departmentFilter by employment typeAdd a new employeeNavigate to employee profile
Before you beginSet up your departments first (page 1.4) so you can assign each new hire to the correct team immediately. You can add an employee without a department, but it is much harder to reorganise after the fact — especially once payroll has started running.
Step-by-stepHow to add a new employee
  1. 01
    Click Add Employee in the top-right corner of the Employees page.
  2. 02
    Enter personal information: full name, date of birth, and contact details.
  3. 03
    Select the employment type — Full-Time, Part-Time, Intern, or Volunteer. This determines whether NASSIT and NRA/PAYE are calculated for this person.
  4. 04
    Enter the base salary — the gross monthly salary used as the starting point for payroll calculations. This value seeds every payroll run the employee appears in.
  5. 05
    Assign the employee to a department.
  6. 06
    Set their employment start date.
  7. 07
    Click Save. The employee is created and immediately available in the Compensation module.
Watch out for
  • Wrong employment type: If a full-time employee is set as a Volunteer, and Volunteers are not in your NASSIT/NRA eligibility list, their statutory deductions will not be calculated.
  • Missing base salary: If you save without a salary, the employee's payroll line will default to zero gross pay. Always set a salary before the next payroll run is created.

Page 1.3

Employee Profile

The complete record for a single employee — personal info, employment details, full payroll history, year-to-date statistics, admin role management, and all documents filed for this person.

Clicking any employee from the list takes you to their profile — the most data-rich page in the HR module. It brings together everything Nestus AI knows about that person: who they are, what they earn, how they've been paid across every closed payroll, and every document filed against their name (including payslips the Compensation module files automatically).

What you can do here

View personal informationEdit employment detailsUpdate base salaryAssign job titleAssign admin rolesView YTD compensation statsView monthly payment historyAccess employee documentsUpload documentsView payslips

Updating base salary

When an employee receives a raise, their base salary is updated here. Because salary is the foundation of every payroll calculation, Nestus AI checks whether any open payroll runs include this employee and offers to propagate the change.

Step-by-stepHow to update an employee's base salary
  1. 01
    Open the employee's profile and locate the Employment Details section.
  2. 02
    Click the edit icon next to the Base Salary field.
  3. 03
    Enter the new gross monthly salary and confirm.
  4. 04
    If open payroll runs include this employee, the platform will prompt: “This employee has open payroll runs. Apply the new salary to them?”
  5. 05
    Choose Update open runs to propagate (all draft payroll items recalculate: NASSIT, NRA, net pay), or Skip to apply only to future runs.
  6. 06
    The employment record is saved. Closed (historical) payrolls are never affected.
How historical records stay accurateClosed payrolls are period-locked. Updating a salary today will not change what was paid in any month that has already been closed. Each payroll run is a permanent record of what was earned and deducted in that specific period.

Year-to-date statistics

The Compensation section shows running YTD totals from January 1 of the current year: total net amount paid, total NASSIT deducted, total NRA/PAYE withheld, total allowances, total bonuses, and total deductions. These update automatically each time a payroll run is closed.

Documents and payslips

Every employee has their own document folder. Payslips are filed here automatically — under a Payslips subfolder — each time a payroll run is closed. You can also upload contracts, offer letters, ID copies, and appraisal records manually.

Assigning admin roles to an employee

Platform admin roles control which modules a user can administer. You assign these roles from the employee's profile — not from Settings. This keeps admin access tied to the employment record so it is easy to audit who has elevated permissions and to remove access when someone leaves.

Nestus AI has four admin role types, and a person can hold more than one simultaneously:

Admin roles

HR AdminFull access to the HR module: employees, departments, attendance, documents, policies, and HR settings. Can create users and assign admin roles.
Finance AdminFull access to the Finance module: ledgers, accounts, income, expenses, and bulk imports.
Comps AdminFull access to the Compensation module: payroll runs, allowances, deductions, bonuses, and compensation settings.
Super AdminCross-module access to all three modules plus the Super Admin dashboard: organisation overview, approvals, and reports. Has the power to close and reopen payroll runs.
Step-by-stepHow to assign admin roles to an employee
  1. 01
    Open the employee's profile from the Employees page.
  2. 02
    Click the Admin Roles button — it appears near the top of the profile alongside the Assign Job Title button.
  3. 03
    The Admin Roles modal opens showing four checkboxes: HR Admin, Finance Admin, Comps Admin, Super Admin.
  4. 04
    Check the roles this person should hold. You can select multiple.
  5. 05
    Click Save Roles. The roles take effect immediately — the user will see the updated module access on their next login or page refresh.
Watch out for
  • Saving with no roles selected: The warning “No roles selected — saving will remove all admin access” appears in the modal. Confirming will revoke all admin permissions for that employee.
  • Propagating salary mid-run: Review the updated payroll item before closing to ensure figures are correct, especially if the employee has complex allowance or deduction structures that interact with the base salary.

How multi-role users switch between modules

When a user holds more than one admin role — for example both HR Admin and Finance Admin — they can switch between modules without signing out. The switch happens from the company profile dropdown in the top-right corner of the header. Click the company name (or logo avatar) to open it.

What the company profile dropdown shows

Organisation

Your company name, logo or initial, industry, location, email, and phone — pulled from the tenant record. This is always visible regardless of how many roles the user holds.

Signed in as

The logged-in user's name, email, and a colour-coded role badge showing their current active module: blue for Super Admin, green for HR Admin, yellow for Finance Admin, red for Comps Admin.

Current module (multi-role only)

The currently active module is shown as a badge. This section only appears if the user has been assigned two or more admin roles.

Switch to (multi-role only)

One button per additional role. Clicking a button swaps the active module — the platform fetches a new scoped token for that role, updates the session, and navigates to the target module's dashboard. While switching, a full-page skeleton overlay (sidebar + header + content) appears to cover the transition. The dropdown only shows roles that have been assigned to the user in HR.

Settings

Navigates to the Settings page for the currently active module (HR → /hr/settings, Finance → /finance/settings, etc.).

Sign Out

Ends the session and returns to the sign-in page.

Module switching does not change role assignmentsSwitching from HR Admin to Finance Admin in the dropdown is a session change — it changes which module you are currently viewing, not what roles exist on your account. The roles are still all assigned; you are just changing which one is active. To permanently remove a role, go back to the employee's profile and uncheck the role in the Admin Roles modal.

Page 1.4

Departments

Define the structural building blocks of your organisation. Departments group employees into teams — and are also where you create and manage job titles.

Departments in Nestus AI are the organisational containers that give your headcount structure. Department names appear in payroll breakdowns, compensation reports, and any cross-module filtering. Setting them up correctly before you add staff is the single most impactful setup step in the HR module.

What you can do here

View all departmentsCreate a departmentEdit a department nameView department membersDelete a departmentCreate a job titleEdit a job titleDelete a job titleAssign a job title to an employee
Step-by-stepHow to create a department
  1. 01
    On the Departments page, click Add Department.
  2. 02
    Enter a clear, unambiguous department name (e.g. "Finance", "Human Resources", "Operations").
  3. 03
    Click Save. The department is immediately available when adding or editing employees.
Best practiceCreate all departments before adding a single employee. Use names that are stable — renaming a department after employees have been assigned can cause confusion in older reports.

Job Titles

Job titles are created and managed from within the Departments page. Each job title is linked to a specific department — so “Senior Accountant” would belong to the Finance department, and “HR Officer” would belong to Human Resources. Once created, a job title can be assigned to any employee from their profile or during the Create New User flow in Settings.

Job titles serve two purposes: they appear on the employee profile and payslip as the person's designated position, and they let you track who holds which role across departments without needing to rely on free-text fields.

Step-by-stepHow to create a job title
  1. 01
    On the Departments page, open the department you want to add a job title to (e.g. click on the Finance department).
  2. 02
    Click Add Job Title within that department.
  3. 03
    Enter the job title name (e.g. "Finance Manager", "HR Officer", "IT Specialist").
  4. 04
    Optionally add a description to clarify the role.
  5. 05
    Click Save. The job title is now available to assign to any employee in that department.
Step-by-stepHow to assign a job title to an employee
  1. 01
    Open the employee's profile from the Employees page.
  2. 02
    Click the Assign Job Title button near the top of the profile.
  3. 03
    The Assign Job Title modal opens with a job title dropdown pre-filtered to the tenant's available titles.
  4. 04
    Select the appropriate job title from the list.
  5. 05
    Click Assign Job Title to save. The title appears on the profile immediately and will show on future payslips.
Assigning from SettingsWhen you create a brand new user via Settings → Create New User, you can assign a job title as part of the employment setup step — so there is no need to go back to the profile afterwards.
Watch out for
  • Deleting a department with active employees: The system will block the deletion. Reassign or off-board all members first.
  • Duplicate names: Avoid creating two departments with the same name — it creates ambiguity in reports and makes filtering payroll data by department unreliable.
  • Deleting a job title in use: If employees are currently assigned to a job title you delete, those assignments will be removed. Check who holds the title before deleting it.

Page 1.5

Attendance

Log and review daily attendance records for every employee. A reference layer that sits alongside payroll for HR review and dispute resolution.

The Attendance page lets you record whether each employee was present, absent, late, or on a half-day on any given date. Records are stored per employee per day and can be reviewed by date range or filtered by individual. They serve as a reference when reviewing payroll for part-time staff and as an evidence base for disciplinary conversations.

What you can do here

Log attendanceView attendance historyFilter by employeeFilter by date rangeEdit past records
Step-by-stepHow to log an attendance record
  1. 01
    Click Log Attendance on the Attendance page.
  2. 02
    Select the employee from the dropdown.
  3. 03
    Select the date. You can log for past dates to correct missed entries.
  4. 04
    Choose the status: Present, Absent, Late, Half Day, or other configured options.
  5. 05
    Add an optional note and click Save.
Important to knowAttendance records are informational in the current version — they do not automatically adjust payroll calculations. An “Absent” entry does not deduct a day's pay. Payroll adjustments for absences must be made manually in the Compensation module.
AI & AttendanceThe AI layer analyses your attendance records over time to detect patterns — clusters of absences on the same day of week, departments with rising late-arrival rates, or individuals showing irregular attendance before they formally trigger a policy violation. These insights will surface in the HR Dashboard as AI-generated Key Alerts and will eventually be delivered as proactive email and push notifications, giving managers the information they need before attendance problems become HR problems.

Page 1.6

Documents

Organisation-level and per-employee document storage. The Compensation module automatically files payslips here — you handle everything else.

Documents in Nestus AI live in two places. The Documents page in the HR sidebar is for company-wide files — the employee handbook, registration certificates, templates. The Documents tab inside each Employee Profile is for that person's individual paperwork.

The most important thing to know: payslips land here automatically. Every time a payroll run is closed, Nestus AI generates a PDF payslip for each employee and files it under a Payslips subfolder. There is nothing to do — it happens the moment the payroll closes.

What you can do here

Upload documentsCreate foldersView and download filesDelete documentsView auto-filed payslips
Step-by-stepHow to upload a document
  1. 01
    Navigate to the Documents page (company-wide) or the Documents tab of a specific employee's profile.
  2. 02
    Click Upload Document.
  3. 03
    Select the file from your device.
  4. 04
    Optionally select or create a folder (e.g. "Contracts", "Tax Records", "ID Copies").
  5. 05
    Click Upload to save the file.
Watch out for
  • Uploading the same file twice: Nestus AI creates separate entries for each upload rather than replacing an existing file. Delete the old version manually if you are replacing a document.

Page 1.7

Leaves & Holidays

Manage every employee's leave records and public holidays in one place — from leave requests and approvals to entitlement balances and upcoming schedules.

The Leaves & Holidays page is where HR logs, approves, and tracks all leave activity across the organisation. It is split into four tabs — Overview, Leave Management, Holiday Management, and Employee Balances — so you can switch between a high-level picture and the detailed records in one click.

What you can do here

Log a leaveLog a holidayApprove a leave or holidayEdit a leave recordDelete a recordView upcoming leavesView employee leave balancesFilter by department or employee

Tab 1 — Overview

The Overview tab gives you the health of leave across your organisation at a glance. Three KPI cards show: total leave days taken year-to-date across all employees; the number of employees currently on upcoming scheduled leave; and which department has the highest leave count. Click any KPI card to expand a detail modal showing the individual employees behind that number, with their leave type (Excused or Unexcused) and the option to send them a direct email.

The overview also flags employees whose leave balance has gone negative — they have used more days than their entitlement allows. These records are surfaced prominently so HR can follow up.

Tab 2 — Leave Management

Leave Management is the main working list of all leave records in the system. Each row shows the employee name, department, leave type, date range, and whether the leave has been approved. You can search by name or department, filter by leave type (Excused / Unexcused) or date, and take action on any record.

Nestus AI supports two leave types: Excused leave is authorised absence (sick leave, compassionate leave, annual leave). Unexcused leave is unauthorised absence — it counts against the employee's leave balance but is recorded separately so HR can identify patterns.

Step-by-stepHow to log a leave record
  1. 01
    Click Add Leave in the top-right of the Leaves & Holidays page.
  2. 02
    Select the employee from the dropdown.
  3. 03
    Set the start date and end date.
  4. 04
    Select the leave type: Excused or Unexcused.
  5. 05
    Add an optional reason or note.
  6. 06
    Toggle Approved on if the leave has already been authorised, or leave it off to record it as pending.
  7. 07
    Click Save. The record appears in Leave Management and updates the employee's balance immediately.
Step-by-stepHow to approve a leave record
  1. 01
    On the Leave Management tab, find the record to approve.
  2. 02
    Click the view icon (eye) on the row to open the leave detail panel.
  3. 03
    Click Approve. A success toast confirms the action and the record updates to Approved status.

Tab 3 — Holiday Management

Holiday Management works the same way as Leave Management but for public or gazetted holidays. HR logs holiday periods per employee, sets the number of holiday days, adds a description (e.g. “Independence Day”), and can approve or reject each entry. Holidays draw from the employee's holiday entitlement (set in Settings → Holiday Policy), not their annual leave balance.

Step-by-stepHow to log a holiday record
  1. 01
    Click Add Holiday in the top-right of the page.
  2. 02
    Select the employee and set the start and end dates.
  3. 03
    Enter the number of holiday days and a description (e.g. "Eid al-Fitr").
  4. 04
    Toggle Approved if the holiday has been confirmed.
  5. 05
    Click Save.

Tab 4 — Employee Balances

Employee Balances shows each employee's entitlement versus usage in one table. For every employee you can see:

Leave permitTheir annual leave entitlement in days, calculated from the Leave Policy tiers in Settings based on their start date.
Leave usedTotal leave days consumed so far this year (Excused + Unexcused).
Leave balanceDays remaining (permit minus used). A negative value means the employee has overdrawn their entitlement.
Holiday permitTotal public holiday days they are entitled to per year, from Settings → Holiday Policy.
Holiday usedHoliday days consumed this year.
Holiday balanceHoliday days remaining.
Where balances come fromLeave entitlements are not manually entered per employee — they are calculated automatically from the Leave Policy tiers you configured in Settings, based on each employee's start date. If the balances look wrong, the most common cause is an incomplete or mismatched leave policy.
Watch out for
  • Logging leave without approving: An unapproved leave record still counts against the balance. Always set the Approved toggle correctly when entering the record, or approve it from the Leave Management tab afterwards.
  • Negative balance in Employee Balances: This means the employee has used more leave than their entitlement. Review the records for duplicate or incorrect entries before taking corrective action.

Page 1.8

Reports

The analytics and export hub of the HR module — workforce statistics, attendance logs, leave summaries, and document compliance, all in one place with PDF export.

The Reports page gives HR a cross-organisation view of people, attendance, and compliance data, organised into four tabs: Workforce, Attendance, Leave & Holidays, and Compliance & Audit. Each tab is independently filterable and most have a PDF export button so you can produce printable reports without any external tool.

What you can do here

View workforce KPIsSearch employee directoryView headcount by departmentView gender parity by departmentView daily attendance summaryView present/absent/late logsView attendance trend chartView leave balances by departmentView document complianceExport any report as PDF

Tab 1 — Workforce

The Workforce tab is your headcount dashboard. Four KPI cards at the top show total employees, active employees, inactive or exited employees, and total number of departments — all with quarter-over-quarter change indicators. Below the KPIs are two charts and a searchable directory.

Employee Directory

A full list of every employment record — name, employee ID, department, job title, start date, and status. Filter by status (Active, Suspended, Exited), department, or start-date range. Export the filtered list as a PDF employee directory report branded with your organisation name and address.

Department Headcount Chart

A bar chart showing how many employees are in each department. Useful for identifying understaffed or overstaffed teams at a glance.

Gender Parity Chart

A grouped bar chart showing the male-to-female ratio per department. Each department has two bars (blue = male, pink = female). Export as a branded PDF chart.

Tab 2 — Attendance

The Attendance tab breaks down every dimension of attendance tracking. It has five sections:

Daily Attendance Summary

A table showing, for each working day since the organisation was created, how many employees were Present, Absent, and Late. Filter by a specific date or date range. Export as PDF.

Present Logs

All clock-in records for employees who were marked Present, with their shift name and time. Filter by department, employee, or date range.

Absent Logs

All records for employees who were marked Absent on a scheduled working day. Filter by department, employee, or date range.

Late Logs

All records for employees who clocked in after the late threshold set in Workspace Settings. Filter by department, employee, or date range.

Attendance Trend

A line chart plotting Present, Absent, and Late counts over time. Use the date range filter to zoom into a specific period. Paginate through 14-day windows. Export as a branded PDF chart.

Tab 3 — Leave & Holidays

This tab gives you a reporting view of leave data — separate from the management view in the Leaves & Holidays page. It has three sections:

Leave Balance by Department

A summary table showing total leave entitlement, total leave used, and remaining balance aggregated at the department level. Useful for understanding which departments are drawing down leave fastest.

Leave Logs

All individual leave records across the organisation — the same data as Leave Management but optimised for reading and exporting rather than editing.

Holiday Logs

All individual holiday records. Useful for auditing which employees have claimed public holidays and whether they were approved.

Tab 4 — Compliance & Audit

The Compliance & Audit tab tracks whether employees have the required documents on file. It pulls from the HR Documents system and classifies each employee's document status.

Compliance KPIs

Summary cards showing the percentage of employees with valid documents, documents expiring soon, and expired documents. These are calculated from the documents filed in each employee's profile.

Employee Document Status Table

A filterable list of all employees with their document status (Valid, Expiring, Expired). Filter by department, status, or date range. Use this before regulatory audits to identify which employees need updated paperwork.

PDF exports are brandedEvery PDF exported from the Reports page automatically includes your organisation's name and address at the top of each report. Make sure your organisation details are set correctly — they are pulled from the tenant record.
AI & ReportsThe AI layer will extend HR Reports with generated summaries and narrative insights — automatically interpreting the patterns in your attendance data, workforce composition, and compliance status rather than just displaying the raw numbers. Expect to see AI-written briefings alongside the existing charts, and the ability to ask the AI assistant (Sparkles button in the sidebar) to summarise any report in plain language on demand.

Page 1.9

Settings

All HR configuration lives here — organised into five panels under two groups: Workspace settings (rules, working hours, leave, holidays) and People settings (department managers and creating new platform users).

The HR Settings page has a left sidebar with two groups: Workspace and People. Click any item in that sidebar to switch between panels. Every change you make here affects how Nestus AI behaves for your entire organisation — not just for a single employee.

Settings navigation

GroupPanelWhat it controls
WSWorkspaceWorking week, late threshold, auto absent marking, working hours per day
WSLeave PolicyAnnual leave entitlement tiers based on length of service
WSHoliday PolicyTotal public holiday days per calendar year
PPLManagersAssign and remove department managers and assistant managers
PPLCreate New UserInvite and register a brand-new platform user, then immediately add them as an employee

Workspace

The Workspace panel controls how attendance is tracked and what constitutes a working day for your organisation. These rules apply to every employee globally — there are no per-employee overrides.

Working week

Select the days your organisation normally operates. Toggle a day on (highlighted in purple) to mark it as a working day, or off to mark it as a rest day.

Click each day pill to toggle it. The selection updates the attendance tracking rules — employees are only expected to be present on days marked as working days, and the late-arrival clock applies only on those days.

Default: Monday through Friday. Saturday and Sunday are off.

Attendance rules

Three rules that govern how attendance is recorded and interpreted.

Auto-create employee IDToggle

When enabled, Nestus AI generates a unique employment ID automatically when a new employee is added. When disabled, you must enter the employment ID manually. Enable this if you do not have a fixed ID format — disable it if your organisation uses a specific employee numbering scheme you want to control.

Late threshold (minutes)Number

How many minutes after the scheduled start time a clock-in is still treated as on-time. If you enter 15, an employee who clocks in up to 15 minutes past their shift start is recorded as Present rather than Late. Increase this if your location has traffic variability; set it to 0 for strict punctuality tracking.

Auto absent markingToggle

When enabled, any employee who is scheduled to work on a given day but does not clock in is automatically marked as Absent at the end of that day. Turn this OFF only if your fingerprint device is broken or attendance is being entered manually in bulk — otherwise you will end up with missing (rather than absent) records.

Working hours by day

Set the start and end times for each working day. These times drive the late threshold — if an employee clocks in after the start time plus the threshold, they are marked Late.

The table shows one row per day of the week. Days you marked as non-working are shown greyed out — you cannot set hours for them. For working days, set Work starts (e.g. 08:00) and Work ends (e.g. 17:00).

You can give each day its own hours. If your team works shorter hours on Fridays, set Friday's end time to 13:00 — it will not affect any other day.

Example: Monday–Thursday 08:00–17:00, Friday 08:00–13:00.

Step-by-stepHow to save workspace settings
  1. 01
    Go to Settings → Workspace in the HR sidebar.
  2. 02
    Toggle your working days on or off by clicking each day pill.
  3. 03
    Set the late threshold in minutes and toggle auto absent marking as needed.
  4. 04
    Set the start and end time for each active working day in the Working hours table.
  5. 05
    Click Save workspace settings at the bottom. A success toast confirms the save.

Leave Policy

The Leave Policy panel defines how many days of annual leave employees receive, based on how long they have worked at the organisation. You build the policy as a set of tiers — each tier covers a tenure range (in months) and gives the matching leave entitlement.

Leave tiers by length of service

Each row in the table represents one tenure band. Employees who fall within that band receive that many leave days per year.

From (months)Number

The start of the tenure band in months. For a new joiner tier, this is 0. For a mid-career tier, this might be 24 (two years).

To (months)Number

The end of the tenure band in months. Leave this blank on the last tier to make it apply without an upper limit — meaning anyone with more than that many months of service falls into this tier forever.

Leave days / yearNumber

How many days of annual leave employees in this band receive per year. A common Sierra Leone structure is: 0–11 months → 21 days, 12–59 months → 25 days, 60+ months → 30 days.

Step-by-stepHow to set up a leave policy
  1. 01
    Go to Settings → Leave Policy.
  2. 02
    Click Add tier to create a new row.
  3. 03
    Enter the From (months) and To (months) values. For the final tier, leave To blank.
  4. 04
    Enter the number of leave days per year for this band.
  5. 05
    Repeat for each tier. Use the trash icon to remove a tier you no longer need.
  6. 06
    Click Save leave policy. A toast confirms the save.
Example leave tiers
0 – 11 months21 leave days / year
12 – 59 months25 leave days / year
60+ months (no upper limit)30 leave days / year

Holiday Policy

The Holiday Policy panel has a single field: the total number of paid public holiday days employees are entitled to per calendar year. This is a flat number that applies to all employees regardless of tenure.

Public holiday entitlement

Set the number of public holidays your organisation observes per year.

Holiday days per yearNumber

The count of gazetted public holidays employees receive as paid leave. In Sierra Leone this is typically 13 days, covering national holidays like Independence Day, Eid al-Fitr, Christmas, and others. Enter 0 if your organisation does not treat public holidays as additional paid leave on top of annual leave.

Step-by-stepHow to set the holiday policy
  1. 01
    Go to Settings → Holiday Policy.
  2. 02
    Enter the number of public holiday days per year.
  3. 03
    Click Save holiday policy. Done.

Managers

The Managers panel is where you assign department managers and assistant managers. A manager is linked to one department — a person can be the manager of only one department at a time, though a different person can be the assistant manager of the same department simultaneously.

The panel shows two tabs: Managers and Assistant Managers. Each tab lists every department and who is currently assigned to that role. Expand a department card to see the full assignment history — every person who has ever held that role, and when they were assigned and unassigned.

Step-by-stepHow to assign a department manager
  1. 01
    Go to Settings → Managers.
  2. 02
    Click Assign Manager (or Assign Assistant Manager) from the action buttons at the top of the Settings page, or switch to the Managers panel and click the assign option there.
  3. 03
    In the assignment form, select a Department from the dropdown.
  4. 04
    Select an Employee. The list is filtered to employees in your organisation.
  5. 05
    Click Assign. A success toast confirms the assignment. The department card updates immediately.
Step-by-stepHow to remove a department manager
  1. 01
    On the Managers panel, expand the department card for the manager you want to remove.
  2. 02
    Click the Unassign button next to their name.
  3. 03
    A confirmation dialog appears. Confirm the removal.
  4. 04
    The person is unassigned. The history log records the date they were removed. The department is now unmanaged until a new manager is assigned.

Create New User

This is how HR adds a brand new person to the Nestus AI platform. Unlike adding an employee from the Employees page (which requires the person to already have a user account), Create New User creates the platform account and the employee record in one guided flow. Use this for all new hires.

The flow has three steps: enter personal details, verify with a one-time code, and then set up the employment record.

Create user — step by step

Step 1 — Personal information

Fill in who this person is. All fields except email are required to create the account.

First nameRequired

The person's legal first name as it will appear on their profile and payslips.

Last nameRequired

The person's legal last name.

Gender

Select Male or Female. Used on payroll records.

Date of birth

Used for employee records and age-sensitive compliance checks.

Phone number

The person's contact number.

Address

Residential address — appears on employment records.

Nationality

Country of citizenship.

City / State / Country

Location fields for the employment record.

Email address

Optional but strongly recommended. The platform sends account access notifications to this email. Without it, you must communicate the login credentials manually.

Profile photo

Optional. Upload a photo to make the employee recognisable in lists. If skipped, the system uses initials.

Step 2 — OTP verification

After submitting step 1, the system creates the user account and sends a 6-digit one-time code to the email address you entered. Enter the code in the six boxes to verify the account and proceed. You can resend the code if it does not arrive within a minute.

Step 3 — Employee details

Once verified, you immediately link this user to an employment record. These are the payroll-critical fields.

Employment IDRequired

A unique identifier for this employment record. If Auto-create employee ID is enabled in Workspace Settings, this is generated for you. Otherwise enter it manually following your organisation's numbering scheme.

Start dateRequired

The official employment start date. This is the date from which tenure is calculated for leave policy tier matching.

Basic salaryRequired

The employee's gross monthly base salary in Leones. This seeds every payroll run they appear in. Allowances and bonuses are added on top of this figure in the Compensation module.

Bank nameRequired

The name of the bank where their salary will be paid.

Account numberRequired

The employee's bank account number. Appears on payslips and remittance records.

Employment typeRequired

Select from the employment types your organisation has configured (e.g. Full-Time, Part-Time, Intern, Volunteer). This must match one of the types listed in the Compensation module's NASSIT/NRA eligibility settings or statutory deductions will not be applied.

Department

Optional at this step but recommended. Assign the employee to their department so they appear correctly in payroll breakdowns from their very first run.

Job title

Optional. Select the job title from those created for the selected department. Can also be assigned later from the employee profile.

Step-by-stepHow to create a new user and add them as an employee
  1. 01
    Go to Settings → Create New User.
  2. 02
    Fill in the personal information form: first name, last name, gender, date of birth, phone, address, and email. Optionally upload a profile photo.
  3. 03
    Click Create User. The system registers the account and sends a 6-digit OTP to the email address.
  4. 04
    Enter the 6-digit OTP in the verification screen. If the code does not arrive, click Resend.
  5. 05
    After OTP verification, the Add Employee form opens. Fill in employment ID, start date, salary, bank name, account number, and employment type.
  6. 06
    Optionally select a department and job title.
  7. 07
    Click Add Employee. The person is now a registered user with an active employment record, visible on the Employees page and in the Compensation module.
Watch out for
  • No email address provided: The OTP is sent by email. If you did not provide an email, you will not receive the code and cannot complete verification. Add an email before submitting step 1, or go back and edit the form.
  • Wrong employment type: If the type you select here does not match the NASSIT/NRA eligibility list in Compensation Settings, statutory deductions will not be calculated for this employee. Confirm the type names match before running their first payroll.
  • Missing salary: You cannot skip the basic salary field. An employee added with zero salary will produce a zero net pay line in every payroll run until the salary is corrected from their profile.
User codeAfter step 2 (OTP verification), Nestus AI displays a User Code — a short alphanumeric identifier that links the platform user to their employment record. You do not need to do anything with it; it is used internally. It will also appear on the success screen for reference.

Page 1.10

Assets

A registry of all company-owned devices and equipment — laptops, phones, monitors, and anything else your organisation issues to employees or departments. Track condition, status, and the full assignment history from one place.

The Assets page gives you a complete, searchable inventory of every physical item your organisation owns. Each asset receives a unique auto-generated tag (formatted as AST-0001, AST-0002, and so on), a category, a condition rating, and a status that reflects whether it is currently available, assigned, under repair, retired, or lost. When you assign an asset to an employee or a department, the assignment is recorded with a timestamp and added to the asset's full history — so you can always see who had a device and when.

Asset statuses

AvailableThe asset is in stock and ready to be assigned.
AssignedThe asset is currently with an employee or department. It cannot be assigned to anyone else until it is returned.
Under RepairThe asset has been sent for maintenance and is temporarily out of service.
RetiredThe asset is no longer in use and has been permanently decommissioned.
LostThe asset has been reported missing.

Asset conditions

NewBrand new, unused.
GoodUsed but in full working order with no significant wear.
FairFunctional but showing visible wear or minor defects.
PoorWorking but with significant wear — consider scheduling for repair or retirement.

Categories

Assets are organised by category. Eight built-in categories are available to every organisation: Laptop, Desktop, Monitor, Phone, Tablet, Peripheral, Printer, and Other. These cannot be deleted. You can create additional custom categories to match your organisation's specific equipment — for example “Server”, “Camera”, or “Vehicle”. Custom categories appear alongside the built-ins wherever a category is selected.

What you can do here

Register a new assetAssign an asset to an employee or departmentReturn an assigned assetUpdate condition or statusAdd or delete custom categoriesUpload a photoView assignment history
Step-by-stepHow to register a new asset
  1. 01
    On the Assets page, click New Asset.
  2. 02
    Enter a name for the asset (e.g. MacBook Pro 16-inch) and select its category.
  3. 03
    Set the condition and optionally enter the serial number, purchase date, and purchase price.
  4. 04
    Add any notes — for example, the order reference or any known issues.
  5. 05
    Click Create. The asset is registered with an auto-generated tag (e.g. AST-0042) and an Available status.
Step-by-stepHow to assign an asset to an employee or department
  1. 01
    Open the asset from the list — its status must be Available.
  2. 02
    Click Assign.
  3. 03
    Choose whether to assign to an employee or a department, then select from the dropdown.
  4. 04
    Click Confirm. The asset status changes to Assigned and the assignment is recorded in the asset's history with a timestamp.
Step-by-stepHow to return an assigned asset
  1. 01
    Open the asset — its status will show as Assigned.
  2. 02
    Click Return.
  3. 03
    Confirm the return. The status reverts to Available and the return is logged in the asset's history.
Step-by-stepHow to manage asset categories
  1. 01
    On the Assets page, open the Categories panel.
  2. 02
    Built-in categories are listed and cannot be deleted.
  3. 03
    To add a custom category, enter a name and click Add Category. It is immediately available when creating or editing assets.
  4. 04
    To delete a custom category, click the delete icon beside it. A category that is in use by existing assets cannot be deleted until those assets are re-categorised.
Asset photosYou can attach a photo to any asset — useful for identifying equipment at a glance. Open the asset, click the photo area, and select an image file. The upload goes directly to secure cloud storage; the asset record is updated automatically. Photos are optional and can be added or changed at any time.
Full assignment historyEvery assignment and return is preserved permanently in the asset's history — you always know who held a device, when they received it, and when it was returned. This record cannot be edited or deleted, giving you a complete audit trail for every item.
Watch out for
  • One assignment at a time: An asset can only be assigned to one employee or department at a time. To reassign it to someone else, return it first so it becomes Available again.
  • Status blocks assignment: Only Available assets can be assigned. If an asset is Under Repair, Retired, or Lost, update its status to Available before assigning it.
Coming up: Chapter 2 — The Finance Module. Ledger management, account hierarchy setup, income and expense recording, and bulk data import in Nestus AI.

Chapter Two

The Finance Module

The Finance module is your organisation's financial ledger — the permanent, auditable record of every leone that flows in and out. Every income and expense entry is classified under a structured account hierarchy, recorded against a period-based ledger, and available for review at any time.

The module has twelve pages: Dashboard, Performances, Ledgers, Income Analysis, Income Entries, Expense Analysis, Expense Entries, Transactions, Nestus Wallet, Documents, Reports, and Settings. Crucially, Finance does not live in isolation from payroll — when a payroll run is closed, Nestus AI automatically posts four approved expense entries directly into the correct Finance ledger.

Recommended Setup Order — Finance Module
01

Build your account hierarchy in Settings

Every income and expense entry must be filed under a Primary → Secondary → Tertiary → Tertiary Type chain. Set this up before recording any transactions. Payroll auto-entries create their own accounts, but your revenue and operating expense categories need to be defined manually.

02

Ensure ledger coverage for your periods

Nestus AI automatically creates a ledger for every tenant at midnight on the 1st of each month, so ongoing operations need no manual ledger creation. If you are setting up mid-year, use the Ledgers page to manually create entries for any historical months that need to receive backfilled data.

03

Record income and manual expenses

Once accounts and ledgers exist, begin recording transactions. Payroll-related expenses arrive automatically; everything else is entered manually or imported via CSV/XLSX from the Income Entries or Expense Entries pages.

Page 2.1

Dashboard

The Finance module home page — current period income, expenses, and net position, plus a monthly trend bar chart and income/expense breakdowns by account category.

The Finance Dashboard shows the current ledger period's financial position at a glance. It is the first page you see when you open the Finance module and gives you a real-time summary without needing to navigate into individual entry lists.

KPI cards

Current Period IncomeTotal income entries recorded in the active ledger period (current month). Click to navigate to Income Entries filtered to this period.
Current Period ExpensesTotal expense entries (including payroll auto-entries) in the active ledger period. Click to navigate to Expense Entries.
Net PositionIncome minus Expenses for the current period. Positive means the organisation brought in more than it spent this month; negative means the reverse.
Income Entry CountNumber of individual income entries recorded in the current period.
Expense Entry CountNumber of individual expense entries in the current period, including payroll auto-entries.

Charts

Monthly Income vs Expense Bar Chart

A grouped bar chart covering all ledger periods in the current year — purple bars for income, grey bars for expenses, side by side for each month. Hover any bar to see the exact amounts. Immediately shows which months had the highest cost or highest revenue.

Income Breakdown Pie Chart (YTD)

Year-to-date income broken down by Primary Account. Each slice represents a revenue category. Hover to see the category name and total amount. Shows where your income is coming from.

Expense Breakdown Pie Chart (YTD)

Year-to-date expenses broken down by Primary Account. Hover to see each category. Useful for seeing what share of expenses is payroll vs operating costs vs other categories.

The Dashboard reflects the active ledger periodThe KPI cards show the current active ledger (the most recent open month). Ledgers are created automatically at midnight on the 1st of every month, so the current month's ledger is always available under normal operation. If the dashboard appears to be showing an older period, check the Ledgers page — a ledger for the current month may need to be created manually if the automatic job missed a month.
AI & the Finance DashboardThe AI layer will extend the Finance Dashboard with trend detection — automatically flagging when current period income or expenses are running materially above or below the same period in prior years, and highlighting unusual movements before you would notice them manually. Income and expense forecasts (projected from your historical ledger data) will appear alongside actuals so you can compare what is happening to what the model expects.

Page 2.2

Performances

A deeper financial analytics page — period-over-period comparisons, income and expense trend charts, average monthly figures, and account-level breakdowns filterable by date range and account category.

The Performances page is the analytics layer of the Finance module. While the Dashboard shows the current period snapshot, Performances lets you analyse financial trends over custom date ranges, compare months, and drill into specific account categories. It is the page to use for management reporting and period-end review.

KPI cards

The top of the page shows three KPI cards for the current active ledger period: Total Income (with trend indicator vs prior period), Total Expenses (with trend indicator), and Net Income (income minus expenses, with a positive or negative indicator). All three also show the average monthly figure for the current year below the headline number.

Filters

Period From / ToDate range filter. Both charts and breakdowns update to show only the months within this range. Leave blank to use all available ledger periods.
Account FilterFilter the account breakdown chart by a specific Primary Account. Useful for focusing on a single category like “Revenue” or “Compensation”.

Charts

Income Trend Line Chart

Monthly income plotted as a line chart over the selected period range. Shows whether income is growing, falling, or flat month over month.

Expense Trend Line Chart

Monthly expenses plotted over the same range. Compare the slope of income vs expenses to see whether the margin is widening or compressing.

Net Income Trend Line

Net income (income minus expenses) plotted month by month. A positive line above zero means the organisation ran a surplus; dips below zero mark deficit months.

Account Breakdown Bar Chart

Income or expense amounts grouped by Primary Account for the selected period. Shows which revenue or cost categories are largest. Use the Account Filter to drill into a single category and see its secondary breakdown.

Page 2.3

Ledgers

Period-based financial containers — one per calendar month. Every income and expense entry belongs to a ledger. Payroll auto-entries post here the moment a run is closed.

Think of a ledger as a financial month. January 2025 has its own ledger; February 2025 has its own. All transactions — income, expenses, and payroll auto-entries — are recorded against the ledger that matches their period. This keeps financial records organised by time and makes period-specific reporting straightforward.

The ledger system also enforces financial integrity. If you are closing a January payroll and no January ledger exists, the payroll closes successfully — but the four automatic expense entries are silently skipped. Under normal operation this is not a concern: Nestus AI automatically creates the current month's ledger at midnight on the 1st of every month. The manual creation flow exists for historical setup — for example, if you onboarded in April and need to create ledgers for January, February, and March so that historical payroll data can be backfilled.

What you can do here

View all ledgersCreate a ledger for a historical monthOpen a ledger to view its entriesSee income and expense totals per period
Step-by-stepHow to create a ledger for a historical period
  1. 01
    On the Ledgers page, click New Ledger.
  2. 02
    Select the year and month for the period (e.g. January 2026).
  3. 03
    Click Create. The ledger is now active and ready to receive entries.
  4. 04
    Repeat for each historical month you need to cover. If you onboarded Nestus AI mid-year, create a ledger for every month from your start date to the present so that past payroll data can be backfilled correctly.
Payroll and ledgers — the critical linkWhen a payroll run is closed, Nestus AI looks up the ledger for the payroll's period month. If it finds one, it posts four approved expense entries. If the ledger does not exist, those entries are skipped without an error message. Because ledgers are created automatically at the start of every month, this is rarely an issue — but if you are closing payroll for a historical period, confirm that a ledger for that month exists before closing the run.
Watch out for
  • Missing ledger → missing payroll entries: If you close a payroll without a matching ledger, the net salary, NASSIT, NRA, and employer contribution entries are never created. To recover: create the ledger, then have a Super Admin reopen and re-close the payroll.
  • One ledger per month: Do not create duplicate ledgers for the same month — all entries for that period should live in one place.

Page 2.4

Income Analysis

A visual breakdown of all income entries — trend chart, hierarchical account table, top category rankings, and PDF/CSV export. Use this page to understand where your income is coming from.

The Income Analysis page gives you a structured view of income across the organisation. It is the analytical counterpart to Income Entries — instead of a list of individual transactions, it shows charts and summaries that let you see income by account category, track trends, and export reports for management review or audit.

KPI cards

Four summary cards across the top: total income for the current ledger period, total income YTD, the top income category (the Primary Account with the highest total), and the percentage that top category represents of total income.

Filters

Ledger PeriodScope all charts and tables to a specific ledger month. Defaults to the active ledger period.
Date From / ToOverride with a specific date range to see income across multiple ledger periods.
AccountFilter charts to a specific Primary Account to focus on one revenue stream.

Charts and tables

Income Trend (Area Chart)

Monthly income plotted as an area chart over the selected date range. Shows whether income is growing or declining.

Income by Primary Account (Bar Chart)

Total income for the period grouped by Primary Account. Each bar represents one top-level category. Click a bar to drill into that category's secondary breakdown.

Income Category Pie Chart

Percentage breakdown of income by category. Each slice is colour-coded. Hover for exact amounts.

Hierarchical Account Table

A collapsible tree table showing income totals at every level of the account hierarchy — Primary, Secondary, Tertiary, Tertiary Type. Expand any row to see the breakdown below it. This is the full drill-down view of where income was recorded.

What you can do here

View income trend chartDrill down by account categoryFilter by period or accountExport income analysis as PDF
AI & Income AnalysisIncome Analysis is where AI-powered forecasting will have the most visible impact. Based on your historical ledger data, the AI will project expected income for the next month and quarter — showing the forecast line alongside the actual trend so you can see whether income is tracking ahead or behind expectations. The AI will also flag when a specific revenue category is running materially below its historical average, prompting you to investigate before it affects cashflow.

Page 2.5

Income Entries

The working list of all income entries — add, edit, approve, and delete individual income transactions. Includes bulk import from CSV or XLSX for migrating historical data.

Income Entries is the data entry and management page for income. Every leOne your organisation earns is recorded here — one entry per transaction, filed under the correct ledger period and account chain. Entries have a status lifecycle: Pending (submitted but not yet confirmed) and Approved (confirmed and counted in all financial totals).

What you can do here

View all income entriesAdd a new income entryFilter by period, account, or statusApprove a pending entryEdit an entryDelete an entryBulk import from CSV or XLSXLink an entry to a transaction
Prerequisites
  • ·The ledger for the income period must exist before you can record the entry.
  • ·The account hierarchy must include a chain for the income type you are recording.
Step-by-stepHow to record an income entry
  1. 01
    Click Add Income on the Income Entries page.
  2. 02
    Select the ledger period (month and year) for this income.
  3. 03
    Set the date the income was received.
  4. 04
    Select the account chain: Primary → Secondary → Tertiary → Tertiary Type. Each selection narrows the next dropdown.
  5. 05
    Enter the amount.
  6. 06
    Add a clear description — include invoice numbers, client names, or project references. This is your audit trail.
  7. 07
    Click Save. The entry is created as Pending.
  8. 08
    To confirm it, click the entry and click Approve. It now counts in all financial totals.
Step-by-stepHow to bulk import income entries from CSV or XLSX
  1. 01
    Click Import on the Income Entries page.
  2. 02
    Download the import template. Fill in one row per transaction — date, amount, description, ledger period, and the full account chain. Account names must exactly match existing accounts in your hierarchy.
  3. 03
    Save as CSV or XLSX and upload the file.
  4. 04
    Review the preview. Rows with unrecognised account names or missing ledger periods are flagged.
  5. 05
    Click Confirm Import. Entries are created as Pending — review and approve them as a batch.
Watch out for
  • Wrong ledger: If a payment received in March is posted to February's ledger, your monthly financials will be wrong. Always match the ledger to when the income was actually received.
  • Bulk import: no deduplication: If you import the same file twice you get duplicate entries. Verify the import succeeded before re-trying.

Page 2.6

Expense Analysis

A visual breakdown of all expense entries — trend charts, hierarchical account table, category rankings, and export. Includes both manual expenses and the payroll auto-entries posted on each run close.

Expense Analysis mirrors Income Analysis but for expenses. It aggregates all expense entries — manual ones you recorded plus the four payroll auto-entries created on each payroll close — and presents them as charts and a hierarchical table. Use it to understand your cost structure, identify the largest expense categories, and produce management reports.

KPI cards

Total expenses for the current ledger period, total expenses YTD, the top expense category (Primary Account with the highest spend), and the percentage that category represents of total expenses.

Charts and tables

Expense Trend (Area Chart)

Monthly expenses over the selected date range. Shows how total spending is moving over time.

Expense by Primary Account (Bar Chart)

Total expenses grouped by Primary Account. Compensation-related categories (populated by payroll auto-entries) appear alongside your manually recorded operating expenses.

Expense Category Pie Chart

Percentage breakdown of expenses by category. Shows at a glance what proportion of your costs is payroll versus other operating expenses.

Hierarchical Account Table

A collapsible tree showing expense totals at every level of the hierarchy. Expand Compensation → Statutory Liabilities to see your NASSIT and NRA totals. Expand Operating Expenses to see rent, utilities, and other manual entries.

What you can do here

View expense trend chartDrill down by account categoryFilter by period or accountExport expense analysis as PDF
AI & Expense AnalysisThe AI layer will analyse your expense patterns over time to detect anomalies and trends. It will flag when an expense category is running above its historical baseline — for example if operating costs in a specific month spike significantly compared to the same month in prior years. Expense forecasts will be projected from historical data, giving Finance teams a forward view of expected costs before the period closes.

Page 2.7

Expense Entries

The working list of all expense entries — add, edit, approve, and delete individual expense transactions. Payroll auto-entries appear here alongside manual entries. Includes bulk import from CSV or XLSX.

Expense Entries holds two kinds of entries: manual entries (rent, utilities, professional fees, and any other costs you record yourself) and automatic entries (the four payroll-linked entries created each time a payroll run is closed). Both appear in the same list.

Expense entry statuses

Pending

Submitted but not yet confirmed. Manual entries start as Pending — visible in reports but reviewable before being treated as final.

Approved

Confirmed and counted in all financial summaries. Payroll auto-entries are always created as Approved — they represent obligations already incurred.

What you can do here

View all expensesAdd a manual expenseApprove a pending expenseFilter by period, account, or statusEdit an entryDelete an entryBulk import from CSV or XLSXLink an entry to a transaction
Step-by-stepHow to record a manual expense entry
  1. 01
    Click Add Expense on the Expense Entries page.
  2. 02
    Select the ledger period this expense belongs to.
  3. 03
    Set the date the expense was incurred.
  4. 04
    Select the account chain: Primary → Secondary → Tertiary → Tertiary Type.
  5. 05
    Enter the amount.
  6. 06
    Write a clear description — include the vendor, invoice number, or purpose.
  7. 07
    Click Save. The entry is created as Pending.
  8. 08
    When ready to confirm, open the entry and click Approve. The entry is counted in all financial totals.

The four payroll auto-entries

Each time a payroll run is closed, Nestus AI creates four expense entries in the Finance ledger for that period:

Auto-created on every payroll close
01

Net Salary — Payroll Disbursement

Total net pay across all employees in the run. Filed under Compensation → Salaries & Wages → Net Salary → Payroll Disbursement.

02

NASSIT Remittance

Total employee NASSIT deductions across the run. Filed under Compensation → Statutory Liabilities → NASSIT → NASSIT Remittance.

03

NRA Remittance

Total PAYE/NRA withheld across the run. Filed under Compensation → Statutory Liabilities → PAYE / NRA → NRA Remittance.

04

Employer NASSIT Contribution

Total employer-side NASSIT contributions. Filed under Compensation → Statutory Liabilities → Employer Contribution → Employer NASSIT Contribution.

Idempotent entries — payroll reopen and re-closeIf a Super Admin reopens a closed payroll and re-closes it after a correction, the system does not create duplicate expense entries. It finds the existing entries by their internal marker and updates their amounts. The Finance ledger always reflects the final, correct payroll numbers.
Watch out for
  • Do not edit auto-entry descriptions: Payroll auto-entries use an internal description marker to maintain idempotency. Editing the description means the system will create a duplicate on the next re-close instead of updating the existing entry.
  • Payroll closed before ledger created: If the Finance team forgot to create the period's ledger, the four auto-entries were never posted. Create the ledger, then have Super Admin reopen and re-close the payroll to recover them.

Page 2.8

Transactions

Link your income and expense entries to bank transactions — reconcile your financial records with actual bank movements, track approval status, and attach supporting documents.

The Transactions page is the reconciliation layer of the Finance module. It lets you create transaction records that represent actual bank movements, then link them to the corresponding income or expense entries already recorded in the system. This gives you a complete audit trail connecting your financial entries to the real-world bank activity that drove them.

KPI cards

Income TransactionsCount of all transactions linked to income entries.
Expense TransactionsCount of all transactions linked to expense entries.
Net AmountTotal income transaction amounts minus total expense transaction amounts.
Approved TransactionsCount of transactions with Approved status.
Pending TransactionsCount of transactions still awaiting approval.

What you can do here

View all transactionsCreate a new transactionLink a transaction to an income or expense entryFilter by type (income / expense)Filter by status (approved / pending)Filter by reconciliation statusAttach supporting documentsApprove a transaction

Tabs

The transactions list has three tabs: All (every transaction), Income (transactions linked to income entries only), and Expense (transactions linked to expense entries only). Use the tabs alongside the status and reconciliation filters to find the exact records you need.

Step-by-stepHow to create a transaction and link it to an entry
  1. 01
    Click New Transaction on the Transactions page.
  2. 02
    Set the transaction date and amount.
  3. 03
    Select the type: Income or Expense.
  4. 04
    Add a description (e.g. bank reference number).
  5. 05
    In the Link section, search for and select the income or expense entry this transaction corresponds to.
  6. 06
    Click Save. The transaction is created and linked to the entry.
  7. 07
    Optionally attach a supporting document (bank statement screenshot, receipt) using the Attachments section.
Reconciliation status tracks linkage completenessEach transaction has a reconciliation status: Full (amount matches the linked entry exactly), Partial (linked but amounts differ — possible split transactions), or None (no entry linked yet). Use the reconciliation filter to find unreconciled transactions before period-end.

Page 2.9

Nestus Wallet

Your organisation's Nestus Wallet — view your balance, top up funds, and track wallet transaction history. The Nestus Wallet is the source of funds for salary disbursements from the Compensation module.

The Nestus Wallet is an embedded financial account tied to your organisation within the Nestus AI platform. When salaries are disbursed from the Compensation module, the funds come from your Nestus Wallet balance. The Wallet page lets you view your current balance, top up the wallet, and review all wallet transactions.

Wallet balance card

The large card at the top of the page shows your current wallet balance in Leones. Click the eye icon to toggle the balance display between visible and hidden — useful when sharing your screen. The card also shows your total deposits and total disbursements to date.

Wallet transactions

Below the balance card is a full transaction history showing every deposit (top-up) and disbursement (salary payment) with the date, amount, and direction. The list is paginated and filterable. Each transaction shows a status — pending or completed.

What you can do here

View wallet balanceToggle balance visibilityTop up the walletView transaction historyFilter transactions by type or date
Step-by-stepHow to top up the Nestus Wallet
  1. 01
    Click Top Up on the Nestus Wallet page.
  2. 02
    Enter the top-up amount.
  3. 03
    Click Continue. You will be directed through the top-up payment flow.
  4. 04
    Once the payment is confirmed, your wallet balance updates automatically and the transaction appears in the history.
Set up a wallet before your first salary disbursementIf your organisation has never used Nestus Wallet before, the Wallet page will show a setup prompt. Complete the wallet creation flow to link your organisation to a Nestus Wallet before attempting to disburse salaries from the Compensation module.
Watch out for
  • Insufficient balance blocks disbursement: If your wallet balance is lower than the total net salary for a payroll run, the disbursement will fail. Top up the wallet before attempting disbursement, allowing time for the payment to process.

Page 2.10

Documents

The Finance module's document store — the same folder-based document management system as HR. Store financial statements, contracts, vendor invoices, bank statements, and any other finance-related files.

The Documents page in Finance shares the same underlying document library as HR and Compensation — your organisation has one unified document store accessible from all three modules. From Finance, you can create folders (e.g. “Vendor Invoices”, “Bank Statements”, “Audit Files”), upload files into them, and manage existing documents.

What you can do here

Browse document foldersCreate a new folderUpload a fileDownload a documentDelete a document
Documents are shared across HR, Compensation, and FinanceAny folder or file created in Finance Documents is immediately visible in HR Documents and Compensation Documents. The organisation has one document library — the module context you access it from is purely for navigation convenience.

Page 2.11

Reports

Financial reports with period filtering and export — performance KPIs, income and expense entry lists, and an income statement exportable as PDF. The audit-ready view of your organisation's financial activity.

The Finance Reports page aggregates financial data across periods into structured reports with PDF export. It has four tabs: Performance, Income, Expense, and Statement. All tabs respect the period filter at the top of the page (preset options like “This Month”, “Last Quarter”, or a custom date range).

What you can do here

View performance KPIs for a periodView income entries for a periodView expense entries for a periodGenerate an income statementExport any report as PDFFilter by date preset or custom rangeFilter by account level (Primary, Secondary, Tertiary)

Tab 1 — Performance

The Performance tab shows financial KPIs for the selected period: total income, total expenses, and net income. Below the KPIs are trend charts (income trend, expense trend, net income trend) and an account breakdown bar chart. Use the Account Level filter to toggle between seeing data summarised at Primary, Secondary, or Tertiary account level.

Tab 2 — Income

A filterable list of all income entries within the selected period — the same data as Income Entries but scoped to the date range you set in the report filter. Use this tab to produce a period income report for review or audit. Export as PDF to generate a branded financial document.

Tab 3 — Expense

A filterable list of all expense entries within the selected period, including payroll auto-entries. Identical in structure to the Income tab but for costs. The status filter lets you separate Approved entries from Pending ones so you can see confirmed costs vs. entries still under review.

Tab 4 — Statement

The Income Statement tab generates a formatted profit-and-loss style statement for the selected period. It groups all income and expense entries into their account hierarchy, showing subtotals at each level — Primary Account totals, then Secondary, then the overall net income at the bottom. This is the most audit-ready output in the Finance module. Export as PDF to produce a formal financial statement for management, auditors, or board review.

Period presets make common reporting periods one clickThe period filter has built-in presets: This Month, Last Month, This Quarter, Last Quarter, This Year, Last Year, and Custom Range. For monthly management reporting, “Last Month” immediately scopes all four tabs to the just-closed period without needing to enter dates manually.
AI & Financial ReportsThe AI layer will augment Finance Reports with generated narrative summaries — automatically interpreting what the numbers mean for the period rather than just displaying them. Expect to see AI-written commentary in the Statement tab (e.g. “Compensation costs grew 12% vs prior quarter, driven by the April salary run. Revenue is tracking 8% below Q2 last year across all categories”) and the ability to ask the AI assistant to explain any chart or figure in plain language directly from the Reports page.

Page 2.12

Settings

Build and manage the account hierarchy — the four-level classification system (Primary, Secondary, Tertiary, Tertiary Type) that every income and expense entry is filed under. This is the backbone of your financial categorisation.

The Finance Settings page is where you build and maintain the account hierarchy. Every income and expense entry must be assigned to an account chain — Primary → Secondary → Tertiary → Tertiary Type — and those chains are defined here. There is also a Types panel for managing any additional classification types the organisation uses.

The four hierarchy levels

Account Hierarchy — Four Levels
01

Primary Account

The broadest category. Examples: Revenue, Compensation, Operating Expenses, Assets, Liabilities. Most organisations have 4–8 primary accounts.

02

Secondary Account

Sub-categories within a primary. Under Compensation → "Salaries & Wages", "Statutory Liabilities". Under Revenue → "Service Fees", "Product Sales".

03

Tertiary Account

A further breakdown. Under Salaries & Wages → "Net Salary". Under Statutory Liabilities → "NASSIT", "PAYE / NRA", "Employer Contribution".

04

Tertiary Type

The most specific level — the actual transaction type. Under Net Salary → "Payroll Disbursement". Under NASSIT → "NASSIT Remittance".

Auto-created accounts from payroll

You do not need to create payroll-related accounts manually. When a payroll run is closed for the first time, Nestus AI automatically creates (or finds) the following chains:

Accounts created automatically on first payroll close

Net Salary — Payroll Disbursement

Compensation → Salaries & Wages → Net Salary → Payroll Disbursement

NASSIT Remittance

Compensation → Statutory Liabilities → NASSIT → NASSIT Remittance

NRA Remittance

Compensation → Statutory Liabilities → PAYE / NRA → NRA Remittance

Employer NASSIT Contribution

Compensation → Statutory Liabilities → Employer Contribution → Employer NASSIT Contribution

What you can do here

Create primary accountsCreate secondary accountsCreate tertiary accountsCreate tertiary typesBrowse the full hierarchy tree
Step-by-stepHow to add a new account category
  1. 01
    Decide where in the hierarchy the new account belongs: Primary (top-level category), Secondary, Tertiary, or Tertiary Type (most specific).
  2. 02
    Navigate to Finance → Settings → Financial Accounts.
  3. 03
    Click Add next to the relevant level.
  4. 04
    Enter the account name. If creating a Secondary, Tertiary, or Tertiary Type — select the parent account it belongs under.
  5. 05
    Click Save. The account is immediately available when recording income or expense entries.
Plan before you buildSketch your full account hierarchy before creating anything in the system. A well-structured chart of accounts makes reports meaningful; a chaotic one makes them useless. Think about how you want to see your financial data — by category, by cost centre, by expense type — and build the hierarchy to support that view from the start.
Watch out for
  • Accounts cannot be deleted once they have entries: If you record a transaction under a Tertiary Type and later find the name is wrong, you cannot delete the account. Choose names carefully from the start.
  • Don't duplicate payroll accounts: The accounts Nestus AI auto-creates for payroll should not be recreated manually. Creating duplicates splits your data between two versions, breaking reports.
Coming up: Chapter 3 — The Compensation Module. A complete guide to payroll creation, NASSIT and NRA calculations, allowances and deductions, payslip generation, and salary disbursement.

Chapter Three

The Compensation Module

Compensation is the payroll engine of Nestus AI. It takes the employee data from HR, applies your organisation's statutory rates, calculates every employee's gross and net pay, generates payslips, posts expense entries to Finance, and — with the Nestus Wallet integration — disburses salaries directly to employee accounts.

The module has ten pages: Dashboard, Payroll, Payroll Items, Payroll Item Detail, Allowances, Deductions, Bonuses, Documents, Reports, and Settings. Everything flows in one direction: from employee profile to paid salary.

Recommended Setup Order — Compensation Module
01

Configure Settings first

Set your NASSIT contribution rates, NRA PAYE tax brackets, and confirm which employment types are NASSIT-eligible. These rates are frozen into every payroll run — get them right before you run payroll for the first time.

02

Define allowance and deduction types

Create the categories your organisation uses (housing allowance, transport allowance, loan repayment, etc.) before creating payroll runs. This makes seeding more accurate since existing allowances and deductions are pre-filled per employee.

03

Review and close payroll runs

Nestus AI automatically creates a new payroll run at midnight on the 1st of every month. Once it appears, seed employees, review each item, and have a Super Admin close it. The Finance and HR integrations are fully automatic.

Payroll Run — End to End
01

Configure Settings first

Set your NASSIT contribution rates, NRA PAYE tax brackets, and confirm which employment types are NASSIT-eligible. These rates are frozen into every payroll run — get them right before you run payroll for the first time.

02

Define allowance and deduction types

Create the categories your organisation uses (housing allowance, transport allowance, loan repayment, etc.) before creating payroll runs. This makes seeding more accurate since existing allowances and deductions are pre-filled per employee.

03

Payroll run created automatically

Nestus AI opens a new payroll run at midnight on the 1st of every month. If you need to create one manually — for a historical month or a missed month — use New Payroll Run on the Payroll page.

04

Seed all employees

The system pulls every active employee, creates a payroll item for each, and pre-fills their current base salary plus any existing allowances and deductions.

05

Review and adjust items

For each employee, confirm the base salary, add one-off bonuses, adjust deductions, or override the base salary for this run only.

06

Verify gross and net pay

Each item recalculates automatically. Gross pay = base salary + allowances + bonuses. Net pay = gross − income tax (NRA) − NASSIT − deductions.

07

Close the payroll run

The Super Admin closes the run. Payslips are generated for every employee and filed in HR. Four Finance expense entries are posted automatically.

08

Disburse salaries

Via the Nestus Wallet integration, net salaries are disbursed directly to employee accounts from within the platform.

Page 3.1

Dashboard

The Compensation module home page — a year-to-date payroll summary, current run status, payroll composition breakdown, and a 5-month trend chart, all at a glance.

The Dashboard is the first page you see when you open the Compensation module. It pulls together payroll numbers from the current calendar year so you can see the financial weight of your payroll at a glance, without opening any specific run.

KPI cards

Gross Payroll (YTD)Total gross pay across all closed payroll runs this year. Includes base salary, allowances, and bonuses before any deductions. Shows percentage change vs the same period last year.
Total Deductions (YTD)Sum of all custom deductions (loan repayments, insurance, etc.) across all closed runs this year. Excludes statutory NASSIT and NRA which are shown separately.
Net Payroll (YTD)Total net pay disbursed to employees year to date — what employees actually received after all deductions and taxes.
Total Allowances (YTD)All allowance payments across all closed runs this year (housing, transport, medical, etc.).
Total Bonuses (YTD)All bonus payments across all closed runs this year (performance, 13th month, etc.).

Charts

Current Payroll Run Status

A banner showing the most recent payroll run — the period it covers (month/year) and its current status (Open or Closed). Click it to navigate directly into that run.

Payroll Composition Pie Chart

A pie chart showing how YTD gross payroll breaks down into Base Salary, Allowances, and Deductions. Hover each segment to see the exact amount and percentage.

5-Month Payroll Trend (Line Chart)

A line chart covering the last five months, showing Allowances, Bonuses, and Deductions as three separate lines. Lets you spot trends in compensation components at a glance.

Department Breakdown Bar Chart

A grouped bar chart of Allowances, Bonuses, and Deductions per department from the most recent payroll run. Useful for identifying which departments carry the highest supplemental pay costs.

Dashboard reflects closed runs onlyAll YTD figures on the Dashboard are drawn from closed payroll runs. An open or pending run does not contribute to the numbers until a Super Admin closes it. If a run you expect to see reflected is missing from the totals, check whether it has been closed.
AI & the Compensation DashboardThe AI layer will add intelligence to the payroll trend chart — detecting whether allowances, bonuses, or deductions are trending in ways that warrant attention, and flagging outliers (e.g. a department whose bonus spend jumped significantly vs the prior period) as AI-generated alerts. Over time, the AI will forecast expected gross and net payroll totals based on your headcount and historical patterns, so payroll admins have a projection to verify against before a run is closed.

Page 3.2

Payroll

The list of all payroll runs, one per period. Runs are created automatically at the start of every month — track their status and navigate into each one to manage employee items.

The Payroll page is the control centre for all payroll runs. Each row in the list is one run — a snapshot of your entire organisation's pay for a given month. Runs progress through statuses: Open (active, items can be edited), Pending (awaiting Super Admin closure), and Closed (locked, payslips generated, Finance entries posted).

Only one payroll run can be open for a given month at a time. If you need to correct a closed run, a Super Admin can reopen it — which reverts the run to Open status, making all items editable again.

What you can do here

View all payroll runsCreate a run manually (historical months)See run statusNavigate into a run's itemsFilter by month / year
Step-by-stepHow to manually create a payroll run (historical or missed months)
  1. 01
    Click New Payroll Run on the Payroll page.
  2. 02
    Select the month and year for this run (e.g. a historical month you need to backfill).
  3. 03
    Click Create. The run is created with an Open status and zero items.
  4. 04
    Click into the run to open its detail, then click Seed Employees to populate it with all active employees from HR.

Payroll run statuses

Open

The run is active. Items can be added, edited, and removed. Base salaries can be overridden. Allowances, deductions, and bonuses can be modified per item.

Closed

The run is locked. Payslips have been generated. Finance expense entries have been posted. No further edits are possible unless a Super Admin reopens the run.

Run rates are frozen at creationWhen a payroll run is created, the current NASSIT contribution rates and NRA PAYE tax brackets are copied into the run. From that point forward, changing the rates in Settings has no effect on this run. This means your historical payroll records are always accurate — re-opening a run from three months ago and closing it again does not alter the rates used for those calculations.
Watch out for
  • Finance ledger must exist for the same period: Finance ledgers are created automatically each month, so this is rarely an issue. If you are closing payroll for a historical period, verify that a ledger for that month exists in the Finance module first — otherwise the four automatic expense entries are skipped without an error.
  • Only Super Admins can close or reopen runs: Finance admins and HR admins can edit open items but cannot lock or unlock a run.

Page 3.3

Payroll Items

The individual employee lines within a payroll run. Each item represents one employee's pay for the period — base salary, allowances, deductions, bonuses, gross pay, and net pay, all in one view.

Every payroll run contains payroll items — one per employee. The Payroll Items page shows the full list for the selected run, with each row summarising an employee's gross and net pay for the period. From here you can navigate into any item for full detail, search by employee name, or bulk-review the run before closing.

What you can do here

View all items in the runSearch by employee nameSee gross and net pay per employeeNavigate to item detailSee NASSIT and NRA totalsCheck disbursement status
Step-by-stepHow to seed employees into a run
  1. 01
    Open the payroll run from the Payroll page.
  2. 02
    Click Seed Employees. The system scans HR for all active employees.
  3. 03
    A payroll item is created for each active employee, pre-filled with their current base salary and any standing allowances or deductions on their profile.
  4. 04
    Review the item list. Items for employees who joined or left mid-period may need manual review.
  5. 05
    Click into any item to make adjustments before closing the run.
Salary pulled from HR at seeding timeWhen an employee is seeded into a run, their base salary is pulled from their HR profile at that moment and stored on the payroll item. Any salary change made in HR after seeding does NOT automatically update open payroll items — the system will offer to propagate the change, but you must confirm. This protects mid-run consistency.
Watch out for
  • Employees added to HR after seeding won't appear: If a new employee is added to HR after you seed the run, they will not have a payroll item. You can manually add them or re-seed (which adds missing employees without duplicating existing ones).
  • Items inherit employment type from HR: NASSIT eligibility is determined by employment type. If an employee's type is set incorrectly in HR Settings, their NASSIT deduction will be wrong in every run until corrected.

Page 3.4

Payroll Item Detail

The full breakdown for a single employee in a payroll run — base salary, gross pay calculation, NASSIT and NRA deductions, allowances, bonuses, custom deductions, and net pay. This is where per-employee adjustments happen.

The Payroll Item Detail page is where payroll accuracy is verified and adjusted, one employee at a time. It shows the complete pay calculation — base salary, every allowance and bonus that adds to gross pay, every deduction and tax that reduces it, and the final net pay that will be disbursed.

How pay is calculated

Pay Calculation Formula
Base Salary

Set on the employee's HR profile or overridden for this run only

+ Allowances

Housing, transport, medical, and any other configured allowance types

+ Bonuses

One-off additions for this run (performance bonus, 13th month, etc.)

= Gross Pay

The taxable total before statutory deductions

− NRA / PAYE

Calculated using the frozen NRA bracket table for this run, applied to gross pay

− NASSIT

Employee NASSIT contribution — only for employment types configured as eligible

− Deductions

Loan repayments, insurance, and any other configured deduction types

= Net Pay

The amount the employee receives in their account

What you can do here

View full pay breakdownOverride base salary for this runAdd / remove allowancesAdd / remove bonusesAdd / remove deductionsView NASSIT and NRA amountsSee disbursement status
Step-by-stepHow to override the base salary for this run
  1. 01
    Open the payroll item for the employee you want to adjust.
  2. 02
    Find the Base Salary field at the top of the pay breakdown. Click the edit icon inside the input.
  3. 03
    Enter the new salary for this run.
  4. 04
    Click Save. The system recalculates gross pay, NRA, NASSIT, and net pay immediately.
  5. 05
    A note below the field confirms: "Employment record shows Le X,XXX — this change only applies to this run." The HR record is untouched.
Step-by-stepHow to add a bonus to a payroll item
  1. 01
    On the Payroll Item Detail page, navigate to the Bonuses section.
  2. 02
    Click Add Bonus.
  3. 03
    Select the bonus type (e.g. Performance Bonus, 13th Month).
  4. 04
    Enter the amount.
  5. 05
    Click Save. Gross pay and net pay recalculate immediately.
Step-by-stepHow to add a one-run deduction
  1. 01
    On the Payroll Item Detail page, navigate to the Deductions section.
  2. 02
    Click Add Deduction.
  3. 03
    Select the deduction type (e.g. Loan Repayment, Health Insurance).
  4. 04
    Enter the amount for this run.
  5. 05
    Click Save. Net pay recalculates immediately.
Base salary override is run-scopedOverriding the base salary on a payroll item changes that employee's pay for THIS run only. The HR profile retains the original salary. The override does not carry forward to future runs — each new run seeds fresh from HR. Use this for legitimate per-run adjustments like a salary advance offset, a partial month, or a temporary adjustment that hasn't yet been formalized in HR.
NASSIT eligibility is set by employment typeNASSIT is only calculated for employment types configured as eligible in HR Settings. If an employee's employment type is "Volunteer" and Volunteer is not NASSIT-eligible, their NASSIT row will show zero and the employer contribution will not be calculated. Check HR Settings if you expect NASSIT but see zero.
Watch out for
  • Net pay can be negative: If deductions exceed gross pay, net pay goes negative. This is surfaced as a warning on the item but does not prevent the run from being closed. Review all items before closure to catch this.
  • Closed items are read-only: Once the run is closed, you cannot edit any item. The Super Admin must reopen the run before corrections are possible.

Page 3.5

Allowances

Define the allowance types your organisation offers — housing, transport, medical, and any others. Once defined, they can be assigned per employee and will be pre-filled into every payroll run.

Allowances are named additions to an employee's gross pay beyond their base salary. The Allowances page is where you manage the allowance types available in your organisation. Once a type exists, it can be assigned to individual employees and will appear pre-filled in every future payroll run for those employees.

Common examples: Housing Allowance, Transport Allowance, Medical Allowance, Meal Subsidy, Communication Allowance. These vary by organisation and role — Nestus AI lets you define exactly the types that apply to your team.

What you can do here

View all allowance typesCreate a new allowance typeEdit an allowance typeView which employees have each allowanceAssign allowances to employees
Step-by-stepHow to create a new allowance type
  1. 01
    On the Allowances page, click New Allowance.
  2. 02
    Enter the allowance name (e.g. "Housing Allowance", "Transport Allowance").
  3. 03
    Click Save. The type is now available when assigning allowances to employees.
Allowances vs one-off bonusesAllowances are recurring — assigned to an employee once and pre-filled into every payroll run. Bonuses are one-off additions added per payroll item, specific to a single run. Use allowances for regular monthly additions like housing or transport; use bonuses for performance payments, 13th-month salaries, or any payment that varies run to run.
Watch out for
  • Allowances add to gross pay and are taxable: All allowances count toward gross pay and therefore increase the NRA PAYE calculation. If certain allowances are meant to be tax-exempt, this requires separate configuration — by default all allowances are included in the taxable gross.
  • Changing an allowance amount for an employee after seeding: If you update an employee's allowance amount on their HR profile after the run has been seeded, the change is NOT automatically applied to the open run. You must update the amount on the payroll item directly.

Page 3.6

Deductions

Define deduction types for recurring reductions to an employee's net pay — loan repayments, insurance premiums, pension top-ups, and any other recurring withholdings beyond statutory deductions.

Deductions are voluntary or contractual withholdings from an employee's net pay — distinct from statutory NASSIT and NRA deductions which are calculated automatically. The Deductions page is where you manage the types of deductions your organisation uses, which can then be assigned to employees and pre-filled into payroll runs.

Common examples: Loan Repayment, Health Insurance Premium, Staff Cooperative Contribution, Company Car Deduction. Define as many types as your organisation needs.

What you can do here

View all deduction typesCreate a new deduction typeEdit a deduction typeView which employees have each deductionAssign deductions to employees
Step-by-stepHow to create a new deduction type
  1. 01
    On the Deductions page, click New Deduction.
  2. 02
    Enter the deduction name (e.g. "Loan Repayment", "Health Insurance").
  3. 03
    Click Save. The type is now available when assigning deductions to employees or adding them to individual payroll items.
Deductions reduce net pay, not gross payCustom deductions (loan repayments, insurance, etc.) are applied AFTER NRA and NASSIT are calculated. They reduce net pay but do not affect the taxable gross. Statutory deductions (NASSIT and NRA) are always calculated first on gross pay — your custom deductions come after.
Watch out for
  • Deductions can drive net pay below zero: If an employee has large deductions relative to their gross pay, their net pay can become negative. Always verify items before closing. A negative net pay means the employee would owe money rather than receive a salary — this is almost always a data error.

Page 3.7

Bonuses

Define bonus types that can be applied as one-off additions to individual payroll items — performance bonuses, 13th month salary, end-of-year awards, and any other non-recurring pay additions.

Bonuses differ from allowances in one key way: they are applied per payroll item, not assigned to an employee permanently. You define the bonus types here (their names and descriptions), and then apply them to specific employees in specific payroll runs through the Payroll Item Detail page.

What you can do here

View all bonus typesCreate a new bonus typeEdit a bonus type
Step-by-stepHow to create a bonus type
  1. 01
    On the Bonuses page, click New Bonus.
  2. 02
    Enter the bonus name (e.g. "Performance Bonus", "13th Month", "Year-End Award").
  3. 03
    Click Save. The type is now available when adding bonuses to payroll items.
Bonuses are added from the payroll item, not hereThe Bonuses page only manages the types (the names and definitions). To actually pay a bonus to a specific employee in a specific run, go to Payroll Items → click the employee → Payroll Item Detail → Add Bonus. The bonus type you defined here will appear in the dropdown.
Watch out for
  • Bonuses add to gross pay and are taxable: Like allowances, bonus amounts count toward the taxable gross and will increase the NRA PAYE amount for that employee in that run. Make sure the employee's expected take-home reflects the tax impact on the bonus.

Page 3.8

Documents

The Compensation module's document store — the same folder-based document management system as HR, shared across your organisation. Store payroll reports, contract addendums, bank transfer confirmations, and any other compensation-related files.

The Documents page in Compensation is the same underlying system as HR Documents — it gives you access to your organisation's full document library, including folders created in HR. You can create new folders specific to compensation (e.g. “Payroll Reports”, “Bank Transfer Confirmations”), upload files into them, and manage existing documents.

One practical use of Compensation Documents is saving bank transfer XLSX reports directly from the Reports page. When you generate a bank transfer export in Compensation Reports, you can choose to save it directly into a Documents folder rather than (or in addition to) downloading it locally.

What you can do here

Browse document foldersCreate a new folderUpload a fileDownload a documentDelete a documentSave payroll reports here directly from Reports
Documents are shared across HR and CompensationFolders and files created in Compensation Documents are immediately visible in HR Documents, and vice versa. The organisation has one unified document library — the module context you access it from doesn't create separate storage.

Page 3.9

Reports

The Compensation reporting hub — payroll summaries, per-employee compensation breakdowns, bank transfer export files, and NASSIT/NRA statutory remittance reports.

The Reports page is where compensation data becomes actionable documents. It has three tabs: Overview, Compensations, and Allowances & Deductions. Use the month and year filters at the top to scope all three tabs to the period you need.

What you can do here

View payroll summary KPIsExport bank transfer file (XLSX)Save report to DocumentsExport NASSIT/NRA remittance reportView per-employee compensation breakdownFilter by month and year

Tab 1 — Overview

The Overview tab shows payroll summary KPIs for the selected month: total gross payroll, net payroll, total allowances, total deductions, and total bonuses. It also shows a count of payroll items and how many employees were included in the run for that month.

Tab 2 — Compensations

The Compensations tab renders a full table of all payroll items for the selected month, one row per employee. This is the bank transfer preparation view — it shows the data your finance team needs to initiate salary payments.

Configurable columns

Choose which columns appear in the table and export. Available columns: Employee Name (locked), Department, Job Title, Bank Name, Account Number, Basic Salary, Total Allowances, Total Deductions, Net Pay, Status. Toggle each column on or off using the column picker.

Bank Transfer XLSX Export

Click Export to XLSX to download the visible columns as a spreadsheet formatted for bank transfer submissions. The export respects your column selection — configure the columns to match what your bank requires before exporting.

Save to Documents

Instead of downloading locally, you can save the XLSX file directly into a Documents folder. After generating the export, click Save to Documents, enter a file name, choose the target folder, and confirm. The file appears in Compensation Documents immediately.

Step-by-stepHow to export a bank transfer file
  1. 01
    Go to Compensation → Reports → Compensations tab.
  2. 02
    Set the month and year filters to the payroll period you need.
  3. 03
    Click Columns to open the column picker. Enable Bank Name and Account Number (required for bank transfers). Enable or disable other columns to match your bank's template.
  4. 04
    Click Export to XLSX. The file downloads to your computer.
  5. 05
    Optionally click Save to Documents to also archive a copy in your document library.

Tab 3 — Allowances & Deductions

This tab breaks down allowance and deduction data for the selected period. It shows totals by type so you can see how much was paid in housing allowances, transport allowances, loan repayments, and so on. It also has the NASSIT and NRA export.

Allowance breakdown

Total amount paid per allowance type across all employees for the selected month.

Deduction breakdown

Total amount deducted per deduction type across all employees for the selected month.

NASSIT / NRA Export

Export a statutory remittance report showing employee NASSIT contributions, employer NASSIT contributions, and NRA/PAYE withheld for the selected period. Required for filing with the National Social Security and Insurance Trust and the National Revenue Authority.

Reports reflect closed runs onlyAll Report data is drawn from closed payroll runs. If the payroll for the selected month hasn't been closed yet, the Reports page will show no data for that period. Close the run first, then generate the report.
AI & Compensation ReportsThe AI layer will extend Compensation Reports with generated payroll narratives — automatically summarising what changed month-on-month (new hires added, salary adjustments applied, unusual bonus amounts, NASSIT liability changes) and flagging anything in the report that deviates from the expected range. Payroll admins will also be able to ask the AI assistant to explain any figure or produce a plain-language summary of the run, directly from the Reports page.

Page 3.10

Settings

Configure the statutory rates your organisation runs on — NASSIT contribution percentages, NRA PAYE tax brackets, and which employment types are eligible for NASSIT. These settings are frozen into every payroll run at creation time.

The Compensation Settings page is where statutory compliance lives. It has three areas: NASSIT configuration (rates and employment type eligibility), NRA configuration (PAYE tax brackets), and general compensation settings. Changes here affect future payroll runs only — existing runs retain the rates that were frozen when they were created.

What you can do here

View and edit NASSIT contribution ratesSet which employment types are NASSIT-eligibleView and edit NRA / PAYE tax bracketsAdd or remove NRA tax tiers

NASSIT Configuration

NASSIT contributions in Sierra Leone are split between the employee and the employer. In the Settings page you configure:

NASSIT Settings

Employee Contribution Rate

The percentage of gross pay deducted from the employee's pay each month (e.g. 5%). This reduces the employee's net pay.

Employer Contribution Rate

The percentage of gross pay your organisation contributes on top of the employee's pay (e.g. 10%). This is an additional organisational cost posted as a Finance expense entry on payroll close.

Employment Type Eligibility

Which employment types (Full-Time, Part-Time, Intern, Volunteer, etc.) attract NASSIT. Employees whose type is not in the eligible list have zero NASSIT deducted regardless of salary.

NRA / PAYE Configuration

NRA PAYE in Sierra Leone uses a tiered bracket system — each tier has an income threshold and a tax rate. Nestus AI applies the brackets progressively: income up to tier 1's threshold is taxed at tier 1's rate, income between tier 1 and tier 2 thresholds at tier 2's rate, and so on. The five-tier system matches Sierra Leone's current PAYE structure.

Step-by-stepHow to update a NASSIT contribution rate
  1. 01
    Go to Compensation → Settings → NASSIT section.
  2. 02
    Click the edit icon next to Employee Rate or Employer Rate.
  3. 03
    Enter the new percentage.
  4. 04
    Click Save. The new rate will apply to all payroll runs created from this point forward. Existing runs are unaffected.
Step-by-stepHow to update an NRA tax bracket
  1. 01
    Go to Compensation → Settings → NRA / PAYE section.
  2. 02
    Find the bracket you need to change — each row shows the income threshold and the tax rate for that tier.
  3. 03
    Click the edit icon on the bracket row.
  4. 04
    Update the threshold or rate as needed.
  5. 05
    Click Save. Future runs will use the updated bracket. Historical runs retain the rates frozen at their creation.
Step-by-stepHow to make an employment type NASSIT-eligible
  1. 01
    Go to Compensation → Settings → NASSIT section → Employment Type Eligibility.
  2. 02
    Find the employment type you want to make eligible (or ineligible).
  3. 03
    Toggle its eligibility status.
  4. 04
    Click Save. Future payroll runs will apply NASSIT to employees of that type. Existing open runs will recalculate NASSIT for affected employees on their next item save.
Rate changes never affect closed payrollsNestus AI freezes NASSIT rates and NRA brackets at the moment a payroll run is created. If the government changes the NASSIT contribution from 5% to 6% in July, runs created before that change continue to use 5%. Only runs created after the change use 6%. This is intentional — it ensures every closed payroll is a permanent, audit-ready record of exactly what was calculated at the time.
Watch out for
  • Verify rates before your first payroll run: Rate errors discovered after closing a run require a Super Admin reopen, recalculation of every item, and re-closure. This triggers new Finance expense entries and new payslips. Getting rates right from the start is always easier.
  • Employment type eligibility mismatch: If an employee's employment type in HR Settings doesn't match the NASSIT-eligible list in Compensation Settings, their NASSIT will always be zero — even if their contract requires it. Cross-check HR Settings and Compensation Settings employment type names.
Coming up: Chapter 4 — The Super Admin Module. A complete guide to organisation-wide oversight, payroll approval and reopen workflows, multi-tenant management, and the full reporting suite.

Chapter Four

The Super Admin Module

The Super Admin module gives organisation-level administrators a single command centre for the entire Nestus AI platform. From one place, a Super Admin can monitor all financial activity, approve or reject finance entries, access every page of every module, and manage organisation-wide settings.

The Super Admin interface has two navigation areas: a Primary Nav (Dashboard, Overview, Approvals, direct Finance page access, Documents, Reports, Settings) and a Module Nav (HR Module, Comps Module, Finance Module — each linking to the full module as if you were in that module directly). Changes made via Module Nav are identical to changes made from the module itself.

Super Admin access spans all three modulesA Super Admin user account is distinct from an HR Manager, Finance Manager, or Compensation Manager account. It is the only role that can approve or reject Finance entries, reopen a closed payroll run, and access all three modules in one session. Assign Super Admin access carefully — it carries the highest level of system authority.

Page 4.1

Dashboard

The Super Admin home — organisation-wide financial KPIs, active employee count, and a payroll trend chart. The first thing a Super Admin sees when they sign in.

The Super Admin Dashboard is a consolidated summary of the organisation's financial and workforce health. Unlike the Finance Dashboard (which focuses on ledger entries for a single period) or the Comps Dashboard (which focuses on payroll composition), the Super Admin Dashboard combines metrics from all three modules into one view.

KPI cards

Total Income (YTD)Sum of all approved income entries recorded in Finance across all ledger periods this year.
Total Expense (YTD)Sum of all approved expense entries — manual and payroll auto-entries — recorded across all ledger periods this year.
Net Income (YTD)Total income minus total expenses for the year to date. Positive means a surplus; negative means a deficit.
Gross Payroll (This Month)Total gross pay from the most recently closed payroll run. Gives a fast check on what the current month's payroll obligation is.
Pending ApprovalsCount of Finance income and expense entries waiting for Super Admin sign-off. Click this card to jump directly to the Approvals page.

Employee list and payroll chart

Below the KPI cards, the dashboard shows a list of active employees drawn from the HR module — a quick headcount view. To the right is a payroll trend line chart plotting gross payroll by month, allowing Super Admins to spot month-over-month payroll growth or anomalies at a glance.

What you can do here

View YTD financial summaryCheck pending approval countReview active employeesSee month-by-month payroll trendNavigate to Approvals from the Pending card
AI & the Super Admin DashboardThe Super Admin Dashboard is the natural home for the AI intelligence layer's highest-level output. The AI will synthesise data from HR, Finance, and Compensation into cross-module insights — surfacing things like “payroll costs rose 15% while revenue declined 8% this quarter” or “three departments are carrying headcount above their historical staffing level.” These insights will be delivered on the Dashboard as AI-generated alerts, and will be pushed as scheduled email briefings and push notifications to all Super Admin accounts.

Page 4.2

Overview

Three module overview pages — HR, Compensation, and Finance — giving a top-level summary of each module's key metrics accessible from one expandable nav section.

The Overview section in the Super Admin primary nav expands to reveal three sub-pages: HR Overview, Compensation Overview, and Finance Overview. Each is a curated summary dashboard for that module, similar to but distinct from the full module Dashboard. They are designed for a quick cross-module status check without switching to a different module session.

HR Overview

Shows total employee count (active/inactive breakdown), recent joiners, and department-level headcount. Useful for a quick workforce snapshot without navigating into the HR module.

Compensation Overview

Shows the current payroll run status, total net pay for the run, NASSIT and NRA summary figures, and a department-level payroll breakdown. Equivalent to the Comps Dashboard but accessible from Super Admin without switching modules.

Finance Overview

Shows current period income, expenses, and net position — plus a summary of pending income and expense entries awaiting approval. Equivalent to the Finance Dashboard accessible from Super Admin.

Overview vs Module Access — what's the difference?The Overview pages are read-oriented summaries. The Module Nav (HR Module, Comps Module, Finance Module at the bottom of the sidebar) gives you full access to every page of each module with complete write permissions. Use Overview for quick status checks; use Module Nav for administrative work.

Page 4.3

Approvals

The Super Admin approval queue for Finance — approve or reject income and expense entries submitted by the Finance team. Three tabs: Overview, Income Approvals, and Expense Approvals.

The Approvals page is where Super Admins review and action Finance entries that require sign-off before they are treated as confirmed. When a Finance user submits an income or expense entry, it is created with a Pending status. The Super Admin reviews it here and either approves it (making it count in all financial totals) or rejects it (returning it with a reason).

Tab 1 — Overview

A summary of the current approval queue: total pending income entries, total amount pending, total pending expense entries, and total expense amount pending. A quick read on how much financial activity is waiting for review before the period is considered complete.

Tab 2 — Income Approvals

A paginated list of all pending income entries. Each row shows the entry date, ledger period, account chain (Primary / Secondary / Tertiary / Type), amount, and the Finance user who created it. Click any entry to open its detail view, then approve or reject it with a reason.

What you can do here

View pending income entriesOpen an entry to review detailsApprove an income entryReject an income entry with a reasonFilter by period or account

Tab 3 — Expense Approvals

The same interface as Income Approvals but for expense entries. Note that payroll auto-entries are always created as Approved — they represent committed payroll obligations and are never routed through the Approvals queue. Only manual expense entries submitted by Finance users appear here.

Finance Entry Approval Lifecycle
01

Finance user creates entry

An income or expense entry is submitted from the Finance module. Status: Pending.

02

Entry appears in Approvals queue

The entry appears in the Super Admin Approvals page (Income or Expense tab) and the Pending Approvals count on the Dashboard increments.

03

Super Admin reviews

Super Admin opens the entry, checks the details (date, amount, account, description), and decides.

04

Approve → Active

The entry status changes to Approved and it counts in all Finance totals, charts, and reports.

05

Reject → Returned

The entry is returned with the rejection reason. The Finance user is notified and can correct and resubmit.

Watch out for
  • Period-end bottleneck: If the Super Admin does not clear the Approvals queue before month-end close, pending entries are excluded from that period's financial reports. Build approval review into the regular month-end routine.
  • Approvals are not reversible: Once an entry is approved, it cannot be moved back to Pending. If an approved entry contains an error, it must be deleted and re-entered.

Page 4.4

Finance Direct Access

The Super Admin primary nav includes direct links to the Finance module's Ledgers, Income, Expenses, and Transactions pages — no need to switch to the Finance module for the most commonly needed finance operations.

Four Finance module pages are surfaced directly in the Super Admin primary navigation: Ledgers, Income, Expenses, and Transactions. These render the exact same pages as Finance → Ledgers, Finance → Income Entries, Finance → Expense Entries, and Finance → Transactions. Any changes made here are instantly reflected in the Finance module.

This is the most efficient route for Super Admins who need to create a ledger for an upcoming payroll period, check a specific income entry, or review the expense entries for the current month — all without leaving the Super Admin context and navigating to a separate module session.

Same data, same permissions — just a shorter pathAccessing Finance pages from the Super Admin primary nav is functionally identical to accessing them from the Finance module. The same data, the same forms, the same permissions. The page is the same component rendered from a different entry point.

Which Finance pages are NOT in the primary nav?

The Finance Dashboard, Performances, Income Analysis, Expense Analysis, Nestus Wallet, Reports, and Settings are not linked from the Super Admin primary nav — but they are all accessible via Finance Module in the Module Nav at the bottom of the sidebar. Use Module Nav to reach those pages.

Page 4.5

Documents

The organisation's shared document library, accessed from the Super Admin context. All folders and files are visible here and shared with HR, Comps, and Finance documents pages.

The Documents page in Super Admin connects to the same organisation-wide document library as HR, Finance, and Compensation Documents. The Super Admin sees every folder and file regardless of which module created them. This is the right place to find compliance documents, HR records, financial statements, payslip archives, and any other files uploaded across the organisation.

What you can do here

Browse all document foldersCreate foldersUpload filesDownload documentsDelete documents
One library, four access pointsHR, Finance, Compensation, and Super Admin all share the same document library. A payslip saved from Compensation Reports appears in Super Admin Documents. A vendor invoice uploaded in Finance Documents appears in HR Documents. Files uploaded by any module are visible everywhere.

Page 4.6

Reports

A unified reporting hub — three tabs (HR, Compensation, Finance) embedding the full reports from each module. Super Admins can review and export any module's reports from one place.

The Super Admin Reports page is a tabbed container that embeds the full reports page from each module. No data is duplicated or re-calculated — it renders the actual HR, Compensation, and Finance report components. This means all the filters, charts, and export functions from each module's own Reports page are available here too.

Tab 1 — HR Reports

The full HR Reports page: Workforce tab (headcount by department, gender, contract type), Attendance tab (daily/monthly summaries), Leave & Holidays tab (leave balances and usage), and Compliance & Audit tab (document expiry and training completion). All period filters and PDF export buttons work the same as in the HR module.

Tab 2 — Compensation Reports

The full Comps Reports page: Overview tab (KPI summary for the selected month), Compensations tab (configurable-column table with XLSX bank transfer export and save-to-Documents), and Allowances & Deductions tab (NASSIT and NRA remittance export). Super Admins can trigger the bank transfer export from here without navigating into the Comps module.

Tab 3 — Finance Reports

The full Finance Reports page: Performance tab (KPI cards and trend charts), Income tab (filterable income entry list), Expense tab (filterable expense entry list), and Statement tab (income statement with period presets and PDF export). Super Admins commonly use this for month-end management reporting.

What you can do here

View HR workforce and attendance reportsExport bank transfer file from CompsGenerate NASSIT / NRA remittance exportExport Finance income statement as PDFReview compliance and audit reportFilter any report by period
AI & Unified ReportsBecause Super Admin Reports spans all three modules, it is the most powerful surface for AI-generated insights. The AI layer will deliver cross-module narrative summaries directly within the Reports page — for example: “Staff costs represent 78% of total expenses this quarter, up from 65% in Q2. Attendance compliance improved in three departments. Two income categories are tracking below prior-year levels.” Super Admins will also receive scheduled AI briefings by email — a weekly summary of the most significant changes across HR, Finance, and Compensation — so the most important signals reach you even when you are not signed in.

Page 4.7

Settings

Super Admin system settings — organisation profile, user management, role assignments, and any platform-level configuration that applies across all modules.

The Super Admin Settings page manages platform-level configuration that sits above individual module settings. This includes organisation profile details (name, logo, address), user account management (creating and deactivating user accounts, assigning module roles), and any system-wide options.

What you can do here

Update organisation profileManage user accountsAssign and revoke module rolesConfigure system-level options
Watch out for
  • Role changes take effect on next sign-in: If you change a user's role (e.g. upgrade from Finance Manager to Super Admin), the change takes effect the next time they sign in. Their current session retains the previous permissions.
  • Deactivated users cannot sign in: Deactivating a user account immediately prevents sign-in. Pending operations initiated by that user (like a Finance entry they submitted) remain in the system and need to be actioned by another user.

Page 4.8

HR Module Access

Super Admins can access every page of the HR module from the Module Nav — the same view an HR Manager sees, with the same data and permissions.

The Module Nav section at the bottom of the Super Admin sidebar shows three expandable groups: HR Module, Comps Module, and Finance Module. Expanding HR Module reveals links to every HR page. These are not read-only views — a Super Admin can add employees, approve leave, create departments, and do anything an HR Manager can do.

The pages are rendered by importing the HR module components directly. There is no separate “Super Admin version” of the HR pages — it's the same component. This means any change you make here is immediately visible if the HR team navigates to the same page in the HR module.

HR Module pages accessible from Super Admin

EmployeesFull employee list with add, edit, and activate/deactivate controls — same view as HR → Employees.
DepartmentsCreate and manage departments.
AttendanceMark and review attendance records for any employee.
DocumentsOrganisation-wide document library.
Leaves & HolidaysApprove leave requests, manage leave types, set public holidays.
ReportsWorkforce, attendance, and leave reports.
SettingsHR module settings — job titles, employment types, and system configuration.
HR module pages are documented in Chapter 1For full documentation of what each HR page does and how to use it, refer to Chapter 1 — The HR Module. Everything described there applies equally when accessing those pages from the Super Admin Module Nav.

Page 4.9

Compensation Module Access

Super Admins can access every page of the Compensation module from the Module Nav, including the ability to reopen a closed payroll run — the most consequential operation in the platform.

The Comps Module section in the Module Nav gives a Super Admin full access to every Compensation page. This includes the ability to create payroll runs, record allowances, deductions, and bonuses, run payroll, and — critically — reopen a closed payroll run. Reopening reverses the payroll auto-entries in Finance and returns the run to an editable state. This is only available to Super Admins.

Compensation Module pages accessible from Super Admin

DashboardYTD payroll KPIs, payroll composition charts, and 5-month trend.
PayrollPayroll run list. Super Admins can reopen a closed payroll — a destructive action that reverses the Finance auto-entries.
Payroll ItemsAll employee salary records across all runs.
AllowancesManage allowance types available to employees.
DeductionsManage deduction types (NASSIT, NRA, loans, etc.).
BonusesRecord bonuses for employees.
ReportsBank transfer export, NASSIT/NRA remittance export, and overview KPIs.
SettingsCompensation module settings — run rates (NASSIT and NRA percentages).
Watch out for
  • Reopening a payroll is destructive: When a Super Admin reopens a closed payroll run, the four Finance auto-entries (Net Salary, NASSIT Remittance, NRA Remittance, Employer NASSIT Contribution) for that period are deleted. When the corrected run is re-closed, they are recreated with the updated amounts. Only reopen if you have identified a genuine error in the closed run.
  • Payslips generated from the original close are not recalled: If payslips were already saved to Documents and distributed to employees before the reopen, those PDFs are not automatically updated. Re-generate and redistribute payslips after re-closing the corrected run.
Compensation module pages are documented in Chapter 3For full documentation of every Comps page, refer to Chapter 3 — The Compensation Module.

Page 4.10

Finance Module Access

Super Admins can access every page of the Finance module from the Module Nav — all pages not already linked in the primary nav, including Dashboard, Performances, Income Analysis, Expense Analysis, Nestus Wallet, Reports, and Settings.

The Finance Module section in the Module Nav gives access to every Finance page, including the ones not surfaced in the Super Admin primary nav (Dashboard, Performances, Analysis pages, Nestus Wallet, Reports, and Settings). This is the route for building the account hierarchy, topping up the Nestus Wallet, and accessing the full Finance income statement without switching to the Finance module.

Finance Module pages accessible from Super Admin

DashboardCurrent period income, expenses, net position, and monthly bar chart.
PerformancesPeriod-over-period financial analytics.
Income AnalysisIncome trend and hierarchical account breakdown.
Income EntriesFull income entry list with add, edit, approve, and bulk import.
Expense AnalysisExpense trend and account breakdown including payroll auto-entries.
Expense EntriesFull expense entry list including payroll auto-entries.
ReportsIncome statement, performance KPIs, income and expense entry reports.
SettingsAccount hierarchy management (Primary → Secondary → Tertiary → Tertiary Type).
Finance module pages are documented in Chapter 2For full documentation of every Finance page, refer to Chapter 2 — The Finance Module.
You've reached the end of the Nestus AI documentation. This guide covers the complete platform — HR, Finance, Compensation, and Super Admin. For product updates, new features, or to report a documentation issue, contact your Nestus AI administrator or reach out to the Manditek support team.