-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #3 from navariltd/readme
Update on readme
- Loading branch information
Showing
2 changed files
with
125 additions
and
47 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,79 +1,157 @@ | ||
|
||
## NL Piece Rate Pay | ||
|
||
|
||
|
||
The Piece Rate Pay streamlines the management of casual workers' payments by providing tools for setting up activity types and linking them to specific items/products. It includes functionalities for daily attendance logging, calculating daily payouts based on attended activities, and assigning salary structures for specified timeframes. With automated rate fetching and payout calculations, this system ensures accurate and efficient payroll processing for casual workers. | ||
|
||
### 1. Set-Up | ||
|
||
|
||
|
||
**Doctypes:** | ||
|
||
- **Activity Type:** | ||
![Screenshot from 2024-04-28 07-40-42](https://github.com/navariltd/navari_csf_ke/assets/60258622/7e9a53c0-347c-452f-87bd-546934a455a1) | ||
|
||
|
||
- **Activity Type:** | ||
|
||
![Screenshot from 2024-04-28 07-40-42](https://github.com/navariltd/navari_csf_ke/assets/60258622/7e9a53c0-347c-452f-87bd-546934a455a1) | ||
|
||
|
||
|
||
Define primary tasks for casual workers, such as "Washing" or "Cleaning". | ||
|
||
- Write the 'Activity Type' name and Save. | ||
|
||
- **Casual Activity Item:** | ||
|
||
![Screenshot from 2024-04-28 08-58-46](https://github.com/navariltd/navari_csf_ke/assets/60258622/36ca612f-1e12-4f22-bd81-45a732d9665e) | ||
|
||
|
||
|
||
Link specific items/products to activity types. Set the cost per item task (e.g., washing each NETM-001 costs Ksh. 150).<br/> | ||
|
||
|
||
|
||
|
||
- Choose the Activity Type | ||
|
||
Define primary tasks for casual workers, such as "Washing" or "Cleaning". | ||
- Write activity type name and Save. | ||
- **Casual Activity Item:** | ||
![Screenshot from 2024-04-28 08-58-46](https://github.com/navariltd/navari_csf_ke/assets/60258622/36ca612f-1e12-4f22-bd81-45a732d9665e) | ||
- Choose the Item | ||
|
||
Link specific items/products to activity types. Set the cost per item manipulation (e.g., washing each NETM-001 costs Ksh. 150).<br/> | ||
- Enter the cost | ||
|
||
- Save | ||
|
||
- Choose the Activity Type | ||
- Choose the Item | ||
- Enter the cost | ||
- Save | ||
|
||
### 2. Daily Casual Payout | ||
|
||
|
||
|
||
**Doctypes:** | ||
|
||
- **Attendance:** | ||
Log daily attendance, including the type of shift worked. | ||
|
||
- **Casual Payroll Payout:** | ||
|
||
|
||
- **Attendance:** | ||
|
||
Log daily attendance, including the type of shift worked. | ||
|
||
- **Casual Payroll Payout:** | ||
|
||
![image (1)](https://github.com/navariltd/navari_csf_ke/assets/60258622/ed9bbeea-997e-41af-a462-48e3e2d87239) | ||
Has two important tables. | ||
|
||
- **Casual Payroll Payout Item:** | ||
- Select the activity type | ||
- Select Item worked on. | ||
- The system will automatically fetch the rate set in the Casual Activity Item. | ||
- Enter the quantity of items worked on that day. | ||
- Total payout for all activities is calculated automatically. | ||
- **Casual Payroll Payout Employee:** | ||
- Choose the shift type and attendance date. | ||
- Click on 'Get Employees' button. | ||
- The system retrieves employees present during the specified shift and date. | ||
- Click on 'Calculate Payout', the system then calculates the payout per employee. i.e Total Amount/Number of Employees fetched | ||
|
||
Has two important tables. | ||
|
||
- **Casual Payroll Payout Item:** | ||
|
||
- Select the activity type | ||
|
||
- Select Item worked on. | ||
|
||
- The system will automatically fetch the rate set in the Casual Activity Item(if the item has not been set in the Casual Activity Item, then uswr will get a message to go and vcreate the Activity item). | ||
|
||
- Enter the quantity of items worked on that day. | ||
|
||
- Total payout for all activities is calculated automatically. | ||
|
||
- **Casual Payroll Payout Employee:** | ||
|
||
- Choose the shift type and attendance date. | ||
|
||
- Click on 'Get Employees' button. | ||
|
||
- The system retrieves employees present during the specified shift and date.(Always ensure casuals have there separate shift). | ||
|
||
- Click on 'Calculate Payout', the system then calculates the payout per employee. i.e Total Amount/Number of Employees fetched | ||
|
||
|
||
|
||
### 3. Casual Salary Structure Assignment Tool | ||
|
||
|
||
|
||
|
||
![image (2)](https://github.com/navariltd/navari_csf_ke/assets/60258622/7fa5d17e-1ca2-475d-937c-c5580637c9cc) | ||
|
||
**Doctypes:** | ||
|
||
- **Casual Salary Structure Assignment Tool:** | ||
- Specify the date range for attendance. | ||
- Click "Calculate Payout" to sum the total amount earned by all casual workers during that period. | ||
- Assign the appropriate salary structure for the specified timeframe. | ||
- To ensure NSSF deductions, select the structure that includes NSSF contributions for the final week. | ||
- Save and submit to automatically generate salary structure assignments for each employee, with the designated salary structure. | ||
|
||
|
||
- **Casual Salary Structure Assignment Tool:** | ||
|
||
- Specify the date range for attendance. | ||
|
||
- Click "Calculate Payout" to sum the total amount earned by all casual workers during that period. | ||
|
||
- Assign the appropriate salary structure for the specified timeframe. | ||
|
||
- To ensure NSSF deductions, select the structure that includes NSSF contributions for the final week. | ||
|
||
- Save and Submit to automatically generate salary structure assignments for each employee, with the designated salary structure. The total amount the employee has worked within the specified duration becomes their base. | ||
- Once this is completed, a checkbox on the Doctype **Casual Payroll Payout** labeled _Payment Processed_ will be checked. This will prevent the creation of another Casual Salary Structure Assignment from it. | ||
However, if the salary structure is canceled, the checkbox will be unchecked, allowing for the creation of a new structure. | ||
|
||
|
||
This system simplifies the process of calculating daily and weekly payouts for casual workers, ensuring accurate payroll processing and efficient management of salary structures. | ||
|
||
|
||
|
||
## Installation | ||
|
||
### Manual Installation | ||
|
||
1. [Install bench](https://github.com/frappe/bench) | ||
|
||
2. [Install ERPNext](https://github.com/frappe/erpnext#installation) | ||
|
||
3. [Install Frappe HR](https://github.com/frappe/hrms) | ||
|
||
4. Once bench, ERPNext and Frappe HR are installed, add nl_piece_rate_pay to your bench by running | ||
```sh | ||
$ bench get-app https://github.com/navariltd/nl-piece-rate-pay.git | ||
``` | ||
Replace <i>{branch-name}</i> with any of the repository's branches | ||
5. After that, you can install the nl_piece_rate_pay app on the required site by running | ||
```sh | ||
$ bench --site {sitename} install-app nl_piece_rate_pay | ||
``` | ||
Replace <i>{sitename}</i> with the name of your site | ||
#### License | ||
AGPL | ||
|
||
```sh | ||
|
||
$ bench get-app https://github.com/navariltd/nl-piece-rate-pay.git | ||
|
||
``` | ||
|
||
If you want to get specific branch use | ||
|
||
```sh | ||
|
||
$ bench get-app https://github.com/navariltd/nl-piece-rate-pay.git --branch {branch-name} | ||
|
||
``` | ||
|
||
Replace <i>{branch-name}</i> with any of the repository's branches | ||
|
||
5. After that, you can install the nl_piece_rate_pay app on the required site by running | ||
|
||
```sh | ||
|
||
$ bench --site {sitename} install-app nl_piece_rate_pay | ||
|
||
``` | ||
|
||
Replace <i>{sitename}</i> with the name of your site. | ||
|
||
>In case you encounter any issues with installation or functionality, please raise a GitHub issue, and we will respond within one business day. | ||
>Also do a PR incase you have additional functionality that you want incoporated in the application. | ||
>Thank you. |
Empty file.