Skip to content

Migration Guide to Frappe HR version 15

Rucha Mahabal edited this page Oct 24, 2023 · 1 revision

Payroll Loans

ERPNext has separated the loan module into a separate app Frappe Lending in v15.

How does this change affect you?

From v15 onwards, loan management in payroll is a soft dependency in Frappe HR so you don't need to install this app if you are not using loans. In that case, this change won't affect you.

If you are using salary slip loans, then you need to install Frappe Lending app on your site for loan integration with payroll after upgrading to v15.

Email Notifications in Leave

This is a functional behaviour change in v15.

Until v14, leave notifications used to be sent to the employee's User ID. This forces users to create User IDs for every employee. From v15 onwards, prefered email field from the employee master will be used for sending emails and other fields would be used as fallback emails.

Review the prefered email field if you have set it in the employee master. Now, the user ID field will only be considered if you don't have prefered email set in the employee record.

Leave Encashment

https://github.com/frappe/hrms/pull/817

Encashment Threshold Days renamed to Non-Encashable Leaves

image

If you are using encashment_threshold_days anywhere in your custom code, make sure to use non_encashable_leaves fieldname instead.

Encashment calculation

Until v14, leave encashment used to auto-calculate encashable days and this field was not editable. v15 onwards, 2 different fields have been introduced:

  • Actual Encashable Days (actual_encashable_days): These would be auto-calculated by the system just like before
  • Encashment Days (encashment_days): These are set equal to Actual Encashable Days by default but user is now allowed to edit this

The encashable_days field be copied to the above fields on update to v15 but if you are using any custom code, make sure you change the fieldnames.

image