Trên Cổng Dịch vụ công BHXH, trình duyệt phải gọi được phần mềm ký số của cổng (Vietnam Social Security Declaration) thì mới đọc được chứng thư trong USB Token. Phần lớn lỗi ký số trên Cổng Dịch vụ công BHXH phát sinh ở khâu này, qua năm thông báo dưới đây, trước khi hồ sơ rời khỏi máy bạn.
"Vui lòng cài đặt công cụ hỗ trợ ký số trước." hay "Lỗi phiên bản script và phiên bản VSS Declaration không trùng khớp." nghĩa là trình duyệt chưa kết nối được công cụ ký: cài bản tải từ mục Tài liệu & ứng dụng của cổng, bật tiện ích, mở lại trình duyệt. "Không tìm thấy thông tin chứng thư số." hay "Không thể lấy được thông tin chứng thư" nghĩa là công cụ chạy nhưng không đọc được chứng thư: kiểm tra Token, driver và chỉ cắm một Token.
Năm thông báo và thời điểm xuất hiện
| Thông báo trên cổng | Khi nào | Lớp lỗi |
|---|---|---|
| Vui lòng cài đặt công cụ hỗ trợ ký số trước. | Ký tờ khai đăng ký, thay đổi thông tin, ngừng dịch vụ | Công cụ ký chưa chạy hoặc chưa được phép |
| Bạn chưa cài đặt bộ công cụ hỗ trợ ký số | Hộp thoại khi gửi đăng ký, thay đổi, ngừng | Trình duyệt không tìm thấy công cụ ký |
| Lỗi phiên bản script và phiên bản VSS Declaration không trùng khớp. | Nộp hồ sơ và một số chức năng có ký số | Trang không gọi được tiện ích VSS Declaration |
| Không tìm thấy thông tin chứng thư số. | Ngay khi ký | Công cụ chạy nhưng không đọc được chứng thư |
| Không thể lấy được thông tin chứng thư | Khi nộp hồ sơ | Không lấy được chứng thư từ công cụ ký |
Đây là các thông báo do chính trang cổng hiển thị khi kiểm tra ngày 28/09/2026, không phải phản hồi của hệ thống tiếp nhận hồ sơ, nên hồ sơ chưa được gửi đi. Khi thiếu tiện ích ký trên trình duyệt, cổng hiển thị thông báo lệch phiên bản ngay cả khi bạn chưa từng cài.
Nguyên nhân, xếp theo khả năng
- Chưa cài phần mềm ký của cổng, hoặc cài trên máy, tài khoản Windows khác.
- Tiện ích trình duyệt tắt hoặc không chạy: dùng trình duyệt khác, chế độ ẩn danh, hồ sơ trình duyệt khác.
- Phiên bản cũ không khớp với trang sau khi cổng cập nhật.
- Token không được đọc: driver, cổng USB, chứng thư chưa nằm trong Token, Token bị khóa PIN.
- Xung đột phần mềm: công cụ ký của phần mềm khác, phần mềm bảo mật chặn kết nối cục bộ.
Cách xử lý từng bước
Dùng Google Chrome
Hướng dẫn của cổng từ trước đến nay dùng Chrome; thao tác ở cửa sổ thường, không ẩn danh.
Tải đúng bộ cài
Trên cổng, vào Tài liệu & ứng dụng, thẻ Tải ứng dụng, phần Phần mềm hỗ trợ; đọc thêm tài liệu hướng dẫn cài phần mềm ký số Vietnam Social Security Declaration trong thẻ Tài liệu hướng dẫn. Chỉ tải từ cổng.
Cài và bật tiện ích
Cài phần mềm, thêm và bật tiện ích ký số trên Chrome theo tài liệu, rồi đóng hết cửa sổ Chrome và mở lại.
Tải lại trang cổng
Đăng nhập lại, tải lại trang để trình duyệt nạp phiên bản trang mới nhất.
Kiểm tra Token
Windows phải nhận Token và phần mềm quản lý Token thấy chứng thư; chỉ cắm một Token. Xem máy tính không nhận USB Token và USB Token bị khóa mã PIN.
Ký lại
Thực hiện lại thao tác; cửa sổ chọn chứng thư phải hiện ra.
Bài này dành cho ký trên cổng BHXH. Phần mềm vBHXH có tool ký và extension riêng, xem cài tool ký số và extension cho vBHXH.
Kiểm tra đã hết lỗi
- Khi bấm ký, cửa sổ chọn chứng thư hiện đúng chứng thư của đơn vị.
- Sau khi nhập PIN, cổng chuyển sang bước gửi và trả kết quả.
- Nếu bước ký qua được nhưng hệ thống báo chứng thư không hợp lệ hay bị thu hồi, xem lỗi chứng thư số không hợp lệ; nếu báo chữ ký trên tờ khai không đúng, xem lỗi CE017, CE022.
Thông tin nên gửi khi cần hỗ trợ
- Phiên bản Windows, Chrome và phần mềm ký của cổng.
- Ảnh thông báo, chức năng đang thao tác (đăng ký, thay đổi, nộp hồ sơ).
- Tình trạng Token: Windows có nhận không, phần mềm quản lý Token có thấy chứng thư không.
Không gửi PIN, OTP hay mật khẩu; không cho người lạ điều khiển máy để "cài hộ" qua đường dẫn lạ. Các mã khác xem bảng mã lỗi BHXH điện tử.
Câu hỏi thường gặp
Công cụ ký của cổng BHXH có dùng chung với công cụ ký của cổng thuế không?
Không. Mỗi cổng có công cụ ký riêng; cài công cụ của cổng thuế không giúp cổng BHXH ký được.
Dùng vBHXH có cần cài phần mềm ký của cổng BHXH không?
Chỉ cần khi bạn ký trực tiếp trên cổng BHXH. vBHXH dùng tool ký và extension riêng theo hướng dẫn của nhà cung cấp.
Đã cài rồi mà cổng vẫn báo chưa cài công cụ ký?
Thường do tiện ích đang tắt, chưa mở lại trình duyệt, đang dùng trình duyệt hoặc hồ sơ trình duyệt khác, hoặc bản cài đã cũ. Cài lại bản mới từ cổng rồi thử lại.
Người hỗ trợ có cần mã PIN để cài công cụ ký không?
Không. PIN chỉ do người giữ Token tự nhập tại cửa sổ ký trên máy của mình.
Cần người hướng dẫn cài công cụ ký?
Chuẩn bị ảnh lỗi và phiên bản trình duyệt, gửi cho đội hỗ trợ vBHXH. Không gửi PIN, OTP hay mật khẩu.
Nguồn đối chiếu: Cổng Dịch vụ công BHXH Việt Nam, mục Tài liệu & ứng dụng; BHXH Nghệ An: hướng dẫn đăng ký, kê khai trên cổng giao dịch điện tử (2019). 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.
