Cài Đặt Hóa Đơn Điện Tử¶
Trang Cài Đặt HĐ Điện Tử (/dashboard/financial/einvoices/settings) cho phép cấu hình kết nối với nhà cung cấp hóa đơn điện tử. Hệ thống hỗ trợ 4 nhà cung cấp chính tại Việt Nam và cho phép cấu hình ở cấp chuỗi hoặc ghi đè riêng cho từng khách sạn.
Giao Diện Theo Vai Trò¶
Trang này hiển thị khác nhau tùy theo vai trò người dùng:
| Vai trò | Giao diện |
|---|---|
| Chain Owner / Chain Manager | Có 2 tab: Chain Config (cấu hình chuỗi) và Hotel Override (ghi đè khách sạn) |
| Hotel Manager | Chỉ hiển thị cấu hình của khách sạn (không có tab) |
Cấu Hình Chuỗi (Chain Config)¶
Tab này chỉ dành cho Chain Owner / Chain Manager. Cấu hình tại đây sẽ được áp dụng cho tất cả khách sạn trong chuỗi nếu khách sạn không có cấu hình riêng.
| # | Phần tử | Mô tả |
|---|---|---|
| ① | Quay lại | Nút điều hướng về trang trước |
| ② | Tiêu đề | "Cài đặt hóa đơn điện tử" |
| ③ | Tab Chain Config | Tab đang active — cấu hình chuỗi |
| ④ | Tab Hotel Override | Chuyển sang xem/chỉnh sửa cấu hình riêng của khách sạn |
| ⑤ | Alert thông tin | Giải thích phạm vi áp dụng của cấu hình chuỗi |
| ⑥ | Loại nhà cung cấp | Dropdown chọn nhà cung cấp HĐĐT |
| ⑦ | API URL | Endpoint kết nối tới hệ thống nhà cung cấp |
| ⑧ | Username | Tên đăng nhập tài khoản nhà cung cấp |
| ⑨ | Password | Mật khẩu (ô nhập bảo mật, có toggle ẩn/hiện) |
| ⑩ | Serial Cert (HSM) | Mã serial chứng thư số HSM |
| ⑪ | Invoice Configuration | Tiêu đề phân đoạn thứ hai |
| ⑫ | Mã số thuế | MST doanh nghiệp (dùng trên hóa đơn) |
| ⑬ | Tên công ty | Tên đơn vị phát hành hóa đơn |
| ⑭ | Địa chỉ công ty | Địa chỉ đầy đủ (chiếm toàn bộ hàng) |
| ⑮ | Mẫu số | Ký hiệu mẫu hóa đơn (pattern) |
| ⑯ | Ký hiệu | Serial của mẫu hóa đơn |
| ⑰ | Đơn vị tiền tệ | VND hoặc USD |
| ⑱ | Thuế suất mặc định | % VAT áp dụng mặc định (0/5/8/10) |
| ⑲ | Lưu cấu hình chuỗi | Nút lưu — áp dụng cho toàn chuỗi |
Nhà Cung Cấp Hóa Đơn Điện Tử¶
| Giá trị | Tên hiển thị | Nhà cung cấp |
|---|---|---|
HILO |
HILO (Softdreams) | Công ty Softdreams |
VIETTEL |
Viettel S-Invoice | Viettel |
VNPT |
VNPT Invoice | VNPT |
MISA |
MISA meInvoice | MISA |
Cấu Hình Khách Sạn (Hotel Override)¶
Tab Hotel Override (Chain User) hoặc trang chính (Hotel Manager) hiển thị cấu hình hiện tại của khách sạn. Có 3 trạng thái khác nhau:
Trạng Thái 1 — Đang Dùng Cấu Hình Chuỗi¶
Khi khách sạn chưa có cấu hình riêng, hệ thống kế thừa từ chuỗi:
| # | Phần tử | Mô tả |
|---|---|---|
| ① | Tab Hotel Override | Tab đang active |
| ② | Alert thông tin | Thông báo "Đang sử dụng cấu hình từ chuỗi" |
| ③ | Xem trước cấu hình | Bảng Descriptions (chỉ đọc) hiển thị toàn bộ thông số chuỗi |
| ④ | Cấu hình riêng | Nút primary (EditOutlined) — bắt đầu tạo cấu hình riêng cho KS |
Trạng Thái 2 — Có Cấu Hình Riêng¶
Khi khách sạn đã lưu cấu hình độc lập:
| # | Phần tử | Mô tả |
|---|---|---|
| ① | Tab Hotel Override | Tab đang active |
| ② | Alert cảnh báo | Thông báo KS đang dùng cấu hình riêng (override chuỗi) |
| ③ | Form chỉnh sửa | ProviderConfigForm với các trường đang được điền sẵn |
| ④ | Hoàn tác | Nút đỏ (Popconfirm xác nhận) — xóa cấu hình riêng, quay về dùng chuỗi |
| ⑤ | Lưu | Lưu thay đổi cấu hình riêng của KS |
Trạng Thái 3 — Đang Tạo Cấu Hình Mới¶
Khi nhấn "Cấu hình riêng" từ Trạng thái 1 hoặc khách sạn chưa có cấu hình chuỗi:
| # | Phần tử | Mô tả |
|---|---|---|
| ① | Alert thông tin | Hướng dẫn điền đầy đủ thông tin |
| ② | Form trống | ProviderConfigForm để điền mới |
| ③ | Lưu | Tạo và lưu cấu hình riêng mới |
Tham Chiếu Trường Cấu Hình¶
Phần Kết Nối Nhà Cung Cấp¶
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Loại nhà cung cấp | ✓ | Chọn HILO / Viettel / VNPT / MISA |
| API URL | ✓ | URL endpoint API của nhà cung cấp |
| Username | ✓ | Tên đăng nhập tài khoản phát hành HĐĐT |
| Password | ✓ | Mật khẩu tài khoản (lưu mã hóa) |
| Serial Cert (HSM) | — | Số serial chứng thư số phần cứng HSM (nếu có) |
Phần Cấu Hình Hóa Đơn¶
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Mã số thuế | ✓ | MST của đơn vị in trên hóa đơn |
| Tên công ty | ✓ | Tên đơn vị bán hàng in trên hóa đơn |
| Địa chỉ công ty | ✓ | Địa chỉ đầy đủ in trên hóa đơn |
| Mẫu số (Pattern) | ✓ | Ký hiệu mẫu do Tổng cục Thuế cấp (VD: 01GTKT0/001) |
| Ký hiệu (Serial) | ✓ | Serial ký hiệu hóa đơn (VD: AA/23E) |
| Đơn vị tiền tệ | ✓ | VND (mặc định) hoặc USD |
| Thuế suất mặc định | — | % VAT áp dụng khi tạo dòng hàng hóa mới (0/5/8/10) |
Luồng Cấu Hình Khuyến Nghị¶
Chain User thiết lập cấu hình chuỗi
→ Tất cả KS tự động kế thừa
→ KS nào cần cấu hình khác → Hotel Override
→ KS nào muốn quay về chuỗi → Hoàn tác (Revert)
Mẹo & Thực Hành Tốt Nhất¶
Cấu hình chuỗi trước, ghi đè sau
Thiết lập cấu hình chuỗi với thông tin chính xác trước. Chỉ tạo Hotel Override cho các khách sạn có MST, mẫu số, hoặc nhà cung cấp khác với chuỗi.
Mẫu số và ký hiệu phải khớp với đăng ký thuế
Mẫu số và ký hiệu sai sẽ khiến hóa đơn bị từ chối bởi cơ quan thuế. Kiểm tra thông tin đăng ký sử dụng HĐĐT trước khi điền.
Password được lưu mã hóa
Trường Password hiển thị dạng ẩn (••••••). Hệ thống không hiển thị lại mật khẩu đã lưu — nếu cần thay đổi, nhập trực tiếp vào ô và lưu lại.
Hoàn tác không thể khôi phục cấu hình riêng
Nhấn Hoàn tác sẽ xóa vĩnh viễn cấu hình riêng của khách sạn và chuyển về dùng cấu hình chuỗi. Hành động này có Popconfirm xác nhận — đọc kỹ trước khi xác nhận.
Kiểm tra kết nối sau khi lưu
Sau khi lưu cấu hình, thử phát hành một hóa đơn DRAFT để xác nhận kết nối API hoạt động đúng. Nếu có lỗi, kiểm tra lại API URL và thông tin đăng nhập.
Câu Hỏi Thường Gặp¶
Hotel Manager có thể tự cấu hình không?
Có. Hotel Manager thấy trang cấu hình trực tiếp (không có tab). Nếu KS đang dùng cấu hình chuỗi, Hotel Manager thấy nút Cấu hình riêng để tạo override. Nếu đã có cấu hình riêng, Hotel Manager có thể chỉnh sửa và lưu.
Khách sạn không có chuỗi thì sao?
Nếu chuỗi chưa có cấu hình, trạng thái hiển thị là NONE — KS cần tự tạo cấu hình riêng. Không có cấu hình nào để kế thừa.
Có thể dùng nhiều nhà cung cấp khác nhau trong cùng chuỗi không?
Có, thông qua Hotel Override. Ví dụ: chuỗi dùng HILO, nhưng một KS cụ thể đã ký hợp đồng với Viettel — KS đó tạo Hotel Override với providerType = VIETTEL.
Serial Cert (HSM) là gì và có bắt buộc không?
Serial Cert là mã số của thiết bị phần cứng HSM (Hardware Security Module) dùng để ký số hóa đơn. Chỉ bắt buộc với nhà cung cấp yêu cầu ký số bằng HSM (một số gói dịch vụ của VNPT/Viettel). Nếu dùng ký số bằng phần mềm, để trống.
Thay đổi cấu hình có ảnh hưởng đến hóa đơn đã phát hành không?
Không. Hóa đơn đã phát hành (ISSUED) lưu thông tin tại thời điểm phát hành. Thay đổi cấu hình chỉ ảnh hưởng đến các hóa đơn tạo mới sau đó.
Liên Kết Liên Quan¶
- Hóa Đơn Điện Tử — Danh sách và quản lý HĐĐT
- Hóa Đơn — Hóa đơn thông thường trong hệ thống
- Thanh Toán — Giao dịch thanh toán liên kết với HĐĐT