Industrial Relations Documentation

Industrial Relations Documentation

Weekly Notifications & Reports

ir sends three kinds of email to the recipients configured on IR Role Restrictions: weekly digests, real-time alerts and daily notices. They all use Frappe's standard transactional email layout with a coloured status dot: red means action is needed now (overdue or new), orange means a deadline is approaching, and blue is informational.

Weekly digests

Digest Covers Designation Limit Branch Limit
Fixed-term contracts expiring soon / already expired Contract of Employment - ✓
Outstanding Disciplinary Actions Disciplinary Action ✓ ✓
Outstanding Incapacity Proceedings Incapacity Proceedings ✓ ✓
Outstanding Poor Performance Poor Performance ✓ ✓
Outstanding External Disputes External Dispute Resolution - -
Employees nearing / past retirement Employee ✓ ✓
Inductions expiring soon / expired Employee Induction Record ✓ per branch trainer
Outstanding Leave Applications Leave Application ✓ ✓
Outstanding Employee Change Forms Status Change Form (including site transfers) ✓ ✓

Contract digests are deliberately branch-only: which designations someone may see isn't the same question as whose contracts they manage.

Real-time alerts

  • Disciplinary Action, Incapacity Proceedings, Poor Performance: sent to that case type's recipients as soon as a case is created, narrowed by each recipient's limits. A Disciplinary Action alert states when the accused is a shop steward (see Trade Unions & Shop Stewards).
  • NTA Enquiry: treated the same way, since it names the employee and position.
  • Status Change Form, Termination Form: sent on creation (and for Status Change Forms, on submission), now narrowed by Designation and Branch Limits like the case alerts.
  • External Dispute Resolution: sent to its recipients, unfiltered.
  • Job Requisition: sent to the Job Requisition Recipients, narrowed by Branch Limits on the requisition's site. The requester is always notified about their own request.
  • Retrenchment Process: sent to the Retrenchment Process Recipients.
  • Anonymous Report: sent only to users with the Anonymous Report Investigator role.

Daily jobs

  • Demotion reversal: reverses temporary demotions whose end date has passed and notifies the Report Recipients. See Automatic Demotion Reversal.
  • Employee termination sync: for Active employees whose Relieving Date has passed, sets the status to Left, clears them from other employees' Reports To, and disables their user account. It also disables any still-enabled user accounts of employees already marked Left.
  • SA localisation housekeeping (daily, weekly, monthly and quarterly long jobs), for example refreshing fringe-benefit statuses.

The scheduler must be enabled for any of this to run.

Last updated 2 weeks ago
Was this helpful?
Thanks!