Cổng dịch vụ công thuế (dichvucong.gdt.gov.vn) chủ yếu báo lỗi bằng câu chữ, không có bảng mã số chính thức, nên cùng một lỗi có thể được gọi bằng nhiều tên. Bảng mã lỗi thuế điện tử này gom các thông báo đã ghi nhận trên cổng và trong hướng dẫn đã công bố, chia theo giai đoạn đăng nhập, cài đặt, ký số, nộp hồ sơ và kết quả xử lý, kèm cách xử lý và bài chi tiết.
Xác định lỗi xảy ra ở bước nào rồi dò nguyên văn thông báo trong bảng tương ứng. Năm lỗi hay gặp nhất: chưa cài hoặc bật plugin chữ ký số (công cụ ký, quyền trình duyệt), chứng thư số chưa được đăng ký với cơ quan thuế (cập nhật chứng thư), sai mã PIN hoặc không tìm thấy thiết bị (USB Token), tờ khai không đúng định dạng với XSD (HTKK, tệp XML) và mẫu tờ khai đã được nâng cấp (nộp lại trên cổng mới, mẫu mới).
Cách dùng bảng mã lỗi
- Chụp nguyên văn thông báo, kể cả dòng chi tiết. Nhiều thông báo gần giống nhau nhưng cách xử lý khác nhau.
- Ghi lại bước đang làm: đăng nhập, mở trang ký, nhập PIN, tải XML hay sau khi nộp.
- Thông báo lấy từ trang đăng nhập của cổng (kiểm tra ngày 28/9/2026), thông báo của Cục Thuế, hướng dẫn trên Thư viện Pháp luật, câu hỏi thường gặp của Viettel-CA – dịch vụ chứng thực chữ ký số của Viettel và hướng dẫn của các nhà cung cấp phần mềm. Giao diện có thể đổi sau mỗi đợt nâng cấp.
- Không gửi PIN, mật khẩu, mã OTP cho bất kỳ ai khi nhờ hỗ trợ.
Tổng quan về cổng, quy định và việc cần chuẩn bị: thuế điện tử doanh nghiệp: hướng dẫn toàn tập.
Lỗi đăng nhập và tài khoản
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| “Vui lòng nhập tên đăng nhập!”, “Vui lòng nhập mật khẩu!”, “Vui lòng nhập mã captcha” | Bỏ trống ô bắt buộc | Nhập đủ tên đăng nhập, mật khẩu, mã captcha | Lỗi đăng nhập |
| “Thông tin tên đăng nhập hoặc mật khẩu chưa đúng” | Sai thông tin; tên đăng nhập có khoảng trắng | Chọn đúng đối tượng Doanh nghiệp, xóa khoảng trắng, nhập mã captcha mới; quên mật khẩu thì dùng Lấy lại mật khẩu trên thuedientu.gdt.gov.vn | Lỗi đăng nhập |
| “Không thể truy vấn sang VNEID!” | Cổng không chuyển được sang VNeID | Thử lại sau ít phút, kiểm tra mạng | Lỗi đăng nhập |
| “Đã có lỗi hệ thống xảy ra!” | Lỗi xử lý hoặc kết nối phía hệ thống | Tải lại trang, thử lại sau, xem mục Tin tức về bảo trì | Lỗi đăng nhập |
| “Tài khoản hiện đang được sử dụng trên một tab khác…” | Cổng chỉ cho một tab hoạt động | Đóng tab thừa, dùng tab đang hoạt động | Lỗi đăng nhập |
| VNeID mức 1; tài khoản thành viên chưa phân quyền; “NNT cần bổ sung thông tin người đại diện pháp luật hoặc liên hệ với cơ quan quản thuế” | Chưa đủ điều kiện truy cập với vai trò tổ chức | Nâng VNeID lên mức 2, nhờ quản trị phân quyền, bổ sung thông tin người đại diện với cơ quan thuế | Đăng nhập cho doanh nghiệp |
| Không nhận OTP hoặc email xác thực | Thư bị lọc hoặc email đăng ký sai | Kiểm tra thư rác, thêm địa chỉ gửi của cơ quan thuế vào danh sách tin cậy | Lỗi đăng nhập |
| “Thông tin Định danh không khớp (tên DN, MST, email)”, “Lỗi thông tin Doanh nghiệp không khớp” | Thông tin doanh nghiệp giữa các hệ thống chưa thống nhất | Đề nghị điều chỉnh thông tin với cơ quan thuế quản lý | Đăng ký lần đầu |
Lỗi công cụ ký và trình duyệt
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| “Chưa cài đặt hoặc bật Plugin chữ ký số” | Trang web không gọi được công cụ ký trên máy | Cài CT SigningHub, eSigner từ mục Trợ giúp; cho phép Local Network Access; tải lại trang | Lỗi 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ử…” | Thiếu công cụ ký hoặc nền tảng | Cài eSigner, Java; khởi động lại trình duyệt rồi thao tác lại | Lỗi plugin chữ ký số |
| eSigner không chạy khi lập giấy nộp tiền | eSigner chưa cài hoặc bị trình duyệt chặn | Cài eSigner; cấp quyền kết nối cho trang | Lỗi eSigner khi nộp tiền |
| Cài CT SigningHub báo lỗi .NET Framework | Thiếu .NET Framework 4.8 hoặc 4.8.1 | Cài .NET Framework từ Microsoft rồi cài lại | Chuẩn bị máy ký số |
| eSigner báo cần Java Runtime Environment | Máy chưa có Java | Cài Java cho máy tính từ java.com | Lỗi plugin chữ ký số |
| CT SigningHub không mở hoặc treo | Tiến trình cũ còn chạy ngầm | Tắt tiến trình trong Task Manager, mở lại; vẫn lỗi thì gỡ và cài bản mới | Chuẩn bị máy ký số |
Lỗi ký số và chứng thư
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| “Chứng thư số chưa được đăng ký với Cơ quan thuế” (biến thể: “Chữ ký số chưa được đăng ký với cơ quan Thuế”) | Chứng thư dùng để ký khác chứng thư đã đăng ký | Thay đổi thông tin dịch vụ cho Khai thuế điện tử và Nộp thuế điện tử | Lỗi chứng thư chưa đăng ký, thay đổi chữ ký số |
| “Không tìm thấy chữ ký số với Serial đã chọn trong USB” | Token đang cắm không chứa chứng thư đã chọn, đã đăng ký | Cắm đúng Token; nếu đã gia hạn, cập nhật chứng thư mới | Lỗi không tìm thấy Serial, không tìm thấy chữ ký số |
| “Sai mã pin hoặc không tìm thấy thiết bị chứng thư số”, “USB không có chữ ký số” | Máy không nhận Token hoặc PIN sai | Kiểm tra Token Manager, khởi động lại công cụ ký, xóa dữ liệu duyệt web; không thử PIN liên tục | Lỗi sai PIN, không thấy thiết bị |
| “Chữ ký điện tử trên tờ khai không hợp lệ” | Chữ ký trên tệp không được chấp nhận | Cài lại eSigner, CT SigningHub; kết xuất lại XML; ký tệp bằng CT SigningHub rồi tải lên, hoặc kê khai trực tuyến | Lỗi chữ ký trên tờ khai, chữ ký số không hợp lệ |
| “Chờ xác thực ký số, vui lòng kiểm tra lại tình trạng hồ sơ” | Yêu cầu ký từ xa chưa được xác nhận | Xác nhận trên ứng dụng ký từ xa; kiểm tra chứng thư đã đăng ký đúng hình thức | Thay đổi chữ ký số |
| “Ký số thất bại, File … có lỗi xảy ra trong quá trình ký số” (tệp đính kèm báo cáo tài chính) | Tệp định dạng .xls cũ, hoặc hình thức ký không hỗ trợ tệp đính kèm | Lưu lại thành .xlsx; ký bằng USB Token | Nộp báo cáo tài chính |
| Chứng thư hết hạn hoặc bị thu hồi | Chứng thư không còn hiệu lực | Gia hạn, sau đó cập nhật trên tài khoản thuế; lỗi thiết bị, chữ ký số của người nộp thuế không làm thay đổi thời hạn nộp | Gia hạn Viettel-CA |
Lỗi khi nộp tờ khai, tệp XML
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| “Tờ khai không đúng định dạng với XSD” (có thể kèm dòng chi tiết cvc-… nhắc HSoThueDTu) | Tệp XML sai cấu trúc hoặc sai dữ liệu | Cập nhật HTKK, sửa dữ liệu, kết xuất lại, bấm View Form XML; lỗi lúc ký thì cập nhật CT SigningHub | Lỗi XSD |
| “File XML không hợp lệ, sai mẫu biểu”, “Có lỗi xử lý khi nộp XML” | Mẫu cũ, sai định dạng ngày, mã cơ quan thuế | Cập nhật HTKK, kiểm tra dữ liệu, xem trước tệp trước khi ký | Lỗi XSD |
| Tệp XML dung lượng lớn không nộp được | Dữ liệu lớn vượt khả năng tải thông thường | Dùng HTKK_DLL, iTaxViewer_DLL; ký tệp trước rồi nộp | Lỗi XSD |
| “Có lỗi trong quá trình xử lý tờ khai. Tờ khai phát sinh các lỗi sau: -Mẫu tờ khai đã được nâng cấp…” | Nộp sai kênh hoặc mẫu cũ | Nộp lại trên dichvucong.gdt.gov.vn bằng mẫu mới, đúng mã thủ tục | Lỗi mẫu tờ khai nâng cấp |
| “Hồ sơ chưa đăng ký nộp qua mạng” | Mã số thuế chưa đăng ký nộp điện tử phù hợp | Kiểm tra đúng mã số thuế, đăng ký dịch vụ; hệ thống cũ: Đăng ký thêm tờ khai | Lỗi chưa đăng ký nộp qua mạng |
| “Đã tồn tại tờ khai chính thức được chấp nhận. Vui lòng kê khai tờ khai bổ sung” | Đã có tờ khai chính thức cùng mẫu, cùng kỳ | Tra cứu hồ sơ đã nộp; sửa kỳ nếu chọn nhầm; khai bổ sung nếu cần điều chỉnh | Lỗi tờ khai chính thức đã tồn tại |
| “Đề nghị NNT thực hiện TTHC bằng hình thức trực tiếp hoặc gửi qua bưu chính” (khi nộp báo cáo tài chính riêng) | Báo cáo tài chính cần nộp kèm tờ khai quyết toán 03/TNDN | Nộp theo luồng tờ khai 03/TNDN kèm báo cáo tài chính | Nộp báo cáo tài chính |
| “Tờ khai chỉ có hiệu lực đến năm 2024. Đề nghị NNT kê khai tờ khai 03/TNDN đính kèm BCTC trước khi ký và nộp tờ khai!” | Chọn mẫu báo cáo tài chính nộp tách riêng | Kê khai 03/TNDN và đính kèm báo cáo tài chính | Nộp báo cáo tài chính |
Kết quả xử lý và sự cố hệ thống
| Mã/thông báo | Ý nghĩa | Cách xử lý | Bài chi tiết |
|---|---|---|---|
| Thông báo không tiếp nhận hồ sơ (mẫu 01/TB-TĐT) | Hồ sơ chưa được tiếp nhận, chưa tính là đã nộp | Đọc lý do, sửa, nộp lại trong hạn | Tra cứu hồ sơ, thông báo |
| Không thấy hồ sơ nộp trước 01/7/2025 | Dữ liệu thuộc hệ thống Thuế điện tử cũ | Dùng phần tra cứu hồ sơ đã nộp trên Thuế điện tử | Tra cứu hồ sơ, thông báo |
| iTaxViewer báo “Không biết chủ thể của chứng thư số” hoặc không kiểm tra được tình trạng thu hồi | Cảnh báo của phần mềm đọc tệp | Lấy trạng thái trên cổng làm căn cứ; cập nhật iTaxViewer | Tra cứu hồ sơ, thông báo |
| Cổng gặp sự cố đúng ngày cuối hạn | Sự cố của hệ thống cơ quan thuế | Theo dõi thông báo sự cố (mẫu 02/TB-TĐT); nộp vào ngày kế tiếp khi hệ thống hoạt động lại vẫn được coi là đúng hạn | Hướng dẫn toàn tập |
| Máy, USB Token hoặc mạng của doanh nghiệp gặp sự cố khi đến hạn | Sự cố phía người nộp thuế | Tự khắc phục; chưa được thì nộp hồ sơ giấy tại bộ phận một cửa hoặc qua bưu chính | Hướng dẫn toàn tập |
Hai dòng cuối theo Điều 12 Thông tư 89/2026/TT-BTC (hiệu lực từ 01/7/2026); đây là tóm tắt để tham khảo, hãy đối chiếu văn bản gốc hoặc hỏi cơ quan thuế quản lý cho trường hợp cụ thể. Khi lỗi không có trong bảng, gửi ảnh thông báo, bước đang làm, phiên bản Windows, trình duyệt và thời điểm xảy ra cho cơ quan thuế quản lý hoặc bộ phận hỗ trợ.
Câu hỏi thường gặp
Cổng dịch vụ công thuế có mã lỗi dạng số không?
Phần lớn lỗi hiển thị bằng câu chữ, không kèm mã số. Một số lỗi tệp XML có thêm dòng chi tiết kỹ thuật bằng tiếng Anh, ví dụ bắt đầu bằng cvc-, cho biết phần tử bị sai.
Vừa gia hạn chữ ký số thì hay gặp lỗi nào?
Thường là “Chứng thư số chưa được đăng ký với Cơ quan thuế” hoặc không tìm thấy chữ ký số với serial đã chọn. Hãy cập nhật chứng thư mới cho dịch vụ khai thuế và nộp thuế.
Gặp lỗi đúng ngày cuối hạn nộp thì sao?
Nếu hệ thống của cơ quan thuế gặp sự cố, Cục Thuế thông báo và hồ sơ nộp vào ngày kế tiếp khi hệ thống hoạt động lại được coi là đúng hạn. Nếu lỗi ở máy, Token hay mạng của doanh nghiệp, doanh nghiệp phải tự khắc phục hoặc nộp hồ sơ giấy.
Lỗi của tôi không có trong bảng thì làm gì?
Chụp nguyên văn thông báo, ghi bước đang làm và thời điểm, rồi liên hệ cơ quan thuế quản lý hoặc kênh hỗ trợ ghi ở chân trang cổng. Không gửi PIN, mật khẩu hay mã OTP.
Bảng này có thay thế hướng dẫn của Cục Thuế không?
Không. Bảng tổng hợp để tra cứu nhanh; khi thông báo trên cổng hoặc hướng dẫn của cơ quan thuế khác với bảng, hãy làm theo hướng dẫn hiện hành của cơ quan thuế.
Không tự xử lý được lỗi ký số trên cổng thuế?
Chuẩn bị ảnh thông báo lỗi và mô tả bước đang làm. Không gửi mã PIN, mật khẩu hay mã OTP cho bất kỳ ai.
Nguồn đối chiếu: Trang đăng nhập Hệ thống thông tin giải quyết TTHC, Cục Thuế; Tin tức – thông báo nâng cấp hệ thống, Cục Thuế; Thông tư 89/2026/TT-BTC, Điều 11–13; Tổng hợp lỗi khi nộp tờ khai trên dichvucong.gdt.gov.vn – Thư viện Pháp luật; Câu hỏi thường gặp – Viettel-CA. 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.
