Chuyển đến nội dung chính
Hệ sinh thái IAM
Hệ sinh thái IAM
Tin nổi bật

Hướng Dẫn Chi Tiết Cách Tải Và Cài Đặt Plugin Chữ Ký Số Trên Trang Dịch Vụ Công, Thuế Điện Tử

Đăng ngày: 13/8/2026

Hướng Dẫn Chi Tiết Cách Tải Và Cài Đặt Plugin Chữ Ký Số Trên Trang Dịch Vụ Công, Thuế Điện Tử

Trong quá trình thực hiện các giao dịch điện tử như kê khai Thuế, Hải quan, Bảo hiểm xã hội hay nộp báo cáo tài chính, Plugin chữ ký số đóng vai trò vô cùng quan trọng. Nếu chưa cài đặt hoặc cài đặt sai plugin, người dùng sẽ liên tục gặp các lỗi gián đoạn như không nhận chữ ký số, không gọi được hàm thực thi hoặc ký hồ sơ không thành công.

Bài viết này sẽ hướng dẫn bạn chi tiết các bước tải, cài đặt plugin chữ ký số trên từng cổng thông tin chuyên dụng và cách khắc phục nhanh các lỗi phổ biến.

1. Plugin chữ ký số là gì?

Plugin chữ ký số là phần mềm trung gian kết nối giữa thiết bị ký số (USB Token hoặc Chữ ký số từ xa) với trình duyệt web/hệ thống quản lý. Nó mở rộng tính năng của trình duyệt, giúp hệ thống xác thực danh tính người ký và đảm bảo tính toàn vẹn của dữ liệu trong các giao dịch điện tử.

Lợi ích khi cài đặt Plugin chữ ký số:

  • Tối ưu hóa quy trình: Ký duyệt và xác minh dữ liệu trực tiếp trên giao diện web nhanh chóng.
  • Tính bảo mật cao: Đảm bảo hồ sơ, tệp tin không bị thay đổi trong quá trình truyền tải.
  • Tương thích cao: Giúp trình duyệt nhận diện thiết bị ký số dễ dàng mà không cần thao tác thủ công phức tạp

2. Hướng dẫn tải và cài đặt plugin cho từng hệ thống

2.1. Plugin ký số trên Cổng Thuế điện tử (thuedientu.gdt.gov.vn)

Để nộp tờ khai và nộp thuế điện tử thông suốt, bạn thực hiện theo các bước:

  • Bước 1: Tải bộ cài đặt Plugin

Truy cập vào cổng thuedientu.gdt.gov.vn, tìm và tải về công cụ hỗ trợ ký số (Plugin eSigner) phiên bản mới nhất.

  • Bước 2: Cài đặt phần mềm

Mở tệp vừa tải về (thường có định dạng .exe), nhấn Next và làm theo hướng dẫn trên màn hình để hoàn tất cài đặt.

Bước 3: Kiểm tra trạng thái hoạt động

Quan sát góc phải bên dưới thanh tác vụ (Taskbar). Nếu thấy biểu tượng phần mềm ký số đang chạy nghĩa là plugin đã khởi động thành công.

Thông báo Plugin đã chạy

Biểu tượng chạy plugin thành công

Bước 4: Đăng nhập và giao dịch

Tải lại hoặc mở lại trình duyệt, đăng nhập tài khoản Thuế điện tử để bắt đầu thực hiện các giao dịch ký nộp hồ sơ.

2.2. Plugin ký số Cổng Dịch vụ công Thuế nhà nước

Trên Cổng Dịch vụ công, bộ công cụ yêu cầu cài đặt đầy đủ 3 thành phần hỗ trợ:

  • Bước 1: Cài đặt bộ thư viện .NET Framework
  • Truy cập trang hỗ trợ của Microsoft để tải .NET Framework phù hợp với hệ điều hành đang dùng, sau đó tiến hành cài đặt.

  • Căn cứ vào hệ điều hành đang sử dụng để chọn phiên bản tương ứng (4.8 đối với Windows 10 hoặc 4.8.1 đối với Windows 11).
  • Tại thư mục lưu trữ (Downloads), thực hiện khởi chạy tệp tin và tuân thủ các chỉ dẫn của trình cài đặt để hoàn tất.

Bước 2: Cài đặt phần mềm TCT SigningHub

Vào mục Trợ giúp trên Cổng Dịch vụ công Thuế -> Tải gói TCT SigningHub -> Giải nén file và chạy tệp CKS_Client.exe -> Nhấn Next -> Install -> Finish.

  • Sau khi tải xuống thành công, truy cập mục Downloads hoặc thư mục đã chọn lưu tệp để thực hiện giải nén tệp tin đã tải và chạy file CKS_Client.

  • Tại giao diện cài đặt, lần lượt chọn “Next”“Install” để hệ thống tự động thiết lập. Nhấn “Finish” để kết thúc quy trình.

Bước 3: Cài đặt phần mềm eSigner

Tại mục Trợ giúp, tiếp tục tải bộ cài eSigner -> Giải nén và chạy file eSigner_setup.exe -> Thực hiện cài đặt theo chỉ dẫn.

  • Tiến hành giải nén và chạy file eSigner_setup. Người dùng thực hiện các thao tác xác nhận “Next”“Install” theo trình tự để hoàn tất tích hợp vào máy tính.

Bước 4: Kiểm tra và hoàn tất thiết lập

Sau khi hoàn tất cài đặt 03 phần mềm nêu trên, người nộp thuế thực hiện khởi động lại máy tính để hệ thống đồng bộ dữ liệu. Dấu hiệu nhận biết cài đặt thành công chính là khi thanh tác vụ (Taskbar) của màn hình máy tính hiển thị đầy đủ biểu tượng của HĐĐT Plugin và eSigner.

Khi thực hiện ký hồ sơ, hệ thống sẽ tự động hiển thị danh sách chữ ký số để người dùng lựa chọn thực hiện giao dịch.

2.3. Plugin Cổng Thanh toán điện tử và Thông quan Hải quan (epayment.customs.gov.vn)

Nộp thuế Hải quan và thông quan hàng hóa 24/7 đòi hỏi môi trường trình duyệt chuẩn xác:

  • Lưu ý chuẩn bị: Nên sử dụng trình duyệt Google Chrome và đảm bảo thiết bị chữ ký số (USB Token hoặc Chữ ký số từ xa) đã được cắm/kích hoạt trên máy.
  • Bước 1: Truy cập cổng thông tin tại địa chỉ: [https://epayment.customs.gov.vn](https://epayment.customs.gov.vn).

Bước 2: Tải bộ cài Plugin dành riêng cho cổng Hải quan, chạy file installation cho đến khi hoàn tất, sau đó đóng và khởi động lại trình duyệt.

Bước 3: Kiểm tra bằng cách nhấn nút "Kiểm tra Plugin" trên giao diện trang web. Khi màn hình xuất hiện thông báo “Plugin đã được chạy…” ở góc phải là đạt yêu cầu.

Bước 4: Đăng nhập tài khoản và tiến hành giao dịch nộp thuế/lệ phí hải quan.

3. Cách khắc phục các lỗi thường gặp khi sử dụng Plugin ký số

1. Lỗi hệ thống báo "Chưa cài đặt Plugin" dù đã cắm Chữ ký số

  • Nguyên nhân: Máy tính chưa cài hoặc thiếu công cụ nền eSigner.
  • Cách xử lý: Tải trực tiếp bộ cài eSigner từ thông báo trên trang Thuế và tiến hành cài đặt lại cho đến khi xuất hiện biểu tượng ở thanh Taskbar.

2. Lỗi không gọi được hàm thực thi khi nhấn Ký

  • Nguyên nhân: Cơ chế chặn bảo mật hoặc chứng thư của trình duyệt Google Chrome.
  • Cách xử lý: Truy cập chrome://flags trên thanh địa chỉ Chrome -> Tìm từ khóa localhost -> Chuyển mục Allow invalid certificates for resources loaded from localhost sang Enabled -> Nhấn Relaunch để khởi động lại trình duyệt.

3. Lỗi phiên bản Plugin đã cũ gây gián đoạn giao dịch

  • Nguyên nhân: Phiên bản plugin hiện tại không còn tương thích với hệ thống nâng cấp của cơ quan Thuế/Hải quan.
  • Cách xử lý: Vào Control Panel gỡ bỏ hoàn toàn phiên bản cũ, truy cập website chính thức để tải và cài đặt phiên bản Plugin mới nhất.

4. Lỗi Plugin đã cài đặt nhưng không hoạt động

  • Nguyên nhân: Dịch vụ ký số bị tắt hoặc không được thiết lập tự động chạy cùng hệ điều hành Windows.
  • Cách xử lý: Mở Menu Start -> Tìm tên phần mềm Plugin tương ứng -> Nhấp đúp để kích hoạt thủ công hoặc chuột phải chọn Restart Service.

5. Lỗi trình duyệt bị treo, xung đột phần mềm

  • Nguyên nhân: Máy tính mở đồng thời nhiều phần mềm/plugin ký số khác nhau dẫn đến xung đột hệ thống.
  • Cách xử lý: Tắt bớt các ứng dụng hoặc plugin ký số không liên quan, chỉ duy trì 1 plugin phù hợp nhất với cổng dịch vụ đang làm việc.