Skip to main content
Vietnam Payroll Localization — Build-to-order Odoo payroll for Vietnam: SI/HI/UI insurance, PIT brackets, VND structures and  — 1/1Illustrative preview

Build-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

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

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your Odoo.

  3. 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

CriterionECOSIRECustom BuildCompetitorOdoo Native
Vietnam SI/HI/UI insurance rules with statutory ceilingsBuilt in as configurable Odoo salary rules per your ratesPossible but you design and maintain every rule yourselfVaries; may be generic or partial and hard to adjustNot included
Progressive PIT bracket engine (resident 7-bracket table)Encoded with dependent/personal relief and auto-recomputeMust be researched, coded and tested from scratchSometimes included but often not tuned to your reliefsNot included
Meal allowance localization (taxable vs non-taxable split)Dedicated salary rule handling the split correctlyYou implement the tax treatment yourselfFrequently missing or treated as plain allowanceNot included
VND salary structures for Vietnamese employment typesPre-built and tailored to your componentsBuilt manually per structureGeneric structures needing reworkPartial support
Accounting integration (journal entries to your CoA)Optional variant mapped to your account.account setupYou wire the account moves yourselfRarely mapped to your specific accountsPartial support
Editable rates/brackets from the UI when regs changeConfigurable tables — no redeploy neededDepends on how you built it; often code changesOften hard-coded, requires vendor updateNot included
Role-scoped security (ir.model.access.csv + record rules)Shipped and scoped to HR/Payroll rolesYou must define and test all access rulesVaries by module qualityPartial support
Delivery, install, training and support includedECOSIRE builds, installs, trains and supports (2–4 wks)Your internal team or contractor owns all of itDownload only; support depends on the publisherNot 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.

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

Request a Quotation

Tell us about your Vietnam Payroll Localization requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.