Các lỗi thường gặp khi kết nối/xuất hoá đơn sang MeInvoice

Nhà bán hàng có thể dễ dàng tra cứu nguyên nhân và chủ động xử lý các lỗi thường gặp khi kết nối/xuất hoá đơn sang phần mềm MeInvoice.

STT
Mã lỗi
Mô tả
Cách xử lý

1

InvalidAppID

Sai thông tin AppID

Liên hệ MISA để nhận AppID

2

InActiveAppID

Ứng dụng ngừng theo dõi

Liên hệ MISA để nhận AppID

3

UnAuthorize

Sai thông tin

- Kiểm tra lại thông tin đăng nhập - Nếu thông tin đăng nhập đúng hết --> APPID (token) hết hạn --> Đăng nhập lại để lấy token mới

4

TokenExpiredCode

Token hết hạn

Cần gọi hàm RefreshToken

5

InvalidTokenCode

Token lỗi cần đăng nhập lại

Đăng nhập lại để lấy token mới

6

DuplicateTemplateName

Lỗi trùng tên mẫu

Thay đổi tên mẫu hóa đơn

7

DuplicateTemplateNo

Lỗi trùng ký hiệu

Thay đổi ký hiệu mẫu hóa đơn

8

InvoiceTemplateNotExist

Mẫu hóa đơn không tồn tại

Tạo mẫu hóa đơn/ kiểm tra lại thông tin InvSeries

9

CreateInvoiceDataError

Tạo XML hóa đơn lỗi không xác định

10

InvoiceDetail_{0}

Nếu mã lỗi bắt đầu bằng InvoiceDetail_{0} thì thông tin có tên trường dữ liệu phía sau không hợp lệ - Không thuộc loại được cho phép - Giá trị bắt buộc - không được trống - Vượt quá giới hạn MaxLength cho phép

Lỗi thông tin nào kiểm tra thông tin đó, kiểm tra về kiểu dữ liệu, số lượng ký tự, tính đúng đắn của dữ liệu

11

StockInTaxCode_NotInfo_{0}_{1}

Nếu mã lỗi bắt đầu bằng StockInTaxCode_NotInfo_{0}_{1} thì thông tin MST có nhưng thông tin đơn vị không có 0: Loại phiếu xuất kho 1: thông tin thiếu

Lỗi thông tin nào kiểm tra thông tin đó, kiểm tra về kiểu dữ liệu, số lượng ký tự, tính đúng đắn của dữ liệu

12

RequireError_{0}

Nếu bắt đầu bằng RequireError_{0} thì thông tin có tên trường dữ liệu phía sau không hợp lệ - Không thuộc loại được cho phép - Giá trị bắt buộc - không được trống - Vượt quá giới hạn MaxLength cho phép

Lỗi thông tin nào kiểm tra thông tin đó, kiểm tra về kiểu dữ liệu, số lượng ký tự, tính đúng đắn của dữ liệu

13

TaxRateInfo_VATRateName

Tên loại thuế suất trong Bảng tổng hợp thuế suất của hóa đơn có dữ liệu không hợp lệ

Bổ sung thêm thông tin tổng hợp thuế suất TaxRateInfo

14

InvoiceQuantityTooLarge

Số lượng hóa đơn gửi lên trong 1 Request quá số lượng cho phép

Nếu dữ liệu của 1 hóa đơn lớn, nên gửi tối đa 30 hóa đơn/request

15

XMLTooLong

File XML quá dài

Nếu số lượng dòng hàng quá lớn, nên tách thành nhiều hóa đơn, mỗi hóa đơn <200 dòng hàng

16

LicenseInfo_NotBuy

Chưa mua tài nguyên

Liên hệ MISA để đăng ký/ mua dịch vụ

17

LicenseInfo_OutOfInvoice

Số lượng tài nguyên còn lại không đủ để phát hành toàn bộ các hóa đơn gửi lên

Mua thêm tài nguyên phát hành hóa đơn

18

LicenseInfo_Expired

Tài nguyên chưa thanh toán hoặc đã hết hạn

Liên hệ kinh doanh MISA để thanh toán/cấp tài nguyên

19

InvalidTransactionID

Mã tra cứu không hợp lệ

Mã tra cứu được hệ thống MISA cung cấp, KH không tự ý thay đổi

20

DuplicateTransactionID

Trùng Mã tra cứu

Thực hiện lại bước tạo hóa đơn để lấy mã tra cứu mới (thường gặp khi ký số qua tool)

21

SignatureEmpty

Chữ ký số bị bỏ trống

Thực hiện ký số (thường gặp khi ký số qua tool)

22

InvalidSignature

Chữ ký số không hợp lệ

Kiểm tra lại chữ ký số với chữ ký số đăng ký trên tờ khai được chấp thuận

23

CertRevocation

Chữ ký số đã bị thu hồi

Lỗi về CKS, liên hệ các bên liên quan

24

InvalidCertByRegistration

Chữ ký số không tồn tại trong tờ khai

Tạo tờ khai hoặc ký số hóa đơn đúng với CKS đã đăng ký ở tờ khai

25

HasRegistrationStopUseCert

Tồn tại tờ khai Ngừng sử dụng chứng thư số

Tạo tờ khai hoặc ký số hóa đơn đúng với CKS đã đăng ký ở tờ khai

26

SigningTimeNotInRegistration

Ngày ký không thuộc khoảng thời gian có hiệu lực của chứng thư số đã đăng ký với cơ quan thuế và được CQT chấp nhận

Tạo tờ khai hoặc ký số hóa đơn đúng với CKS đã đăng ký ở tờ khai

27

InvalidXMLData

XML không hợp lệ

Kiểm tra lại định dạng của XML

28

InvalidInvNo

Số hóa đơn không hợp lệ

Số hóa đơn thường có 8 ký tự, do hệ thống cấp tự động, người dùng k can thiệp vào dữ liệu của những field liên quan đến số hóa đơn

29

InvalidTaxCode

Mã số thuế không hợp lệ

Kiểm tra, tra cứu MST đang sử dụng

30

DuplicateInvoiceRefID

Trùng RefID của hóa đơn

- gọi đầu API lấy trạng thái hóa đơn theo RefID => cập nhật lại trạng thái xuống client (số hóa đơn, mã tra cứu, mã CQT cấp, ...)

31

InvoiceNumberNotCotinuous

Số hóa đơn không liên tục

- PA chung là: gặp mã lỗi này thì retry gọi lại hàm phát hành - có 2 TH mã lỗi này thường gặp: - TH1: kỹ thuật đơn vị dùng vòng lặp for phát hành hàng loạt bắn request liên tục => Xử lý: Báo kỹ thuật xử lý mỗi khi phát hành xong 1 request thì sleep khoảng 3s - TH2: có nhiều điểm máy trạm phát hành đồng thời => Xử lý: Tư vấn đơn vị mỗi 1 điểm máy trạm phát hành sẽ theo 1 ký hiệu khác nhau

32

SignSoftDream78Exception

Lỗi ký số HSM

Liên hệ MISA

33

SignEsignHSMError

Lỗi ký số HSM

Liên hệ MISA

34

InvoiceDuplicated

Trùng số hóa đơn - hóa đơn đã được phát hành

- Giả sử khi gọi api phát hành lỗi nó đang trả về số hóa đơn là 15 - PA chung là: gặp mã lỗi này thì retry gọi lại hàm phát hành => Xử lý: trường hợp retry vẫn bị thì liên hệ kỹ thuật MISA

35

Exception

Thực hiện bị Exception - Không rõ nguyên nhân

Liên hệ kỹ thuật MISA để tìm hiểu nguyên nhân

36

DeclarationNotExist

Chưa tồn tại Tờ khai/Thay đổi thông tin

Lập tờ khai và chờ CQT chấp nhận thì thực hiện phát hành hóa đơn

37

InvalidDeclaration

Chưa tồn tại Tờ khai/Thay đổi thông tin có trạng thái CQT chấp nhận

Lập tờ khai và chờ CQT chấp nhận thì thực hiện phát hành hóa đơn

38

ExistDeclarationNotReceive

Tồn tại tờ khai có trạng thái: Đã gửi CQT/ CQT Tiếp nhận

Chờ CQT chấp nhận tờ khai

39

ExistsInvoiceNextYear

Tồn tại hóa đơn của năm tiếp theo

Lập hóa đơn/ gửi tờ khai mới với loại hóa đơn sử dụng (thường liên quan đến hóa đơn có mã/không mã)

40

InvoiceTemplateNotValidInDeclaration

Tờ khai/Thay đổi thông tin không chứa loại hóa đơn đang phát hành

Lập hóa đơn/ gửi tờ khai mới với loại hóa đơn sử dụng (thường liên quan đến hóa đơn có mã/không mã)

41

InvalidInvoiceDate

Ngày hóa đơn phải đáp ứng không được nhỏ hơn ngày của số hóa đơn lớn nhất theo ký hiệu đang sử dụng.

Ngày hóa đơn phải đáp ứng không được nhỏ hơn ngày của số hóa đơn lớn nhất theo ký hiệu đang sử dụng.

42

InvoiceCannotReplace

Không thể thay thế hóa đơn đã hủy

Sai về nghiệp vụ, không có phương án xử lý

43

InvoiceCannotAdjust

Không thể điều chỉnh hóa đơn đã hủy/thay thế

Sai về nghiệp vụ, không có phương án xử lý

44

TaxReductionDateInValid

Ngày hóa đơn giảm thuế không hợp lệ

Ngày phát hành hóa đơn giảm thuế không nằm trong thời gian giảm thuế theo Quyết định

45

X509SubjectName

Không có SubjectName trên file XML đã ký

Lỗi về CKS, liên hệ các bên liên quan

46

X509Certificate

Không có chứng thư số

Lỗi về CKS, liên hệ các bên liên quan

47

InvoiceCannotReplaceByStatusNew

Hóa đơn gốc chưa được hủy, không thể thay thế

Cần hủy hóa đơn gốc trước khi phát hành/điều chỉnh hóa đơn

48

HasAdjustmentInvoice

Hóa đơn đã được lập hóa đơn điều chỉnh, không thể thay thế

Đã tồn tại hóa đơn điều chỉnh/thay thế, không thể thực hiện các nghiệp vụ điều chỉnh/thay thế nữa

49

BuyerFullName

Tên khách hàng quá 100 ký tự

Vào màn chi tiết đơn bán hàng sửa tên người mua

Last updated