Gộp dòng hóa đơn điện tử Việt Nam
| Số dòng Code | 696 |
| Tên kỹ thuật | l10n_vn_edi_line_grouping |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.0/l10n_vn_edi_line_grouping |
| Đọc mô tả cho | v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 v 18.0 |
| Yêu cầu các App | Invoicing (account) Discuss (mail) |
| Bao gồm Các phụ thuộc | Tích hợp Hóa đơn Điện tử Việt Nam Mã đơn vị quan hệ ngân sách Thông tin Định danh Đối tác Mô-đun Cơ Sở Nhóm các dòng Hóa đơn Nền tảng Kế toán Ghi nhật ký API Request Số hóa đơn pháp lý |
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.
Cài đặt
- Truy cập Ứng dụng.
- Tìm từ khóa l10n_vn_edi_line_grouping.
- Ấn Cài đặt.
Hướng dẫn sử dụng
Note
Extends l10n_vn_viin_edi - see its documentation.
Note
Extends viin_invoice_line_grouping - see its documentation.
Video hướng dẫn: Gộp dòng hóa đơn điện tử
Phân hệ này (trước đây có tên Vietnam Electronic Invoice Summary, nay đổi tên thành Vietnam Electronic Invoice Line Grouping - Gộp dòng hóa đơn điện tử Việt Nam) cho phép bạn phát hành hóa đơn điện tử Việt Nam theo một trong hai mẫu: mẫu chi tiết - mỗi dòng hóa đơn gốc hiển thị riêng - hoặc mẫu gộp dòng (tổng hợp), trong đó các dòng hóa đơn được gộp thành từng nhóm trước khi gửi cho nhà cung cấp hóa đơn điện tử. Phân hệ này độc lập với nhà cung cấp: khi cài đặt cùng phân hệ nền tảng l10n_vn_viin_edi và bất kỳ nhà cung cấp nào được hỗ trợ (Viettel S-Invoice, VNInvoice, MISA meInvoice), tùy chọn gộp dòng sẽ khả dụng trên mọi hóa đơn điện tử, không phân biệt nhà cung cấp. Phân hệ này dựa trên nền tảng gộp dòng viin_invoice_line_grouping để tạo ra các nhóm dòng hóa đơn.
1. Tạo hóa đơn khách hàng có nhiều dòng cùng một sản phẩm.
- Tạo một hóa đơn khách hàng có nhiều dòng của cùng một sản phẩm hoặc biến thể sản phẩm. Ví dụ: hai dòng của các biến thể sản phẩm Táo Envy (To) và Táo Envy (Nhỏ).
2. Chọn tiêu chí gộp dòng và chế độ hiển thị.
- Trên hóa đơn, mở tab Dòng hóa đơn tóm tắt (Invoice Lines Summary).
- Chọn Chế độ hóa đơn tóm tắt (Invoice Summary Line Mode) - tiêu chí dùng để gộp các dòng hóa đơn (theo sản phẩm hoặc theo mẫu sản phẩm, giữ nguyên hay tính trung bình đơn giá, tách riêng theo thuế hoặc chiết khấu).
- Chọn Chế độ hiển thị hóa đơn (Invoice Display Mode) - Dòng hóa đơn (Invoice Lines) để giữ các dòng chi tiết gốc, hoặc Dòng hóa đơn đã gộp (Invoice Line Grouping Lines) để hiển thị các dòng đã được gộp/tổng hợp.
- Xem chi tiết hướng dẫn từng tiêu chí gộp dòng, kèm ví dụ minh họa, tại mô-đun viin_invoice_line_grouping.
3. Phát hành hóa đơn điện tử.
- Xác nhận và phát hành hóa đơn điện tử như bình thường qua giao diện Hóa đơn điện tử thống nhất (xem hướng dẫn tại l10n_vn_viin_edi). Khi Chế độ hiển thị hóa đơn được đặt thành Dòng hóa đơn đã gộp, mọi nhà cung cấp đã cài đặt có hỗ trợ gộp dòng sẽ nhận các nhóm dòng đã gộp thay vì các dòng hóa đơn gốc. Tên sản phẩm và đơn vị tính của mỗi dòng đã gộp được hiển thị song ngữ: tiếng Việt luôn được hiển thị, và phụ đề tiếng Anh chỉ được tự động thêm vào khi ngôn ngữ của khách hàng không phải tiếng Việt.
4. Phát hành hóa đơn gộp dòng hoạt động với mọi nhà cung cấp đã cài đặt - không cần mô-đun bổ sung.
- Phân hệ này tự xây dựng dữ liệu hóa đơn gộp dòng một cách tổng quát, dựa trên phân hệ nền tảng l10n_vn_viin_edi và nền tảng gộp dòng viin_invoice_line_grouping. Khi cài đặt cùng hai phân hệ này, tính năng phát hành hóa đơn gộp dòng hoạt động ngay với bất kỳ nhà cung cấp nào được hỗ trợ - MISA meInvoice, VNInvoice, hoặc Viettel S-Invoice - không cần thêm bất kỳ mô-đun tích hợp riêng nào của nhà cung cấp.
- Trước khi gửi một nhóm dòng đã gộp cho nhà cung cấp, dữ liệu của nhóm đó sẽ được kiểm tra. Khi phát hành qua MISA meInvoice hoặc VNInvoice, nếu một nhóm dòng có nhiều hơn một loại thuế hoặc không có thuế, việc phát hành sẽ bị chặn kèm thông báo lỗi nêu rõ sản phẩm liên quan; phát hành qua VNInvoice còn yêu cầu mọi nhóm dòng đã gộp phải có đơn vị tính.
- Giấy báo có/hóa đơn điều chỉnh giảm, và chế độ hiển thị Dòng hóa đơn (mẫu chi tiết), luôn truyền dữ liệu theo từng dòng chi tiết bất kể nhà cung cấp nào - tính năng gộp dòng không áp dụng cho các trường hợp này.
Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).
Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).
Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.
Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.