Khi bấm ký trên dichvucong.gdt.gov.vn mà cổng báo “Chưa cài đặt hoặc bật Plugin chữ ký số” hoặc “Hiện tại máy tính của bạn chưa được cài đặt đầy đủ các công cụ…”, trang web chưa kết nối được với công cụ ký trên máy. Bài này giúp bạn tìm đúng mắt xích bị thiếu: công cụ ký, nền tảng cài đặt hay quyền của trình duyệt.
Cài đủ CT SigningHub và eSigner tải từ mục Trợ giúp của cổng, cùng .NET Framework 4.8/4.8.1 và Java; khởi động lại máy và kiểm tra biểu tượng công cụ ký ở khay hệ thống. Sau đó cho phép trang dichvucong.gdt.gov.vn truy cập mạng cục bộ (Local Network Access) trong cài đặt trang web của trình duyệt, tải lại trang và ký lại.
Hai thông báo cùng một nhóm lỗi
Theo các hướng dẫn xử lý lỗi đăng trên Thư viện Pháp luật năm 2026, cổng thuế có thể hiển thị một trong hai thông báo khi ký tờ khai, lập giấy nộp tiền hoặc ký hồ sơ khác:
- “Chưa cài đặt hoặc bật Plugin chữ ký số”.
- “Hiện tại máy tính của bạn chưa được cài đặt đầy đủ các công cụ để có thể thực hiện ký điện tử. Bạn cần cài đặt đầy đủ các công cụ trước khi tiếp tục sử dụng dịch vụ thuế điện tử của Tổng cục Thuế.”
Cả hai đều có nghĩa: trang web không gọi được phần mềm ký chạy trên máy tính của bạn. Lúc này lỗi chưa liên quan tới chứng thư hay mã số thuế, nên chưa cần đổi chứng thư hay cập nhật tài khoản.
Nguyên nhân xếp theo khả năng
| Nguyên nhân | Dấu hiệu |
|---|---|
| Trình duyệt chặn truy cập mạng cục bộ | Máy đã cài đủ công cụ, biểu tượng vẫn chạy, nhưng cổng vẫn báo lỗi. Từ Chrome 142, trang web phải được cho phép mới kết nối tới dịch vụ trên chính máy (loopback) |
| Chưa cài hoặc cài thiếu công cụ ký | Máy mới, vừa cài lại Windows, hoặc chỉ cài một trong hai công cụ CT SigningHub và eSigner |
| Công cụ đã cài nhưng không chạy | Khay hệ thống không có biểu tượng “HĐĐT plugin” hoặc eSigner; công cụ treo sau khi máy ngủ |
| Thiếu nền tảng | Cài CT SigningHub báo lỗi .NET Framework; mở eSigner báo cần Java |
| Bộ cài cũ | Dùng lại bộ cài lưu từ trước; Cục Thuế đã phát hành SigningHub 1.1 (19/01/2026) và CT SigningHub 1.2 (05/02/2026) có tính năng nâng cấp tự động |
Cách xử lý từng bước
Xem khay hệ thống
Theo hướng dẫn cài đặt năm 2026, máy cài đúng sẽ có biểu tượng “HĐĐT plugin” và eSigner cạnh đồng hồ. Thiếu biểu tượng nào thì mở lại công cụ đó từ menu Start hoặc cài lại.
Tải bộ cài từ mục Trợ giúp
Vào dichvucong.gdt.gov.vn, mở Trợ giúp, phần Phần mềm hướng dẫn có “CT SigningHub – Phần mềm hỗ trợ ký điện tử CT SigningHub” và “eSigner – Phần mềm hỗ trợ ký điện tử eSigner”. Luôn tải bản đang đăng ở đây.
Cài nền tảng trước
Cài .NET Framework 4.8 (Windows 10) hoặc 4.8.1 (Windows 11) từ trang của Microsoft, và Java cho máy tính từ java.com. Thiếu hai thành phần này, công cụ ký có thể không chạy.
Cài công cụ ký và khởi động lại
Giải nén, chạy tệp cài của CT SigningHub (CKS_Client) và eSigner (eSigner_setup) theo trình hướng dẫn. Nếu thay bản cũ, gỡ bản cũ trước. Cài xong, khởi động lại máy.
Cho phép truy cập mạng cục bộ
Mở dichvucong.gdt.gov.vn, bấm biểu tượng cạnh địa chỉ trang, chọn Cài đặt trang web (Site settings), tìm Local Network Access (Truy cập mạng cục bộ) và chọn Allow. Nếu trình duyệt hỏi quyền khi tải trang, chọn cho phép.
Tải lại trang và ký thử
Quay về trang chủ cổng, kiểm tra dấu hiệu báo công cụ sẵn sàng ở đầu trang, đăng nhập và ký lại. Cửa sổ chọn chứng thư hoặc nhập PIN hiện ra là đã thông.
Hướng dẫn cài đặt chi tiết cho máy mới nằm ở bài chuẩn bị máy ký số trên dichvucong.gdt.gov.vn.
Những cách không nên làm
- Không tải công cụ ký từ đường link gửi qua nhóm chat hay trang không rõ nguồn; chỉ dùng mục Trợ giúp của cổng.
- Ưu tiên cấp quyền cho riêng trang dichvucong.gdt.gov.vn. Tắt mục kiểm tra Local Network Access trong trang cờ thử nghiệm của trình duyệt ảnh hưởng tới mọi trang web, chỉ nên là biện pháp tạm thời khi được bộ phận hỗ trợ hướng dẫn.
- Không cho người lạ điều khiển máy từ xa để “cài plugin hộ”, và không đọc PIN qua điện thoại.
- Không cài chồng nhiều bản công cụ ký; gỡ bản cũ, khởi động lại rồi mới cài bản mới.
Vẫn lỗi: kiểm tra tiếp và thông tin cần gửi
Nếu lỗi chỉ xảy ra khi lập giấy nộp tiền, xem bài xử lý lỗi eSigner không chạy khi nộp tiền thuế. Nếu cửa sổ ký đã hiện nhưng báo sai PIN hoặc không tìm thấy thiết bị, chuyển sang lỗi sai mã PIN hoặc không tìm thấy thiết bị chứng thư số. Nếu ký được nhưng cổng báo chứng thư chưa đăng ký, xem lỗi chứng thư số chưa được đăng ký với cơ quan thuế.
Hướng dẫn trên Thư viện Pháp luật khuyên liên hệ cơ quan thuế quản lý nếu đã làm đủ các bước mà vẫn lỗi. Chuẩn bị: phiên bản Windows, trình duyệt và phiên bản, ảnh thông báo lỗi, ảnh khay hệ thống, thao tác đang làm (ký tờ khai, nộp tiền…) và thời điểm xảy ra.
Câu hỏi thường gặp
Đã cài SigningHub rồi sao cổng vẫn báo chưa cài plugin?
Thường do trình duyệt chặn quyền truy cập mạng cục bộ, công cụ chưa chạy, hoặc máy thiếu eSigner. Kiểm tra biểu tượng ở khay hệ thống và quyền Local Network Access của trang trước khi cài lại.
Có cần cài cả CT SigningHub và eSigner không?
Có. Mục Trợ giúp của cổng liệt kê cả hai là phần mềm hỗ trợ ký điện tử, và các hướng dẫn xử lý lỗi đều yêu cầu cài đủ hai công cụ.
eSigner có cần Java không?
Có. Hướng dẫn xử lý lỗi đăng ngày 14/4/2026 yêu cầu cài Java cho máy tính từ java.com cùng eSigner. Chỉ tải Java từ trang chính thức.
Có nên tắt kiểm tra Local Network Access trong cờ thử nghiệm của Chrome?
Nên cấp quyền cho riêng trang dichvucong.gdt.gov.vn trước. Tắt cờ thử nghiệm ảnh hưởng mọi trang web, chỉ dùng tạm khi được bộ phận hỗ trợ hướng dẫn.
Tải công cụ ký thuế ở đâu cho an toàn?
Tại mục Trợ giúp trên dichvucong.gdt.gov.vn. Không cài bộ cài gửi qua nhóm chat, email lạ hoặc trang quảng cáo.
Cần hỗ trợ cài công cụ ký thuế?
Chuẩn bị ảnh thông báo lỗi, phiên bản Windows và trình duyệt. Không gửi mã PIN, mật khẩu hay mã OTP cho bất kỳ ai.
Nguồn đối chiếu: Trợ giúp – Hệ thống thông tin giải quyết TTHC, Cục Thuế; Xử lý lỗi chưa cài đặt hoặc bật Plugin chữ ký số – Thư viện Pháp luật; Sửa lỗi máy tính chưa được cài đặt đầy đủ công cụ ký điện tử – Thư viện Pháp luật; Cài đặt cấu hình chữ ký số trên Cổng dịch vụ công thuế – Thư viện Pháp luật; Local Network Access – Chrome for Developers. 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.
