Thông tin Hóa đơn Điện tử Viettel Sinvoice trên Biên lai POS
bởi Viindoo
| Số dòng Code | 486 |
| Tên kỹ thuật | l10n_vn_viin_accounting_sinvoice_pos |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/18.0/l10n_vn_viin_accounting_sinvoice_pos |
| Đọc mô tả cho | v 16.0 v 17.0 |
| Yêu cầu các App | Invoicing (account) Discuss (mail) Inventory (stock) |
| Bao gồm Các phụ thuộc | Tích hợp Hóa đơn Điện tử Việt Nam Tích hợp Hóa đơn Điện tử Viettel S-Invoice Thông tin chung của Hóa đơn Điện tử trên Biên lai POS Điểm bản lẻ hóa đơn hoàn tiền mở rộng 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 |
POS Receipt - Viettel S-Invoice Information
Print the Viettel S-Invoice e-invoice number, lookup code and lookup URL on the point of sale receipt, keeping every cash-register sale compliant with Decree 254/2026/ND-CP.
Odoo 18.0 · Community and Enterprise · OPL-1
Extends Show EInvoice Information on POS Receipt with Viettel S-Invoice.
Key Features
Built natively on Odoo/Viindoo to streamline real business operations:
Decree 254/2026/ND-CP Receipt Disclosure
Prints the invoice number, the secure lookup code and the lookup URL for a Viettel S-Invoice e-invoice right on the printed POS receipt.
One Shared Receipt Layout
Plugs Viettel S-Invoice into the single, provider-agnostic POS receipt layout - no separate template to configure or maintain.
Built on Odoo's S-Invoice Integration
Works on top of Odoo's own Viettel S-Invoice point-of-sale integration, which issues the e-invoice at checkout - nothing to re-implement.
Benefits
Keeps every cash-register sale invoiced through Viettel S-Invoice compliant with Vietnam's Decree 254/2026/ND-CP e-invoice disclosure requirement.
Customers can verify their e-invoice directly from the printed receipt - invoice number, lookup code and lookup URL, no separate lookup needed.
Once Auto-send to SInvoice is on for the point of sale, the disclosure appears on its own - no receipt template to design.
The receipt looks and behaves the same whichever e-invoice provider the company uses, so cashiers need to learn only one layout.
A new register takes the company's Default PoS Symbol, so adding registers needs no extra receipt setup.
Decree 254/2026/ND-CP disclosure on the printed receipt
Viettel S-Invoice returns no tax authority code, so the receipt carries the invoice number and the lookup code.
Enable Viettel S-Invoice at the register
One-time setup: S-Invoice account, symbol and default serial
See POS Receipt - Viettel S-Invoice Information in Action
See how this module solves real business problems in a working Viindoo environment.
Need help with POS Receipt - Viettel S-Invoice Information?
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
Works Great With These Modules
Extend POS Receipt - Viettel S-Invoice Information with complementary Viindoo apps:
Vietnamese E-Invoice Integration
The provider-agnostic backbone: one E-Invoice menu, one status filter and one settings section for every Vietnamese e-invoice provider.
Module l10n_vn_viin_ediE-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
The shared, provider-agnostic Decree 254/2026/ND-CP receipt disclosure this module plugs Viettel S-Invoice into.
Module l10n_vn_viin_edi_posWho Should Use This Module?
Built for Vietnamese retail and food-service businesses that issue e-invoices through Viettel S-Invoice at the point of sale:
Retail & Shopping Centers
Supermarkets and shopping centers that must print the Decree 254/2026/ND-CP disclosure on every cash-register e-invoice.
Restaurants, Cafes & Hotels
Food-and-beverage and hospitality businesses issuing Viettel S-Invoice e-invoices straight from the register.
Accounting & Compliance Teams
Teams that need proof the mandated e-invoice disclosure reaches the customer at the point of sale, not only on the backend invoice.
Cài đặt
- Truy cập Ứng dụng.
- Tìm từ khóa l10n_vn_viin_accounting_sinvoice_pos.
- Ấn Kích hoạt.
Hướng dẫn sử dụng
Phân hệ này là một cầu nối mỏng giữa Viettel S-Invoice và điểm bán hàng (POS). Nó không có màn hình riêng: khi được cài cùng Tích hợp Hóa đơn Điện tử Viettel S-Invoice (l10n_vn_viin_accounting_sinvoice), Thông tin chung của Hóa đơn Điện tử trên Biên lai POS (l10n_vn_viin_edi_pos) và phân hệ điểm bán hàng Viettel S-Invoice của Odoo core (l10n_vn_edi_viettel_pos), một giao dịch bán tại máy tính tiền được phát hành hóa đơn điện tử qua Viettel S-Invoice sẽ in ra biên lai khách hàng phần công bố hóa đơn điện tử bắt buộc theo Nghị định 254/2026/NĐ-CP - dùng chung một mẫu biên lai với mọi nhà cung cấp hóa đơn điện tử khác.
Note
Mở rộng Thông tin chung của Hóa đơn Điện tử trên Biên lai POS - xem tài liệu của phân hệ này: l10n_vn_viin_edi_pos.
1. Xác nhận các phân hệ bắt buộc đã được cài đặt.
- Odoo tự động cài đặt Tích hợp Hóa đơn Điện tử Viettel S-Invoice, Thông tin chung của Hóa đơn Điện tử trên Biên lai POS và phân hệ điểm bán hàng Viettel S-Invoice như các phân hệ phụ thuộc khi bạn cài đặt phân hệ này từ Ứng dụng.
2. Thiết lập Viettel S-Invoice làm nhà cung cấp hóa đơn điện tử của công ty.
- Truy cập Hóa đơn > Cấu hình > Hóa đơn điện tử > Dịch vụ hóa đơn điện tử (ứng dụng này tên là Kế toán ở ấn bản Enterprise) và mở dịch vụ S-Invoice API v2 của công ty. Chế độ của dịch vụ là Kiểm thử khi bạn chạy thử và Vận hành khi phát hành hóa đơn thật.
- Truy cập Hóa đơn > Cấu hình > Hóa đơn điện tử > Viettel S-Invoice để tạo Mẫu hóa đơn và Ký hiệu hóa đơn đã đăng ký với Viettel, rồi truy cập Hóa đơn > Cấu hình > Hóa đơn điện tử > Ký hiệu hóa đơn điện tử để tạo một ký hiệu dùng dịch vụ S-Invoice và một mẫu hóa đơn điện tử.
- Truy cập Hóa đơn > Cấu hình > Thiết lập. Tại phần Tích hợp Việt Nam, nhập Tên đăng nhập và Mật khẩu của tài khoản Viettel S-Invoice trong Thiết lập SInvoice, và chọn Ký hiệu mặc định cho POS dùng cho mọi điểm bán hàng chưa có ký hiệu riêng.
- Tại phần Hóa đơn điện tử Việt Nam của cùng trang Thiết lập, đặt Ký hiệu Hóa đơn mặc định là ký hiệu của dịch vụ S-Invoice. Khách hàng chưa có ký hiệu riêng, chẳng hạn người mua tại điểm bán hàng, sẽ được xuất hóa đơn qua Viettel S-Invoice.
3. Bật phát hành Viettel S-Invoice tự động trên điểm bán hàng.
- Truy cập Điểm bán hàng > Cấu hình > Thiết lập, chọn điểm bán hàng dùng tại quầy và, tại phần Kế toán, bật Tự động gửi SInvoice (tùy chọn này được bật sẵn với điểm bán hàng mới của công ty Việt Nam). Mọi đơn hàng được xuất hóa đơn sẽ được gửi tới Viettel S-Invoice theo thời gian thực.
- Trường Ký hiệu hóa đơn bên dưới là ký hiệu hóa đơn của điểm bán hàng này. Trường được điền sẵn bằng Ký hiệu mặc định cho POS của công ty; chỉ đổi khi muốn cấp ký hiệu riêng cho điểm bán hàng này. Nếu chưa có ký hiệu, máy tính tiền từ chối xác nhận đơn hàng xuất hóa đơn và hiển thị Lỗi cấu hình yêu cầu đặt ký hiệu hóa đơn POS hoặc tắt Tự động gửi SInvoice.
4. Hoàn tất một đơn hàng POS có xuất hóa đơn.
- Tại quầy, thêm sản phẩm, chọn khách hàng rồi ấn Thanh toán. Với công ty Việt Nam, tùy chọn Hóa đơn đã được bật sẵn (chỉ tắt sẵn với đơn trả hàng) và khách hàng là Walk-in Customer cho tới khi bạn chọn khách khác.
- Chọn phương thức thanh toán rồi ấn Xác nhận. Đơn hàng được xuất hóa đơn và phát hành qua Viettel S-Invoice.
5. Đọc phần công bố theo Nghị định 254/2026/NĐ-CP trên biên lai đã in.
- Trên màn hình biên lai, khối THÔNG TIN HÓA ĐƠN ĐIỆN TỬ nằm sau các dòng đơn hàng. Khối này hiển thị ghi chú hóa đơn điện tử khởi tạo từ máy tính tiền, tên, địa chỉ và mã số thuế của khách hàng (khi khách hàng có), ký hiệu hóa đơn điện tử, Số HĐ, Mã tra cứu và URL tra cứu để khách hàng kiểm tra hóa đơn điện tử. Khối này được vẽ bởi mẫu biên lai chung, độc lập nhà cung cấp.
- Viettel S-Invoice không trả mã cơ quan thuế về cho Odoo, nên dòng Mã CQT không xuất hiện trên các biên lai này; số hóa đơn và mã tra cứu giúp khách hàng tra cứu hóa đơn điện tử.
6. Khi hóa đơn điện tử chưa được gửi.
- Khi hóa đơn vẫn đang chờ gửi sau thanh toán, chẳng hạn do thiếu thông tin đăng nhập Viettel S-Invoice trong Thiết lập SInvoice hoặc không kết nối được dịch vụ, máy tính tiền hiển thị thông báo Lỗi SInvoice yêu cầu kiểm tra chi tiết ở hệ thống quản trị và thử lại. Biên lai khi đó được in không có khối THÔNG TIN HÓA ĐƠN ĐIỆN TỬ; khối này chỉ xuất hiện khi hóa đơn điện tử đã có số hóa đơn. Hãy khắc phục nguyên nhân rồi gửi lại hóa đơn từ chính hóa đơn trong hệ thống quản trị.
- Khi hóa đơn điện tử đã được phát hành nhưng số hóa đơn chưa trả về, máy tính tiền kiểm tra lại tối đa ba lần, cách nhau một giây, trước khi in biên lai. Nếu vẫn chưa có số hóa đơn, biên lai được in không có khối THÔNG TIN HÓA ĐƠN ĐIỆN TỬ.
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.