Odoo
Implementation
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Lines of code | 223 |
| Technical Name |
lb_account_num_word |
| License | OPL-1 |
| Website | https://lucidbrainz.com |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Lines of code | 223 |
| Technical Name |
lb_account_num_word |
| License | OPL-1 |
| Website | https://lucidbrainz.com |
Invoice Amount in Words (Arabic & English)
Professional Bilingual Amount Text Conversion System - Automatically Convert Invoice Amounts to Words in English and Arabic for Invoices, Reports & Financial Documents in Odoo 19
Overview
Invoice Amount in Words (Arabic & English) by Lucidbrainz Infotech is a professional and essential accounting module for Odoo 19 that automatically converts invoice amounts to readable text format in both English and Arabic languages. This module is perfect for businesses operating in Middle East, GCC countries, Saudi Arabia, UAE, Qatar, Kuwait, Bahrain, Oman, and any Arabic-speaking regions where bilingual financial documentation is required by law or business practice. The system seamlessly integrates with Odoo's invoicing and accounting modules, providing real-time automatic conversion of invoice totals into human-readable text format. Ideal for accountants, finance managers, billing departments, legal compliance teams, and organizations requiring professional invoice presentation, clear payment communication, multilingual support, and regulatory compliance. The module features configurable currency units in Arabic (e.g., ريال for Riyal, درهم for Dirham, دينار for Dinar), automatic integer and decimal handling (main amount + fractional subunits), support for Saudi Riyal (SAR), UAE Dirham (AED), Kuwaiti Dinar (KWD) and all other currencies, smart rounding to 4 decimal places, integration with num2words library for accurate linguistic conversion, custom Arabic number-to-text converter as backup, automatic computation on invoice save, display in invoice reports and PDF exports, and multi-company support. Built on clean Odoo 19 architecture with minimal customization, no conflicts with existing modules, easy currency configuration, and professional text formatting. Perfect for businesses that want to improve invoice professionalism, meet legal requirements for amount disclosure, enhance customer communication, support Arabic-speaking clients, eliminate payment disputes, and maintain bilingual financial records!
Complete Features & Capabilities
- Dual Language Support: Automatic amount conversion to text in both English and Arabic languages with proper linguistic rules and grammatical accuracy
- Configurable Currency Units: Define custom Arabic names for currency units (e.g., ريال, درهم, دينار) and subunits (e.g., هللة, فلس, درهم) per currency
- Intelligent Amount Parsing: Smart separation of integer and decimal parts with proper handling of main currency units and fractional subunits
- Real-Time Auto Computation: Amounts automatically convert to text on invoice save with live updates on amount changes - no manual intervention needed
- Accurate Rounding Logic: Professional 4-decimal place rounding ensuring mathematical precision and consistency across all calculations
- Invoice Report Integration: Converted text appears automatically in invoice PDFs, printed documents, and email templates for professional presentation
- num2words Library Integration: Leverages industry-standard num2words Python library for English and Arabic linguistic conversion with proper grammar
- Custom Arabic Converter: Built-in fallback Arabic number-to-text engine for environments without num2words library - ensures module always works
- Multi-Currency Ready: Works with Saudi Riyal (SAR), UAE Dirham (AED), Kuwaiti Dinar (KWD), Qatari Riyal (QAR), Omani Rial (OMR), Bahraini Dinar (BHD), USD, EUR, and all Odoo currencies
- Three Computed Fields: amount_in_text (English), amount_in_text_ar (Arabic), amount_tot_signed_in_text (signed total) automatically calculated and stored
- Invoice Line Dependency: Smart recalculation triggers on invoice line changes, tax updates, or discount applications - always accurate
- Database Field Storage: Converted text stored in database for quick retrieval, reporting, and historical record keeping without recalculation
- Easy Configuration: Simple currency form extension with two additional fields - no complex setup or technical knowledge required
- Multi-Company Support: Full Odoo 19 multi-company architecture support with company-specific currency configurations and independent text conversion
- UTF-8 Arabic Encoding: Proper Unicode support ensuring Arabic text displays correctly in all interfaces, reports, and PDF exports
- Arabic Numeral Conversion: Bonus feature converting English digits (0-9) to Arabic-Indic numerals (۰-۹) for complete Arabic document formatting
- Clean Module Architecture: Minimal core customization using Odoo inheritance - no conflicts with other modules, easy updates and maintenance
- Secure Implementation: Read-only computed fields prevent manual editing ensuring data integrity and consistency across all invoice records
- Performance Optimized: Efficient calculation algorithms with minimal server overhead - no impact on invoice processing speed or system performance
- SAR Symbol Auto-Configuration: Post-install hook automatically sets Saudi Riyal symbol ensuring proper display from first use
- Template Ready: Compatible with custom invoice templates - easily add amount-in-words fields to your branded invoice designs
- Historical Data Support: Works with existing invoices - recalculates text on edit ensuring all historical records can be updated
- Mobile Responsive: Arabic text displays correctly on mobile devices, tablets, and all screen sizes with proper RTL (right-to-left) support
- Well Documented Code: Clean, commented code following Odoo best practices for easy customization, extension, and developer understanding
- Extensible Design: Easy to extend for custom requirements like additional languages, special formatting, or integration with other financial modules
Live Module Screenshots - Odoo 19
Settings → General Settings → Invoicing → Currencies section:
• Main Currency: USD (United States Dollar) configured
• Currency Link: Access to full currencies configuration
• Easy Navigation: Quick access from accounting settings
This is where you select and manage your company's primary currency before configuring Arabic names
Invoicing → Dashboard → Customers → Invoices:
• Clean Interface: Empty state showing "Create a customer invoice" prompt
• New Button: Quick invoice creation access
• Upload Option: Bulk invoice import capability
• Search Functionality: Advanced search and filtering
Starting point for creating invoices that will display amount-in-words automatically
Invoice INV/2026/00001 for customer "Abigail Peterson":
• Invoice Lines: → Customizable Desk (10.00 × $125.50) = $1,255.00
→ Customizable Desk (1.00 × $1,000.00) = $1,000.00
• Total Amount: $2,255.00 (untaxed and total)
• Status: Posted (confirmed invoice)
• Activity Tracking: Full audit trail on right panel
Upon saving, this amount automatically converts to English and Arabic text
Invoice INV/2026/00001 PDF showing complete details:
• Invoice Number: INV/2026/00001
• Invoice Date: 01/02/2026 | Due Date: 01/02/2026
• Line Items: Detailed product descriptions with quantities and amounts
• Total Display: $2,255.00 prominently shown
• Amount in Words: "الاجمالى" (Arabic total indicator visible)
• Payment Communication: Clear payment reference INV/2026/00001
This PDF is where the module's bilingual amount text would appear if template is customized
How It Works - Simple 3-Step Process
Configure Currency
Go to Settings → Currencies → Select your currency (SAR, AED, etc.) → Add Arabic Currency Unit (ريال) and Subunit (هللة) names → Save
Create Invoice
Create your invoice as usual → Add invoice lines with products/services → Calculate totals → Confirm invoice normally
Automatic Conversion
Module automatically converts amount to text in English and Arabic → View in invoice form, reports, PDFs → No manual work required!
Our Professional Services
Odoo
Customization
Odoo
Migration
Support &
Maintenance
📞 Contact Us
WhatsApp:
Email:
Website: |
🌐 Follow Us📘 Facebook 📸 Instagram 💼 LinkedIn 🎥 YouTube |
© 2025 Lucidbrainz Infotech | Professional Odoo 19 Solutions | All Rights Reserved
Odoo Proprietary License v1.0 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.
Please log in to comment on this module