VN-Invoice: Line Grouping Option for Flexible E-Invoice Issuing
| Lines of Code | 656 |
| Technical name | l10n_vn_viin_accounting_vninvoice_line_grouping |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/18.0/l10n_vn_viin_accounting_vninvoice_line_grouping |
| Read description for | v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 |
| Required Apps | Invoicing (account) Discuss (mail) |
| Included Dependencies | Vietnamese E-Invoice Integration Partner Identity Information Partner Budget Code Viindoo Base E-Invoice - VNIs VN-Invoice Integrator Invoice Lines Summary Accounting Foundation Legal Invoice Number API Request Logger Vietnam Electronic Invoice Line Grouping |
VN-Invoice: Line Grouping Option for Flexible E-Invoice Issuing
Flexibly issue VN-Invoice e-invoices in detailed or aggregated formats to simplify your invoicing process
Key Features
Built natively on Odoo/Viindoo to streamline real business operations:
Detailed or Aggregated Issuing, Your Choice
Issue every VN-Invoice e-invoice in its original detailed form, or switch to a line-grouped (aggregated) form that buckets similar lines together - per invoice, on demand.
Bilingual, Weighted-Average Grouped Lines
Each grouped line transmitted to VN-Invoice carries a weighted-average unit price and a bilingual product / unit-of-measure name, with an English subtitle added automatically for non-Vietnamese-speaking customers.
Built-In Data-Quality Guardrails
Issuance is blocked with a clear message whenever a grouped line carries more than one tax, no tax, or a product with no unit of measure - so invalid e-invoices never reach VN-Invoice.
Detailed Mode and Refunds Stay Untouched
Detailed mode and every credit note / refund automatically keep per-line transmission, so adjustments and replacements always stay traceable to the original invoice lines.
Benefits
Long invoices with many repeated lines become a compact, easy-to-read VN-Invoice document without losing any billed value.
VN-Invoice users get the same flexible detailed-or-grouped choice already available on other e-invoice providers - one consistent workflow across your accounting team.
Invalid grouped lines are caught and explained before transmission, so accountants fix data at the source instead of chasing a rejected e-invoice.
Corrections, replacements, and credit notes always keep the original per-line detail, protecting traceability exactly where regulators and auditors look first.
The grouping option reuses the invoice fields your team already knows - there is nothing new to set up or train on.
Invoice Lines Summary tab
Pick the grouping criteria and switch the display mode directly on the customer invoice.
Grouped VN-Invoice issuance
Aggregated lines transmit with a weighted-average price and a bilingual product name.
Guarded against invalid grouped lines
A clear blocking message appears before an unsupported grouped line ever reaches VN-Invoice.
See VN-Invoice Line Grouping in Action
See how this module solves real business problems in a working Viindoo environment.
Need help with VN-Invoice Line Grouping?
For questions, implementation support, or consulting services, contact Viindoo.
Pre-Sales & Partnership
When contacting us, please include:
- Odoo/Viindoo version (CE/EE).
- Number of users and business scope.
- Other modules currently in use.
Technical Support
For faster troubleshooting, please provide:
- Order number or app reference.
- Odoo/Viindoo version & edition.
- Steps to reproduce the issue.
- Screenshots/logs if available.
Technical Requirement
Changes log
We continuously improve this module. Recent updates from the official Viindoo repository:
- 2026-07-05 Improved Upgraded to Odoo 18.0: renamed from Vietnam Electronic Invoice Summary to VN-Invoice Line Grouping, re-pointed onto the unified E-Invoice issuing seam, and now depends on the standalone Vietnam Electronic Invoice Line Grouping bridge instead of the retired e-invoice format flow.
- 2026-07-05 Fixed Fixed a crash that masked the "missing unit of measure" warning, and a crash on invoices carrying a section/note line while in aggregated display mode.
- 2025-07-23 Fixed Could not issue a replacement e-invoice while an invoice was set to the aggregated (grouped) display mode.
Works Great With These Modules
Extend VN-Invoice Line Grouping with complementary Viindoo apps:
Vietnamese E-Invoice Integration
The provider-agnostic backbone that unifies e-invoice configuration, issuance, tracking, adjustment and replacement for every provider.
Module l10n_vn_viin_ediE-Invoice - VNIs VN-Invoice Integrator
Issue Vietnamese e-invoices through VN-Invoice (VNIs), fully integrated with the unified E-Invoice interface. Required for this module to have any effect.
Module l10n_vn_viin_accounting_vninvoiceVietnam Electronic Invoice Line Grouping
The provider-agnostic bridge that builds the bilingual grouped-line buckets this module transmits to VN-Invoice. Required for this module to have any effect.
Module l10n_vn_edi_line_groupingInvoice Line Grouping
The generic engine that lets you bucket invoice lines by product, price, tax or discount - the foundation the grouped VN-Invoice option builds on.
Module viin_invoice_line_groupingWho Should Use This Module?
Built for teams issuing Vietnamese e-invoices through VN-Invoice who need more than one presentation format.
Accountants & Finance Teams
Issue clean, shorter e-invoices for orders with many repeated lines, without giving up per-line detail when it matters.
Businesses With High-Volume Invoices
Retailers, distributors, and manufacturers issuing VN-Invoice e-invoices with many similar line items each billing cycle.
Implementers & Odoo Partners
Looking for a production-ready VN-Invoice companion to deliver flexible e-invoicing projects faster and at lower risk.
Installation
- Navigate to Apps.
- Search with keyword l10n_vn_viin_accounting_vninvoice_line_grouping.
- Press Install.
Instruction
This module is a thin companion that bridges the VN-Invoice provider (l10n_vn_viin_accounting_vninvoice) with the provider-agnostic E-invoice Line Grouping bridge (l10n_vn_edi_line_grouping). Installed alongside both, it lets a VN-Invoice (VNIs) e-invoice be issued either in its original detailed form - one e-invoice line per invoice line - or in a line-grouped (aggregated) form, where the invoice lines are bucketed together before being sent to VN-Invoice. This module adds no screens of its own - it reuses the fields and tab that the line-grouping bridge and its engine already expose on the customer invoice, and only changes what VN-Invoice actually receives once the aggregated option is chosen.
1. Install alongside the VN-Invoice provider and the line-grouping bridge.
- Go to Apps and make sure E-Invoice - VNIs VN-Invoice Integrator (l10n_vn_viin_accounting_vninvoice) and Vietnam Electronic Invoice Line Grouping (l10n_vn_edi_line_grouping) are installed, then install this module. Once installed, the aggregated-issuing option becomes active specifically for e-invoices issued through VN-Invoice.
2. Choose the grouping criteria and the display mode on the invoice.
- Open a customer invoice billed through VN-Invoice and go to the Invoice Lines Summary tab.
- Pick an Invoice Summary Line Mode - the criteria used to bucket lines together (by product or by product template, keeping or averaging the unit price, separating by tax or discount).
- Set Invoice Display Mode to Invoice Line Grouping Lines to issue the aggregated form, or leave it at Invoice Lines to keep the original detailed form.
3. Issue the e-invoice in aggregated form through VN-Invoice.
- Issue the e-invoice as usual from the unified E-Invoice interface. When Invoice Display Mode is Invoice Line Grouping Lines, VN-Invoice receives the grouped buckets instead of the raw invoice lines: each bucket carries a weighted-average unit price and a bilingual product / unit-of-measure name (Vietnamese is always shown; an English subtitle is added automatically when the customer's language is not Vietnamese).
4. Detailed mode and refunds always transmit per-line detail.
- Leaving Invoice Display Mode at Invoice Lines, or issuing a credit note / refund, always sends VN-Invoice the original per-line detail - grouping is bypassed automatically so adjustments and replacements stay traceable to the original invoice lines.
5. Fix data-quality issues flagged before an aggregated e-invoice can be issued.
- VN-Invoice requires exactly one tax and a unit of measure on every grouped line. If a bucket carries more than one tax, no tax at all, or a product with no unit of measure, issuance is blocked with a message identifying the line and product to fix before trying again.
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.
