هذه المقالة متاحة حاليًا باللغة الإنجليزية فقط. الترجمة قريبا.
Odoo Vietnam Localization 2026: VAT, E-Invoicing & GTGT Setup
Vietnam's tax framework is administered by the General Department of Taxation (GDT) under the Ministry of Finance, and the country has been a regional leader in mandatory e-invoicing since the rollout of Decree 123/2020/ND-CP and Circular 78/2021/TT-BTC. By 2026, every business operating in Vietnam must issue electronic invoices ("hoa don dien tu") through GDT-approved providers, with structured XML data transmitted to the tax authority. Odoo's l10n_vn localization provides the chart of accounts and VAT structure, but e-invoice integration is handled by middleware connecting to local providers such as VNPT, Viettel, MISA, or BKAV.
Key Takeaways
- General Department of Taxation (GDT) administers VAT (GTGT), CIT, and PIT under Vietnam's tax laws
- VAT (GTGT) standard rate is 10%; reduced rates of 5% and 0% (exports); 8% reduction extended through 2026
- Mandatory e-invoicing via GDT-approved providers since July 2022 — applies to all businesses
- Odoo
l10n_vncovers chart of accounts and tax structure; e-invoicing requires connector to VNPT/Viettel/MISA- Statutory reports include Form 01/GTGT (monthly VAT), Form 03/TNDN (annual CIT), and Form 02/QTT-TNCN (PIT)
- Vietnamese Accounting Standards (VAS) differ from IFRS — separate VAS-aligned chart required
Vietnam Tax Framework Overview
The General Department of Taxation enforces three primary tax types relevant to Odoo deployments: Value Added Tax (Thue Gia Tri Gia Tang, abbreviated GTGT or VAT), Corporate Income Tax (Thue Thu Nhap Doanh Nghiep, TNDN) at 20% standard rate, and Personal Income Tax (Thue Thu Nhap Ca Nhan, TNCN) for payroll. Foreign contractors face a separate Foreign Contractor Tax (FCT) regime.
VAT in Vietnam uses three positive rates: 10% (standard), 5% (essential goods such as clean water, fertilizers, medical equipment), and 0% (exports). The government has periodically reduced the 10% rate to 8% as economic stimulus; the most recent reduction has been extended through 2026 for many sectors per National Assembly resolutions. Confirm the current rate applicability with the GDT before configuring tax codes.
Companies must also follow Vietnamese Accounting Standards (VAS), which mandate the official chart of accounts in Circular 200/2014/TT-BTC. Foreign-owned enterprises must produce VAS-compliant financial statements regardless of internal IFRS reporting.
Required Odoo Localization Modules
| Module | Purpose | Edition |
|---|---|---|
l10n_vn | Vietnam chart of accounts (Circular 200) and base taxes | Community |
l10n_vn_account | VAS-aligned accounting reports (Form B01-DN, B02-DN) | Enterprise / Community |
l10n_vn_edi | E-invoice generation framework | Custom / Partner |
account_reports | Tax report engine for VAT and CIT | Enterprise |
hr_payroll_l10n_vn | PIT, social insurance, health insurance rules | Enterprise / Custom |
Odoo's official Enterprise localization for Vietnam covers VAS chart of accounts and main VAT taxes. E-invoicing is not native — every Vietnam Odoo deployment integrates with a GDT-licensed provider via API. Common partners include VNPT-Invoice, Viettel-Invoice, MISA meInvoice, BKAV eHoadon, and FPT.
Chart of Accounts Setup
VAS uses a four-digit account numbering system mandated by Circular 200/2014. Key accounts include:
- 111: Cash on hand
- 112: Cash at bank (sub-accounts per bank)
- 131: Accounts receivable
- 133: Deductible VAT input
- 156: Goods (inventory)
- 211: Tangible fixed assets
- 331: Accounts payable
- 3331: VAT payable (output VAT)
- 3334: Corporate income tax payable
- 3335: Personal income tax payable
- 511: Sales revenue
- 632: Cost of goods sold
After installing l10n_vn, verify the company record has the correct tax code (Ma so thue, 10 or 13 digits), business registration number, and registered address matching the Investment Registration Certificate (IRC) or Enterprise Registration Certificate (ERC).
VAT (GTGT) Configuration
Configure the following tax records under Accounting > Configuration > Taxes:
| Tax Name | Rate | Type | Notes |
|---|---|---|---|
| VAT 10% Output | 10% | Sales | Standard |
| VAT 8% Output (reduced) | 8% | Sales | Per current reduction resolution |
| VAT 5% Output | 5% | Sales | Essential goods |
| VAT 0% Output | 0% | Sales | Exports |
| VAT 10% Input | 10% | Purchase | Deductible |
| VAT Non-Deductible | 10% | Purchase | Marketing entertainment per CIT law |
Vietnamese law restricts VAT input deduction in specific cases — for example, certain entertainment expenses are non-deductible for both VAT and CIT. Configure separate non-deductible tax codes that post to expense rather than the input VAT receivable account.
# Example salary rule for PIT computation in Odoo payroll
result = 0
taxable = inputs.GROSS - inputs.SI - inputs.HI - inputs.UI - 11000000 # Personal allowance
brackets = [
(5000000, 0.05),
(10000000, 0.10),
(18000000, 0.15),
(32000000, 0.20),
(52000000, 0.25),
(80000000, 0.30),
(float('inf'), 0.35),
]
remaining = max(0, taxable)
prev_cap = 0
for cap, rate in brackets:
band = min(remaining, cap - prev_cap)
result += band * rate
remaining -= band
if remaining <= 0:
break
prev_cap = cap
E-Invoicing Requirements
E-invoicing in Vietnam is governed by Decree 123/2020/ND-CP and Circular 78/2021/TT-BTC. Since 1 July 2022, all enterprises must issue e-invoices through a GDT-approved provider. Two formats exist:
- E-invoices with tax authority code: Each invoice receives a code (ma cua co quan thue) from the GDT before issuance. Required for high-risk taxpayers.
- E-invoices without code (with periodic submission): The provider submits batches to the GDT within prescribed timeframes. Available for low-risk taxpayers.
The XML schema is standardized. Required fields include seller and buyer tax codes, invoice symbol (mau so, ky hieu), serial number, line items with VAT rates, and a digital signature.
Odoo integration typically follows this pattern:
- Invoice is validated in Odoo
- A connector module pushes the invoice payload (JSON or XML) to the provider's API
- Provider obtains the GDT code (if required) and signs the invoice
- Provider returns the e-invoice link, GDT code, and signed XML
- Odoo stores the link, code, and PDF as attachments on the invoice record
Custom development time for a robust e-invoice integration with one provider is usually 80-160 hours depending on workflow complexity (cancellations, replacements, adjustment invoices).
Payroll Considerations
Vietnam payroll requires three social contributions and PIT:
| Contribution | Employee | Employer | Cap |
|---|---|---|---|
| Social Insurance (BHXH) | 8% | 17.5% | 20x base salary |
| Health Insurance (BHYT) | 1.5% | 3% | 20x base salary |
| Unemployment Insurance (BHTN) | 1% | 1% | 20x regional minimum wage |
| Trade Union Fee | N/A | 2% | Same as SI cap |
PIT uses a progressive 7-bracket scale from 5% to 35%. Personal allowance is VND 11,000,000/month and dependent allowance is VND 4,400,000/month per qualifying dependent (current as of 2026). Payroll periods aligned to the Vietnamese calendar month are standard.
Reporting Requirements
A Vietnam Odoo deployment must generate:
- Form 01/GTGT: Monthly or quarterly VAT declaration (filed via eTax portal)
- Form 03/TNDN: Annual corporate income tax finalization
- Form 02/QTT-TNCN: Annual PIT finalization for employees
- Form 05/KK-TNCN: Monthly PIT declaration
- B01-DN, B02-DN, B03-DN, B09-DN: VAS financial statements (balance sheet, P&L, cash flow, notes)
- Goods Movement Reports: Per VAS inventory rules
Reports are submitted electronically through the GDT eTax portal (thuedientu.gdt.gov.vn) using digital signature tokens.
Implementation Checklist
- Obtain Tax Code (MST) and Enterprise Registration Certificate
- Sign contract with GDT-approved e-invoice provider (VNPT, Viettel, MISA, BKAV, FPT)
- Install
l10n_vn, configure company tax code, address, business activities - Verify VAS chart of accounts; add company-specific sub-accounts
- Configure all VAT rates including 8% reduction if applicable
- Build e-invoice connector to chosen provider; test with sample invoices
- Configure non-deductible VAT codes for entertainment, gifts, etc.
- Set up payroll with BHXH/BHYT/BHTN/PIT structures and 2026 thresholds
- Build VAS financial statement reports (B01-DN through B09-DN)
- Run parallel manual + Odoo VAT calculation for two months before going live
Common Pitfalls
Using IFRS chart instead of VAS: VAS is mandatory for statutory reporting. IFRS-only setups force expensive year-end remapping.
Skipping non-deductible VAT codes: Marketing, entertainment, and certain employee benefits have VAT input restrictions. Treating them as fully deductible inflates VAT refund claims and triggers GDT audits.
E-invoice provider lock-in: Some providers offer cheaper rates with closed-source connectors. Insist on documented APIs to allow provider switching.
Wrong invoice symbol format: The "mau so" (template number) and "ky hieu" (symbol) must match the registered series with the GDT. Mismatches cause invoice rejection at the GDT validation step.
Outdated PIT brackets: Personal allowance increased to VND 11M/month and dependent allowance to VND 4.4M/month. Older Odoo configurations using prior values cause under-withholding.
ECOSIRE delivers Odoo localization for Vietnam, including VAS-compliant reports and integration with major e-invoice providers. Contact us for implementation or request an Odoo audit.
Frequently Asked Questions
Which e-invoice provider works best with Odoo in Vietnam?
VNPT and Viettel offer the broadest API documentation and have been integrated with Odoo by multiple partners. MISA meInvoice is popular with SMEs. The right choice depends on your transaction volume, budget, and whether you need code-required (Type 1) or code-free (Type 2) invoices. ECOSIRE has integrated all four major providers and can advise based on your scenario.
Is the 8% VAT reduction still active in 2026?
The reduction from 10% to 8% on most goods and services has been extended multiple times through National Assembly resolutions. As of early 2026 it remains active for many sectors but with carve-outs (e.g., banking, real estate, telecom). Always check the current resolution before configuring rates and update tax codes if the reduction expires mid-year.
Does Odoo handle Vietnamese Accounting Standards (VAS)?
Odoo Enterprise's Vietnam localization ships VAS chart of accounts. Statement formats (B01-DN through B09-DN) and inventory valuation methods (perpetual or periodic) require either Enterprise's reporting engine or custom modules. Foreign-owned enterprises must produce both VAS and group-level IFRS reports — Odoo can run dual ledgers via analytic accounts.
How are foreign contractor payments taxed in Odoo?
Payments to overseas contractors trigger Foreign Contractor Tax (FCT) — typically a deemed VAT plus deemed CIT withheld at source. Configure FCT as a withholding tax on vendor bills with the appropriate split (e.g., 5% VAT + 5% CIT for services). The withheld amount is remitted via separate declarations and paid to the GDT.
Can we issue cancellation or adjustment e-invoices in Odoo?
Yes, but the workflow is provider-specific. Vietnamese e-invoice rules require either a "replacement invoice" (hoa don thay the) or "adjustment invoice" (hoa don dieu chinh) depending on whether errors are in tax-affecting fields. The connector module must implement both flows and link the new invoice to the original via the e-invoice serial.
بقلم
ECOSIRE TeamTechnical Writing
The ECOSIRE technical writing team covers Odoo ERP, Shopify eCommerce, AI agents, Power BI analytics, GoHighLevel automation, and enterprise software best practices. Our guides help businesses make informed technology decisions.
ECOSIRE
قم بتحويل أعمالك باستخدام Odoo ERP
تنفيذ وتخصيص ودعم خبير Odoo لتبسيط عملياتك.
مقالات ذات صلة
كيفية إضافة زر مخصص إلى عرض نموذج Odoo (2026)
إضافة أزرار إجراءات مخصصة إلى طرق عرض نموذج Odoo 19: طريقة إجراء Python، وعرض الميراث، والرؤية المشروطة، ومربعات حوار التأكيد. تم اختبار الإنتاج.
كيفية إضافة حقل مخصص في Odoo بدون الاستوديو (2026)
قم بإضافة حقول مخصصة عبر وحدة مخصصة في Odoo 19: وراثة النموذج، وامتداد العرض، والحقول المحسوبة، وقرارات المتجر/غير المتجر. الكود أولاً، يتم التحكم في الإصدار.
كيفية إضافة تقرير مخصص في أودو باستخدام التخطيط الخارجي
أنشئ تقرير PDF يحمل علامة تجارية في Odoo 19 باستخدام web.external_layout: قالب QWeb، تنسيق الورق، ربط الإجراء. مع طباعة الشعار + تجاوزات التذييل.