---
title: "Finding Your Way: SA Workspaces"
space: "Industrial Relations Documentation"
url: "http://buff0k.co.za/ir-docs/sa-user-guide/navigating-workspaces"
updated: "2026-11-01"
---

The South African localisation is part of the **Industrial Relations** app (ir), reached from one unified sidebar on the left of the desk. The SA-specific areas sit alongside ir's other sections (General, Disciplinary Matters, Attendance, Training, Setup) rather than under a separate app or tile.

![The SA VAT workspace](/files/docs-ir-workspace-sa-vat.png)

![The SA Payroll workspace](/files/docs-ir-workspace-sa-payroll.png)

## The workspaces

| Workspace | What's in it | You'll use it for |
|---|---|---|
| **IR General** | The app's home — shortcuts across all of ir | Getting oriented |
| **IR Setup** | Installation, ZA Local Setup, master/reference data | Initial setup and master data (usually a practitioner's job) |
| **SA VAT** | VAT settings, VAT201 return, VAT reports, tax templates | Day-to-day VAT and the periodic return |
| **SA Payroll** | Salary components, payroll entry, salary slips, EMP201, EMP501, IRP5, payroll reports | Running payroll |
| **SA Labour** | SETA, bargaining councils, skills (WSP/ATR), Employment Equity, business trips | Skills and EE reporting; staff travel |
| **SA COIDA** | COIDA settings, workplace injuries, OID claims, annual return | Injury records and the COIDA return |

All of these are always present — ir requires HRMS (Frappe HR), so payroll features are never turned off.

## Getting around

- **Open a workspace** from the sidebar; the cards and shortcuts inside jump to lists, new documents and reports.
- **Search** with the search bar (or press `Ctrl/Cmd + K`) and type a document name like "Sales Invoice", "Payroll Entry" or "VAT201 Return".
- **Lists** show existing records with filters at the top; **+ Add** (or **New**) creates a new one.
- **Reports** are listed in each workspace and in the global report view — see [Finding & Running Reports](/ir-docs/sa-user-guide/finding-reports).

## A typical day

- **Sales/finance user:** SA VAT workspace → raise Sales Invoices, capture Purchase Invoices, and at period-end build the VAT201 Return.
- **Payroll user:** SA Payroll workspace → Payroll Entry each month, review and submit slips, then EMP201; IRP5/EMP501 at year-end.
- **HR user:** SA Labour and SA COIDA workspaces → skills plans, EE reports, injury records.

## Next

Confirm the basics are in place before transacting: [Before You Begin](/ir-docs/sa-user-guide/before-you-begin).
