Tuỳ chọn Gộp Dòng Hóa Đơn Điện Tử VN-Invoice
| Số dòng Code | 656 |
| Tên kỹ thuật | l10n_vn_viin_accounting_vninvoice_line_grouping |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/app/17.0/l10n_vn_viin_accounting_vninvoice_line_grouping |
| Đọc mô tả cho | v 13.0 v 14.0 v 15.0 v 16.0 v 17.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 Thông tin Định danh Đối tác Mã đơn vị quan hệ ngân sách Mô-đun Cơ Sở Nhóm các dòng Hóa đơn Nền tảng Kế toán Số hóa đơn giá trị gia tăng Ghi nhật ký API Request Gộp dòng hóa đơn điện tử Việt Nam Tích hợp Hóa đơn Điện tử VNIs VN-Invoice |
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.
Cài đặt
- Truy cập Ứng dụng.
- Tìm từ khóa l10n_vn_viin_accounting_vninvoice_line_grouping.
- Ấn Cài đặt.
Hướng dẫn sử dụng
Phân hệ này là một tiện ích mỏng, kết nối nhà cung cấp VN-Invoice (l10n_vn_viin_accounting_vninvoice) với nền tảng Gộp dòng hóa đơn điện tử độc lập với nhà cung cấp (l10n_vn_edi_line_grouping). Khi cài đặt cùng cả hai phân hệ trên, hóa đơn điện tử VN-Invoice (VNIs) có thể được phát hành theo mẫu chi tiết gốc - mỗi dòng hóa đơn hiển thị riêng - hoặc theo 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 VN-Invoice. Phân hệ này không thêm màn hình riêng nào - nó tái sử dụng các trường và tab mà nền tảng gộp dòng cùng bộ máy gộp dòng đã hiển thị sẵn trên hóa đơn khách hàng, và chỉ thay đổi dữ liệu thực sự gửi cho VN-Invoice khi tùy chọn gộp được chọn.
1. Cài đặt cùng nhà cung cấp VN-Invoice và nền tảng gộp dòng.
- Vào Ứng dụng và đảm bảo E-Invoice - VNIs VN-Invoice Integrator (l10n_vn_viin_accounting_vninvoice) cùng Gộp dòng hóa đơn điện tử Việt Nam (l10n_vn_edi_line_grouping) đã được cài đặt, sau đó cài đặt phân hệ này. Khi cài đặt xong, tùy chọn phát hành gộp dòng sẽ khả dụng riêng cho các hóa đơn điện tử phát hành qua VN-Invoice.
2. Chọn tiêu chí gộp dòng và chế độ hiển thị trên hóa đơn.
- Mở một hóa đơn khách hàng phát hành qua VN-Invoice và vào tab Dòng hóa đơn tóm tắt.
- Chọn Chế độ hóa đơn tóm tắt - 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).
- Đặt Chế độ hiển thị hóa đơn thành Dòng hóa đơn đã gộp để phát hành theo mẫu tổng hợp, hoặc giữ nguyên Dòng hóa đơn để giữ mẫu chi tiết gốc.
3. Phát hành hóa đơn điện tử theo mẫu gộp qua VN-Invoice.
- Phát hành hóa đơn điện tử như bình thường từ giao diện Hóa đơn điện tử thống nhất. Khi Chế độ hiển thị hóa đơn là Dòng hóa đơn đã gộp, VN-Invoice sẽ nhận các nhóm dòng đã gộp thay vì các dòng hóa đơn gốc: mỗi nhóm mang đơn giá bình quân gia quyền và tên sản phẩm / đơn vị tính song ngữ (tiếng Việt luôn hiển thị; phụ đề tiếng Anh chỉ được tự động thêm khi ngôn ngữ của khách hàng không phải tiếng Việt).
4. Mẫu chi tiết và hóa đơn điều chỉnh/thay thế luôn gửi chi tiết theo từng dòng.
- Giữ Chế độ hiển thị hóa đơn ở Dòng hóa đơn, hoặc phát hành hóa đơn điều chỉnh/hoàn trả, luôn gửi cho VN-Invoice chi tiết theo từng dòng hóa đơn gốc - việc gộp dòng tự động được bỏ qua để hóa đơn điều chỉnh và thay thế vẫn truy vết được về các dòng hóa đơn gốc.
5. Khắc phục lỗi dữ liệu được cảnh báo trước khi phát hành hóa đơn gộp.
- VN-Invoice yêu cầu mỗi dòng đã gộp phải có đúng một loại thuế và một đơn vị tính. Nếu một nhóm dòng mang nhiều hơn một loại thuế, không có thuế, hoặc sản phẩm không có đơn vị tính, việc phát hành sẽ bị chặn kèm thông báo chỉ rõ dòng và sản phẩm cần sửa trước khi thử lại.
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.