Tích hợp Hóa đơn Điện tử Viettel S-Invoice
| Số dòng Code | 1204 |
| Tên kỹ thuật | l10n_vn_viin_accounting_sinvoice |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/18.0/l10n_vn_viin_accounting_sinvoice |
| Đọc mô tả cho | v 12.0 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 | 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ở Nền tảng Kế toán Ghi nhật ký API Request Số hóa đơn giá trị gia tăng |
| Các mở rộng | Thông tin Hóa đơn Điện tử Viettel Sinvoice trên Biên lai POS |
E-Invoice - Viettel S-Invoice Integrator
Integrates with Viettel's S-Invoice service to issue legal e-Invoice
At a Glance
The facts of E-Invoice - Viettel S-Invoice Integrator, version 1.0.5, in one place. Published by Viindoo.
Key Features
Built natively on Odoo/Viindoo to streamline real business operations:
Preview Draft Before You Issue
Open a full preview PDF of the S-Invoice before it is issued - no e-invoice number reserved, nothing sent to the tax authority yet - so you can check figures and layout with confidence.
Automatic Payment-Status Sync
Registering a payment on the invoice in Odoo automatically pushes the paid status to Viettel S-Invoice - one less manual step for your accounting team.
E-Invoice Cancel-Guard
An issued S-Invoice can no longer be plainly cancelled, however long ago it was issued - this module blocks the cancel, even through the core Request Cancel button, and redirects you to adjust or replace it instead, keeping you compliant.
Legal Disclosure on the Customer Portal
Your customer's portal invoice page shows the legal e-invoice number, secret code and a direct link to look it up on the Viettel S-Invoice lookup page - so they can verify it independently.
One Unified E-Invoice Interface
Issuance, adjustment, replacement and download run through Odoo's native Viettel integration and appear on the same E-Invoice menu, tab and status filter shared by every e-invoice provider - no separate Viettel-only screens.
S-Invoice Numbering, Reachable in One Place
Manage your Viettel S-Invoice templates and symbols from the same E-Invoice menu you use for every other e-invoice setting - no more digging through generic Invoicing configuration.
Benefits
The cancel-guard closes a real compliance gap: an issued e-invoice can never be silently cancelled and detached from the tax-authority record.
Draft preview and automatic payment-status sync remove two manual checks accountants used to run by hand.
Accountants stop switching between a Viettel-only screen and every other provider's screen - one E-Invoice menu, tab and status filter for all of them.
Buyers can independently verify their legal e-invoice number and secret code straight from the customer portal.
Issuance itself rides on Odoo core's own Viettel integration, so you benefit from upstream fixes and improvements while keeping the Viindoo conveniences on top.
Select Viettel S-Invoice in Vietnam E-Invoicing settings
Issue through the unified E-Invoice tab
Download the display and converted files
Automatic payment-status sync
E-Invoice cancel-guard
See E-Invoice - Viettel S-Invoice Integrator in Action
See how this module solves real business problems in a working Viindoo environment.
Need help with E-Invoice - Viettel S-Invoice Integrator?
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: issuance now rides entirely on Odoo core's native Viettel integration; kept only the draft preview, automatic payment-status sync and portal legal disclosure on top, added the cancel-guard, and moved into the unified E-Invoice menu, tab and status filter.
- 2025-09-11 Added Identification, passport, budget code for Vietnam edi.
- 2025-09-15 Fixed Rounding subtotal when have discount.
- 2025-08-15 Fixed Wrong taxable amount.
- 2025-06-13 Fixed BuyerLegalName is require when have taxcode.
- 2025-06-09 Fixed Only get positive tax amount when needed, correct meinvoice data.
- 2025-05-06 Fixed Tax code for personal is optional.
Works Great With These Modules
Extend E-Invoice - Viettel S-Invoice Integrator with complementary Viindoo apps:
Vietnam E-Invoice Integration
The provider-agnostic hub that powers the unified E-Invoice menu, tab, status filter and Vietnam E-Invoicing settings this module plugs into.
Module l10n_vn_viin_ediPOS Receipt Viettel Sinvoice Information
Show the Viettel S-Invoice legal number, secret code and lookup URL on the Point of Sale receipt, as the legal disclosure requires.
Module l10n_vn_viin_accounting_sinvoice_posVietnam Electronic Invoice Line Grouping
Provide options to issue an e-invoice on a detailed or line-grouped form, including for invoices issued via Viettel S-Invoice.
Module l10n_vn_edi_line_groupingVietnam 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.
Accounting Managers
Manage Viettel S-Invoice e-invoices seamlessly, alongside every other provider, while staying compliant with state regulations.
Companies Already Using Viettel S-Invoice
Keep your existing Viettel S-Invoice registration while gaining the unified E-Invoice interface and the cancel-guard.
Implementers & Odoo Partners
Looking for a production-ready Viettel S-Invoice add-on to deliver Vietnam-localized projects faster and at lower risk.
Cài đặt
- Truy cập Ứng dụng.
- Tìm từ khóa l10n_vn_viin_accounting_sinvoice.
- Ấn Cài đặt.
Hướng dẫn sử dụng
Video hướng dẫn: Tích hợp E-Invoice - Viettel S-Invoice
Phân hệ này giúp công ty phát hành hóa đơn điện tử Việt Nam qua Viettel S-Invoice. Việc phát hành, điều chỉnh, thay thế và tải hóa đơn nay chạy hoàn toàn trên tích hợp Viettel gốc của Odoo; phân hệ này chỉ bổ sung một số tiện ích mà lõi chưa có - xem trước bản nháp trước khi phát hành, tự động đồng bộ trạng thái thanh toán, hiển thị công bố pháp lý trên cổng thông tin khách hàng, và cơ chế chặn hủy trên hóa đơn S-Invoice đã phát hành - và đưa tất cả các tiện ích đó vào cùng một giao diện Hóa đơn điện tử thống nhất dùng chung cho mọi nhà cung cấp trong bộ phân hệ này.
1. Chọn Viettel S-Invoice làm nhà cung cấp.
- 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.
- Đặt Nhà cung cấp là Viettel S-Invoice. Các trường kết nối Viettel (tài khoản, chế độ thử nghiệm/chính thức, thông tin đăng nhập) sẽ hiện ra bên dưới.
2. Xem trước bản nháp trước khi phát hành (tiện ích riêng của phân hệ này).
- Trên một hóa đơn khách hàng chưa phát hành đang định tuyến qua Viettel S-Invoice, ấn Xem trước bản nháp S-Invoice cạnh nút Gửi & In thông thường. Thao tác này mở ra bản PDF đúng như khi được phát hành, chưa cấp số hóa đơn điện tử và chưa gửi gì lên cơ quan thuế - một cách an toàn để kiểm tra bố cục và số liệu trước.
3. Phát hành hóa đơn điện tử qua Gửi & In.
- Vào sổ hóa đơn (Đã vào sổ), rồi chạy Gửi & In như bình thường. Lõi Odoo gửi hóa đơn lên Viettel S-Invoice và trả về số hóa đơn điện tử, trạng thái pháp lý cùng các tệp đã sinh - tất cả được hiển thị chung trên tab Hóa đơn điện tử của hóa đơn, cạnh các trường của mọi nhà cung cấp khác.
- Hóa đơn điện tử mang ngày của hóa đơn: hóa đơn có ngày trước hôm nay vẫn phát hành được, còn hóa đơn có ngày sau hôm nay chỉ phát hành được từ ngày đó.
- Với khách hàng cá nhân, số định danh cá nhân (CCCD) nhập trên liên hệ, hoặc số hộ chiếu khi không có số định danh, được gửi lên Viettel S-Invoice cùng hóa đơn điện tử.
4. Tải về các tệp đã sinh ra.
- Sau khi phát hành, tải bản thể hiện hoặc bản chuyển đổi của hóa đơn S-Invoice ngay trên tab Hóa đơn điện tử của hóa đơn.
5. 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 - Viettel S-Invoice cũng nằm chung, cạnh bất kỳ nhà cung cấp nào khác bạn đang dùng.
6. Trạng thái thanh toán tự động đồng bộ (tiện ích riêng của phân hệ này).
- Khi bật Đồng bộ Trạng thái Thanh toán trên cấu hình nhà cung cấp Viettel S-Invoice (mặc định đang bật), việc ghi nhận thanh toán trên hóa đơn trong Odoo sẽ tự động đẩy trạng thái đã thanh toán lên Viettel S-Invoice - không cần thao tác thủ công.
7. Khách hàng thấy công bố pháp lý trên cổng thông tin (tiện ích riêng của phân hệ này).
- Sau khi phát hành, trang hóa đơn trên cổng thông tin khách hàng hiển thị số hóa đơn điện tử hợp pháp, mã bí mật và đường dẫn tra cứu trên hệ thống Viettel S-Invoice - để khách hàng có thể tự tra cứu, xác minh hóa đơn điện tử một cách độc lập.
8. Điều chỉnh hoặc thay thế thay vì hủy một hóa đơn S-Invoice đã phát hành.
- Một hóa đơn Viettel S-Invoice đã 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 - phân hệ này chặn thao tác này ngay cả khi bạn ấn nút Yêu cầu Hủy gốc của lõi. Nút vẫn hiển thị bình thường, nhưng khi ấn vào sẽ hiện thông báo hướng dẫn bạn điều chỉnh hoặc thay thế hóa đơn điện tử thay vì hủy, để một hóa đơn S-Invoice đã phát hành hợp lệ không thể bị tách khỏi bản ghi tại cơ quan thuế một cách âm thầm.
- Để điều chỉnh tăng một hóa đơn S-Invoice đã phát hành (pháp luật yêu cầu điều chỉnh tăng ghi số dương), trước hết cài ứng dụng Debit Notes (Hóa đơn điều chỉnh tăng) trong Ứng dụng nếu chưa cài. Sau đó mở hóa đơn và chọn Hành động > Hóa đơn điều chỉnh tăng. Giữ Sao chép các dòng để bắt đầu từ các dòng của hóa đơn gốc, rồi sửa các dòng theo số tiền tăng thêm. Trên tab Hóa đơn điện tử của hóa đơn điều chỉnh tăng, kiểm tra Loại điều chỉnh là Điều chỉnh tiền và, với khách hàng là tổ chức, nhập văn bản thỏa thuận tại Tên văn bản thỏa thuận: Gửi & In từ chối hóa đơn điều chỉnh tăng của khách hàng là tổ chức khi chưa có văn bản này, như trình hướng dẫn tạo hóa đơn điều chỉnh giảm, trừ khi người bán hoặc giao dịch thuộc trường hợp được miễn. Xác nhận rồi chạy Gửi & In: Viettel S-Invoice nhận đây là hóa đơn điều chỉnh tăng của hóa đơn điện tử gốc, hóa đơn gốc khi đó hiển thị đã điều chỉnh. Trong sổ sách, đây vẫn là một hóa đơn bán hàng thông thường. Hóa đơn điện tử đã bị thay thế hoặc đã hủy không còn hiệu lực: hãy điều chỉnh tăng hóa đơn thay thế.
9. Quản lý cấu hình đánh số S-Invoice từ menu Hóa đơn điện tử.
- Truy cập menu Hóa đơn điện tử thống nhất (Kế toán > Cấu hình > Hóa đơn điện tử) và mở mục SInvoice để vào Mẫu hóa đơn và Ký hiệu hóa đơn riêng của Viettel dùng để đánh số hóa đơn S-Invoice - có thể truy cập từ cùng một nơi với mọi thiết lập hóa đơn điện tử khác, thay vì phải tìm trong thiết lập chung của phân hệ Hóa đơn.
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.
