Industrial Relations Documentation

Industrial Relations Documentation

Overview

Industrial Relations (ir) extends Frappe, ERPNext and HRMS with connected processes for the whole employment relationship in a South African workplace: discipline, incapacity and poor performance, contracts and employee changes, training, disputes, workforce planning and, since version 16.10, the full South African localisation (VAT, payroll and statutory submissions, labour and COIDA) that used to be the separate za_local app.

Everything is built around the HRMS Employee record.

What you can do with it

  • Run a full disciplinary, incapacity or poor-performance process: open a case, issue a hearing notice (with a calendar invite), record the written outcome, issue a sanction, and handle an appeal. See Opening a Case.
  • Get sanction guidance from your own disciplinary code while you capture the charges.
  • Manage contracts of employment, status changes (including site transfers), terminations and leave applications as tracked, signed documents.
  • Design a site's workforce plan visually: a Shift Design roster, a reusable Site Plan, and a Site Organogram populated from it. Cost it with a Site Budget and track fill rates on the Branch Staffing Dashboard.
  • Track inductions, licences and qualifications with the Training Compliance Dashboard and automatic expiry reminders.
  • Manage external disputes (CCMA, Labour Court and others), trade unions and shop stewards, and receive anonymous reports through a public whistleblower form.
  • Run KPI reviews, extend HRMS Job Requisitions, and produce the HR Exception Report for management.
  • Prepare Section 189 retrenchment processes (in preview).
  • Use the South African localisation: VAT201, SA payroll, EMP201/EMP501/IRP5, ETI, fringe benefits, SETA and skills reporting, Employment Equity and COIDA. See SA Localisation.
  • Keep access and notifications consistent: Designation Limits, Branch Limits, a Responsible IR override and an own-case exclusion decide who sees what, in the app and in every email.

The data model in one paragraph

Every process is ultimately about one Employee. A Disciplinary Action, Incapacity Proceedings or Poor Performance case names the employee; the NTA Enquiry, Written Outcome, sanction and appeal all link back to that case. A Contract of Employment, Status Change Form (including a site transfer) or Termination Form describes a change to that employee's own record. The Site Organogram and Site Budget describe a site's structure and cost rather than one person, but real employees are slotted into organogram positions.

Where to go next

All screenshots and videos use a fictional company (Demo Mining Co (Pty) Ltd) and fictional employees.

Last updated 2 weeks ago
Was this helpful?
Thanks!