Vietnam Electronic Invoice Line Grouping
| Lines of Code | 696 |
| Technical name | l10n_vn_edi_line_grouping |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.0/l10n_vn_edi_line_grouping |
| Read description for | v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 v 18.0 |
| Required Apps | Invoicing (account) Discuss (mail) |
| Included Dependencies | Vietnamese E-Invoice Integration Partner Budget Code Partner Identity Information Viindoo Base Invoice Lines Summary Accounting Foundation Legal Invoice Number API Request Logger |
Vietnam Electronic Invoice Line Grouping
Provide options to issue an e-invoice on a detailed or aggregated form
Formerly Vietnam Electronic Invoice Summary - renamed for Odoo 19.0. Works with any Vietnamese e-invoice provider through the E-Invoice hub.
At a Glance
The facts of Vietnam Electronic Invoice Line Grouping, version 0.1, in one place. Published by Viindoo.
Key Features
Built natively on Odoo/Viindoo to give long, high-volume invoices a compliant, readable e-invoice presentation:
Detailed or Line-Grouped E-Invoice
Choose, per invoice, between the original detailed invoice lines or a line-grouped (aggregated) form for the e-invoice sent to your provider.
Flexible Grouping Criteria
Bucket invoice lines by product or by product template, keeping or averaging the unit price, and separating by tax or discount - to match how you actually want the e-invoice to read.
Automatic Bilingual Naming
Every grouped line's product and unit-of-measure name is rendered in Vietnamese - with an English subtitle added automatically only when the customer is foreign.
Provider-Agnostic by Design
Built on the shared E-Invoice hub, so the grouped-line option is not tied to a single provider - any Vietnamese e-invoice provider companion can plug into the same extension point.
Safe Standalone Install
Installs cleanly on its own - if no provider companion is installed yet, the display-mode option simply has no effect, with no error and no assumption about which provider you use.
Built for High Line-Count Invoices
Turns a long, repetitive invoice - many lines of the same product across different orders - into a compact, readable e-invoice without losing the underlying accounting detail.
Benefits
Stay aligned with Vietnam's e-invoicing requirements while presenting long invoices in a compact, legally sound form.
Replace pages of near-duplicate lines with a compact, grouped e-invoice that is easier for your customer to read and reconcile.
The grouping and the bilingual naming are computed automatically at issuance - no manual re-typing or re-formatting of invoice lines.
Because the grouping logic is provider-agnostic, switching or adding a Vietnamese e-invoice provider does not mean redoing your line-grouping setup.
A shared extension hook lets future providers reuse the same bilingual grouped-line formatter instead of duplicating it.
Create a customer invoice
Issue the e-invoice
See Vietnam Electronic Invoice Line Grouping in Action
See how this module solves real business problems in a working Viindoo environment.
Need help with Vietnam Electronic 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 19.0 and renamed from Vietnam Electronic Invoice Summary to Vietnam Electronic Invoice Line Grouping, aligned with the renamed viin_invoice_line_grouping engine and the unified E-Invoice interface.
- 2025-11-21 Improved Bilingual naming: English subtitle now added only when the customer's language is not Vietnamese.
- 2025-09-11 Added Standalone-install safety: with no provider companion installed, the grouped-line hook returns no data instead of raising an error.
Works Great With These Modules
Extend Vietnam Electronic Invoice Line Grouping with complementary Viindoo apps:
Vietnamese E-Invoice Integration
The provider-agnostic E-Invoice hub - configure your provider once and issue, track, adjust, replace and cancel every e-invoice from one unified interface.
Module l10n_vn_viin_ediInvoice Line Grouping
The generic engine that builds the grouped invoice-line buckets this module formats for the e-invoice - required for the line-grouped option to work.
Module viin_invoice_line_groupingVN-Invoice: Line Grouping Option for Flexible E-Invoice Issuing
The VNInvoice provider companion that issues the actual line-grouped e-invoice through the VNInvoice (VNIs) service.
Module l10n_vn_viin_accounting_vninvoice_line_groupingShow EInvoice Information on POS Receipt
Shows the tax-authority lookup code and e-invoice details on the POS receipt, complementing any e-invoice - detailed or line-grouped - you issue.
Module l10n_vn_viin_edi_posWho Should Use This Module?
Built for Vietnamese businesses that issue long or high-volume invoices and want a clean, compliant e-invoice presentation:
Trading & Distribution Companies
Invoice many repeated product lines per order and want a compact, readable e-invoice for customers.
Accounting & Finance Teams
Need e-invoices that stay compliant with Vietnam's e-invoicing rules while keeping full accounting detail underneath.
Implementers & Odoo Partners
Looking for a production-ready, provider-agnostic grouped e-invoice option to deliver to Vietnamese customers faster.
Installation
- Navigate to Apps.
- Search with keyword l10n_vn_edi_line_grouping.
- Press Install.
Instruction
Note
Extends l10n_vn_viin_edi - see its documentation.
Note
Extends viin_invoice_line_grouping - see its documentation.
Instruction video: E-invoice Line Grouping
This module (formerly named Vietnam Electronic Invoice Summary, renamed to Vietnam Electronic Invoice Line Grouping) lets you issue a Vietnamese e-invoice in either a detailed form - one line per original invoice line - or a line-grouped (aggregated) form, where the invoice lines are bucketed together before being sent to the e-invoice provider. It is provider-agnostic: once installed alongside the l10n_vn_viin_edi hub and any supported provider (Viettel S-Invoice, VNInvoice, MISA meInvoice), the grouped-line option becomes available on every e-invoice, regardless of provider. It relies on the generic viin_invoice_line_grouping engine to build the grouped buckets.
1. Create a customer invoice with several lines of the same product.
- Create a customer invoice that contains multiple lines of the same product or product variant. For example, two lines of the product variants Grape (Large) and Grape (Small).
2. Choose the grouping criteria and the display mode.
- On the invoice, open 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).
- Pick the Invoice Display Mode - Invoice Lines to keep the original detailed lines, or Invoice Line Grouping Lines to show the grouped/aggregated buckets instead.
- See the viin_invoice_line_grouping user guide for the full breakdown of every grouping criterion, with worked examples.
3. Issue the e-invoice.
- Confirm and issue the e-invoice as usual through the unified E-Invoice interface (see the l10n_vn_viin_edi user guide). When the Invoice Display Mode is set to Invoice Line Grouping Lines, every installed provider that supports line grouping receives the grouped buckets instead of the raw invoice lines. Each grouped line's product and unit-of-measure name is rendered bilingually: Vietnamese is always shown, and an English subtitle is added automatically only when the customer's language is not Vietnamese.
4. Grouped-line issuing works with any installed provider - no extra module needed.
- This module builds the grouped-line payload generically, on top of the l10n_vn_viin_edi hub and the viin_invoice_line_grouping engine. Once these two modules are installed alongside this one, grouped-line issuing works out of the box with any supported provider - MISA meInvoice, VNInvoice, or Viettel S-Invoice - with no separate provider companion module required.
- Before a grouped bucket is sent to the provider, its data is checked. When issuing through MISA meInvoice or VNInvoice, a bucket that carries more than one tax or no tax at all blocks issuing, with an error message naming the affected product; issuing through VNInvoice also requires every grouped bucket to have a unit of measure.
- A credit note/refund, and the plain Invoice Lines display mode, always transmit per-line detail regardless of provider - line grouping never applies to those.
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.
