Odoo Community
Odoo Enterprise
Viindoo Cloud
Contribution bases and caps that depend on where the employee works
Per administrative region and contribution type: minimum and maximum contribution base, maximum employee and company contribution. The contract picks its region from the employee and the payslip caps the contributions.
Payroll By Administrative Regions (technical name viin_hr_payroll_administrative_region) is an Odoo 17.0 app for Odoo Community and Odoo Enterprise and Viindoo Cloud, built for payroll officer, hr, employee.
At a Glance
The facts of Payroll By Administrative Regions, version 0.1.1, in one place. Published by Viindoo.
Technical name
viin_hr_payroll_administrative_region
Odoo version
17.0 (Odoo Community, Odoo Enterprise, Viindoo Cloud)
Category
Human Resources/Payroll
Depends on
to_hr_payroll, viin_administrative_region
Adds
1 new model, 9 extended models
Best for
Payroll officer; HR; Employee
Not for
The rule table on the contract shows in developer mode.
Key features
Region x contribution type rules with bases and caps, Region on employee and contract, kept in sync, Matching rules listed on the contract, Caps stored in contribution history, Payslip contributions limited to the caps, Default caps on the contribution type
How It Works
Create the rules; set the region on employees; compute payslips.
1
The rules
Tier 1 and Tier 2 rules for the three insurances.
2
A rule
Bases and caps for one region and type.
3
On the contract
Region and the matching rules.
4
On the employee
Where the contract reads it from.
What You Get
Region x contribution type rules with bases and caps
Region on employee and contract, kept in sync
Matching rules listed on the contract
Caps stored in contribution history
Payslip contributions limited to the caps
Default caps on the contribution type
More Screens
Everything below was taken on a database seeded with real business data, on this series - not a mock-up and not a screenshot from an older version.
Contribution type defaults
What This App Does Not Do
Read this before you buy. Everything below is something the app deliberately leaves to another app or to you.
The rule table on the contract shows in developer mode.
The values apply regardless.
Caps apply only when greater than zero.
Zero means no cap.
Regions must be assigned by hand.
No address lookup.
Works Well With
Apps from the same stack, built to fit this one:
Who Should Use Payroll By Administrative Regions?
Payroll officer
Caps by region without formulas.
HR
Sets the region once on the employee.
Employee
The right deduction for the city.
Frequently Asked Questions
What does Payroll By Administrative Regions do?
Per administrative region and contribution type: minimum and maximum contribution base, maximum employee and company contribution. The contract picks its region from the employee and the payslip caps the contributions.
What does Payroll By Administrative Regions not do?
The rule table on the contract shows in developer mode. The values apply regardless. Caps apply only when greater than zero. Zero means no cap. Regions must be assigned by hand. No address lookup.
Who is Payroll By Administrative Regions for?
Payroll officer: Caps by region without formulas. HR: Sets the region once on the employee. Employee: The right deduction for the city.
Which Odoo version and editions does it support?
Odoo 17.0 - Odoo Community, Odoo Enterprise, Viindoo Cloud. Upgrades to a newer Odoo series are a separate purchase for that series.
What does it depend on?
It installs on top of: to_hr_payroll, viin_administrative_region. Odoo installs them with it.
How do I set it up?
Create the rules; set the region on employees; compute payslips.
What works well with it?
Administrative Region (viin_administrative_region): The regions. Payroll (to_hr_payroll): The contributions.
Can I try it before buying?
Yes - the Live Preview button at the top of this page opens the module's own screen on a working database.
How do I get support?
Write to apps.support@viindoo.com with your Odoo version and the technical name viin_hr_payroll_administrative_region; pre-sales questions go to sales@viindoo.com.
Need help with Payroll By Administrative Regions?
For questions, implementation support or a custom feature, contact Viindoo.
Upgrades to a newer Odoo series are a separate purchase for that series.
All Viindoo apps: apps.odoo.com/apps/modules/browse?author=Viindoo
About Viindoo. Viindoo builds and maintains more than 1,000 apps on the Odoo App Store for the Community and Enterprise editions and runs them on Viindoo Cloud. A purchase of Payroll By Administrative Regions covers the 17.0 series: bug fixes on the module reach you through the store, questions go to apps.support@viindoo.com with the technical name viin_hr_payroll_administrative_region, and moving to a newer Odoo series is a separate purchase for that series. Source code is delivered with the module and stays yours to read and adapt.
Technical Requirement
Editions: Odoo Community, Odoo Enterprise, Viindoo Cloud
Changes log
0.1.1 - Latest on the 17.0 line
- Aligned with the 17.0 models and views.
Cài đặt
- Truy cập Ứng dụng;
- Tìm từ khóa viin_hr_payroll_administrative_region;
- Bấm chọn Cài đặt.
Hướng dẫn sử dụng
1. Thiết lập mức lương tối thiểu theo vùng
Truy cập Bảng lương ‣ Cấu hình ‣ Thiết lập, chọn Mở Vùng hành chính, sau đó ấn Tạo để tạo các vùng hành chính theo quốc gia và thiết lập mức lương tối thiểu tương ứng:
2. Thiết lập cơ sở đóng góp tối thiểu/tối đa
Truy cập Bảng lương ‣ Cấu hình ‣ Thiết lập, chọn Mở Đóng góp từ lương theo vùng hành chính để tạo các đóng từ lương theo vùng hành chính tương ứng:
Thiết lập các cơ sở đóng góp và mức đóng góp:
- Cơ sở đóng góp tối thiểu: Mức tối thiểu để làm cơ sở tính toán các khoản đóng góp từ lương. Nếu mức lương đóng bảo hiểm thấp hơn mức tối thiểu thì các khoản đóng góp sẽ được tính dựa theo mức tối thiểu.
- Cơ sở đóng góp tối đa: Mức tối đa để làm cơ sở tính toán các khoản đóng góp từ lương. Nếu mức lương đóng bảo hiểm cao hơn mức tối đa thì các khoản đóng góp sẽ được tính dựa theo mức tối đa.
- Đóng góp tối đa bởi nhân viên: Khoản trích đóng góp từ lương tối đa mà nhân viên phải đóng. Nếu khoản đóng góp bởi nhân viên được tính toán cao hơn mức này thì khoản trích đóng góp thực tế sẽ bằng khoản đóng góp tối đa này. Đặt bằng 0 nếu không có quy định.
- Đóng góp tối đa bởi công ty: Khoản trích đóng góp tối đa mà công ty phải đóng. Nếu khoản đóng góp của công ty được tính toán cao hơn mức này thì khoản trích đóng góp thực tế sẽ bằng khoản đóng góp tối đa này. Đặt bằng 0 nếu không có quy định.
3. Áp dụng trên hợp đồng nhân viên
Truy cập Bảng lương ‣ Nhân viên ‣ Hợp đồng để lựa chọn một hợp đồng có sẵn hoặc tạo mới. Tại tab Ghi nhận đóng góp, lựa chọn Vùng hành chính tương ứng cho nhân viên, sau đó lựa chọn các Kiểu đóng góp từ lương:
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.