Demo video: Number to Vietnamese Words
What it does
This is the base module to help other modules convert numbers into Vietnamese words. You will need to install other modules to see this module in action.
Main Features
- Number to Vietnamese Words Conversion: Provides the `num2words` function to convert numeric values to words, example: 1000 → "One thousand".
- Supports Various Cases: Handles integers, decimals, negative numbers, and zero.
- Context Control: Uses `skip_vietnam_number2words` context to enable/disable the conversion process.
- Extensibility: Allows other modules to inherit and integrate easily through programming.
Technical Features
- Number to Words Conversion API: The `num2words(amount)` function supports parameters:
- precision_digits: Decimal precision.
- precision_rounding: Rounding rules.
- rounding_method: Rounding method (HALF-UP, HALF-DOWN).
- Integration with `res.currency`: Extends Odoo's amount_to_text function to display amounts in words when language is vi_VN.
- Context Control: Uses `skip_vietnam_number2words` context to disable the feature when not needed.
Benefits
- Flexible Integration: Easy connection with modules like accounting, sales, invoicing.
- Accuracy Assurance: Converts numbers to grammatically correct Vietnamese words.
- Time Saving: Automates the process, minimizes manual errors.
Target Users
- Odoo Developers: Need to integrate number to words conversion in custom modules.
- Viindoo Business Users: Indirect use through integrated accounting and sales modules.
- Accounting Department: Applied on financial documents after business modules integration.
Editions Supported
- Community Edition
- Enterprise Edition
Installation
- Navigate to Apps.
- Search with keyword to_vietnamese_number2words.
- Press Install.
How it works
Instruction video: Number to Vietnamese Words
This is the base module to help other modules convert numbers into Vietnamese words. E.g. from "1" to "một", "1000" to "một nghìn".
Applicability: This helps to meet the Vietnamese Government's regulations on the principles of invoicing, making receipts and payments, etc. For example, after installing the Vietnam Chart of Accounts - Circular 200 and 133 (l10n_vn_viin) module, the receipts/payments will change from numbers to words: "200,000" to "Hai trăm nghìn".
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.
