| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employee Contracts (hr_contract)
• Employees (hr) • Discuss (mail) • Time Off (hr_holidays) • Calendar (calendar) |
| Community Apps Dependencies | Show |
| Lines of code | 11197 |
| Technical Name |
dff_hr_payroll_data |
| License | OPL-1 |
| Website | https://www.devforfuture.com |
DFF Payroll — Master Data (Vietnam Default)
Vietnam salary rules, PIT brackets, and BHXH defaults ready to install
Data pack for companies that want Vietnam payroll salary rules on
Odoo 18 without building the rule chain from scratch. Extends
dff_hr_payroll by loading PIT (personal income tax) brackets under
Law 109/2025, social insurance related statutory parameters (including the
2026-07-01 base salary and PIT cap updates), insurance regions, payroll
structures, job defaults, and payslip input types. All records remain editable
after installation.
Tax year 2026+ (employer payroll) — Seeded for payslips from January 2026, with versioned amounts effective 2026-07-01: base salary reference 2,530,000 VND (Decree 161/2026; SI/HI cap 20×), meal PIT exemption cap 1,200,000 VND/month, and voluntary pension/life insurance deduction cap 3,000,000 VND/month (Decree 253/2026). Contract advantage templates are out of scope for this data pack.
Install order (required apps):
payroll → payroll_contract_advantages →
dff_hr_payroll → this module.
What You Gain
- Ready-to-run rule set - Salary rules from basic pay through net (including PIT and insurance-related lines) are loaded on install.
- Vietnam statutory defaults - PIT / personal income tax brackets, insurance regions, and BHXH-related parameter values are seeded for tax year 2026+, including 2026-07-01 base salary and PIT cap rows.
- Payroll structures - General, Backoffice, and Sale structures with the full Vietnam rule chain in compute order.
Loaded Data
Salary Rules and Categories
Loads the full Vietnam payslip rule chain: wage, supports, performance pay, gross, SHUI (SI/HI/UI, BHXH-related) deductions, PIT, union fee, mixed-mode employer gap, and net. Includes overtime, night shift, KPI, commission, and absence handling rules.
Payroll Structures
General, Backoffice, and Sale structures — wage, supports, and performance pay where applicable — created with the full ordered rule set ready to assign on contracts or payslip batches.
PIT and SHUI (BHXH) Defaults
Progressive PIT brackets (Law 109/2025), four insurance regions with regional minimum wages, and versioned statutory rows for BHXH-related rates and caps — including base salary 2,530,000 VND from 2026-07-01 (Decree 161/2026) and Decree 253/2026 meal / voluntary pension PIT caps.
Jobs and Input Types
Sample job positions linked to payroll structures, plus payslip input types for overtime and night-shift hours, KPI score, commission, 13th month, union fee override, and common PIT deduction inputs (charity, medical, education). Contract advantage templates are not included in this pack.
When You Need This vs. Manual Setup
Manual Setup Is Enough When...
- You already maintain your own salary rules and structures
- Your payroll policy differs significantly from Vietnam defaults
- You only need a small custom rule set for one structure
This Module Fits When...
- You want Vietnam salary rules and structures without building them from scratch
- You need seeded PIT brackets and four insurance regions on day one
- You already use the DFF Payroll core engine and need operational defaults
Scope of Delivery
Included Data
- Salary rule categories and salary rules
- Payroll structures (General / Backoffice / Sale) with ordered rules
- PIT brackets (Law 109/2025, from 2026-01-01) and four insurance regions
- Versioned statutory values: rates, GTGC, and 2026-07-01 rows (base salary 2.53M; meal / pension PIT caps per Decree 253/2026)
- Basic salary levels used by contract wage packaging
- Sample jobs and payslip input types
- Post-install default insurance region on companies
Explicit Limitations
- Data only — no new menus, models, or approval workflow
- Tax year 2026+ — not a historical pack for pre-2026 periods
- Employer payslip scope — does not compute SI agency benefit payouts (pension uplift, funeral, maternity lump sums)
- No advantage templates — out of scope for this data pack
- No accounting mappings — salary rules do not include journal account sides
- No statutory report forms — no PIT or SHUI (SI/HI/UI) export wizards are added
How It Works
Install the core engine first
dff_hr_payroll must already be installed because this module only
loads data into the core payroll setup.
Install this data module
Salary rules, structures, brackets, regions, and parameters are created automatically during installation.
Assign a structure and compute
Set a payroll structure on employee contracts, create payslips, and run Compute Sheet using the loaded rules.
Implementation Notes
- Prerequisite: Install
dff_hr_payroll(and its OCA Apps dependencies) before this data pack. - Editable data: All loaded records can be changed in Payroll configuration screens after install.
- Supports: This pack seeds SUP_* salary rules. Contract advantage / support templates are out of scope; only codes that have matching salary rules are paid on the payslip.
- Demo recommendation: Validate one payslip per structure on a test database before production use.
FAQ
I need Vietnam salary rules on Odoo Community - is this the pack?
Yes, if you already run the matching Vietnam payroll core engine on Odoo 18 with OCA Payroll. This module seeds salary rules, structures, PIT brackets, and social insurance related defaults so you do not build the full Vietnam rule chain by hand.
Does it include BHXH / social insurance and PIT formulas?
It seeds salary rules and statutory parameter values used for Vietnam personal income tax (PIT) and social insurance related deductions / employer costs. Review and adjust rates after install if your company policy or circular guidance differs.
Can I edit the loaded salary rules?
Yes. The module seeds data; administrators can change rules, structures, and parameters in the standard Payroll configuration screens.
Does this module add new screens?
No. It is a data-only package. You manage the loaded records through the menus already provided by the core payroll engine and OCA Payroll.
Which PIT law version is seeded?
Default brackets follow Vietnam Law 109/2025/QH15 (5 progressive brackets, effective 2026-01-01). This data pack targets tax year 2026 onward. Update them under Payroll → Configuration → PIT Brackets when regulations change.
Is the 2026-07-01 law update included?
Yes for employer payroll. Versioned statutory rows switch on 2026-07-01: base salary reference 2,530,000 VND (Decree 161/2026; SI/HI contribution ceiling 20×), meal allowance PIT cap 1,200,000 VND/month, and voluntary pension/life insurance deduction cap 3,000,000 VND/month (Decree 253/2026). Payslips before that date keep the prior amounts. Social insurance benefit payouts administered by the SI agency (for example pension uplift) are outside this pack.
Technical Details
Platform
- Odoo 18.0 Community Edition with OCA Payroll (primary target)
- Also installable on Enterprise when OCA Payroll is present
- XML-only data pack (no Python hooks)
- Runs inside your existing Odoo database
Required Apps
dff_hr_payroll— core payroll engine and configuration screenspayroll(via dependency) — OCA Community Payroll (LGPL-3, free)payroll_contract_advantages(via dependency) — OCA contract allowances (LGPL-3, free)- No external API or subscription service
Where It Fits
- Populates Salary Rules, Structures, and payroll configuration masters
- Uses the menus and models already delivered by the core payroll engine
- Does not change payslip workflow or add new user-facing applications
License and Publisher
- License: OPL-1
- Publisher: devluoicode
- Website: www.devforfuture.com
- Support: ngocphat.business@gmail.com
Screenshots
Payslip computation with seeded Vietnam rules
After install, a computed payslip shows wage, supports, insurance, and PIT lines driven by the seeded Vietnam salary rules and structure.
PIT brackets and statutory amounts
Review Law 109 progressive brackets or versioned statutory parameter values (personal deduction, insurance rates, base salary from 2026-07-01) in Payroll configuration.
Support and Maintenance
Installation Support
Help with installing the data pack, verifying loaded rules and structures, and assigning the right payroll structure to contracts.
Bug Fixes and Data Pack Updates
Support for defects in seeded rules or defaults. When Vietnamese payroll guidance changes, updated formulas may ship in later module versions - always review rates after upgrade.
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employee Contracts (hr_contract)
• Employees (hr) • Discuss (mail) • Time Off (hr_holidays) • Calendar (calendar) |
| Community Apps Dependencies | Show |
| Lines of code | 11197 |
| Technical Name |
dff_hr_payroll_data |
| License | OPL-1 |
| Website | https://www.devforfuture.com |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module