User Manual HR & Payroll module Version 1.0 · Stable

Payslips manual

The payslip automatically calculates the transition from gross to net in accordance with Tunisian regulations: CNSS (employee & employer shares), CSS and IRPP by brackets (brought to a monthly basis). Individual or bulk generation, then payment and transfer order.

3
Legal deductions
6
Gross → net steps
2
Statuses (Paid / Not)
÷12
Monthly IRPP
1

Overview

The Payslips screen produces the monthly payslip for each employee. When a payslip is opened, Swifto calculates all the components (prorated gross, CNSS, taxable salary, CSS, IRPP, net); the possible entries (overtime, public holidays, bonuses, fines, advances) recalculate the net in real time. The list is grouped by month.

Business goal

  • Calculate the compliant net payable
  • Apply CNSS, CSS and IRPP automatically
  • Bulk-generate for the entire workforce
  • Pay and produce the transfer order

Target audience

  • Payroll manager — generates & adjusts payslips
  • Accounting — payment & transfers
  • Declarations — basis for the social reports

Position in the module

The payslip relies on the employee record (marital status, children) and the contract (base pay, work schedule). It then feeds the social declarations.

2

Access and navigation

Left-hand side menu: Human resourcesPayslips.

Swifto ERP — Human resources menu
Global dashboard
Human resources
Employees
Leave management
Payslips
Declarations of employees and salaries
Advances on salaries
Sales
Need help? Click here...
The list of payslips opens on the right after the click.
3

Payslip list

The list is grouped by month. Each row shows the employee, days worked, gross salary, net, net payable, status (Paid / Not paid) and the payment date.

Human resources › Payslips
Human resources
Employees
Payslips
Declarations of employees and salaries
Sales
Mrs Sonia TRABELSI
Manage payslips
Payment Transfer order New Search
EmployeemonthDaysGross salaryNet salaryNet payableStatus
April 2026
Mohamed Ali GHARBIApril 202626 / 26 days2,400.000TND1,932.480TND1,932.480TNDPaid
Ines BEN SALAHApril 202626 / 26 days1,600.000TND1,345.600TND1,145.600TNDNot paid

Table columns

ColumnDescription
EmployeeEmployee concerned by the payslip.
MonthMonth / year of the payroll (list grouping).
DaysDays worked / business days of the month.
Gross salaryProrated base + overtime + bonuses.
Net salaryGross − employee CNSS − CSS − IRPP.
Net payableNet − advances − fines + exceptional bonuses.
StatusPaid or Not paid (+ payment date).
4

Action bar

New

Generates a payslip for a given employee (month / year).

Bulk generation

Produces in one go the payslips for the entire workforce for a month.

Payment

Marks the selected payslips as paid (date, currency, account).

Transfer order

Exports a multiple transfer order (Excel) for the bank.

5

Payslip detail — gross → net engine

When a payslip is opened, Swifto automatically calculates all the components. The possible entries (overtime, unworked public holidays, bonuses, fines, advances) recalculate the net in real time.

Payslip — April 2026
Payslip
Mohamed Ali GHARBI
April / 2026
Married · 3 children
2,400.000
26 / 26 days
0.0
0.000
2,400.000
1,932.480
1,932.480
Details — employee & employer shares
DesignationRatesBaseEmployee shareEmployer's share
Gross salary2,400.0002,400.000
CNSS9,18 % / 16,57 %2,400.000220.320397.680
Taxable salary2,179.680
CSS0,5 %2,179.68010.898
IRPPscale2,168.782236.302
Net salary: 1,932.480 TND

The Bonuses, Fines / Suspensions and Advances fields only appear for entry if there is an amount concerning them for the month (see Bonuses, allowances & advances).

6

CNSS, CSS & IRPP — the sequence

CNSS

Social security contribution: employee share withheld + employer share (employer charge), calculated on the gross.

CSS

Social Solidarity Contribution: configurable rate applied to the taxable base, then ÷ 12.

IRPP

Income tax by brackets on the annual taxable base, brought to the month (÷ 12).

Calculation sequence

1. Gross = prorated base (days/hours) + overtime + bonuses − unpaid days
2. Employee CNSS + employer CNSS (on the gross)
3. Taxable salary = Gross − employee CNSS (− professional expenses)
4. CSS = rate × taxable, then ÷ 12
5. IRPP = bracket scale (annual) ÷ 12
6. Net = Gross − employee CNSS − CSS − IRPP

The IRPP bracket scale

IRPP is calculated on the annual taxable salary by applying the progressive scale (brackets from the tax table), then divided by 12 for the monthly deduction. The deductions (head of household, children) are deducted before the scale is applied.

The amounts in the screenshots are illustrative examples. The applied CNSS, CSS rates and IRPP scale depend on the tax table in force (configurable per year).

Dependent children — special cases (IRPP)

Before applying the IRPP scale, Swifto subtracts the deductions for dependent children. Two situations qualify for an increased deduction: the disabled child and the child pursuing higher education without receiving a scholarship. The number of children concerned is entered on the employee record.

Substitution, not accumulation

The increased deduction for a disabled child or a child in higher education replaces that child's ordinary deduction — it is not added to it. This is a substitution rule, in accordance with article 40 of the Tunisian IRPP Code.

Worked example — 3 dependent children

An employee has 3 dependent children, including 1 in higher education. Assume an ordinary deduction of 100.000 TND per child per year, and an increased higher-education deduction of 1,000.000 TND per year (illustrative values — see the year's tax table).

• Child 1 (ordinary) ......... 100.000
• Child 2 (ordinary) ......... 100.000
• Child 3 (higher ed.) ...... 1,000.000  ← replaces the ordinary 100.000
Total children deduction = 1,200.000 TND / year

Compare with 3 × 100.000 = 300.000 TND if the 3 children were ordinary. The increase applies only to the child concerned; the other two keep their rank deduction. This total is subtracted from the annual taxable salary before the scale is applied, which reduces the IRPP due.

The same rule applies to a disabled child: their increased deduction replaces their ordinary deduction. Enter the number of disabled children and children in higher education on the employee record; Swifto applies the substitution automatically when calculating the payslip.

The gross↔net simulation available from the employee record uses exactly the same engine as the actual generation.

7

Generation & payment

Payroll is generated employee by employee or for the entire workforce (bulk generation), then paid and turned into a bank transfer order.

Bulk generation

Entire workforce

Choose the month/year: Swifto produces all the payslips at once. Then adjust case by case if needed.

Payment

Mark as paid

Select payslips then fill in the date, currency and payment account. The status changes to Paid.

Transfer order

Excel export

Produces an Excel file of the multiple transfer order to send to the bank.

PDF payslip

Document

Generates the payslip in PDF (per-row action) to give to the employee.

8

Payslip statuses

StatusMeaning
Not paidPayslip generated, net payable awaiting settlement.
PaidPayslip settled: payment date, currency and account filled in.

Only generated and validated payslips feed the social declarations for the period.

9

Lifecycle (workflow)

flowchart LR
  A([Employee + Contract]):::s --> B[Payslip generation
Gross to Net]:::p B --> C([CNSS employee + employer]):::st B --> D([CSS]):::st B --> E([IRPP scale /12]):::st C --> F[Net payable]:::p D --> F E --> F F -->|payment| G([Paid + transfer]):::ok F --> H[Social declarations]:::p classDef p fill:#F5F3FF,stroke:#8B5CF6,color:#5B21B6; classDef s fill:#f3f1ff,stroke:#7366fe,color:#1f1c3d; classDef st fill:#FEF3C7,stroke:#F59E0B,color:#92400E; classDef ok fill:#D1FAE5,stroke:#10B981,color:#065F46;
10

Business rules

IRPP by brackets — the tax is calculated on the annual taxable salary by applying the progressive scale, then divided by 12 for the monthly deduction.

CNSS & CSS — CNSS separates an employee share (withheld) and an employer share (employer charge), both on the gross. CSS applies to the taxable base at a configurable rate, brought to the month.

Child deductions by substitution — a disabled child or a child in higher education has their "raised to" deduction replace (and not add to) their rank deduction. Details on the Employees page.

Simulation = generation — the gross↔net simulation (employee record) and the actual generation use the same engine: no discrepancy.

Tax table — CNSS/CSS rates and IRPP scale depend on the year's tax table. Incorrect configuration distorts all the calculations.

11

Roles & permissions

ActionManagerHR managerAccountantAdmin
View payslips
Generate (individual / bulk)
Adjust a payslip
Payment / transfer
PDF payslip
Delete

Indicative matrix — the actual rights depend on the profiles defined in your company.

12

Usage scenarios

Monthly payroll for the entire workforce

Bulk generation for the month → case-by-case review → grouped PaymentTransfer order Excel sent to the bank.

Employee with an advance

An advance for the month is automatically deducted from the net payable of the corresponding payslip.

Overtime

Entering overtime on the payslip increases the gross and instantly recalculates the net.

13

FAQ & Tips

The calculated net does not match my expectations?

Check the year's tax table (CNSS/CSS rates, IRPP scale) and the dependent children (disabled / higher ed. by substitution).

A bonus / advance does not appear on the payslip?

Make sure it is entered for the same month/year as the payslip, and for the right employee. The field only shows if an amount exists.

How to generate payroll for the entire workforce?

Use bulk generation (icon ) from the list, then adjust case by case if needed.

Tip — check before paying

After a bulk generation, review the atypical payslips (overtime, fines, advances) before launching the payment and the transfer order.

Swifto

Swifto ERP · HR & Payroll module · User Manual v1.0

Payslips — HR & Payroll module · Home