Tích hợp Hóa đơn Điện tử Viettel S-Invoice
| Số dòng Code | 1097 |
| Tên kỹ thuật | l10n_vn_viin_accounting_sinvoice |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.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 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ở Nền tảng Kế toán Ghi nhật ký API Request Số hóa đơn pháp lý |
| Các mở rộng | [TEST] Adapter Kiểm thử Nhà cung cấp Hóa đơn Điện tử Việt Nam |
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 19.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
Note
Mở rộng l10n_vn_viin_edi - xem tài liệu của phân hệ đó.
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à trên biên lai điểm bán 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. Thiết lập dịch vụ Viettel S-Invoice.
- Truy cập Kế toán ‣ Cấu hình ‣ Hóa đơn điện tử ‣ Dịch vụ hóa đơn điện tử và mở (hoặc tạo mới) bản ghi dịch vụ dành cho Viettel S-Invoice.
- Trên tab Configuration, điền các trường kết nối: Chế độ (Kiểm thử hoặc Vận hành), cùng Tên đăng nhập/Mật khẩu cho môi trường vận hành, hoặc Tên đăng nhập sandbox/ Mật khẩu sandbox cho môi trường kiểm thử.
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 S- Invoice dự thảo 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.
4. Tải về các tệp đã sinh ra.
- Sau khi phát hành, tải Bản thể hiện hóa đơn điện tử (bản PDF), Tệp tin chuyển đổi hóa đơn điện tử, hoặc Bản thể hiện hóa đơn điện tử (Zip/XML) ngay trên tab Hóa đơn điện tử của hóa đơn, trong mục Tài liệu.
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 Hóa đơn điện tử đã phát hành / Hóa đơn điện tử đã hủy / Hóa đơn điện tử bị lỗi, hoặc gom nhóm theo 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ộ tình trạng thanh toán trên tab Cài đặt S-Invoice của bản ghi dịch vụ 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ị thẻ Hóa đơn điện tử với số hóa đơn điện tử hợp pháp, đường dẫn tra cứu, mã số thuế của công ty, mã bí mật và - khi Viettel S-Invoice trả về cho giao dịch đó - mã cơ quan thuế, để 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. Công bố tương tự cũng được in trên biên lai điểm bán hàng.
- Một đơn hàng điểm bán hàng được phát hành hóa đơn điện tử qua Viettel S-Invoice cũng nhận được cùng khối công bố bắt buộc theo Nghị định 123 trên biên lai in ra như mọi nhà cung cấp hóa đơn điện tử khác - số hóa đơn, mã tra cứu và đường dẫn tra cứu, cùng mã QR mã hóa đường dẫn đó. Xem hướng dẫn sử dụng của Thông tin chung của Hóa đơn Điện tử trên Biên lai POS (l10n_vn_viin_edi_pos) để biết đầy đủ các bước.
- Một điểm riêng của Viettel S-Invoice: số hóa đơn và mã tra cứu luôn được in ngay khi hóa đơn điện tử được phát hành, nhưng dòng mã cơ quan thuế chỉ xuất hiện khi Viettel S-Invoice thực sự trả về mã đó cho giao dịch.
9. Đ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.
10. 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.