Lỗi thường gặp khi dùng MySign nằm ở bốn chặng: phần mềm kết nối tài khoản, yêu cầu ký chờ xác nhận, tài khoản trên ứng dụng và cổng tiếp nhận sau khi ký. Bài viết chỉ liệt kê các mã, thông báo có trong tài liệu chính thức của Viettel-CA – dịch vụ chứng thực chữ ký số của Viettel, kèm nguyên nhân và cách xử lý.
Bảng tra nhanh lỗi MySign theo mã và thông báo
Các mã dưới đây lấy từ tài liệu tích hợp API MySign và hướng dẫn hỗ trợ của Viettel-CA. Phần mềm bạn dùng có thể hiển thị nguyên mã hoặc diễn đạt lại bằng lời.
| Mã, thông báo | Chặng | Ý nghĩa | Xử lý nhanh |
|---|---|---|---|
| 401 – "user ID or password is invalid" | Kết nối | Phần mềm đăng nhập dịch vụ không thành công | Kiểm tra User ID khai báo trong phần mềm; lỗi còn thì báo nhà cung cấp phần mềm. |
| 400 – "Invalid parameter credentialID" | Kết nối | Mã chứng thư phần mềm gửi đi không hợp lệ | Chọn lại chứng thư trong phần mềm, nhất là sau gia hạn. |
| Trạng thái khóa DISABLED | Kết nối | Chứng thư không dùng được để ký | Kiểm tra hạn và tình trạng chứng thư, liên hệ nhà cung cấp. |
| 4000 – Chờ người dùng xác nhận | Chờ ký | Yêu cầu đang đợi bạn | Mở MySign, đối chiếu, xác nhận hoặc từ chối. |
| 4001 – Hết thời gian chờ | Chờ ký | Không xác thực kịp | Tạo lại yêu cầu, mở sẵn ứng dụng. |
| 4002 – Người dùng từ chối ký | Chờ ký | Yêu cầu đã bị từ chối | Tạo lại nếu từ chối nhầm. |
| 4004 – Ký thất bại | Chờ ký | Có lỗi khi tạo chữ ký | Thử lại một lần, lặp lại thì báo hỗ trợ. |
| 50000 – Lỗi khi lấy thông tin | Chờ ký | Không lấy được trạng thái | Chờ ít phút rồi kiểm tra lại, tránh ký trùng. |
| Tài khoản đã bị vô hiệu hóa | Tài khoản | Tài khoản bị chặn sử dụng | Gọi Tổng đài Viettel 18008000 nhánh 1 để mở khóa. |
| "Chứng thư số chưa được đăng ký với Cơ quan thuế" | Sau khi ký | Cổng thuế chưa ghi nhận chứng thư đang dùng | Cập nhật chứng thư trên cổng thuế. |
Lỗi khi phần mềm kết nối tài khoản MySign
Theo tài liệu tích hợp ký đồng bộ của Viettel-CA, trước khi gửi yêu cầu ký, phần mềm đăng nhập dịch vụ bằng mã ứng dụng của nó cùng User ID của người ký, sau đó lấy danh sách chứng thư của tài khoản. Lỗi ở chặng này xảy ra trước khi điện thoại nhận được gì, nên bấm lại trên ứng dụng MySign không giải quyết được.
401: user ID or password is invalid
Thông báo đầy đủ trong tài liệu là "Failed to process request - user ID or password is invalid". Nguyên nhân có thể là User ID khai báo trong phần mềm bị gõ sai, thừa khoảng trắng hoặc thuộc tài khoản khác, hoặc thông tin kết nối của chính phần mềm chưa đúng. Kiểm tra lại User ID, và mật khẩu nếu phần mềm yêu cầu nhập, trong phần cấu hình chữ ký số. Thông tin đúng mà vẫn lỗi thì báo nhà cung cấp phần mềm, vì thông tin kết nối của phần mềm do họ quản lý.
400: Invalid parameter credentialID
Tài liệu liệt kê các biến thể "Missing (or invalid type) string parameter credentialID" và "Invalid parameter credentialID": phần mềm gửi mã chứng thư trống hoặc không thuộc tài khoản. Tình huống điển hình là phần mềm còn lưu chứng thư cũ sau khi bạn gia hạn hoặc được cấp chứng thư mới. Vào phần cấu hình, tải lại danh sách chứng thư và chọn chứng thư đang còn hiệu lực.
Chứng thư ở trạng thái DISABLED
Danh sách chứng thư trả về cho phần mềm có trạng thái khóa ENABLED hoặc DISABLED; DISABLED nghĩa là chứng thư không dùng được để ký. Theo Nghị định 23/2025/NĐ-CP, chứng thư có hiệu lực là chứng thư chưa hết hạn, không bị tạm dừng hoặc thu hồi. Hãy kiểm tra ngày hết hạn và liên hệ nhà cung cấp để biết chứng thư có đang bị tạm dừng hay không.
Lỗi trong lúc chờ xác nhận ký
Tài liệu tích hợp ký bất đồng bộ của Viettel-CA mô tả các trạng thái phần mềm nhận được khi hỏi kết quả yêu cầu ký. Cách xử lý:
- 4001, hết thời gian chờ: yêu cầu hết hiệu lực vì không được xác thực kịp; phải tạo yêu cầu mới. Mở sẵn MySign rồi bấm ký lại trên phần mềm.
- 4002, người dùng từ chối ký: nếu bạn từ chối nhầm, tạo yêu cầu mới. Nếu không phải bạn từ chối, kiểm tra xem tài khoản có đang đăng nhập trên thiết bị khác không.
- 4004, ký thất bại: thử lại một lần. Nếu lặp lại, ghi thời điểm, mã giao dịch mà phần mềm hiển thị và liên hệ hỗ trợ.
- 50000, lỗi khi lấy thông tin: đừng ký lại ngay. Chờ ít phút, kiểm tra hồ sơ đã được gửi hay chưa để tránh nộp trùng.
Nếu không thấy yêu cầu nào trên điện thoại, xem luồng đầy đủ trong bài cài đặt và sử dụng MySign, mục tự kiểm tra nhanh.
Tài khoản bị vô hiệu hóa, không đăng nhập được
MySign có chức năng Vô hiệu hóa tài khoản trong mục Cài đặt chung, dành cho khách hàng muốn ngừng sử dụng. Theo hướng dẫn của Viettel-CA, sau khi vô hiệu hóa, muốn mở khóa lại phải liên hệ Tổng đài Viettel 18008000 nhánh 1. Tài khoản bị vô hiệu hóa thì không nhận được yêu cầu ký, dù phần mềm và chứng thư vẫn đúng.
Quên mật khẩu thì chỉ khôi phục qua ứng dụng MySign chính thức hoặc tổng đài, không dùng đường link gửi qua tin nhắn. Không ai được yêu cầu bạn đọc mã xác thực qua điện thoại. Mất điện thoại hoặc SIM thì xử lý theo hướng dẫn đổi, mất máy trước.
Lỗi ở cổng tiếp nhận sau khi ký
Ký thành công trên MySign chưa có nghĩa hồ sơ được chấp nhận. Cổng tiếp nhận còn kiểm tra chứng thư đã được đăng ký với họ hay chưa.
"Chứng thư số chưa được đăng ký với Cơ quan thuế"
Viettel-CA có hướng dẫn riêng cho lỗi này: chứng thư đang dùng chưa được cập nhật vào tài khoản giao dịch thuế, thường gặp sau khi gia hạn hoặc chuyển sang chứng thư mới. Cách xử lý là đăng nhập cổng thuế và thay đổi thông tin chứng thư số sang chứng thư đang dùng. Cục Thuế đã triển khai hệ thống tại dichvucong.gdt.gov.vn để thay thế Thuế điện tử, nên thao tác cụ thể trên cổng mới xem tại hướng dẫn thuế điện tử toàn tập.
Hóa đơn điện tử, BHXH
Với hóa đơn điện tử, chứng thư dùng để ký cần có trong danh sách chứng thư số đã khai trên tờ khai 01/ĐKTĐ-HĐĐT theo Thông tư 91/2026/TT-BTC; xem hướng dẫn hóa đơn điện tử trên cổng Cục Thuế. Với BHXH, kiểm tra theo hướng dẫn BHXH điện tử toàn tập. Tài liệu đã ký mà trình đọc PDF báo chữ ký chưa xác định, xem lỗi chữ ký số không hợp lệ.
Thông tin cần chuẩn bị khi gọi hỗ trợ
- Tên phần mềm hoặc cổng đang ký, thời điểm xảy ra lỗi.
- Nguyên văn thông báo, mã lỗi, mã giao dịch nếu phần mềm hiển thị.
- User ID MySign và tên chủ thể chứng thư; tuyệt đối không gửi mật khẩu, OTP.
- Ảnh chụp màn hình đã che thông tin nhạy cảm.
Kênh chính thức Viettel-CA công bố: hotline 18008009 nhánh 3, email [email protected]; mở khóa tài khoản MySign: Tổng đài Viettel 18008000 nhánh 1. Lỗi do cấu hình phần mềm thì báo nhà cung cấp phần mềm đó.
Câu hỏi thường gặp về lỗi MySign
Phần mềm báo sai User ID, có phải đổi mật khẩu MySign không?
Không nhất thiết. Lỗi 401 xảy ra khi phần mềm đăng nhập dịch vụ, bằng mã ứng dụng của phần mềm và User ID của bạn. Kiểm tra User ID đã khai báo trước; nếu đúng mà vẫn lỗi, báo nhà cung cấp phần mềm.
Vì sao sau khi gia hạn thì phần mềm báo lỗi credentialID?
Phần mềm có thể còn lưu mã chứng thư cũ. Tải lại danh sách chứng thư trong phần cấu hình và chọn chứng thư đang còn hiệu lực.
Yêu cầu ký báo hết thời gian thì có mất hồ sơ không?
Không. Hồ sơ vẫn nằm trên phần mềm, chỉ yêu cầu ký hết hiệu lực. Mở sẵn MySign rồi bấm ký lại.
Tài khoản MySign bị vô hiệu hóa thì làm sao dùng lại?
Theo hướng dẫn của Viettel-CA, liên hệ Tổng đài Viettel 18008000 nhánh 1 để được mở khóa.
Ký MySign xong nhưng cổng thuế báo chứng thư chưa đăng ký?
Chứng thư đang dùng chưa được cập nhật vào tài khoản giao dịch thuế. Đăng nhập cổng thuế, thay đổi thông tin chứng thư số sang chứng thư hiện tại rồi nộp lại.
Lỗi vẫn chưa xử lý được?
Chuẩn bị nguyên văn thông báo lỗi, tên phần mềm và thời điểm xảy ra, rồi để lại thông tin để được hướng dẫn. Không gửi mật khẩu, OTP hay ảnh chụp có mã xác thực.
Nguồn đối chiếu: Viettel-CA – Hướng dẫn tích hợp API ký đồng bộ dịch vụ MySign, ký bất đồng bộ, vô hiệu hóa tài khoản MySign, lỗi chứng thư số chưa được đăng ký với cơ quan thuế; thông báo triển khai dichvucong.gdt.gov.vn (Thư viện Pháp luật). Thông tin có thể thay đổi; ưu tiên hướng dẫn hiện hành của nhà cung cấp và cơ quan quản lý tại thời điểm thao tác. Cập nhật: 28/09/2026.