From 9d98bb9bbd6713b1d61eb91f8f4fe10c93555dd7 Mon Sep 17 00:00:00 2001 From: larm-odoo Date: Fri, 25 Oct 2024 16:26:40 +0000 Subject: [PATCH] [ADD] Payroll: Salary attachments closes odoo/documentation#11340 X-original-commit: afe998d6a07c2721e7ffef8a14210e57b0e94250 Signed-off-by: Lara Martini (larm) --- content/applications/hr/payroll.rst | 23 +-- .../hr/payroll/salary_attachments.rst | 154 ++++++++++++++++++ .../salary_attachments/attachment-types.png | Bin 0 -> 11643 bytes .../salary-attachment-form.png | Bin 0 -> 17899 bytes 4 files changed, 157 insertions(+), 20 deletions(-) create mode 100644 content/applications/hr/payroll/salary_attachments.rst create mode 100644 content/applications/hr/payroll/salary_attachments/attachment-types.png create mode 100644 content/applications/hr/payroll/salary_attachments/salary-attachment-form.png diff --git a/content/applications/hr/payroll.rst b/content/applications/hr/payroll.rst index 90172798c..32c1993bf 100644 --- a/content/applications/hr/payroll.rst +++ b/content/applications/hr/payroll.rst @@ -665,25 +665,6 @@ field. .. _payroll/salary-attachment-types: -Salary attachment types ------------------------ - -Salary attachments, also thought of as "wage garnishments", are portions of earnings taken out of a -payslip for something specific. Much like all other aspects of payroll configurations, the types of -salary attachments **must** be defined. - -To view the currently configured salary attachments, navigate to :menuselection:`Payroll app --> -Configuration --> Salary --> Salary Attachment Types`. The default salary attachment types are -:guilabel:`Attachment of Salary`, :guilabel:`Assignment of Salary`, and :guilabel:`Child Support`. - -To make a new type of salary attachment, click the :guilabel:`New` button. Then, enter the -:guilabel:`Name`, the :guilabel:`Code` (used in the salary rules to compute payslips), and decide if -it should have :guilabel:`No End Date`. - -.. image:: payroll/new-attachment.png - :align: center - :alt: A new salary attachment form filled in. - Salary package configurator =========================== @@ -960,8 +941,9 @@ form. .. seealso:: - :doc:`payroll/contracts` - - :doc:`payroll/payslips` - :doc:`payroll/work_entries` + - :doc:`payroll/salary_attachments` + - :doc:`payroll/payslips` - :doc:`payroll/reporting` - :doc:`payroll/work_entry_analysis` - :doc:`payroll/salary_attachment` @@ -971,6 +953,7 @@ form. payroll/contracts payroll/work_entries + payroll/salary_attachments payroll/payslips payroll/reporting payroll/work_entry_analysis diff --git a/content/applications/hr/payroll/salary_attachments.rst b/content/applications/hr/payroll/salary_attachments.rst new file mode 100644 index 000000000..a8dc0f9ef --- /dev/null +++ b/content/applications/hr/payroll/salary_attachments.rst @@ -0,0 +1,154 @@ +================== +Salary attachments +================== + +Salary attachments are portions of earnings taken directly out of a payslip for a specific purpose, +whether voluntary or required. + +When the deduction is voluntary, they are typically considered *deductions*. When the deduction is +court-ordered, or involuntary, it is sometimes referred to as a *wage garnishment*. In Odoo, these +are all universally called, *salary attachments*. + +.. _payroll/salary-attachment/types: + +Salary attachment types +======================= + +To view the currently configured salary attachment types, navigate to :menuselection:`Payroll app +--> Configuration --> Salary Attachment Types`. The default salary attachment types are: +:guilabel:`Attachment of Salary`, :guilabel:`Assignment of Salary`, and :guilabel:`Child Support`. + +Each salary attachment type displays the :guilabel:`Name` of the attachment type, the +:guilabel:`Code` used when calculating payslips, a checkbox to indicate if there is :guilabel:`No +End Date`, and whether it is :guilabel:`Country` specific (or universal). + +.. image:: salary_attachments/attachment-types.png + :alt: The default salary attachment types. + +Create new salary attachment types +---------------------------------- + +.. danger:: + Upon installation of the **Payroll** application, the pre-configured default salary attachment + types are linked to a variety of rules that are linked to various salary structures, as well as + the installed :ref:`localization package `. + + It is **not** recommended to alter or modify **any** of the preconfigured salary attachment + types, especially if they have been previously used on payslips in the database. Doing so may + affect various salary rules, and can prevent the creation of payslips. + + A new salary attachment type *can* be created, but this should only be done when absolutely + necessary. All salary attachments can be associated with one of the three default salary + attachment types. + +To make a new type of salary attachment, click the :guilabel:`New` button, and a blank +:guilabel:`Salary Attachment Types` form loads. Enter the :guilabel:`Name` for the new salary +attachment type in the corresponding field. Next, enter the :guilabel:`Code` used in the salary +rules to compute payslips. Last, tick the :guilabel:`No End Date` checkbox if this salary attachment +never expires. + +If in a multi-company database, with locations in multiple countries, a :guilabel:`Country` field +also appears on the :guilabel:`Salary Attachment Types` form. Select the country the attachment +applies to, or leave blank if it is universal. + +.. _payroll/salary-attachment/create: + +Create a salary attachment +========================== + +All salary attachments must be configured separately for each employee, for each type of salary +attachment. To view the currently configured salary attachments, navigate to :menuselection:`Payroll +app --> Contracts --> Salary Attachments`. + +All salary attachments appear in a default list view, and displays the name of the +:guilabel:`Employees`, :guilabel:`Description`, the salary attachment :guilabel:`Type`, the +:guilabel:`Monthly Amount`, :guilabel:`Start Date`, and current :guilabel:`Status`. + +To create a new salary attachment, click the :guilabel:`New` button in the top-left corner, and a +blank :guilabel:`Salary Attachment` form loads. Enter the following information on the form: + +- :guilabel:`Employees`: Using the drop-down menu, select the desired employees. Multiple employees + can be listed in this field. +- :guilabel:`Description`: Enter a short description of the salary attachment. +- :guilabel:`Type`: Using the drop-down menu, select the specific :ref:`salary attachment type + `. +- :guilabel:`Start Date`: Using the calendar selector, select the date the salary attachment goes + into effect. +- :guilabel:`Estimated End Date`: This field is **not** modifiable, and **only** appears after the + :guilabel:`Monthly Amount` field is populated. This field is the estimated date when the salary + attachment will be completed. Today's date populates the field by default. Then, when the + :guilabel:`Total Amount` field is populated, this date is updated. +- :guilabel:`Document`: If any documentation is needed, such as a court order, click the + :guilabel:`Upload your file` button, and a file explorer window loads. Select the desired document + to attach it to the record. Only **one** document can be attached to a salary attachment. +- :guilabel:`Monthly Amount`: Enter the amount taken out of each paycheck every month in this field. +- :guilabel:`Total Amount`: This field **only** appears if the :ref:`salary attachment type + ` has no end date (the :guilabel:`No End Date` option is + **not** ticked.) + +.. image:: salary_attachments/salary-attachment-form.png + :alt: The salary attachment form with all fields filled out. + +Since the salary attachment form auto saves as the fields are populated, after making a salary +attachment for an individual employee, there is no further action required. + +If creating salary attachments for multiple employees on a single salary attachment form, after the +form is filled out, click the :guilabel:`Create Individual Attachments` button. This creates +separate salary attachments for each of the employees listed in the :guilabel:`Employees` field. + +After the separate salary attachments have been created, the screen returns to the :guilabel:`Salary +Attachment` dashboard, but with a :guilabel:`Description` filter, populated with the description +filled in on the salary attachment form. All the salary attachments have a status of +:guilabel:`Running`, since they are currently active. Clear the filter in the search box to view the +default :guilabel:`Salary Attachment` dashboard in its entirety. + +Manage salary attachments +========================= + +Salary attachments can have one of three statuses: *Running*, *Completed*, or *Canceled*. To view +the current status of all salary attachments, navigate to :menuselection:`Payroll app --> Contracts +--> Salary Attachments`. + +All salary attachments appear in the order they were configured. To view the salary attachments by +a particular metric, such as the :guilabel:`Status`, or :guilabel:`Type`, click on the column title +to sort by that specific column. + +Completed salary attachments +---------------------------- + +When a salary attachment is created, it has a status of :guilabel:`Running`. Once the salary +attachment is finished (the *Total Amount* entered on the :ref:`salary attachment form +` has been paid in full), the status automatically changes to +*Completed*, and the employee no longer has the money taken out of future paychecks. + +If a salary attachment has been fulfilled, but has not automatically changed to *Completed*, the +record can be manually updated. To change the status, open the *Salary Attachment* dashboard by +navigating to :menuselection:`Payroll app --> Contracts --> Salary Attachments`. + +Click on the record to update, and the detailed :guilabel:`Salary Attachment` form loads. On the +individual :guilabel:`Salary Attachment` record, click the :guilabel:`Mark as Completed` button in +the upper-left corner, and the status changes to :guilabel:`Completed`. + +.. example:: + The following is an example of when a payroll manager may need to manually change a salary + attachment from :guilabel:`Active` to :guilabel:`Cancelled`. + + Rose Smith has a salary attachment for a lawsuit settlement, where she is required to pay + $3,000.00. A salary attachment is created that takes $250.00 a month out of Rose's paycheck, to + go towards this settlement payment. + + After six months, Rose has paid $1,500.00 from her salary. She received a tax refund, and uses + the money to pay off the remainder of the lawsuit settlement. After sending the relevant + documentation to the payroll manager, showing the settlement has been paid in full, the payroll + manager manually changes the status of her salary attachment to :guilabel:`Completed`. + +Cancel salary attachments +------------------------- + +Any salary attachment can be cancelled at any time. To cancel a salary attachment, click on the +individual attachment record from the main :guilabel:`Salary Attachment` dashboard to open the +record. From the :guilabel:`Salary Attachment` record, click the :guilabel:`Cancel` button to cancel +the salary attachment, and stop having the designated money taken out of future paychecks. + +.. seealso:: + :doc:`salary_attachment` diff --git a/content/applications/hr/payroll/salary_attachments/attachment-types.png b/content/applications/hr/payroll/salary_attachments/attachment-types.png new file mode 100644 index 0000000000000000000000000000000000000000..455daca7809b7f81dc1b719673ff0cd87c5e7a3e GIT binary patch literal 11643 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 KMNUMnLSTX`7nLml literal 0 HcmV?d00001