Lỗi chữ ký số Viettel-CA thường xuất hiện ở một trong bốn lớp: USB Token/Token Manager, mã PIN và chứng thư số, Plugin ký số trên trình duyệt, hoặc thông tin chứng thư chưa được cập nhật trên hệ thống Thuế, Hải quan, hóa đơn điện tử hay dịch vụ công. Bài này tổng hợp các lỗi phổ biến, cách xác định nguyên nhân và thứ tự xử lý an toàn để người dùng có thể tự kiểm tra trước khi cần hỗ trợ kỹ thuật.
Bắt đầu từ triệu chứng đang gặp. Không nên gỡ/cài nhiều bộ phần mềm cùng lúc khi chưa xác định lỗi nằm ở thiết bị, driver, Plugin hay hệ thống tiếp nhận.
| TRIỆU CHỨNG | NGUYÊN NHÂN THƯỜNG GẶP | XỬ LÝ ĐẦU TIÊN |
|---|---|---|
| Token Manager không thấy USB | Chưa cài/driver sai, cổng USB lỗi, thiết bị chưa được nhận | Đổi cổng USB → mở Token Manager → kiểm tra đúng phiên bản driver |
| Token Manager mở nhưng nút bị mờ | Lỗi Smartcard/driver ở một số thiết bị V4/V5 | Dùng công cụ fix Smartcard chính thức của Viettel-CA |
| Nhập PIN không được / Token bị khóa | Nhập sai PIN nhiều lần hoặc quên PIN | Dừng nhập thử, dùng quy trình reset/mở khóa USB Token |
| Token Manager nhận Token nhưng website không ký | Plugin/Signer chưa chạy, trình duyệt chưa kết nối công cụ ký | Mở/cài Plugin ký số đúng hệ thống rồi thử lại |
| “Chứng thư số chưa được đăng ký” | Vừa gia hạn/cấp chứng thư mới nhưng hệ thống chưa cập nhật CTS mới | Cập nhật/thay đổi chữ ký số trên hệ thống Thuế hoặc cổng đang sử dụng |
| Không thấy CTS để chọn sau gia hạn | Đang chọn CTS cũ hoặc chưa tải CTS mới lên hệ thống | Kiểm tra Serial, ngày hết hạn và chọn chứng thư có hiệu lực mới |
| USB bị mất/hỏng | Thiết bị vật lý không còn sử dụng được | Không thể copy khóa riêng; cần xử lý hủy/cấp lại theo quy trình |
Đây là lỗi nền tảng: nếu máy tính chưa nhận thiết bị thì các bước ký số phía sau đều không thể hoạt động ổn định.
Trường hợp Token Manager mở được nhưng các nút thao tác bị mờ có thể liên quan đến Smartcard/driver, đặc biệt trên một số thiết bị Token V4/V5.
USB đã cắm, Token Manager mở được nhưng một số chức năng không thao tác được hoặc chương trình không đọc đúng thiết bị.
Trang Download Viettel-CA hiện công bố riêng phần mềm fix lỗi Smartcard thiết bị Token V4, V5 cho trường hợp Token Manager bị mờ chức năng.
Xác định Token là V4/V5 trước, tải công cụ từ nguồn Viettel-CA, đóng ứng dụng ký số và thực hiện theo hướng dẫn của bộ công cụ.
Mã PIN bảo vệ việc sử dụng khóa riêng trong USB Token. Nếu không chắc mã PIN, không nên tiếp tục nhập thử nhiều lần.
Nếu Token Manager vẫn nhìn thấy chứng thư số nhưng website không mở cửa sổ chọn chứng thư/PIN, lỗi thường nằm ở lớp tích hợp giữa trình duyệt và phần mềm ký số.
| KIỂM TRA | NẾU ĐÚNG | NẾU CHƯA ĐÚNG |
|---|---|---|
| Token Manager thấy USB? | Chuyển sang kiểm tra Plugin/Signer | Xử lý driver/USB trước |
| Plugin/Signer đang chạy? | Tải lại trang và thử ký | Mở hoặc cài đúng công cụ ký số |
| Website yêu cầu extension/add-on? | Kiểm tra extension đang bật | Cài theo hướng dẫn của chính website |
| Chỉ lỗi trên một website? | Kiểm tra cấu hình/CTS đăng ký tại website đó | Nếu lỗi mọi nơi, quay lại kiểm tra Token/Plugin |
Thông báo này có thể xuất hiện khi công cụ ký số không chạy hoặc trình duyệt không kết nối được với dịch vụ ký cục bộ, dù USB Token đang cắm.
→ Tham khảo hướng dẫn Viettel-CA về lỗi kết nối USB-TOKEN trên hệ thống hóa đơn
Gia hạn trên USB Token thành công chưa chắc hệ thống Thuế, Hải quan, hóa đơn hoặc DVC đã biết chứng thư số mới.
Triệu chứng điển hình: “Chữ ký số chưa được đăng ký với cơ quan Thuế”, hệ thống vẫn hiển thị chứng thư cũ, không chọn được CTS mới hoặc ký bằng chứng thư mới nhưng hệ thống từ chối.
Nguyên nhân thường gặp là sau gia hạn, Serial/chứng thư số mới cần được cập nhật lại trên hệ thống đang sử dụng. Viettel-CA có hướng dẫn riêng cho eTax: vào Quản lý tài khoản → Thay đổi thông tin dịch vụ → thay đổi chữ ký số → nhập PIN → xác nhận/ký gửi.
Các lỗi dưới đây là lỗi nghiệp vụ/tích hợp theo từng cổng. Hãy xử lý sau khi đã xác nhận USB Token, Token Manager và chứng thư số hoạt động bình thường.
| THÔNG BÁO | NGUYÊN NHÂN / HƯỚNG XỬ LÝ |
|---|---|
| “Không tìm thấy Chữ ký số hoặc Chữ ký số không đúng” | Kiểm tra Driver USB Token; nếu Token Manager bị mờ chức năng, xử lý lỗi driver/Smartcard trước. |
| “Sai mã PIN hoặc không tìm thấy thiết bị chứng thư số” | Nếu PIN chắc chắn đúng, Viettel-CA từng hướng dẫn xóa dữ liệu trình duyệt và đăng nhập lại eTax; hiện nay cũng nên kiểm tra Plugin/Signer của hệ thống. |
| “Chữ ký số chưa được đăng ký với cơ quan Thuế” | Thường xảy ra sau gia hạn khi CTS mới chưa được cập nhật trên eTax. Thực hiện thay đổi thông tin chữ ký số. |
| Hải quan mã lỗi A0036 | Viettel-CA ghi nhận nguyên nhân do chọn chưa đúng hạn sử dụng CTS đã đăng ký với Hải quan; kiểm tra chứng thư đang chọn và thông tin đã đăng ký. |
| Hải quan không hiển thị CTS để chọn | Có thể liên quan môi trường Java/công cụ ký theo yêu cầu của hệ thống Hải quan đang sử dụng. |
Đây không phải lỗi phần mềm thông thường. USB Token lưu và bảo vệ khóa riêng nên cần xử lý theo quy trình an toàn.
Viettel-CA nêu rõ khóa bí mật trong USB Token không cho phép copy hoặc backup sang thiết bị khác như dữ liệu USB thông thường.
Nên nhanh chóng liên hệ để thực hiện thủ tục hủy chứng thư cũ và cấp lại theo đúng quy trình bảo mật.
Không nên tự tháo hoặc can thiệp phần cứng. Nhân viên hỗ trợ sẽ kiểm tra tình trạng thiết bị và phương án cấp lại phù hợp.
Khi liên hệ, nên gửi kèm ảnh chụp thông báo lỗi, phiên bản USB Token, hệ điều hành và tên website/hệ thống đang ký. Không gửi mã PIN USB Token.
USB Token · Token Manager · PIN · Plugin · Thuế · Hải quan · Gia hạn
GỌI 0972 93 5858