Quick facts
- Price
- $299.00 USD
- Odoo versions
- 17, 18, 19
- Setup time
- 20160 min
- License
- One-time perpetual
- Languages
- 11 languages
One-time Purchase
Vietnam Payroll Localization
Build-to-order Odoo payroll for Vietnam: SI/HI/UI insurance, PIT brackets, VND structures and meal-allowance rules.
$299.00USD
No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.
Key Features
Social insurance (BHXH) salary rules with configurable employer and employee percentages and statutory contribution ceiling, implemented as Odoo salary rules under a dedicated rule category
Health insurance (BHYT) contribution rules split employer/employee, respecting the capped insurable salary base per Vietnamese regulation
Unemployment insurance (BHTN) rules with its own ceiling and rate, computed independently from SI/HI on each payslip
Progressive Personal Income Tax (PIT) engine encoding the seven-bracket resident tax table, with taxable income derived after insurance deductions and personal/dependent relief
Personal and dependent relief allowances configurable on hr.contract, feeding @api.depends computed fields so PIT recalculates automatically when dependents change
Meal allowance localization as a distinct, tax-treated salary rule so the non-taxable portion is handled correctly and the remainder folds into taxable income
VND salary structures and structure types pre-built for common Vietnamese employment arrangements (full-time, probation, contract), assignable per employee contract
Computed contribution and tax fields using @api.depends on gross, insurable base and dependents, so no manual recalculation and no stale figures
Vietnamese-language, VND-formatted QWeb PDF payslip reports itemising SI/HI/UI, PIT and net pay for each employee
Accounting-integration variant that posts payroll journal entries to the correct account.account accounts, mapping salary, statutory contributions and net-pay liabilities
Role-scoped security via ir.model.access.csv plus record rules so only HR/Payroll users can view or edit contributions and tax figures
Configurable rate and bracket tables editable from the Odoo UI (no code redeploy) so regulatory rate changes are applied by your finance team
Optional automated actions for monthly contribution accruals and payroll-period rollover to reduce manual clicks
XML-RPC / JSON-RPC API exposure so external timekeeping or HR systems can feed inputs and retrieve computed payslip results
Batch payroll run support that computes SI/HI/UI and PIT across all employees in a period in one pass
About this Product
Vietnam Payroll Localization is a build-to-order Odoo module that ECOSIRE designs, develops, installs and supports for your specific company — it is not an instant download from apps.odoo.com. Odoo's core HR Payroll ships without Vietnam-specific salary rules, so most Vietnamese companies fall back to spreadsheets for social insurance (BHXH), health insurance (BHYT), unemployment insurance (BHTN), personal income tax (PIT) and meal-allowance handling. This module encodes those rules directly into Odoo so each payslip computes correctly, in VND, and is auditable.
Why Choose Vietnam Payroll Localization
Social insurance (BHXH) salary rules with configurable employer and employee percentages and statutory contribution ceiling, implemented as Odoo salary rules under a dedicated rule category
Health insurance (BHYT) contribution rules split employer/employee, respecting the capped insurable salary base per Vietnamese regulation
Unemployment insurance (BHTN) rules with its own ceiling and rate, computed independently from SI/HI on each payslip
Progressive Personal Income Tax (PIT) engine encoding the seven-bracket resident tax table, with taxable income derived after insurance deductions and personal/dependent relief
Personal and dependent relief allowances configurable on hr.contract, feeding @api.depends computed fields so PIT recalculates automatically when dependents change
Meal allowance localization as a distinct, tax-treated salary rule so the non-taxable portion is handled correctly and the remainder folds into taxable income
We deliver a proper Odoo addon: a clean __manifest__.py declaring dependencies on hr_payroll (and account for the accounting-integration variant), Python models extending hr.payslip, hr.contract and hr.salary.rule via models.Model, and computed fields using @api.depends so contributions and tax recalculate the moment gross pay, salary base or dependents change. Statutory ceilings and rates for SI/HI/UI, the progressive PIT bracket table, and the standard/meal-allowance categories are implemented as configurable Odoo salary rules and rule categories rather than hard-coded constants, so your finance team can adjust rates from the UI when regulations change — without a redeploy.
Access is governed the Odoo way: ir.model.access.csv grants plus record rules keep payroll data scoped to HR/Payroll roles, and QWeb PDF payslip reports render Vietnamese-language, VND-formatted documents your employees actually recognise. Optional automated actions handle recurring events (monthly contribution accruals, period rollovers), and where you already run other systems we expose the computation over Odoo's XML-RPC / JSON-RPC API so external HR or timekeeping tools can push inputs and pull results.
The module targets Odoo 17, 18 and 19 and works on both Community and Enterprise — the Enterprise HR Payroll app gives you richer batch/dashboard tooling, while Community users get the same statutory engine on the open-source hr_payroll base. Scope, salary-structure design and any integrations are agreed up front, then built, tested against your real payroll examples, and handed over with documentation, admin training and a support window. Typical lead time is 2–4 weeks depending on the number of salary structures and whether the accounting-integration variant is included.
What you get
- Complete, installable Odoo module (source code) with __manifest__.py, Python models, salary rules/categories, security CSV + record rules, XML/QWeb views and reports — packaged for your Odoo 17, 18 or 19 instance
- Configured VND salary structures, rule categories and statutory rate/bracket tables tailored to your salary components and employee types
- The accounting-integration variant wired to your chart of accounts (when selected), mapping salary, contribution and net-pay journal entries
- Installation and deployment on your environment (Community or Enterprise), with a validation run reconciled against sample payslips you provide
- Written documentation: admin configuration guide, salary-rule reference, and how to update rates/brackets when regulations change
- Live admin and HR training session plus recording, covering payslip runs, contribution/PIT review and report generation
- A post-go-live support window for bug fixes and configuration questions, with agreed response terms
- Source in a Git repository you can access, with clear versioning against the Odoo major version deployed
Who this is for
HR & Payroll Manager at a Vietnamese company
Runs monthly payroll for local staff and needs SI/HI/UI and PIT calculated correctly and defensibly. Wants to stop reconciling insurance and tax by hand in spreadsheets and instead run a single Odoo payroll batch that produces auditable, VND payslips.
Finance / Chief Accountant
Owns statutory compliance and the month-end close. Needs payroll contributions and tax posted to the correct accounts via the accounting-integration variant, and needs to adjust insurance rates or PIT brackets from the UI when the regulations are updated — without waiting on a developer.
IT / ERP administrator or Odoo partner
Maintains the Odoo deployment across 17/18/19 and cares about a clean, upgrade-safe addon: proper manifest dependencies, ir.model.access.csv security, record rules, and API access via XML-RPC/JSON-RPC so timekeeping and other systems can integrate cleanly.
Installation overview
Download from ECOSIRE
Buy the license on ecosire.com and download the Vietnam Payroll Localization module ZIP from your account dashboard.
Upload to Odoo
Extract the ZIP into your Odoo custom addons folder on the server (or upload via Apps > Install from file on Odoo.sh / runbot).
Install the module
Activate Developer Mode, open Apps, click Update Apps List, search for Vietnam Payroll Localization, and press Install.
Configure settings
Open the new menu, paste your ECOSIRE license key, connect any external credentials (Shopify, Amazon, Stripe, etc.), and save.
Verify & go live
Run the built-in connection test, sync your first 10 records, and schedule the recurring cron. Contact support if anything fails.
How Vietnam Payroll Localization Compares
| Criterion | ECOSIRE | Custom Build | Competitor | Odoo Native |
|---|---|---|---|---|
| Vietnam SI/HI/UI insurance rules with statutory ceilings | Built in as configurable Odoo salary rules per your rates | Possible but you design and maintain every rule yourself | Varies; may be generic or partial and hard to adjust | |
| Progressive PIT bracket engine (resident 7-bracket table) | Encoded with dependent/personal relief and auto-recompute | Must be researched, coded and tested from scratch | Sometimes included but often not tuned to your reliefs | |
| Meal allowance localization (taxable vs non-taxable split) | Dedicated salary rule handling the split correctly | You implement the tax treatment yourself | Frequently missing or treated as plain allowance | |
| VND salary structures for Vietnamese employment types | Pre-built and tailored to your components | Built manually per structure | Generic structures needing rework | |
| Accounting integration (journal entries to your CoA) | Optional variant mapped to your account.account setup | You wire the account moves yourself | Rarely mapped to your specific accounts | |
| Editable rates/brackets from the UI when regs change | Configurable tables — no redeploy needed | Depends on how you built it; often code changes | Often hard-coded, requires vendor update | |
| Role-scoped security (ir.model.access.csv + record rules) | Shipped and scoped to HR/Payroll roles | You must define and test all access rules | Varies by module quality | |
| Delivery, install, training and support included | ECOSIRE builds, installs, trains and supports (2–4 wks) | Your internal team or contractor owns all of it | Download only; support depends on the publisher |
Frequently Asked Questions about Vietnam Payroll Localization
+How long until the module is delivered, and what happens after I order?
This is a build-to-order module, not an instant apps.odoo.com download. Typical lead time is 2–4 weeks, depending on how many salary structures you need and whether the accounting-integration variant is included. After purchase we run a short scoping call to confirm your salary components, insurance rates, PIT relief settings and Odoo version (17, 18 or 19), then build, test against your sample payslips, install on your environment and hand over with documentation and training.
+What support and updates do I get, and what happens when insurance rates or PIT brackets change?
Your engagement includes a post-go-live support window for bug fixes and configuration questions. Because SI/HI/UI rates and PIT brackets are built as configurable salary rules and rate tables editable from the Odoo UI, your finance team can update them without a redeploy when regulations change. For larger regulatory overhauls or new statutory components, we offer a maintenance/retainer option; you also receive the full source code so any Odoo partner can maintain it.
+Does this work on Odoo Community or only Enterprise?
Both. The statutory engine (SI/HI/UI contributions, PIT, meal-allowance and VND structures) runs on the open-source hr_payroll base, so Community works. Odoo Enterprise adds richer batch, dashboard and payslip tooling on top. We target Odoo 17, 18 and 19 and confirm your exact version during scoping so the manifest and views match your release.
+Can it post payroll to our accounting, and integrate with our timekeeping system?
Yes. The accounting-integration variant adds account as a manifest dependency and posts payroll journal entries — salary expense, statutory contribution liabilities and net-pay payable — to your chart of accounts. For external systems, the module's data is available through Odoo's standard XML-RPC / JSON-RPC API, so a timekeeping or HR tool can push attendance/inputs and read computed payslip results.
+How is our payroll data kept private inside Odoo?
Access follows Odoo's security model. We ship ir.model.access.csv grants plus record rules so only users in the HR/Payroll groups can view or edit contributions, tax and salary figures — regular employees only see their own payslips. Salary rules and computed fields keep the calculation transparent and auditable rather than hidden in spreadsheets.
+Do you customise the salary structures to our company, or is it a fixed template?
It's built to your company. We start from Vietnamese statutory defaults (SI/HI/UI ceilings, the resident PIT bracket table, meal-allowance treatment) and then configure VND salary structures, rule categories and relief settings to match your actual salary components and employee types. We validate the result against real sample payslips you provide before go-live.
Why Customers Trust ECOSIRE
SOC 2 Aligned
GDPR Compliant
Secure Stripe Payment
30-Day Money Back
Lifetime Updates
LGPL-3.0 License
Related Modules
Request a quote
Vietnam Payroll Localization
Build-to-order Odoo payroll for Vietnam: SI/HI/UI insurance, PIT brackets, VND structures and meal-allowance rules.
- Social insurance (BHXH) salary rules with configurable employer and employee percentages and statutory contribution ceiling, implemented as Odoo salary rules under a dedicated rule category
- Health insurance (BHYT) contribution rules split employer/employee, respecting the capped insurable salary base per Vietnamese regulation
- Unemployment insurance (BHTN) rules with its own ceiling and rate, computed independently from SI/HI on each payslip
- Progressive Personal Income Tax (PIT) engine encoding the seven-bracket resident tax table, with taxable income derived after insurance deductions and personal/dependent relief