- Home
- Apps
- SaaS Tools
- Vietnam Payroll Localization
Illustrative previewBuild-to-order Odoo payroll for Vietnam:
SI/HI/UI insurance, PIT brackets, VND structures and meal-allowance rules.
What is Vietnam Payroll Localization?
Build-to-order Odoo payroll for Vietnam: SI/HI/UI insurance, PIT brackets, VND structures and meal-allowance rules. Built to order by ECOSIRE for Odoo 17, 18, 19 — indicative price from $999.00 USD; request a quote for a scoped proposal.
Key Features
Built to order, done for you
No DIY setup — a working app, built, installed and supported by ECOSIRE.
- 1
You order
Start with a one-time build price. We scope it with you at kickoff.
- 2
We build & install
ECOSIRE builds, configures and installs it on your Odoo.
- 3
Go live + support
You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.
Technical Specifications
- Odoo Compatibility
- Odoo 17, Odoo 18, Odoo 19
- Editions
- Enterprise & Community
- License
- Licence confirmation required
- Python Requirement
- Python 3.10+
- Database
- PostgreSQL 12+
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.
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 one working week 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.
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 | Not included |
| 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 | Not included |
| 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 | Not included |
| VND salary structures for Vietnamese employment types | Pre-built and tailored to your components | Built manually per structure | Generic structures needing rework | Partial support |
| 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 | Partial support |
| 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 | Not included |
| 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 | Partial support |
| 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 | Not included |
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 one working week, 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.
Related Modules

UStVa Export für ELSTER Basic
A build-to-order Odoo module that generates ELSTER-compatible XML for the German Umsatzsteuervoranmeldung (UStVa), mapping your Odoo tax lines to the correct Kennziffern for upload. Scoped, built, installed and supported by ECOSIRE — this is not an off-the-shelf download.

Vendor Post-Dated Cheque (PDC) Management
Manage outgoing vendor post-dated cheques in Odoo with PDC payment entries, clearing journals, due-date alerts and full cheque lifecycle tracking.

Wallee Payment Provider for Odoo
A made-to-order Odoo payment provider that connects your Wallee space to native checkout, with hosted or inline card entry, TWINT and PostFinance support, tokenization, refunds and automatic reconciliation. ECOSIRE builds, installs and supports it after a scoping call.
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
