nstallation

1. Navigate to Apps

2. Find with keyword 'to_hr_payroll_contribution'

3. Install it as usual then you are done

Default Data

Upon completion of installation, the following date will be created

1. Contribution Register Categories

   1. Insurance

   2. Labor Union

2. Contribution Registers

   1. Social Insurance: bound to the contribution register Category 'Insurance' mentioned above

   2. Health Insurance: bound to the contribution register Category 'Insurance' mentioned above

   3. Unemployment Insurance: bound to the contribution register Category 'Insurance' mentioned above

   4. Labor Union: bound to the contribution register Category 'Labor Union' mentioned above

3. Payroll Contribution Types

   1. Social Insurance

      • Name: Social Insurance

      • Code: SINS

      • Employee Contribution Register: bound to the contribution register 'Social Insurance' mentioned above

      • Employee Contribution Rate: 8%, which you can modify according to the policy of your your company/country

      • Company Contribution Register: bound to the contribution register 'Social Insurance' mentioned above

      • Company Contribution Rate: 18%, which you can modify according to the policy of your your company/country

   2. Health Insurance

      • Name: Health Insurance

      • Code: HINS

      • Employee Contribution Register: bound to the contribution register 'Health Insurance' mentioned above

      • Employee Contribution Rate: 1.5%, which you can modify according to the policy of your your company/country

      • Company Contribution Register: bound to the contribution register 'Health Insurance' mentioned above

      • Company Contribution Rate: 3%, which you can modify according to the policy of your your company/country

   3. Unemployment Insurance

      • Name: Unemployment Insurance

      • Code: UEINS

      • Employee Contribution Register: bound to the contribution register 'Unemployment Insurance' mentioned above

      • Employee Contribution Rate: 1%, which you can modify according to the policy of your your company/country

      • Company Contribution Register: bound to the contribution register 'Unemployment Insurance' mentioned above

      • Company Contribution Rate: 1%, which you can modify according to the policy of your your company/country

   4. Labor Union

      • Name: Labor Union

      • Code: LU

      • Employee Contribution Register: bound to the contribution register 'Labor Union' mentioned above

      • Employee Contribution Rate: 1%, which you can modify according to the policy of your your company/country

      • Company Contribution Register: None, as we think the company has nothing to do here. But if it does, you can modify this accordingly

      • Company Contribution Rate: None, as we think the company has nothing to do here. But if it does, you can modify this accordingly

4. Payroll Data

   1. Salary Rule Categories

      • Employee Insurance (by employee): to categorize salary rules related to employee insurance contributed by employee

        • Name: Employee Insurance (by employee)

        • Code: E_INSURANCE, which you can use in other salary rules' Python code

        • Parent: Deduction

      • Employee Insurance (by company): to categorize salary rules related to employee insurance contributed by company

        • Name: Employee Insurance (by company)

        • Code: C_INSURANCE, which you can use in other salary rules' Python code

        • Parent: None

      • Labor Union (by employee): to categorize salary rules related to labor union fee contributed by employee

        • Name: Labor Union (by employee)

        • Code: E_LU, which you can use in other salary rules' Python code

        • Parent: Deduction

   2. Salary Rules

      • Social Insurance by Employee: to compute social insurance that the employee has to contribute

        • Sequence: 101

        • Code: ESINS

        • Appear on Payslip: Yes

        • Category: Employee Insurance (by employee)

        • Condition Based on: Python Expression

        • Python Condition

          result = True if payslip.hr_payslip_contrib_history_line_ids and payslip.hr_payslip_contrib_history_line_ids.filtered(lambda l: l.state in ('confirmed','resumed') and l.type_id.code == 'SINS') else False

        • Amount Type: Python

        • Python Code

          result = 0.0
          for line in payslip.hr_payslip_contrib_history_line_ids.filtered(lambda l: l.state in ('confirmed','resumed') and l.type_id.code == 'SINS'):
              rate = -1 * line.employee_contrib_rate / 100
              # if computation base is zero, category.GROSS will be used as the computation base
              result += line.contribution_base * rate if line.contribution_base else categories.GROSS * rate

        • Contribution Register: Social Insurance

      • Social Insurance by Company: to compute employee social insurance that the company has to contribute

        • Sequence: 102

        • Code: CSINS

        • Appear on Payslip: No

        • Category: Employee Insurance (by employee)

        • Condition Based on: Python Expression

        • Python Condition

          result = True if payslip.hr_payslip_contrib_history_line_ids and payslip.hr_payslip_contrib_history_line_ids.filtered(lambda l: l.state in ('confirmed','resumed') and l.type_id.code == 'SINS' and l.company_contrib_rate) else False

        • Amount Type: Python

        • Python Code

          result = 0.0
          for line in payslip.hr_payslip_contrib_history_line_ids.filtered(lambda l: l.state in ('confirmed','resumed') and l.type_id.code == 'HINS' and l.company_contrib_rate):
              rate = line.company_contrib_rate / 100
              # if line's computation base is zero, category.GROSS will be used as the computation base
              result += line.contribution_base * rate if line.contribution_base else categories.GROSS * rate

        • Contribution Register: Social Insurance

      • Unemployment Insurance by Employee: to compute employee unemployment insurance that the employee has to contribute. See Payroll > Configuration > Salary Rules > Unemployment Insurance by Employee for details

      • Unemployment Insurance by Company: to compute employee unemployment insurance that the company has to contribute. See Payroll > Configuration > Salary Rules > Unemployment Insurance by Company for details

      • Labor Union Fee by Employee: to compute employee Labor Union Fee that the employee has to contribute. See Payroll > Configuration > Salary Rules > Labor Union Fee by Employee for details

   3. Salary Structures: no new salary structure was created but the default one Base for new salary structures will be modified to add the newly created salary rules mentioned above.

Register a new Payroll Contribution for an employee

1. Navigate to Payroll > HR Payroll Contribution

2. Hit the button Create to create a new Payroll Contribution record

3. Select the employee for whom you want to register

4. Select a desired contribution type, e.g.: Social Insurance. Upon selecting, Odoo will fill the employee rate and company rate to the register.

5. By default, the computation base of the register is zero which means Odoo will use the contract's basic wage as the computation base (according to the salary rules defined above). However, you could fill another value in case you don't want the basic wage.

6. Fill the contribution number the validate the register so that it will be considered during salary computation.

How to employ Payroll Contribution Register for other purposes?

Use case 1: Fixed Allowance

1. Create a new Contribution Register Category: Payroll > Configuration > Contribution Register Category

   • Name: Fixed Allowance

   • Color: any

2. Create a new Contribution Register: Payroll > Configuration > Contribution Registers

   • Name: Fixed Allowance

   • Category: Fixed Allowance

   • Partner: None

3. Create a new Payroll Contribution Type: Payroll > HR Payroll Contribution > Payroll Contribution Type

   • Name: Fixed Allowance

   • Code: FAL

   • Employee Rate: -100%

4. Create a new Payroll Contribution Register: Payroll > HR Payroll Contribution > Payroll Contribution Register

   • Employee: select an employee for whom you want to register fixed allowance

   • Computation Base: enter the fixed amount of the allowance

   • Employee Rate: -100%

   • Date From: Select a date from which the allowance will be considered in salary computation

5. Create a new salary rule 'Fixed Allowance': Payroll > Configuration > Salary Rules

   • Name: Fixed Allowance

   • Category: Allowance

   • Code: FAL

   • Condition Based on: Python Expression

   • Python Condition

     result = True if payslip.hr_payslip_contrib_history_line_ids and payslip.hr_payslip_contrib_history_line_ids.filtered(lambda l: l.state in ('confirmed','resumed') and l.type_id.code == 'FAL') else False

   • Amount Type: Python

   • Python Code

     result = 0.0
     for line in payslip.hr_payslip_contrib_history_line_ids.filtered(lambda l: l.state in ('confirmed','resumed') and l.type_id.code == 'FAL' and l.employee_contrib_rate):
         rate = line.employee_contrib_rate / 100
         # if line's computation base is zero, category.GROSS will be used as the computation base
         result += line.contribution_base * rate if line.contribution_base else categories.GROSS * rate

6. Assign the salary rule newly created above to any salary structures that you want to get Fixed Allowance involved

Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).

Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).

Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.

Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.

PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.