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

<table><thead><tr><th width="60" align="center">STT</th><th width="134" valign="middle">          Mã lỗi</th><th width="190">                  Mô tả</th><th>                  Cách xử lý</th></tr></thead><tbody><tr><td align="center">1</td><td valign="middle">InvalidAppID</td><td>Sai thông tin AppID</td><td>Liên hệ MISA để nhận AppID</td></tr><tr><td align="center">2</td><td valign="middle">InActiveAppID</td><td>Ứng dụng ngừng theo dõi</td><td>Liên hệ MISA để nhận AppID</td></tr><tr><td align="center">3</td><td valign="middle">UnAuthorize</td><td>Sai thông tin</td><td>- Kiểm tra lại thông tin đăng nhập<br>- 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</td></tr><tr><td align="center">4</td><td valign="middle">TokenExpiredCode</td><td>Token hết hạn</td><td>Cần gọi hàm RefreshToken</td></tr><tr><td align="center">5</td><td valign="middle">InvalidTokenCode</td><td>Token lỗi cần đăng nhập lại</td><td>Đăng nhập lại để lấy token mới</td></tr><tr><td align="center">6</td><td valign="middle">DuplicateTemplateName</td><td>Lỗi trùng tên mẫu</td><td>Thay đổi tên mẫu hóa đơn</td></tr><tr><td align="center">7</td><td valign="middle">DuplicateTemplateNo</td><td>Lỗi trùng ký hiệu</td><td>Thay đổi ký hiệu mẫu hóa đơn</td></tr><tr><td align="center">8</td><td valign="middle">InvoiceTemplateNotExist</td><td>Mẫu hóa đơn không tồn tại</td><td>Tạo mẫu hóa đơn/ kiểm tra lại thông tin InvSeries</td></tr><tr><td align="center">9</td><td valign="middle">CreateInvoiceDataError</td><td>Tạo XML hóa đơn lỗi không xác định</td><td></td></tr><tr><td align="center">10</td><td valign="middle">InvoiceDetail_{0}</td><td>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ệ<br>- Không thuộc loại được cho phép<br>- Giá trị bắt buộc - không được trống<br>- Vượt quá giới hạn MaxLength cho phép</td><td>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</td></tr><tr><td align="center">11</td><td valign="middle">StockInTaxCode_NotInfo_{0}_{1}</td><td>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ó<br>0: Loại phiếu xuất kho<br>1: thông tin thiếu</td><td>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</td></tr><tr><td align="center">12</td><td valign="middle">RequireError_{0}</td><td>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ệ<br>- Không thuộc loại được cho phép<br>- Giá trị bắt buộc - không được trống<br>- Vượt quá giới hạn MaxLength cho phép</td><td>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</td></tr><tr><td align="center">13</td><td valign="middle">TaxRateInfo_VATRateName</td><td>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ệ</td><td>Bổ sung thêm thông tin tổng hợp thuế suất TaxRateInfo</td></tr><tr><td align="center">14</td><td valign="middle">InvoiceQuantityTooLarge</td><td>Số lượng hóa đơn gửi lên trong 1 Request quá số lượng cho phép</td><td>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</td></tr><tr><td align="center">15</td><td valign="middle">XMLTooLong</td><td>File XML quá dài</td><td>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 &#x3C;200 dòng hàng</td></tr><tr><td align="center">16</td><td valign="middle">LicenseInfo_NotBuy</td><td>Chưa mua tài nguyên</td><td>Liên hệ MISA để đăng ký/ mua dịch vụ</td></tr><tr><td align="center">17</td><td valign="middle">LicenseInfo_OutOfInvoice</td><td>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</td><td>Mua thêm tài nguyên phát hành hóa đơn</td></tr><tr><td align="center">18</td><td valign="middle">LicenseInfo_Expired</td><td>Tài nguyên chưa thanh toán hoặc đã hết hạn</td><td>Liên hệ kinh doanh MISA để thanh toán/cấp tài nguyên</td></tr><tr><td align="center">19</td><td valign="middle">InvalidTransactionID</td><td>Mã tra cứu không hợp lệ</td><td>Mã tra cứu được hệ thống MISA cung cấp, KH không tự ý thay đổi</td></tr><tr><td align="center">20</td><td valign="middle">DuplicateTransactionID</td><td>Trùng Mã tra cứu</td><td>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)</td></tr><tr><td align="center">21</td><td valign="middle">SignatureEmpty</td><td>Chữ ký số bị bỏ trống</td><td>Thực hiện ký số (thường gặp khi ký số qua tool)</td></tr><tr><td align="center">22</td><td valign="middle">InvalidSignature</td><td>Chữ ký số không hợp lệ</td><td>Kiểm tra lại chữ ký số với chữ ký số đăng ký trên tờ khai được chấp thuận</td></tr><tr><td align="center">23</td><td valign="middle">CertRevocation</td><td>Chữ ký số đã bị thu hồi</td><td>Lỗi về CKS, liên hệ các bên liên quan</td></tr><tr><td align="center">24</td><td valign="middle">InvalidCertByRegistration</td><td>Chữ ký số không tồn tại trong tờ khai</td><td>Tạo tờ khai hoặc ký số hóa đơn đúng với CKS đã đăng ký ở tờ khai</td></tr><tr><td align="center">25</td><td valign="middle">HasRegistrationStopUseCert</td><td>Tồn tại tờ khai Ngừng sử dụng chứng thư số</td><td>Tạo tờ khai hoặc ký số hóa đơn đúng với CKS đã đăng ký ở tờ khai</td></tr><tr><td align="center">26</td><td valign="middle">SigningTimeNotInRegistration</td><td>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</td><td>Tạo tờ khai hoặc ký số hóa đơn đúng với CKS đã đăng ký ở tờ khai</td></tr><tr><td align="center">27</td><td valign="middle">InvalidXMLData</td><td>XML không hợp lệ</td><td>Kiểm tra lại định dạng của XML</td></tr><tr><td align="center">28</td><td valign="middle">InvalidInvNo</td><td>Số hóa đơn không hợp lệ</td><td>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</td></tr><tr><td align="center">29</td><td valign="middle">InvalidTaxCode</td><td>Mã số thuế không hợp lệ</td><td>Kiểm tra, tra cứu MST đang sử dụng</td></tr><tr><td align="center">30</td><td valign="middle">DuplicateInvoiceRefID</td><td>Trùng RefID của hóa đơn</td><td>- 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, ...)</td></tr><tr><td align="center">31</td><td valign="middle">InvoiceNumberNotCotinuous</td><td>Số hóa đơn không liên tục</td><td>- PA chung là: gặp mã lỗi này thì retry gọi lại hàm phát hành<br>- có 2 TH mã lỗi này thường gặp:<br>- 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<br>=> Xử lý: Báo kỹ thuật xử lý mỗi khi phát hành xong 1 request thì sleep khoảng 3s<br>- TH2: có nhiều điểm máy trạm phát hành đồng thời<br>=> 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</td></tr><tr><td align="center">32</td><td valign="middle">SignSoftDream78Exception</td><td>Lỗi ký số HSM</td><td>Liên hệ MISA</td></tr><tr><td align="center">33</td><td valign="middle">SignEsignHSMError</td><td>Lỗi ký số HSM</td><td>Liên hệ MISA</td></tr><tr><td align="center">34</td><td valign="middle">InvoiceDuplicated</td><td>Trùng số hóa đơn - hóa đơn đã được phát hành</td><td>- Giả sử khi gọi api phát hành lỗi nó đang trả về số hóa đơn là 15<br>- PA chung là: gặp mã lỗi này thì retry gọi lại hàm phát hành<br>=> Xử lý: trường hợp retry vẫn bị thì liên hệ kỹ thuật MISA</td></tr><tr><td align="center">35</td><td valign="middle">Exception</td><td>Thực hiện bị Exception - Không rõ nguyên nhân</td><td>Liên hệ kỹ thuật MISA để tìm hiểu nguyên nhân</td></tr><tr><td align="center">36</td><td valign="middle">DeclarationNotExist</td><td>Chưa tồn tại Tờ khai/Thay đổi thông tin</td><td>Lập tờ khai và chờ CQT chấp nhận thì thực hiện phát hành hóa đơn</td></tr><tr><td align="center">37</td><td valign="middle">InvalidDeclaration</td><td>Chưa tồn tại Tờ khai/Thay đổi thông tin có trạng thái CQT chấp nhận</td><td>Lập tờ khai và chờ CQT chấp nhận thì thực hiện phát hành hóa đơn</td></tr><tr><td align="center">38</td><td valign="middle">ExistDeclarationNotReceive</td><td>Tồn tại tờ khai có trạng thái: Đã gửi CQT/ CQT Tiếp nhận</td><td>Chờ CQT chấp nhận tờ khai</td></tr><tr><td align="center">39</td><td valign="middle">ExistsInvoiceNextYear</td><td>Tồn tại hóa đơn của năm tiếp theo</td><td>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ã)</td></tr><tr><td align="center">40</td><td valign="middle">InvoiceTemplateNotValidInDeclaration</td><td>Tờ khai/Thay đổi thông tin không chứa loại hóa đơn đang phát hành</td><td>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ã)</td></tr><tr><td align="center">41</td><td valign="middle">InvalidInvoiceDate</td><td>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.</td><td>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.</td></tr><tr><td align="center">42</td><td valign="middle">InvoiceCannotReplace</td><td>Không thể thay thế hóa đơn đã hủy</td><td>Sai về nghiệp vụ, không có phương án xử lý</td></tr><tr><td align="center">43</td><td valign="middle">InvoiceCannotAdjust</td><td>Không thể điều chỉnh hóa đơn đã hủy/thay thế</td><td>Sai về nghiệp vụ, không có phương án xử lý</td></tr><tr><td align="center">44</td><td valign="middle">TaxReductionDateInValid</td><td>Ngày hóa đơn giảm thuế không hợp lệ</td><td>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</td></tr><tr><td align="center">45</td><td valign="middle">X509SubjectName</td><td>Không có SubjectName trên file XML đã ký</td><td>Lỗi về CKS, liên hệ các bên liên quan</td></tr><tr><td align="center">46</td><td valign="middle">X509Certificate</td><td>Không có chứng thư số</td><td>Lỗi về CKS, liên hệ các bên liên quan</td></tr><tr><td align="center">47</td><td valign="middle">InvoiceCannotReplaceByStatusNew</td><td>Hóa đơn gốc chưa được hủy, không thể thay thế</td><td>Cần hủy hóa đơn gốc trước khi phát hành/điều chỉnh hóa đơn</td></tr><tr><td align="center">48</td><td valign="middle">HasAdjustmentInvoice</td><td>Hóa đơn đã được lập hóa đơn điều chỉnh, không thể thay thế</td><td>Đã 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</td></tr><tr><td align="center">49</td><td valign="middle">BuyerFullName</td><td>Tên khách hàng quá 100 ký tự</td><td>Vào màn chi tiết đơn bán hàng sửa tên người mua</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://upbase.gitbook.io/ups/tinh-nang-san-pham/van-hanh/tai-chinh/cac-loi-thuong-gap/cac-loi-thuong-gap-khi-ket-noi-xuat-hoa-don-sang-meinvoice.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.