Tích hợp Hóa đơn Điện tử Việt Nam
| Số dòng Code | 3297 |
| Tên kỹ thuật | l10n_vn_viin_edi |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/18.0/l10n_vn_viin_edi |
| Đọc mô tả cho | v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 v 19.0 |
| Yêu cầu các App | Invoicing (account) Discuss (mail) |
| Bao gồm Các phụ thuộc | Mã đơn vị quan hệ ngân sách Thông tin Định danh Đối tác Mô-đun Cơ Sở Nền tảng Kế toán Số hóa đơn giá trị gia tăng Ghi nhật ký API Request |
| Các mở rộng | Tích hợp Hóa đơn Điện tử Viettel S-Invoice Tích hợp Hóa đơn điện tử - Misa meInvoice Thông tin chung của Hóa đơn Điện tử trên Biên lai POS Tích hợp Hóa đơn Điện tử VNIs VN-Invoice Hóa Đơn Điện Tử Việt Nam - Bán hàng Gộp dòng hóa đơn điện tử Việt Nam |
Vietnamese E-Invoice Integration
Seamless integration with Vietnamese e-invoice providers (Viettel S-Invoice, VNInvoice, MISA E-Invoice, etc), ensuring compliance and efficiency in invoicing workflows
At a Glance
The facts of Vietnamese E-Invoice Integration, version 1.1.7, in one place. Published by Viindoo.
Key Features
Built natively on Odoo/Viindoo to streamline real business operations:
Provider Integration
Preconfigured for popular Vietnamese e-invoice providers like Viettel S-Invoice, VNInvoice, and MISA E-Invoice, with tools to extend compatibility to new providers.
Easy VietNam E-invoice configuration
config E-invoice serial, type and template with ease.
Enhanced Accounting Fields for E-Invoicing
- In Customer Invoice:
- E-Invoice Issuance Date: Tracks the issuance date of the electronic invoice.
- E-invoice Transaction ID: Tracks the E-invoice Transaction ID of the electronic invoice.
- E-Invoice Issue User: Tracks the E-Invoice Issue User of the electronic invoice.
- E-Invoice Representation File: Stores the representation file generated for the invoice.
- E-Invoice Converted File: Stores the printable version of the e-invoice in PDF format.
- In Account Journal:
- E-Invoice Provider: Specifies the e-invoice provider (e.g., MISA, VNIs, Viettel).
- Default E-Invoice Type: Sets the default type of e-invoice (e.g., VAT Invoice, Sale Invoice).
- Default Template: Assigns the default e-invoice template for all invoices under this journal.
- Default E-Invoice Serial: Links to the e-invoice serial for compliance and traceability.
Real-Time Status Tracking
Monitor issuance in real time and filter every invoice by one normalized E-Invoice Status - to issue, issued, adjusted, replaced, cancelled or error - across all providers.
Benefits
The module ensures businesses fully comply with Vietnam's e-invoice regulations, avoiding legal violations and risks.
Eliminate manual processes such as printing, storing, and delivering paper invoices, helping businesses save operational time and costs.
Easily issue, adjust, and cancel e-invoices directly within the system, ensuring quick and accurate processing.
Real-time tracking of invoice status minimizes errors and enhances financial transparency.
Flexibly expand to integrate with additional e-invoice providers or customize workflows to meet specific business needs.
Vietnam E-Invoicing settings
Unified E-Invoice menu
Merged E-Invoice tab
See Vietnamese E-Invoice Integration in Action
See how this module solves real business problems in a working Viindoo environment.
Need help with Vietnamese E-Invoice Integration?
For questions, implementation support, or consulting services, contact Viindoo.
Pre-Sales & Partnership
sales@viindoo.comWhen contacting us, please include:
- Odoo/Viindoo version (CE/EE).
- Number of users and business scope.
- Other modules currently in use.
Technical Support
apps.support@viindoo.comFor 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: unified E-Invoice menu, one merged notebook tab, a single E-Invoice status filter, a consolidated Vietnam E-Invoicing settings and partner section, and the e-invoice cancel-guard.
- 2026-02-24 Fixed TypeError: object of type 'bool' has no len() while downloading invoice on portal.
- 2026-01-30 Improved E-Invoice validation flow: check on issuance instead of journal posting.
- 2026-01-07 Performance Speed up the pre_init_hook method by ignoring null values.
- 2026-01-05 Fixed Update journal dashboard view to be compatible with v17.0.
- 2025-11-21 Improved Performance by replacing binary attachment domain with filename check.
- 2025-09-11 Added Identification, passport, budget code for Vietnam edi.
Works Great With These Modules
Extend Vietnamese E-Invoice Integration with complementary Viindoo apps:
Vietnam Electronic Invoice Line Grouping
Provide options to issue an e-invoice on a detailed or line-grouped form
Module l10n_vn_edi_line_groupingE-Invoice - Viettel S-Invoice Integrator
Issue Vietnamese e-invoices through Viettel S-Invoice on top of Odoo core, fully integrated with the unified E-Invoice interface
Module l10n_vn_viin_accounting_sinvoiceShow EInvoice Information on POS Receipt
General Information of EInvoice on POS Receipt
Module l10n_vn_viin_edi_posVietnam E-invoice - Sale
Automatically add Vietnamese descriptions when creating invoices from sales orders for compliance and efficiency.
Module l10n_vn_viin_einvoice_saleWho Should Use This Module?
Built for teams that need this capability fully integrated into their Odoo/Viindoo stack.
Executives & Business Owners
Need clear visibility into operations and a stack that scales without bespoke development.
Operations / Department Leaders
Want to streamline daily workflows, remove manual handoffs, and keep data consistent across teams.
Implementers & Odoo Partners
Looking for production-ready Viindoo modules to deliver projects faster and at lower risk.
Cài đặt
- Truy cập Ứng dụng.
- Tìm từ khóa l10n_vn_viin_edi.
- Ấn Cài đặt.
Hướng dẫn sử dụng
Video hướng dẫn: Thông tin chung của hóa đơn điện tử
Phân hệ này cung cấp nền tảng độc lập nhà cung cấp cho hóa đơn điện tử Việt Nam. Khi cài thêm một phân hệ nhà cung cấp bên cạnh nó - Viettel S-Invoice, VNInvoice (VNIs) hoặc MISA meInvoice - mọi nhà cung cấp đều được thiết lập, phát hành, theo dõi, điều chỉnh, thay thế và hủy từ cùng một giao diện hóa đơn điện tử thống nhất dưới đây, thay vì mỗi nhà cung cấp một màn hình riêng.
1. Thiết lập phần Hóa đơn điện tử Việt Nam.
- Truy cập Kế toán > Cấu hình > Thiết lập và mở phần Hóa đơn điện tử Việt Nam.
- Chọn Nhà cung cấp hóa đơn điện tử cho công ty. Các trường kết nối riêng của nhà cung cấp sẽ hiện ra bên dưới sau khi chọn nhà cung cấp, nên bạn chỉ thấy các thiết lập liên quan đến mình.
2. Sử dụng menu Hóa đơn điện tử thống nhất.
- Một menu Hóa đơn điện tử duy nhất nay gom toàn bộ cấu hình và thao tác hóa đơn điện tử - dải số, mẫu, loại và danh sách hóa đơn điện tử đã phát hành - thay thế cho các menu riêng của từng nhà cung cấp trước đây.
3. Điền thông tin hóa đơn điện tử trên hóa đơn khách hàng.
- Mở một hóa đơn khách hàng. Tab Hóa đơn điện tử gom vào một chỗ trạng thái và các định danh, thông tin điều chỉnh, nhóm con của nhà cung cấp và các tài liệu đã sinh ra - bất kể nhà cung cấp nào đã phát hành hóa đơn.
- Việc ký số hóa đơn điện tử và gửi cơ quan thuế chậm nhất là ngày làm việc tiếp theo kể từ ngày hóa đơn là trách nhiệm của kế toán: phần mềm không kiểm tra việc này (điểm 7 Phụ lục Nghị định 254/2026/NĐ-CP).
4. Theo dõi trạng thái hóa đơn điện tử của mọi nhà cung cấp.
- Trên danh sách hóa đơn khách hàng, dùng bộ lọc và gom nhóm Trạng thái hóa đơn điện tử để thấy trong một khung nhìn chuẩn hóa: hóa đơn nào chờ phát hành, đã phát hành, đã điều chỉnh, đã thay thế, đã hủy hay đang lỗi - không phụ thuộc vào nhà cung cấp bên dưới.
5. Điều chỉnh hoặc thay thế thay vì hủy một hóa đơn điện tử đã phát hành.
- Một hóa đơn điện tử đã phát hành không còn được hủy đơn thuần nữa, bất kể được phát hành khi nào. Hệ thống chặn thao tác hủy và hướng dẫn bạn phát hành hóa đơn điện tử điều chỉnh hoặc thay thế, giữ cho sổ sách tuân thủ quy định.
- Ngày bắt đầu áp dụng quy định này là thiết lập Chặn hủy từ ngày trong phần Hóa đơn điện tử Việt Nam tại Kế toán > Cấu hình > Thiết lập. Giá trị sẵn có là ngày 01/07/2026; chỉ đổi khi quy định áp dụng một ngày khác.
6. Phát hành hóa đơn bị quên với đúng ngày của nó.
- Nhập hóa đơn bị quên với ngày bán hàng, không bao giờ với ngày hôm nay: hóa đơn điện tử thể hiện ngày đó, sổ sách và kỳ kê khai thuế GTGT cũng theo ngày đó.
- Khi ký hiệu đã có hóa đơn điện tử ngày sau được phát hành, nhà cung cấp từ chối hóa đơn điện tử
ngày trước trong ký hiệu đó. Hãy phát hành hóa đơn bị quên theo một ký hiệu thứ hai đã đăng ký với
nhà cung cấp, chọn khi hóa đơn còn ở trạng thái nháp; hóa đơn đã xác nhận thì đặt lại về nháp
trước. Sau đó xác nhận hóa đơn và gửi đi. Khi hóa đơn điện tử đã phát hành, ký hiệu của nó không
đổi được nữa.
- VN-Invoice: tạo ký hiệu tại Kế toán > Cấu hình > Hóa đơn điện tử > Ký hiệu hóa đơn điện tử; sau đó quản trị viên kế toán chọn ký hiệu đó tại Ký hiệu hóa đơn điện tử trong tab Hóa đơn điện tử của hóa đơn.
- S-Invoice: Viettel đánh số hóa đơn điện tử theo từng ký hiệu hóa đơn của Viettel. Tạo ký hiệu thứ hai tại Kế toán > Cấu hình > Hóa đơn điện tử > Viettel S-Invoice > Ký hiệu hóa đơn, rồi chọn ký hiệu đó tại Ký hiệu hóa đơn trong tab Hóa đơn điện tử của hóa đơn; giữ nguyên Ký hiệu hóa đơn điện tử.
- MISA meInvoice: hãy hỏi MISA việc kiểm tra thứ tự ngày của họ xét trong một ký hiệu hay trên toàn tài khoản trước khi dựa vào một ký hiệu thứ hai.
7. Mỗi kênh gửi hóa đơn một ký hiệu riêng.
- Hóa đơn được gửi khi không có ai theo dõi - sau một thanh toán trực tuyến, khi Gửi hàng loạt theo lịch, tại điểm bán lẻ - sẽ dừng lại với một ghi chú trong chatter của hóa đơn khi hóa đơn điện tử của nó không phát hành được. Khi bật Phát hành theo thứ tự ngày hóa đơn, một hóa đơn điện tử phải chờ khi còn hóa đơn ngày trước của cùng ký hiệu chưa phát hành; hóa đơn của ký hiệu khác không bao giờ giữ nó lại.
- Vì vậy hãy cho mỗi kênh một ký hiệu riêng: một cho bán hàng trực tuyến, một cho điểm bán lẻ, một cho hóa đơn nhập tay. Đặt mỗi ký hiệu trên sổ nhật ký bán hàng của kênh đó - Sổ nhật ký hóa đơn của điểm bán lẻ, Sổ nhật ký hóa đơn của đơn hàng trực tuyến (sổ nhật ký bán hàng đầu tiên khi đơn hàng không chỉ định) - và để trống Ký hiệu hóa đơn mặc định trong thiết lập để sổ nhật ký quyết định. Khi đó một hóa đơn nhập tay bị chậm không bao giờ giữ lại một kênh tự động. Ký hiệu đặt trên một khách hàng được ưu tiên ở mọi kênh: hóa đơn của khách hàng đó dùng ký hiệu này khi bán trực tuyến, tại điểm bán lẻ cũng như khi nhập tay.
- Lần gửi đã dừng không tự chạy lại, và trong cùng một kênh, một hóa đơn chưa phát hành giữ lại các hóa đơn ngày sau của ký hiệu đó. Mở chúng bằng Hóa đơn điện tử chờ phát hành trên sổ nhật ký bán hàng ở bảng điều khiển Kế toán rồi gửi lại bằng Gửi - từng hóa đơn, hoặc chọn nhiều hóa đơn trong danh sách.
8. Điều chỉnh tăng hóa đơn điện tử đã phát hành.
- Điều chỉnh giảm số tiền của hóa đơn điện tử đã phát hành được thực hiện từ Odoo với mọi nhà cung cấp: tạo Hóa đơn điều chỉnh giảm của hóa đơn rồi gửi đi.
- Điều chỉnh tăng được thực hiện từ Odoo với S-Invoice, như hướng dẫn của phân hệ S-Invoice. Với
MISA meInvoice và VN-Invoice:
- Khi đã cài phân hệ Hóa đơn điều chỉnh tăng, mở hóa đơn đã phát hành, chọn Hóa đơn điều chỉnh tăng trong menu bánh răng, kiểm tra các dòng của hóa đơn điều chỉnh tăng rồi xác nhận. Hóa đơn điều chỉnh tăng ghi nhận phần tăng vào sổ sách và không có Ký hiệu hóa đơn điện tử, nên khi gửi đi sẽ không phát hành hóa đơn điện tử nào.
- Trên cổng thông tin của nhà cung cấp, lập hóa đơn điều chỉnh tăng cho hóa đơn điện tử gốc.
- Nếu thực chất đó là một lần bán mới, quản trị viên kế toán chọn Ký hiệu hóa đơn điện tử trong tab Hóa đơn điện tử khi hóa đơn điều chỉnh tăng còn ở trạng thái nháp: khi đó nó được phát hành thành hóa đơn điện tử mới như mọi hóa đơn.
Căn cứ pháp lý
Hóa đơn điện tử tại Việt Nam áp dụng theo hai văn bản có hiệu lực từ ngày 01/07/2026:
- Nghị định 254/2026/NĐ-CP, hết hiệu lực thi hành toàn bộ Nghị định 123/2020/NĐ-CP, Điều 1 Nghị định 41/2022/NĐ-CP và toàn bộ Nghị định 70/2025/NĐ-CP.
- Thông tư 91/2026/TT-BTC, chấm dứt hiệu lực Thông tư 32/2025/TT-BTC.
Ba quy định trong hai văn bản trên định hình cách phân hệ này vận hành.
Lập văn bản thỏa thuận trước khi điều chỉnh hoặc thay thế. Trường hợp người mua là tổ chức kinh tế, tổ chức khác, hộ kinh doanh hoặc cá nhân kinh doanh, người bán và người mua lập văn bản thỏa thuận ghi rõ sai sót trước khi phát hành hóa đơn điện tử điều chỉnh hoặc thay thế; người mua là cá nhân thì được thông báo thay cho văn bản thỏa thuận. Lưu ý cá nhân kinh doanh được xếp vào nhóm người mua là tổ chức, không phải cá nhân. Yêu cầu lập văn bản thỏa thuận chỉ áp dụng cho trường hợp xử lý sai sót tại điểm b) khoản này; sai sót tại điểm a) chỉ cần thông báo, không phát hành hóa đơn điện tử điều chỉnh hoặc thay thế. Người bán không bắt buộc lập văn bản thỏa thuận khi chuyển dữ liệu hóa đơn điện tử theo Bảng tổng hợp dữ liệu hóa đơn điện tử, khi chuyển cơ sở dữ liệu thông tin chi tiết giao dịch theo Bảng thông tin chi tiết giao dịch, hoặc đối với hoạt động mua bán hàng hóa trên nền tảng thương mại điện tử, nền tảng số khác. Hai thiết lập cho phân hệ biết trường hợp nào áp dụng với bạn. Đặt Phương thức chuyển dữ liệu hóa đơn điện tử trong thiết lập Hóa đơn điện tử Việt Nam để ghi nhận cách công ty bạn chuyển dữ liệu cho cơ quan thuế - đây là đăng ký thường trực nên áp dụng cho mọi hóa đơn cho tới khi bạn thay đổi. Tích Bán trên nền tảng thương mại điện tử hoặc nền tảng số ngay trên hóa đơn đối với giao dịch phát sinh qua nền tảng, vì cùng một người bán có thể vừa bán trên nền tảng vừa bán ngoài nền tảng trong cùng một ngày. Khi một trong hai trường hợp áp dụng, trình hướng dẫn đi tiếp mà không cần tên văn bản thỏa thuận; ngược lại nó yêu cầu điền và không cho đi tiếp nếu bỏ trống. (Điểm b.2 khoản 1 Điều 10 Thông tư 91/2026/TT-BTC, đoạn cuối dẫn chiếu điểm a.1 và a.2 khoản 3 Điều 16 Nghị định 254/2026/NĐ-CP.)
Hóa đơn điện tử đã phát hành thì xử lý sai sót, không hủy. Việc xử lý sai sót được thực hiện bằng cách điều chỉnh hoặc thay thế, bất kể hóa đơn được phát hành khi nào - hóa đơn đã lập theo Nghị định 51/2010/NĐ-CP, Nghị định 04/2014/NĐ-CP, Nghị định 123/2020/NĐ-CP, Nghị định 70/2025/NĐ-CP hay Thông tư 32/2025/TT-BTC đều được xử lý theo cách này (Khoản 2 Điều 24 Thông tư 91/2026/TT-BTC). Đây là lý do thao tác hủy bị chặn một khi hóa đơn điện tử đã phát hành, kể từ ngày 01/07/2026. Hóa đơn điện tử mà nhà cung cấp đã tạo nhưng chưa ký thì chưa phải hóa đơn điện tử đã phát hành, nên vẫn xóa được. Khoản 1 Điều 10 liệt kê đầy đủ các cách xử lý dành cho người bán khi phát hiện hóa đơn điện tử đã lập sai - thông báo cho người mua, lập hóa đơn điều chỉnh, hoặc lập hóa đơn thay thế - và hủy không nằm trong số đó (Khoản 1 Điều 10 Thông tư 91/2026/TT-BTC).
Hóa đơn điện tử thay thế mang dòng ghi chú theo mẫu. Hóa đơn thay thế ghi Thay thế cho hóa đơn Mẫu số... ký hiệu... số... ngày... tháng... năm, ngày viết theo thứ tự ngày, tháng rồi năm. Phân hệ tự điền phần này từ hóa đơn bị thay thế. (Điểm b.2 khoản 1 Điều 10 Thông tư 91/2026/TT-BTC.)
Hãy lưu giữ văn bản thỏa thuận để xuất trình: cơ quan thuế, hoặc cơ quan nhà nước có thẩm quyền khác, có thể yêu cầu người bán cung cấp.
Bạn chọn hình thức xử lý sai sót. Trên hóa đơn điều chỉnh, điều chỉnh tăng ghi số dương, điều chỉnh giảm ghi số âm (Điểm c khoản 6 Điều 10 Thông tư 91/2026/TT-BTC). Phân hệ cho phép điều chỉnh hoặc thay thế mọi hóa đơn điện tử đã phát hành và không chặn hình thức nào. Khi hóa đơn điện tử đã được xử lý theo hình thức điều chỉnh hoặc thay thế, các lần xử lý tiếp theo thực hiện theo hình thức đã áp dụng ở lần đầu: hóa đơn điện tử đã điều chỉnh thì tiếp tục được điều chỉnh, không thay thế (Điểm a khoản 6 Điều 10 Thông tư 91/2026/TT-BTC). Hóa đơn điện tử khởi tạo từ máy tính tiền đã lập sai thì người bán lập hóa đơn thay thế (Điểm c khoản 1 Điều 10 Thông tư 91/2026/TT-BTC), còn hàng hóa người mua trả lại được xử lý bằng hóa đơn điều chỉnh (Điểm c.1 khoản 5 Điều 10 Thông tư 91/2026/TT-BTC).
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.