Loan Management - Vietnam Accounting
| Lines of Code | 496 |
| Technical name | l10n_vn_viin_loan_management |
| License | OPL-1 |
| Website | https://viindoo.com/apps/app/18.0/l10n_vn_viin_loan_management |
| Read description for | v 10.0 v 11.0 v 12.0 v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 |
| Required Apps | Invoicing (account) Discuss (mail) |
| Included Dependencies | Viindoo Base Accounting Foundation Vietnam Chart of Accounts - Circular 99 and 133 Loan Management |
Vietnam accounting, built into Loan Management
This localization sets the correct Vietnamese default accounts on every loan contract - borrowing to 3411, lending to 1283 - so your loan bookkeeping follows Circular 99/2025/TT-BTC (TT99/C99) out of the box.
Start a 15-day free trial
Why It Matters
Correct default accounts, automatically
Borrowing contracts default to account 3411 "Các khoản đi vay" and lending contracts to 1283 "Cho vay", with the matching control accounts (635, 515, 331, 133). No manual account setup per contract.
Zero configuration
The localization installs automatically with Loan Management on a Vietnamese company and backfills existing loan setups. There is nothing to switch on.
Aligned with TT99/C99
Account codes and names follow the current Vietnamese corporate accounting regime (Circular 99/2025/TT-BTC), so loan entries stay compliant.
Key Features
Borrowing loan default accounts
3411 + control accounts 331 / 635 / 133.
Lending loan default accounts
1283 + control accounts 131 / 515 / 333.
Loan-interest product category
Default expense 635 and income 515 accounts.
Auto-activation with backfill
Installs with the loan app on a VN company, no setup.
Who Should Use This?
Any Vietnamese business using Loan Management that wants loan accounting to follow the national chart of accounts without manual account mapping.
Loan Management - Vietnam Accounting
Loan Management - Vietnam Accounting is a small bridge module. It adds no menu, no screen, and no setting of its own. Once installed, it quietly connects two other apps so that any company using a Vietnam Chart of Accounts gets the correct default accounts on its loan contracts, with nothing to configure.
What it does
When a company's Chart of Accounts is VN - Circular No. 99/2025/TT-BTC or VN - Circular No. 133/2016/TT-BTC, this module fills in, automatically:
- The Loan Account used on Borrowing Loan Contracts - account 3411 (Các khoản đi vay).
- The Loan Account used on Lending Loan Contracts - account 1283 (Cho vay), or 1288 for a company on Circular 133.
- The Default Account and the Allowed accounts (the counterpart/control accounts) of the Borrowing Loans Journal and the Lending Loans Journal.
- The Expense Account and Income Account of the shared Loan Interest product category, the category used to bill or invoice loan interest.
Installation
This module installs itself - it is not something you search for and click Install on. It auto-installs the moment both of the following apps are present on a database:
- Loan Management (app to_loan_management) - manages borrowing and lending loan contracts.
- Vietnam Chart of Accounts - Circular 99 and 133 (app l10n_vn_viin) - loads the Vietnam chart of accounts and tax setup.
In practice: go to Apps, install Loan Management on a company that already uses (or will use) the Vietnam chart of accounts. Odoo installs this bridge module for you at the same time - no separate search or click is needed.
If a company's Vietnam chart of accounts was already loaded before this module got installed (for example, an older database being upgraded), the module runs a one-time catch-up pass on install and fills in any missing default account on the existing Borrowing/Lending journals and on the Loan Interest product category - again, no action needed from you.
How it works
The module treats a company as "Vietnam" whenever its Chart of Accounts is one of the two templates above. For such a company:
- Borrowing loans - the Borrowing Loans Journal's Default Account is set to account 3411, and its Allowed accounts are extended with the payables account 331, the finance-cost account 635, and the deductible-VAT account 133.
- Lending loans - the Lending Loans Journal's Default Account is set to account 1283 (1288 under Circular 133), and its Allowed accounts are extended with the receivables account 131, the finance-income account 515, and the tax-payable account 333.
- Loan interest billing - the Loan Interest product category (used by the Loan Service product to bill/invoice interest) gets its Expense Account set to account 635 and its Income Account set to account 515.
These are the same account codes Vietnamese accountants already use for borrowing, lending, and their related expense, income, and tax entries under Circular 99/2025/TT-BTC and Circular 133/2016/TT-BTC. The module does not create new accounts or change what they mean - it only wires the accounts that already exist in the Vietnam chart as the defaults for loan contracts.
Verifying
To check the module is active on a company:
- Switch to a company that uses the Vietnam chart of accounts (top-right company switcher).
- Open Loan Management > Borrowing > Contracts, then click New.
- Open the Accounting section of the form. The Journal field already shows Borrowing Loans Journal, and the Loan Account field is already filled in with 3411 - there is nothing to pick.
The same check works on Loan Management > Lending > Contracts, where the Loan Account defaults to 1283 (or 1288 under Circular 133).
FAQ
Do I need to configure anything after installing this module? No. It is a zero-configuration bridge: as soon as Loan Management and the Vietnam Chart of Accounts are both installed on a company, the default accounts are set automatically.
I already had loan contracts before installing this module. Will old contracts change? No. The module only sets default accounts used by new contracts and by the journals/product category - it never rewrites the Loan Account already saved on an existing contract.
My company is not on a Vietnam chart of accounts. What happens? Nothing. The module only acts on companies whose Chart of Accounts is Circular 99/2025/TT-BTC or Circular 133/2016/TT-BTC; every other company is left untouched.
Where can I see these default accounts later? Go to Loan Management > Configuration > Settings: the Borrowing Loan Account and Lending Loan Account fields show the current company-level defaults. Those values come from the Vietnam Chart of Accounts setup; this module keeps the Borrowing/Lending journals and the Loan Interest product category lined up with them.
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.