Lỗi 20001 "Sai định dạng dữ liệu" là lý do từ chối cấp mã gặp nhiều nhất, vì chỉ cần một ô trên hóa đơn vượt độ dài, sai định dạng hay bị bỏ trống là cả hóa đơn bị trả về. Điểm mấu chốt là đọc phần đuôi của thông báo: nó chỉ ra đúng trường dữ liệu cần sửa.
Thông báo 20001 có dạng "Sai định dạng dữ liệu" kèm tên trường và lý do, ví dụ "nmdctdtu: định dạng không hợp lệ" là thư điện tử người mua sai định dạng hoặc dài quá 50 ký tự. Sửa đúng trường đó, tốt nhất là sửa luôn trong danh mục khách hàng, rồi lập và gửi cấp mã lại. Nếu không đọc được tên trường, nhờ nhà cung cấp phần mềm trích thẻ XML của hóa đơn như hướng dẫn của cơ quan thuế.
Đọc thông báo lỗi 20001
Hóa đơn chỉ được cấp mã khi đủ nội dung theo Điều 10 và đúng định dạng dữ liệu theo quy định của Bộ Tài chính (điểm a khoản 2 Điều 12 Nghị định 254/2026/NĐ-CP). Khi một trường không đạt, cơ quan thuế trả mã 20001 với cấu trúc:
- Đường dẫn trường: ví dụ HDon/DLHDon/NDHDon/NMua/MST, nghĩa là trường mã số thuế trong phần người mua (NMua) của nội dung hóa đơn. Một số phần mềm hiển thị gọn như nmmst, nmdctdtu.
- Lý do sau dấu hai chấm: "định dạng không hợp lệ", "độ dài phải nằm giữa 0 và 100", "không được bỏ trống khi…".
Thuế tỉnh Bình Thuận từng trả lời một doanh nghiệp gặp lỗi "20001- sai định dạng dữ liệu nmdctdtu: định dạng không hợp lệ": liên hệ nhà cung cấp và tổ chức truyền nhận để lấy thẻ XML của hóa đơn, kiểm tra địa chỉ thư điện tử có vượt quá 50 ký tự hoặc sai cấu trúc hay không. Các ví dụ khác dưới đây được nhà cung cấp hóa đơn ghi nhận từ phản hồi thực tế; câu chữ có thể thay đổi theo hệ thống.
Các trường hay bị báo sai
| Trường trong thông báo | Ý nghĩa | Cách sửa |
|---|---|---|
| nmdctdtu / DCTDTu – định dạng không hợp lệ | Thư điện tử người mua | Một địa chỉ đúng dạng ten@tenmien, không quá 50 ký tự, không dấu cách thừa |
| NMua/MST, nmmst – định dạng không hợp lệ | Mã số thuế người mua | Nhập 10 số, hoặc dạng 10 số, gạch nối, 3 số với đơn vị phụ thuộc; không khoảng trắng |
| NMua/DChi – Địa chỉ người mua không được bỏ trống khi có mã số thuế người mua | Đã nhập mã số thuế nhưng thiếu địa chỉ | Nhập địa chỉ theo giấy chứng nhận đăng ký của người mua |
| Tên người mua không được bỏ trống khi có mã số thuế | Đã nhập mã số thuế nhưng thiếu tên đơn vị | Nhập tên đơn vị mua; khách lẻ không có mã số thuế thì để trống ô mã số thuế |
| NMua/HVTNMHang – độ dài phải nằm giữa 0 và 100 | Họ tên người mua hàng quá dài | Rút gọn, không dán cả địa chỉ, ghi chú vào ô họ tên |
| Số điện thoại người bán, số tài khoản ngân hàng người mua – độ dài vượt giới hạn | Trường vượt độ dài cho phép (ghi nhận: điện thoại tối đa 20 ký tự, số tài khoản tối đa 30 ký tự) | Nhập một số điện thoại, một số tài khoản, bỏ ký tự thừa |
| Thuế suất bỏ trống; tổng tiền chưa thuế, tổng tiền thuế không có giá trị | Thiếu chỉ tiêu bắt buộc trên hóa đơn giá trị gia tăng | Chọn thuế suất cho từng dòng hàng; khai đủ tổng tiền, kể cả giá trị 0 khi phù hợp |
| Phương tiện vận chuyển không được để trống | Phiếu xuất kho kiêm vận chuyển nội bộ thiếu thông tin vận chuyển | Khai đủ phương tiện vận chuyển trên phiếu |
Tên, địa chỉ người mua quá dài có thể viết tắt một số danh từ thông dụng như "P", "TP", "VN", "CP", "TNHH", "KCN", "CN" theo Phụ lục Nghị định 254/2026/NĐ-CP, nhưng vẫn phải đủ số nhà, đường, phường xã, tỉnh thành và khớp với đăng ký của người mua.
Cách xử lý từng bước
Chép nguyên văn thông báo
Lưu đường dẫn trường và lý do; không đoán theo tên mã 20001 vì mã này dùng chung cho mọi lỗi định dạng.
Sửa tại nguồn dữ liệu
Sửa trong danh mục khách hàng, hàng hóa hoặc phần mềm bán hàng tích hợp, để các hóa đơn sau không lặp lại lỗi. Kiểm tra mã số thuế người mua trên trang tra cứu thông tin người nộp thuế của Cục Thuế.
Lập và gửi cấp mã lại
Hóa đơn bị từ chối chưa phải hóa đơn có mã, nên không gửi Mẫu 04/SS-HĐĐT; lập, ký và gửi cấp mã lại theo hướng dẫn của phần mềm. Không giao bản chưa có mã cho người mua.
Nhờ trích XML nếu chưa rõ
Nếu thông báo chỉ có đường dẫn trường khó hiểu, đề nghị nhà cung cấp phần mềm, tổ chức truyền nhận trích thẻ XML của hóa đơn để xác định chính xác giá trị bị lỗi.
Kiểm tra đã hết lỗi
- Hóa đơn gửi lại có trạng thái đã cấp mã.
- Tra cứu trên hoadondientu.gdt.gov.vn cho kết quả tồn tại hóa đơn trùng khớp.
- Danh mục khách hàng đã sửa; hóa đơn tiếp theo cho cùng người mua không báo lỗi.
Nếu mã đổi sang 20023 hoặc 20022, lỗi nằm ở loại, hình thức hóa đơn: xem lỗi 20023. Nếu báo chữ ký chưa được đăng ký, xem lỗi 20019. Hóa đơn đã được cấp mã mà sau đó mới phát hiện sai thì làm theo hướng dẫn xử lý hóa đơn lập sai.
Thông tin cần gửi khi nhờ hỗ trợ
- Ảnh hoặc bản chép nguyên văn thông báo 20001, gồm đường dẫn trường và lý do.
- Ký hiệu, số hóa đơn, thời điểm gửi và mã giao dịch nếu có.
- Giá trị bạn đã nhập vào trường bị báo lỗi (che bớt dữ liệu cá nhân của người mua).
- Không gửi mật khẩu tài khoản hóa đơn, mã PIN hay OTP.
Câu hỏi thường gặp
Lỗi 20001 có phải do hệ thống của cơ quan thuế không?
Thường không. Mã 20001 báo một trường dữ liệu trên hóa đơn không đúng định dạng chuẩn; sửa đúng trường được nêu rồi gửi lại. Lỗi do hệ thống thường có mã -1 kèm mô tả kỹ thuật.
Email người mua dài hơn 50 ký tự thì làm sao?
Theo hướng dẫn của Thuế Bình Thuận, kiểm tra độ dài địa chỉ thư điện tử không vượt quá 50 ký tự và đúng cấu trúc. Hãy dùng một địa chỉ ngắn hơn, không ghi nhiều địa chỉ trong cùng một ô.
Khách lẻ không có mã số thuế thì nhập thế nào?
Để trống ô mã số thuế. Theo Phụ lục Nghị định 254/2026/NĐ-CP, người tiêu dùng cung cấp tên, địa chỉ, số định danh thì ghi đủ; không cung cấp thì hóa đơn thể hiện rõ "Bán cho người tiêu dùng".
Có phải gửi Mẫu 04/SS-HĐĐT cho hóa đơn bị lỗi 20001 không?
Không. Mẫu 04/SS-HĐĐT dùng cho hóa đơn đã được cấp mã hoặc đã gửi dữ liệu mà lập sai; hóa đơn bị từ chối cấp mã chỉ cần sửa và gửi lại.
Gặp lỗi 20001 trên S-Invoice?
Gửi nguyên văn thông báo lỗi cho đầu mối hỗ trợ S-Invoice để được chỉ đúng ô cần sửa trên phần mềm. Không gửi mật khẩu hay mã PIN.
Nguồn đối chiếu: Hỏi đáp của Thuế Bình Thuận về lỗi 20001; Nghị định 254/2026/NĐ-CP, Điều 10, 12 và Phụ lục; Tra cứu thông tin người nộp thuế – Cục Thuế. 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.
