Cẩm Nang Chẩn Đoán và Xử Lý Sự Cố Khi Kê Khai Thuế Qua VNeID

Giải Quyết Sự Cố Đăng Nhập và Truy Cập

Xử Lý lỗi trên ứng dụng VNeID

Ngoài những nguyên nhân cơ bản phổ biến như là nhập sai mật khẩu hoặc passcode thì có những lỗi:

Không thể cài đặt hoặc có hạn chế trong quá trình sử dụng VNeID

Nguyên nhân	Giải pháp
Hệ điều hành điện thoại không tương thích.	Hãy kiểm tra điện thoại của bạn về các bản cập nhật hệ điều hành mới, sao cho từ Android 5.0 trở lên hoặc iOS 13 trở lên.

VNeID không khởi động hoặc báo lỗi "Thiết bị không an toàn"

Nguyên nhân

Giải pháp

Vì lý do bảo mật, ứng dụng VNeID phiên bản mới sẽ chặn hoạt động trên các thiết bị đã bị can thiệp vào hệ điều hành (root đối với Android, jailbreak đối với iOS) hoặc đang bật "Chế độ nhà phát triển" (Developer Mode).

- Tắt Chế độ nhà phát triển: Vào phần "Cài đặt" (Settings) của điện thoại, tìm mục "Tùy chọn nhà phát triển" (Developer Options) và tắt nó đi.

- Khôi phục thiết bị: Đối với các máy đã root/jailbreak, giải pháp duy nhất là khôi phục điện thoại về trạng thái cài đặt gốc của nhà sản xuất. Cần sao lưu toàn bộ dữ liệu quan trọng trước khi thực hiện.

Cẩm Nang Chẩn Đoán và Xử Lý Sự Cố Khi Kê Khai Thuế Qua VNeID — Tắt Chế độ nhà phát triển khởi động VNeID

Không đăng nhập được trên thiết bị mới

Nguyên nhân

Giải pháp

Đây là một tính năng bảo mật. Khi đăng nhập trên một thiết bị lạ, hệ thống yêu cầu xác nhận từ thiết bị cũ đã đăng nhập trước đó

Đăng nhập tài khoản định danh điện tử VNeID trên thiết bị mới

- Nếu thiết bị cũ còn sử dụng được: Mở ứng dụng VNeID trên thiết bị cũ để lấy mã OTP hoặc xác nhận yêu cầu đăng nhập cho thiết bị mới.

- Nếu thiết bị cũ đã mất hoặc hỏng: Sử dụng chức năng xác thực bằng cách quét chip NFC trên thẻ CCCD để chứng minh danh tính trên thiết bị mới. Sau đó, nhập mã OTP mà hệ thống tự động gửi về.

Xử Lý lỗi đăng nhập Cổng Thuế điện tử

Các lỗi này xảy ra trong hoặc sau khi người dùng đã xác thực thành công qua VNeID.

Nguyên nhân	Giải pháp
*"Tài khoản không tồn tại”*: Doanh nghiệp chưa hoàn tất đăng ký lần đầu trên Cổng Thuế điện tử, hoặc có lỗi đồng bộ dữ liệu.	=> Đối với doanh nghiệp mới, người đại diện pháp luật phải đăng nhập qua VNeID để hoàn tất quy trình đăng ký ban đầu trên eTax.
*"Tài khoản có quyền thành viên chưa được phân quyền"*: Người đại diện pháp luật đã thêm người dùng trên VNeID nhưng chưa gán vai trò thuế cụ thể trên Cổng thuedientu.gdt.gov.vn.	=> Người quản trị (tài khoản -ql) phải đăng nhập eTax, vào "Quản lý tài khoản" và tạo/gán vai trò cho người dùng theo số CCCD.
"Trình duyệt không hỗ trợ" / Màn hình trắng: Sử dụng trình duyệt, ứng dụng lỗi thời hoặc không tương thích. Cổng eTax và các plugin (eSigner) thường được tối ưu cho Chrome và IE Tab.	=> Cập nhật trình duyệt, cài đặt tiện ích IE Tab cho Chrome, xóa bộ nhớ cache và cookie, hoặc thử một trình duyệt khác.

Tham khảo bài viết hướng dẫn Đăng Nhập Cổng Thuế Điện Tử Bằng VNeID và Phân Quyền Cho Kế Toán: Tích Hợp VNeID vào Hệ Thống Kế Toán Doanh Nghiệp năm 2025

Hiệu Chỉnh Sai Lệch Thông Tin Thuế

Nguyên nhân gốc rễ

Kiểm tra sai lệch

Chính phủ đang trong quá trình thống nhất dữ liệu công dân. Hệ thống của Tổng cục Thuế giờ đây hoạt động như một "bên sử dụng" dữ liệu này. Sai lệch phát sinh do các lỗi lịch sử trong cơ sở dữ liệu cũ của ngành thuế hoặc do độ trễ trong quá trình đồng bộ hóa.

- Cách 1 (Ứng dụng VNeID): Đăng nhập, vào mục "Ví giấy tờ" => Trong phần “Giấy tờ”, chọn mục "Thông tin thuế" để xem các thông tin mà Tổng cục Thuế đã liên kết với tài khoản VNeID của bạn.

- Cách 2 (Cổng Thuế điện tử): Đăng nhập vào thuedientu.gdt.gov.vn và xem lại thông tin đăng ký của doanh nghiệp. Ngoài ra, có thể sử dụng cổng tra cứu công khai tracuunnt.gdt.gov.vn.

Nếu thông tin trên CCCD/VNeID bị sai (ví dụ: sai họ tên, ngày sinh, nơi thường trú): Đây là dữ liệu thuộc quản lý của Bộ Công an. Người dùng phải liên hệ cơ quan công an cấp xã/phường để làm thủ tục điều chỉnh.
Nếu thông tin VNeID đúng nhưng hồ sơ thuế bị sai (ví dụ: địa chỉ kinh doanh cũ, sai thông tin người đại diện pháp luật trên hồ sơ thuế): Đây là dữ liệu thuộc quản lý của cơ quan thuế. Doanh nghiệp phải thực hiện thủ tục thay đổi thông tin đăng ký thuế với cơ quan thuế quản lý trực tiếp.

Thủ tục thay đổi thông tin đăng ký thuế:

Trực tuyến qua Cổng Thuế điện tử: Đăng nhập bằng tài khoản quản trị (-ql), vào mục "Đăng ký thuế" -> "Thay đổi thông tin" và nộp tờ khai điện tử theo mẫu quy định (ví dụ: mẫu 08-MST).

Thông qua cơ quan chi trả thu nhập: Đối với người lao động, việc cập nhật thông tin (ví dụ: từ CMND sang CCCD) có thể được thực hiện thông qua doanh nghiệp nơi họ làm việc.
Trực tiếp tại cơ quan thuế: Đối với các trường hợp phức tạp hoặc khi phương thức trực tuyến không thành công, doanh nghiệp cần chuẩn bị hồ sơ (CCCD, giấy đăng ký kinh doanh...) và nộp trực tiếp tại cơ quan thuế quản lý.

Phân Tích Sâu Lỗi Xác Thực và Ký Điện Tử

Sự cố không nhận được OTP

Đây là lỗi xảy ra khi người dùng đã nhập thông tin đăng nhập nhưng không nhận được mã OTP qua SMS hoặc email để hoàn tất thao tác.

Kiểm tra phía người dùng trước tiên: Sóng di động/kết nối mạng, tình trạng SIM liệu có bị khóa hai chiều hoặc hết hạn sử dụng, cài đặt điện thoại liệu có đang bật chế độ chặn tin nhắn từ số lạ hoặc bộ lọc spam.
Xác minh thông tin đã đăng ký: Số điện thoại/email dùng để nhận OTP liệu có chính xác với đã đăng ký trên VNeID và trên hệ thống thuế.
Kiểm tra phía hệ thống: Hệ thống VNeID hoặc Thuế điện tử liệu có đang bị quá. Chờ vài phút và thử lại bằng cách nhấn nút "Gửi lại OTP".
Phương án cuối cùng: Liên hệ tổng đài hỗ trợ VNeID 1900 0368 hoặc cơ quan thuế địa phương để được trợ giúp.

Lỗi Chữ ký

Đây là bước cuối cùng và phức tạp nhất, nơi các giao dịch thường thất bại khi người dùng nhấn nút "Ký và gửi". Lỗi này thường xuất phát từ sự tương tác không thành công giữa máy tính người dùng, thiết bị USB Token và Cổng Thuế điện tử.

Kiểm tra vật lý: USB Token đã được cắm chắc chắn vào máy tính chưa? Đèn trên Token có sáng không? -> Thử cắm sang cổng USB khác.
Kiểm tra Driver Token: Phần mềm quản lý của USB Token (ví dụ: VNPT-CA Token Manager, Viettel-CA driver) đã được cài đặt và đang chạy chưa? -> Cài đặt lại driver từ trang web của nhà cung cấp CKS.
Kiểm tra Plugin Thuế: Plugin ký điện tử của Tổng cục Thuế (eSigner Java) đã được cài đặt và chạy chưa? -> Cài/cài lại eSigner từ trang thuedientu.gdt.gov.vn. Kiểm tra các vấn đề tương thích với Java.
Kiểm tra chứng thư số: Chứng thư số có hết hạn không? Có phải bạn vừa gia hạn và cần cập nhật số serial mới không? -> Đăng nhập bằng tài khoản -ql để cập nhật lại số serial.
Kiểm tra mã PIN: Bạn có nhập đúng mã PIN không? Có đang bật Caps Lock không? -> Nhập lại cẩn thận. Nếu bị khóa, liên hệ nhà cung cấp CKS.
Kiểm tra thông báo lỗi trên Cổng Thuế: Cổng thông tin có đưa ra thông báo lỗi cụ thể như "Chứng thư số chưa được đăng ký với cơ quan thuế" không? -> Lỗi này xác nhận có sự sai lệch về số serial và phải được khắc phục trong mục "Quản lý tài khoản" của Cổng Thuế.