Giao diện
Cấu hình hệ thống
Mục đích
Tab Cấu hình trong KTV Dashboard cho phép KTV chỉnh các tham số kết nối kỹ thuật của hệ thống (Google Sheet tổng, thư mục Drive lưu file, webhook n8n, kết nối Affise) mà không cần lập trình viên can thiệp. Đây là công cụ vận hành: chỉnh sai địa chỉ kết nối là các tính năng phụ thuộc sẽ ngừng chạy, nên chỉ sửa khi bạn biết rõ giá trị mới.
KTV không xem số liệu tài chính / nghiệp vụ
Vai trò KTV chỉ quản trị kỹ thuật (kết nối, người dùng, tình trạng hệ thống, khớp số). KTV không thấy tiền, công nợ, số chốt hay bất kỳ số liệu quyết toán nào. Xem Vai trò & phân quyền.
Cách dùng
- Mở KTV Dashboard. Trang có 4 tab: Cấu hình, Người dùng, Tình trạng hệ thống, Khớp số. Tab Cấu hình mở sẵn mặc định.
Xem danh sách tham số. Mỗi tham số là một thẻ gồm: nhãn dễ đọc, một mã kỹ thuật nhỏ bên cạnh, và có thể có nhãn phụ secret (giá trị bí mật, bị che) hoặc override (đang dùng giá trị tùy chỉnh, khác mặc định).
Sửa một tham số thường (không bí mật): gõ giá trị mới vào ô. Ô để trống mang ý nghĩa quay về giá trị mặc định của hệ thống — không phải xóa trắng vĩnh viễn.
Sửa một tham số bí mật (ví dụ Affise API key): ô luôn hiện trống với gợi ý dấu chấm
••••• (giá trị ẩn — nhập mới để đổi). Gõ giá trị mới để thay. Bấm nút con mắt 👁 để xem những gì bạn đang gõ, bấm 🙈 để ẩn lại.
- Bấm nút Lưu N thay đổi ở cuối trang (N = số ô bạn vừa sửa — nút hiển thị đúng con số này để bạn kiểm tra trước khi lưu). Muốn bỏ toàn bộ chỉnh sửa chưa lưu, bấm Hủy.
- Lưu xong, hệ thống báo Đã lưu N settings. Giá trị mới có hiệu lực sau khoảng 5 phút (hệ thống lưu tạm để chạy nhanh).
Các tình huống có thể gặp
| Tình huống | Hệ thống xử lý | Bạn cần làm gì |
|---|---|---|
| Sửa nhiều tham số rồi bấm lưu | Lưu tất cả cùng một lần (hàng loạt); nút ghi rõ số lượng để bạn xác nhận | Kiểm tra con số trên nút khớp với số ô đã sửa rồi mới bấm |
| Xóa trắng một ô thường rồi lưu | Tham số quay về giá trị mặc định; nhãn override biến mất | Chỉ làm khi thực sự muốn về mặc định |
| Không sửa ô nào | Nút Lưu và Hủy bị mờ (không bấm được) | Sửa ít nhất một ô mới lưu được |
| Bấm Hủy | Mọi chỉnh sửa chưa lưu bị bỏ, các ô về lại giá trị trước đó | Dùng khi muốn hủy bỏ toàn bộ thay đổi đang gõ dở |
| Tham số có nhãn override | Đang chạy bằng giá trị tùy chỉnh (khác mặc định) | Không cần làm gì — chỉ là dấu hiệu nhận biết |
| Lưu tham số bí mật xong, ô lại trống | Đúng thiết kế: giá trị bí mật luôn bị che, ô reset về trống sau mỗi lần lưu | Không cần làm gì |
⚠ Lưu ý
Ô để trống = quay về mặc định, không phải "giữ nguyên"
Nếu bạn đã sửa một ô rồi xóa hết nội dung và bấm lưu, tham số đó bị đưa về giá trị mặc định của hệ thống. Với webhook n8n hoặc Affise API key, điều này có thể ngắt kết nối khiến hóa đơn, ảnh bill hoặc đồng bộ Affise ngừng chạy. Nếu chỉ muốn giữ nguyên, đừng động vào ô đó.
Thay đổi có độ trễ ~5 phút
Hệ thống lưu tạm cấu hình 5 phút. Sau khi lưu, giá trị mới chưa có hiệu lực ngay; hãy chờ khoảng 5 phút rồi mới kiểm tra tính năng liên quan.
Không phải mọi thông tin kết nối đều nằm ở đây
Chỉ các tham số trong danh sách cho phép mới sửa được tại tab này. Thông tin đăng nhập của bot Telegram, OCR, AI... không nằm ở đây (chúng được cấu hình bên n8n). Không thấy chúng là đúng, không phải lỗi.
Danh sách tham số sửa được
Hiện có 10 tham số: Sheet ID (KT Tổng), Tab name (KT Tổng), Drive folder ID cho invoice PDF, Drive folder ID cho bill ảnh, n8n invoice webhook URL, n8n bill ingest webhook URL, n8n bill reply webhook URL, n8n webhook timeout (giây), Affise base URL, và Affise API key (bí mật). Chỉ có Affise API key bị che; các tham số còn lại hiện giá trị thật.
Lỗi thường gặp & cách xử lý
| Triệu chứng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Nút Lưu mờ, bấm không được | Chưa sửa ô nào (không có thay đổi để lưu) | Sửa ít nhất một ô; nút sẽ sáng và hiện số thay đổi |
| Báo Lưu thất bại, kiểm tra log | Lỗi kết nối tới máy chủ hoặc lỗi hệ thống | Thử lưu lại; nếu vẫn lỗi, chụp màn hình và báo lập trình viên |
| Sửa xong nhưng hệ thống vẫn dùng giá trị cũ | Bộ nhớ tạm 5 phút chưa hết hạn | Chờ khoảng 5 phút rồi kiểm tra lại |
| Nhập Affise API key mới, lưu xong ô vẫn trống / vẫn hiện dấu chấm | Giá trị bí mật luôn bị che và ô luôn reset về trống sau khi lưu | Bình thường — nếu báo Đã lưu, giá trị đã được cập nhật |
| Bấm 👁 mà không thấy giá trị bí mật cũ hiện ra | Nút con mắt chỉ hiện nội dung bạn đang gõ, không hiển thị lại giá trị cũ đã lưu | Muốn đổi thì gõ giá trị mới; giá trị cũ không bao giờ hiện lại nguyên văn |
Ví dụ minh hoạ
KTV cần đổi thời gian chờ webhook n8n từ 30 giây lên 60 giây, đồng thời cập nhật lại địa chỉ n8n invoice webhook URL.
- Vào KTV Dashboard → tab Cấu hình.
- Tại ô n8n webhook timeout (giây), xóa
30và gõ60. Nhãn override xuất hiện trên thẻ này. - Tại ô n8n invoice webhook URL, dán địa chỉ mới.
- Cuối trang, nút hiện Lưu 2 thay đổi — đúng bằng 2 ô vừa sửa.
- Bấm nút. Hệ thống báo Đã lưu 2 settings.
- Chờ khoảng 5 phút để cấu hình mới có hiệu lực, sau đó thử tạo một hóa đơn để kiểm tra webhook chạy đúng.
Xem thêm: Người dùng & Tình trạng hệ thống · Khớp số (KTV) · Từ điển thuật ngữ