Phiên bản ứng dụng đã cũ trên cổng BHXH: cách xử lý nhanh

Cập nhật lần cuối: 08/07/2026

Thông báo “phiên bản ứng dụng đã cũ, vui lòng cài bản mới” xuất hiện khi ứng dụng ký số BHXH trên máy bạn chưa đồng bộ với phiên bản mới nhất của cổng dịch vụ công BHXH. Bạn chỉ cần gỡ bản cũ, cài lại đúng bản mới rồi kiểm tra lại kết nối là ký số tiếp được ngay. Bài viết dưới đây hướng dẫn từng bước cụ thể, kèm cách xử lý các lỗi liên quan thường gặp khác.

Vì sao cổng BHXH báo “phiên bản ứng dụng đã cũ”?

Ứng dụng ký số dùng cho phần mềm BHXH điện tử (ví dụ VSS Declaration) là chương trình chạy nền, có nhiệm vụ kết nối trình duyệt với thiết bị ký số khi bạn thao tác trên cổng dịch vụ công BHXH. Cổng này thường cập nhật phiên bản trước, còn ứng dụng nền trên máy bạn chỉ được nâng cấp khi bạn chủ động tải bản mới về cài.

Khi hai bên lệch phiên bản, hệ thống sẽ chặn thao tác ký và hiện thông báo phiên bản ứng dụng đã cũ để đảm bảo dữ liệu gửi lên đúng chuẩn mới. Lỗi phiên bản ứng dụng đã cũ thường gặp ở máy lâu ngày chưa cập nhật, hoặc máy vừa cài lại Windows nên bản cũ chưa được thay thế. Đây không phải lỗi của chữ ký số hay chứng thư số, nên hồ sơ đã ký trước đó không hề bị ảnh hưởng.

Chuẩn bị gì trước khi cài lại ứng dụng

Trước khi xử lý phiên bản ứng dụng đã cũ, bạn nên chuẩn bị đủ các điều kiện sau để không phải dừng giữa chừng đi tìm thêm dữ liệu:

• Tài khoản có quyền cài đặt phần mềm, hoặc quyền Administrator khi Windows yêu cầu.
• Bộ cài ứng dụng ký số BHXH phiên bản mới nhất, phù hợp với hệ điều hành đang dùng.
• USB Token hoặc thiết bị ký số cùng driver liên quan đã cắm sẵn vào máy.
• Trình duyệt cho phép gọi API cục bộ (localhost) theo cấu hình hệ thống, không bị phần mềm diệt virus chặn.

Nếu chưa chắc bản cài đặt nào tương thích, bạn có thể liên hệ Chukyso1 để được hỗ trợ xử lý phiên bản ứng dụng đã cũ nhanh gọn, tránh mất thời gian tải đi tải lại.

Các bước cài đặt lại ứng dụng đúng chuẩn

Khi đã xác định đúng nguyên nhân, các bước xử lý phiên bản ứng dụng đã cũ dưới đây giúp bạn cài lại đúng chuẩn chỉ trong vài phút.

Bước 1 — Đóng hoàn toàn ứng dụng nền đang chạy

Nhấp chuột phải vào biểu tượng ứng dụng ở khay hệ thống (System Tray) và chọn thoát hẳn. Chỉ đóng cửa sổ trình duyệt sẽ không tắt được tiến trình nền, khiến bản cũ vẫn giữ cổng kết nối.

Bước 2 — Gỡ bản cài đặt cũ

Vào Control Panel > Programs and Features, tìm đúng tên ứng dụng ký số BHXH đang dùng và gỡ cài đặt. Bước này giúp tránh xung đột khi hai phiên bản cùng tồn tại trên một máy.

Bước 3 — Cài đặt lại bản mới với quyền Administrator

Chạy bộ cài, nhấn Next qua các màn hình chào mừng và chọn thư mục cài đặt, sau đó nhấn Install. Nếu Windows hiện hộp thoại User Account Control, chọn Yes để cấp quyền Administrator — chọn No sẽ hủy cài đặt. Đợi tiến trình chạy xong rồi nhấn Finish để hoàn tất xử lý phiên bản ứng dụng đã cũ.

Cách xử lý phiên bản ứng dụng đã cũ này áp dụng chung cho phần mềm BHXH Viettel hay phần mềm BHXH VNPT, vì cả hai đều dùng chung cơ chế ứng dụng nền ký số.

📞 Cần tư vấn gói phù hợp? Gọi/Zalo 0962 163 668 — Chukyso1 hỗ trợ 24/7, báo giá trong 5 phút.

Kiểm tra ứng dụng nền đã chạy đúng qua Swagger

Sau khi xử lý phiên bản ứng dụng đã cũ, hãy kiểm tra lại bằng cách nhấp chuột phải vào biểu tượng ứng dụng ở khay hệ thống và chọn “Mở trình duyệt”. Ứng dụng sẽ tự mở http://localhost:61505/swagger hoặc https://localhost:61505/swagger để kiểm tra tính sẵn sàng của API.

Nếu màn hình Swagger hiển thị danh sách API, nghĩa là ứng dụng nền đã khởi động thành công và không còn báo phiên bản ứng dụng đã cũ nữa. Ngược lại, nếu không truy cập được, bạn cần kiểm tra ứng dụng đã thật sự chạy hay chưa, cổng localhost có bị tường lửa chặn không, hoặc thử khởi động lại máy trước khi mở ứng dụng.

Cấu hình lại mẫu chữ ký sau khi cài đặt

Một số bản cập nhật khắc phục phiên bản ứng dụng đã cũ có thể xóa mất mẫu chữ ký đã lưu trước đó. Sau khi cài đặt lại, bạn vào biểu tượng ứng dụng ở khay hệ thống, chọn mục cấu hình mẫu chữ ký, rồi nhấn “Thêm mới” để tạo lại.

• Nhập tên mẫu chữ ký để dễ phân biệt khi có nhiều mẫu.
• Chọn kiểu hiển thị chữ ký và tải ảnh chữ ký lên (nếu dùng chữ ký hình ảnh).
• Cấu hình các thông tin hiển thị kèm theo rồi nhấn “Lưu” để hoàn tất.

Chứng thư số dùng để ký trên cổng BHXH cần được cấp bởi tổ chức cung cấp dịch vụ chứng thực nằm trong danh sách được NEAC — Trung tâm Chứng thực điện tử quốc gia công nhận. Nếu bạn đang cân nhắc đổi nhà cung cấp hoặc gia hạn, có thể tham khảo thêm dịch vụ chữ ký số tại Chukyso1.com.

Các lỗi liên quan thường gặp khác

Ngoài lỗi phiên bản ứng dụng đã cũ, quá trình ký số trên cổng BHXH còn có thể phát sinh vài lỗi khác. Bảng dưới đây tóm tắt nguyên nhân và cách xử lý tương ứng:

❓ Câu hỏi thường gặp (FAQ)

Vì sao cổng BHXH báo “phiên bản ứng dụng đã cũ, vui lòng cài bản mới”?

Do cổng dịch vụ công BHXH đã cập nhật phiên bản mới trong khi ứng dụng nền trên máy bạn vẫn đang chạy bản cũ. Hệ thống chặn thao tác ký để đảm bảo dữ liệu gửi lên đúng chuẩn mới.

Cập nhật xong vẫn báo phiên bản ứng dụng đã cũ thì kiểm tra gì tiếp theo?

Kiểm tra lại ứng dụng nền cũ đã tắt hẳn ở System Tray chưa, sau đó khởi động lại máy trước khi mở ứng dụng mới. Nếu vẫn báo lỗi, liên hệ hotline Chukyso1 để được hỗ trợ kiểm tra trực tiếp.

Không truy cập được Swagger sau khi cài lại thì phải làm sao?

Kiểm tra ứng dụng nền đã thực sự chạy hay chưa và cổng localhost 61505 có bị chặn bởi firewall/antivirus không. Nếu vẫn không truy cập được, hãy thử khởi động lại ứng dụng hoặc khởi động lại máy.

Ký số báo “cancelled” có liên quan đến lỗi phiên bản không?

Không. Đây là do người dùng đóng hộp thoại chọn chứng thư/ký số giữa chừng, không liên quan đến việc ứng dụng cũ hay mới. Bạn chỉ cần thực hiện lại thao tác ký và chọn đúng chứng thư.

Gặp lỗi “duplicated” khi ký số trên cổng BHXH thì xử lý thế nào?

Lỗi này xảy ra khi hệ thống nhận cùng một yêu cầu ký được gửi lặp trong thời gian ngắn. Bạn cần tạo yêu cầu ký mới thay vì gửi lại nguyên payload cũ.

Lỗi phiên bản cũ có làm mất chữ ký số hoặc ảnh hưởng hồ sơ đã nộp không?

Không. Đây chỉ là lỗi chặn thao tác ký mới, không xóa hay ảnh hưởng đến chữ ký số, chứng thư số hay các hồ sơ đã nộp thành công trước đó.