Thông báo lỗi trên dịch vụ công Kho bạc Nhà nước thường ngắn và khó hiểu, nhưng phần lớn thuộc vài nhóm nguyên nhân quen thuộc: chương trình ký số chưa chạy, serial chứng thư lệch, thiếu chứng thư CA, khai sai thành viên hoặc file đính kèm lỗi. Bảng dưới đây gom các lỗi dịch vụ công kho bạc đã được KBNN và Viettel-CA hướng dẫn, xếp theo giai đoạn.
Tìm đúng nguyên văn thông báo trong các bảng bên dưới. Lỗi khi bấm ký thường nằm ở máy tính: Chương trình ký số KBNN, Firefox, USB Token hoặc chứng thư CA. Lỗi khi đăng ký, thay đổi thông tin thường do khai thành viên, serial chưa đúng. Lỗi khi phê duyệt hồ sơ thường liên quan file đính kèm. Làm theo cột cách xử lý mà vẫn không được thì gửi yêu cầu tới KBNN qua [email protected] kèm mã hồ sơ và ảnh lỗi.
Cách tra bảng lỗi
Chụp nguyên văn thông báo, ghi thời điểm và bước đang làm (đăng nhập, lấy serial, phê duyệt, gửi Kho bạc). Một số thông báo có mã trong ngoặc vuông, ví dụ [KBNN-2002]; nhiều thông báo không có mã. Các dòng dưới đây tổng hợp từ tài liệu xử lý vướng mắc của KBNN (bản cập nhật tháng 12/2023), tài liệu đăng ký sử dụng, đổi mật khẩu của KBNN và hướng dẫn của Viettel-CA. Nhãn nút có thể khác đôi chút theo phiên bản hệ thống.
Lỗi trên trang web (quyền, cách khai hồ sơ) sửa bằng hồ sơ thay đổi hoặc nhờ KBNN; lỗi ở Chương trình ký số KBNN và USB Token nằm trên máy tính của người ký.
Đăng nhập, tài khoản và phân quyền
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| Không nhận được email tên đăng nhập, mật khẩu sau khi hồ sơ được duyệt | Email thành viên khai sai, hoặc dùng Yahoo Mail vốn không nhận thư từ tên miền @vst.gov.vn | Còn kế toán viên đăng nhập được: lập hồ sơ thay đổi email, KBNN duyệt xong thì dùng Quên mật khẩu. Không ai đăng nhập được: gửi văn bản đề nghị đổi email (thủ trưởng ký, đóng dấu) cho đội hỗ trợ KBNN | Đăng ký sử dụng |
| Chỉ nhận tên đăng nhập, chưa có mật khẩu; hoặc quên mật khẩu | Cần tự thiết lập mật khẩu | Trang đăng nhập → Quên mật khẩu → nhập tên đăng nhập, email đã đăng ký, mã xác nhận → Gửi → bấm “Thiết lập lại mật khẩu” trong email → mật khẩu mới ít nhất 8 ký tự, có chữ, số và ký tự đặc biệt | Đăng ký sử dụng |
| “Bạn không có quyền sử dụng chức năng này. Yêu cầu liên hệ cán bộ quản trị đơn vị” | Khi đăng ký hoặc thay đổi, đơn vị chưa tích đủ các loại dịch vụ công cần dùng | Kế toán viên lập hồ sơ thay đổi sử dụng dịch vụ công, tích đủ loại dịch vụ, gửi KBNN duyệt | Đăng ký sử dụng |
| Bấm Gửi phê duyệt nhưng không có kế toán trưởng, chủ tài khoản để chọn | Người ký chưa được gắn với số tài khoản giao dịch đã kê khai, hoặc chọn sai chức danh | Lập hồ sơ thay đổi: bấm biểu tượng kính lúp để lấy lại dự án, tài khoản và thành viên, gắn đúng chức danh, tích chọn các số tài khoản; chủ tài khoản ký gửi KBNN | Lập, ký, gửi chứng từ |
| Hồ sơ thay đổi ở “Chờ phê duyệt” nhưng không thấy nút “Ký số” ở bước 4 | Đang đăng nhập bằng tài khoản kế toán viên hoặc kế toán trưởng | Đăng xuất. Chủ tài khoản đã có tài khoản thì đăng nhập bằng tài khoản của mình; chủ tài khoản mới thì bấm Tra cứu hồ sơ ở trang đăng nhập, dán mã hồ sơ, không đăng nhập | Cập nhật chữ ký số |
Cài đặt và ký số trên máy
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| “Phần mềm ký số chưa được bật” (thường kèm mã [KBNN-1001]) | Trang dịch vụ công không kết nối được Chương trình ký số KBNN: chưa cài, đã cài nhưng chưa chạy, hoặc không dùng Firefox đã cấu hình | Bật chương trình trong thư mục KbnnSignature, cài đúng bộ cho chứng thư số công cộng, chỉnh Firefox theo hướng dẫn của KBNN | Phần mềm ký số chưa bật |
| “Kiểm tra thông tin chứng thư số trên máy, hệ thống không tìm thấy thông tin chứng thư số” | Máy chưa nhận chứng thư, hoặc chứng thư đang cắm có serial khác serial đã đăng ký | Kiểm tra Token trong Token Manager; so serial với mục quản lý chứng thư số trên hệ thống; khác thì lập hồ sơ thay đổi | Không tìm thấy chứng thư |
| “Hệ thống ký số xử lý không thành công trong quá trình đọc thông tin thiết bị” | Không đọc được USB Token | Kiểm tra Token, cài lại phần mềm chứng thư số của nhà cung cấp, khởi động lại máy rồi ký lại | Máy không nhận Token |
| “Kích hoạt CTS không thành công”, hoặc “Array index out of range” khi lấy serial | Thiếu hoặc sai chứng thư CA tương ứng với chứng thư số đang dùng | Cài lại chứng thư CA từ rootca.gov.vn hoặc nhờ nhà cung cấp, vào lại hệ thống nạp thông tin chứng thư, ký lại | Kích hoạt CTS lỗi |
| “Không xác định. Đề nghị liên hệ quản trị viên” khi nhập PIN để phê duyệt | Phần mềm Token chưa chạy, hoặc chưa cài chứng thư CA gốc | Bật lại phần mềm ký số; cài chứng thư CA gốc và CA của nhà cung cấp | Kích hoạt CTS lỗi |
| [KBNN-2002] “Kiểm tra dịch vụ OCSP chứng thư số không xác định được trạng thái từ nhà cung cấp” | Plugin ký số của KBNN xác định sai chứng thư CA của Viettel-CA khi máy có nhiều chứng thư Viettel-CA cũ, mới | Cài bản mới Chương trình ký số KBNN; chỉ giữ đúng chứng thư CA đã cấp chứng thư của bạn | Lỗi OCSP Viettel-CA |
| “Nhà cung cấp CTS đang bị khóa” hoặc “Cảnh báo: Lỗi kiểm tra thông tin chữ ký số: Null” | Xung đột chứng thư CA trung gian Viettel-CA trong kho chứng thư Windows | Theo hướng dẫn của Viettel-CA: xử lý mục Viettel-CA gây xung đột trong certmgr.msc, cài lại đúng chứng thư CA | Lỗi OCSP Viettel-CA |
| “Chứng thư số đã bị thu hồi. Trạng thái Revoked” hoặc “Trạng thái: REVOKED” | Chứng thư trên Token đã bị thu hồi hoặc hỏng; có thể vẫn ký file offline nhưng ký trên hệ thống bị từ chối | Liên hệ nhà cung cấp chứng thư để kiểm tra, cấp lại; sau đó cập nhật serial mới lên hệ thống | Chứng thư bị thu hồi |
Đăng ký, thay đổi thông tin sử dụng
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| Hồ sơ đăng ký hoặc thay đổi đứng ở “Chờ hoàn thiện” | Còn người ký (kế toán trưởng, chủ tài khoản, người được ủy quyền) chưa xác nhận serial | Bấm Tra cứu hồ sơ (không cần đăng nhập), mở hồ sơ, vào mục thông tin thành viên, bấm từng thành viên rồi Ghi, sau đó Lưu. Biểu tượng vàng là thành viên chưa hoàn thiện | Đăng ký sử dụng |
| “Số serial đã tồn tại trong hệ thống” | Khai mới một thành viên trong khi chỉ cần sửa thành viên cũ; hoặc đăng ký lại thành viên cũ đã hết hiệu lực | Bấm kính lúp ở trường họ tên để tìm và sửa thành viên cũ; trường hợp đăng ký lại thành viên cũ thì gửi yêu cầu cho đội hỗ trợ KBNN | Serial đã tồn tại |
| “Không tìm thấy thông tin thành viên thực hiện ký số” | Chủ tài khoản ký hồ sơ gia hạn chữ ký số hoặc hồ sơ thay chủ tài khoản không đúng cách | Chủ tài khoản mới dùng chứng thư mới; vào trang chủ dịch vụ công, tra cứu theo mã hồ sơ, không đăng nhập, rồi phê duyệt | Không tìm thấy thành viên ký |
| “Mã dự án đã tồn tại” hoặc “Tài khoản đã tồn tại” | Dự án chuyển chủ đầu tư, sáp nhập hoặc đã đăng ký nhầm | Cùng Kho bạc: in sao lưu hồ sơ, gửi văn bản đề nghị xóa thông tin dự án qua KBNN nơi giao dịch rồi đăng ký lại. Khác Kho bạc: tất toán tài khoản dự án rồi đăng ký tại Kho bạc mới | Đăng ký sử dụng |
Lập, ký và gửi hồ sơ, chứng từ
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| “Lỗi xảy ra trong quá trình ký số java.io.IOException:… not found as file or resource” | Hồ sơ tạo quá 1 tuần mà chủ tài khoản chưa ký (file đính kèm chỉ lưu 1 tuần), hoặc file scan không đúng chuẩn | Tạo hồ sơ mới; đặt máy scan về mặc định, chỉ xuất PDF, scan dọc; mỗi file không quá 3,5 MB, tổng không quá 5 MB | Lỗi file đính kèm |
| “Lỗi trong quá trình ký file: Chữ ký số trên tệp đã ký số không hợp lệ” | Chưa cập nhật phần mềm ký số mới nhất | Tải bộ cài mới ở mục Phần mềm và tài liệu hướng dẫn, giải nén SignatureAppXp_Setup_2.0.rar và cài; vẫn lỗi thì chủ tài khoản trả lại để kế toán viên scan, đính kèm lại | Lỗi file đính kèm |
| “Lỗi phát sinh: class java.lang.ClassCastException null” khi thêm hồ sơ | Dùng chức năng Thêm chứng từ offline với file từ phần mềm kế toán chưa đúng mẫu của hệ thống | Nhập trực tiếp chứng từ trên hệ thống; báo nhà cung cấp phần mềm kế toán cập nhật mẫu | Lập, ký, gửi chứng từ |
| File đính kèm không hiện chữ ký số của chủ tài khoản | File scan theo chiều ngang, hoặc phần mềm đọc PDF chưa hiển thị vùng ký | Mở bằng Foxit Reader bản mới, bấm biểu tượng chữ ký; nếu cần, scan lại theo chiều dọc, đính kèm lại để chủ tài khoản ký lại | Lỗi file đính kèm |
Kết quả xử lý và theo dõi
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| Không xóa được hồ sơ, chứng từ “KBNN từ chối tiếp nhận/xử lý” | Hệ thống lưu mọi giao dịch như lịch sử hoạt động của đơn vị | Không cần xóa; dùng chức năng sao chép hoặc chỉnh sửa và gửi lại | Trạng thái hồ sơ |
| Đã thanh toán nhưng nút “Tải chứng từ báo nợ KBNN ký số” cho file 0 KB | Lỗi tải file báo nợ | Kiểm tra trạng thái đã là “Đã thanh toán”; nếu vẫn 0 KB, gửi email [email protected] | Trạng thái hồ sơ |
| Trạng thái đứng ở “KBNN đang xử lý chứng từ” | Kho bạc nơi giao dịch chưa xử lý hết quy trình trên hệ thống | Báo cán bộ chuyên quản tại Kho bạc nơi giao dịch | Trạng thái hồ sơ |
| Không nhận email thông báo tiếp nhận, xử lý | Từ 01/7/2020 hệ thống hạn chế gửi thư; kết quả gửi vào email chung của đơn vị, riêng xác nhận đã thanh toán gửi chủ tài khoản và kế toán trưởng | Chủ động tra cứu; nếu email chung vẫn là của kế toán trưởng cũ, lập hồ sơ thay đổi email | Trạng thái hồ sơ |
| Trạng thái trên Cổng Dịch vụ công quốc gia chậm cập nhật | Từ 28/5/2026 kết quả được đồng bộ lên Cổng; KBNN ghi nhận có thời điểm chậm hoặc lỗi kết nối | Tra cứu trực tiếp trên dvc.vst.mof.gov.vn theo mã hồ sơ | Trạng thái hồ sơ |
Gửi yêu cầu hỗ trợ đúng cách
Lỗi của hệ thống, hồ sơ, tài khoản do KBNN hỗ trợ qua email [email protected] (tổng đài ghi ở chân trang đăng nhập). Tiêu đề thư đặt dạng DVC_Tên tỉnh hoặc số hiệu Kho bạc_Trích yếu lỗi, nội dung gồm:
- Tên và mã ĐVQHNS của đơn vị gửi yêu cầu.
- Mô tả vướng mắc, kèm mã hồ sơ hoặc số chứng từ trên hệ thống.
- Số điện thoại liên hệ.
- Hình ảnh lỗi, đã che thông tin không cần thiết.
Lỗi của USB Token, chứng thư Viettel-CA thì liên hệ nhà cung cấp chứng thư. Tuyệt đối không gửi mã PIN, mật khẩu đăng nhập hay mã xác nhận trong email hỗ trợ.
Câu hỏi thường gặp
Lỗi ký số trên dịch vụ công kho bạc do Kho bạc hay do chữ ký số?
Tùy thông báo. Lỗi về quyền, cách khai hồ sơ và trạng thái thuộc hệ thống của KBNN; lỗi chương trình ký số, không tìm thấy chứng thư, OCSP hay thiếu chứng thư CA thường nằm ở máy tính và USB Token.
Mã lỗi KBNN-1001 và KBNN-2002 khác nhau thế nào?
KBNN-1001 đi kèm thông báo phần mềm ký số chưa được bật: trang web chưa kết nối được Chương trình ký số KBNN trên máy. KBNN-2002 là lỗi kiểm tra OCSP, thường do máy có nhiều chứng thư CA Viettel-CA cũ, mới.
Vì sao gia hạn chữ ký số xong thì báo không tìm thấy chứng thư số?
Chứng thư sau gia hạn thường có serial mới, trong khi hệ thống vẫn lưu serial cũ. Kế toán viên cần lập hồ sơ đăng ký thay đổi để cập nhật serial mới, người ký xác nhận, chủ tài khoản ký gửi KBNN.
Gửi yêu cầu hỗ trợ cho Kho bạc cần những thông tin gì?
Tên và mã ĐVQHNS, mô tả vướng mắc kèm mã hồ sơ hoặc số chứng từ, số điện thoại liên hệ và hình ảnh lỗi. Gửi tới [email protected], không kèm mã PIN hay mật khẩu.
Lỗi nằm ở USB Token hay chứng thư Viettel-CA?
Đội hỗ trợ viettel-ca.com giúp kiểm tra Token, chứng thư và chuỗi CA trên máy ký số. Chuẩn bị ảnh lỗi và serial chứng thư; không gửi mã PIN hay mật khẩu.
Nguồn đối chiếu: KBNN: tài liệu hướng dẫn sử dụng và xử lý vướng mắc dịch vụ công; KBNN: khắc phục lỗi ký số của Viettel trên dịch vụ công; Viettel-CA: sửa lỗi OCSP trên hệ thống Kho bạc; Dịch vụ công KBNN: phần mềm và tài liệu hướng dẫn; KBNN: tích hợp với Cổng Dịch vụ công quốc gia. Thông tin có thể thay đổi; ưu tiên hướng dẫn hiện hành của cơ quan/nhà cung cấp tại thời điểm thao tác. Cập nhật: 28/09/2026.
