Why was my document rejected?

When LHDN rejects a document, envoice shows you why, in plain language, next to LHDN's own wording. This article shows where to look and what to do next.

Rejected or Failed?

Two statuses look similar but mean different things:

  • Rejected: LHDN received the document and refused it because something in it broke a validation rule. Retrying the same document will fail again. You need to fix it.
  • Failed: the document did not get through, usually because of a network or LHDN outage. envoice retries it automatically. See Submission failed or stuck in Submitting.

The shop owner gets one email when a document is rejected or fails, so problems are not discovered weeks later. Shops still on the internal test mock do not get these emails.

Where to find the reason

  1. Open Documents and click the rejected document. The dashboard also lists documents LHDN rejected in the last 30 days.
  2. Look for the red Rejection reason box.
  3. Each line in the box tells you:
    • Which field is wrong, for example "Buyer TIN" or "Line item 2 classification code".
    • What went wrong, in plain language.
    • How to fix it, where envoice knows the fix.
    • LHDN's own sentence, in smaller text, and a Read LHDN's guidance link to LHDN's page for that error code.

If the box says "No details available", LHDN has not sent its validation results yet. Click Refresh LHDN status to fetch them.

Fix it and file again

A rejected document was never validated, so you do not cancel it. You file a corrected one.

  1. On the rejected document, click Fix & resubmit.
  2. The new invoice form opens, prefilled from the rejected document.
  3. Correct the field named in the rejection reason.
  4. Submit. It files as a brand-new e-invoice with its own number.

Documents that came from Zoho Books are fixed in Zoho and resubmitted from the Zoho widget, so they do not show Fix & resubmit in envoice.

Still stuck? Send it to support

Under the rejection reason, add a short note on what you tried and click Send to support. envoice sends the full LHDN response with it, so you do not need to copy anything. We reply to your email address. You can send the same document again after ten minutes.

Common rejection families

Source

Related articles