Không tìm thấy ứng dụng nền vietnam social security declaration là 1 lỗi trong tháng 7/2026 này của Bảo hiểm xã hội (BHXH) khi bạn ký hồ sơ trên dịch vụ công. Hãy cùng TOP dịch vụ kế toán xử lý lỗi này nhé.
Hướng dẫn cài đặt vietnam social security declaration
Tài liệu này hướng dẫn cài đặt ứng dụng Windows Vietnam Social Security Declaration chạy trên máy người dùng.
ĐIỀU KIỆN TRƯỚC KHI CÀI ĐẶT
- Máy trạm sử dụng hệ điều hành Windows.
- Người dùng có quyền cài đặt phần mềm hoặc có tài khoản Administrator khi Windows yêu cầu.
- Trình duyệt cho phép gọi API cục bộ localhost theo cấu hình của hệ thống.
- Thiết bị ký số/USB Token và driver liên quan đã được cài đặt nếu chức năng ký số yêu cầu.
- Có bộ cài Vietnam Social Security Declaration phiên bản phù hợp với hệ thống.
HƯỚNG DẪN CÀI ĐẶT ỨNG DỤNG WINDOWS
Tải về ứng dụng nền vietnam social security declaration tại: https://dichvucong.baohiemxahoi.gov.vn:8888/download/vss-declaration-setup_26.7.3.0.exe
Sau khi tải về sẽ tiến hành cài đặt theo từng bước. Như vậy, để không gặp trường hợp Không tìm thấy ứng dụng nền vietnam social security declaration, bạn cần làm đúng ngay từ ban đầu.
Lưu ý nếu trước đó đã cài rồi nhớ gỡ ứng dụng cũ trước khi cài mới
Bước 1 – Màn hình chào mừng
Người dùng chạy bộ cài đặt Vietnam Social Security Declaration. Tại màn hình chào mừng, nhấn tiếp tục.
Bước 2 – Chọn thư mục cài đặt
Chọn thư mục cài đặt hoặc giữ nguyên thư mục mặc định do bộ cài đề xuất. Sau đó nhấn tiếp tục.
Bước 3 – Sẵn sàng cài đặt
Tại màn hình xác nhận, nhấn Install/Cài đặt để bắt đầu cài đặt ứng dụng.
Sau khi nhấn Cài đặt, Windows có thể hiển thị hộp thoại User Account Control. Người dùng chọn Yes để cấp quyền Administrator. Nếu chọn No, quá trình cài đặt sẽ bị hủy.
Bước 4 – Theo dõi tiến độ cài đặt
Chờ bộ cài sao chép tệp và cấu hình ứng dụng nền. Không tắt cửa sổ cài đặt khi thanh tiến trình đang chạy.
Bước 5 – Hoàn tất cài đặt
Khi màn hình hoàn tất hiển thị, nhấn Finish/Kết thúc. Ứng dụng nền sẽ được khởi động để phục vụ các API ký số trên localhost.
Xử lý lỗi Không tìm thấy ứng dụng nền vietnam social security declaration
Vietnam social security declaration của BHXH sau khi cài xong không chạy ngay giống như trước đây. Nếu bán kỳ liền sẽ có lỗi là Không tìm thấy ứng dụng nền vietnam social security declaration. Hãy cùng TOP dịch vụ kế toán xử lý lỗi này ngay sau đâu nhé.
Cài đặt SSL sau khi cài đặt
Sau khi cài đặt thành công, nhấp chuột phải vào biểu tượng Vietnam Social Security Declaration tại khu vực khay hệ thống (System Tray) ở góc phải thanh Taskbar, sau đó chọn “Cài đặt SSL”.
Kiểm tra tính sẵn sàng của các api bằng Swagger
Sau khi cài đặt xong, nhấp chuột phải vào biểu tượng Vietnam Social Security Declaration tại khu vực khay hệ thống (System Tray) ở góc phải thanh Taskbar, sau đó chọn “Mở trình duyệt“.
Ứng dụng sẽ tự động mở trình duyệt trên máy người dùng và kiểm tra một trong các địa chỉ sau:
- http://localhost:61505/swagger
- https://localhost:61505/swagger
Nếu màn hình Swagger hiển thị danh sách API, ứng dụng nền đã khởi động thành công. Nếu không truy cập được, cần kiểm tra ứng dụng đã chạy hay chưa, cổng localhost có bị chặn hay không, hoặc thử khởi động lại ứng dụng nền.
Cấu hình mẫu chữ ký sau khi cài đặt
Bước 1: Sau khi cài đặt thành công, nhấp chuột phải vào biểu tượng Vietnam Social Security Declaration tại khu vực khay hệ thống (System Tray) ở góc phải thanh Taskbar, sau đó chọn “Cấu hình”.
Bước 2: Trong màn hình “Cấu hình chữ ký”, nhấn nút “Thêm mới” (được khoanh đỏ) để tạo mẫu chữ ký mới.
Bước 3: Nhập Tên mẫu, lựa chọn kiểu hiển thị chữ ký, tải ảnh chữ ký và cấu hình các thông tin hiển thị.
Bước 4: Sau khi hoàn tất cấu hình, nhấn nút “Lưu” để lưu lại mẫu chữ ký.
LỖI THƯỜNG GẶP VÀ CÁCH XỬ LÝ
Tuy nhiên vẫn còn 1 số lỗi do trình duyệt và máy tính bạn có thể xem thêm tại đây nhé
| Hiện tượng | Nguyên nhân thường gặp | Cách xử lý |
| Không truy cập được Swagger | Ứng dụng nền chưa chạy hoặc port bị chặn. | Khởi động lại ứng dụng, kiểm tra firewall/antivirus, thử lại localhost:61505. |
| Windows hỏi quyền Administrator | Bộ cài cần quyền ghi file/cấu hình ứng dụng. | Chọn Yes; nếu không có quyền, liên hệ IT để cài đặt. |
| FE báo không tìm thấy ứng dụng ký số | Safe Host chưa chạy hoặc SDK chưa scan đúng endpoint. | Mở ứng dụng nền, kiểm tra /checkport, xóa cache endpoint nếu cần. |
| Ký bị cancelled | Người dùng đóng hộp thoại chọn chứng thư/ký số. | Thực hiện lại thao tác và chọn chứng thư hợp lệ. |
| duplicated | Nonce bị gửi lặp trong thời gian ngắn. | Tạo request mới với nonce mới, không retry y nguyên payload cũ. |
| Chứng thư không hiển thị | USB Token/driver chưa sẵn sàng hoặc chưa chọn chứng thư. | Kiểm tra USB Token, driver, phần mềm quản lý token và thử lại. |
TOP dịch vụ kế toán – nơi kết nối các doanh nghiệp và công ty kế toán, khai thuế, báo cáo thuế uy tín – chuyên nghiệp – giá rẻ – gói toàn quốc.
- Bạn là CÔNG TY DỊCH VỤ KẾ TOÁN: đăng ký làm Dịch vụ kế toán miễn phí và chứng minh năng lực để khách hàng lựa chọn
- Bạn là DOANH NGHIỆP: xem ngay DANH SÁCH CÔNG TY DỊCH VỤ KẾ TOÁN theo từng tỉnh thành để có nhiều lựa chọn
- Cùng thảo luận tại: Diễn đàn kế toán và thuế
