Skip to main content
Apragya AIFree quotation builderQuotation builderQuote builderno signup
GST troubleshooting

Fix E-Invoice IRN Rejection: What Each Error Means and How to Get the IRN Generated

For billing clerks and accountants whose invoices come back from the portal without an IRN: what each error means, how to fix it, and how to catch it before you submit.

A billing lead checking an invoice sheet while a delivery man waits

To fix e-invoice IRN rejection, read the error code first. The portal's messages are brief, and a rejection for a rounding difference looks just as alarming as one for a cancelled GSTIN. The fix for each is very different.

Most rejections come from a few causes that can be checked before submission. Businesses that check nothing in advance meet them at dispatch time, with a truck waiting and a customer asking for the invoice.

This page explains the common errors, gives an illustrative example from Hyderabad, and shows how Apragya checks the invoice before it reaches the portal.

Why the IRN is refused, and the fix

An IRN rejection means the Invoice Registration Portal checked your invoice and refused it. The invoice is not a valid e-invoice until an IRN is generated, so it should not go out with the goods.

The most common causes are: a document number that already has an IRN; a buyer GSTIN that is not active; a place of supply that does not match the buyer's state; line values and tax that do not add up to the total; an invalid HSN code; and a supplier GSTIN not enabled for e-invoicing. Authentication failures also look like rejections.

Read the error code, fix the cause on the invoice, and submit again. Do not change the invoice number to get past a duplicate error.

  1. Read the portal's error code and message, not just 'failed'.
  2. For a duplicate error, fetch the existing IRN for that document number instead of generating again.
  3. Check the buyer GSTIN is active, and that its first two digits match the place of supply.
  4. Recompute taxable value and tax line by line, and fix rounding on the total.
  5. Check HSN codes, the document number format and the invoice date.
  6. Check your own GSTIN is enabled for e-invoicing and your API credentials are valid.
  7. Submit again, and print the IRN and QR code on the invoice.

IRN generation error: what you see and what it means

What it means

  • That document number already has an IRN; fetch it rather than regenerate.
  • The buyer's GSTIN is cancelled or wrong; check it on the GST portal.
  • For a registered buyer, the GSTIN's state decides the place of supply.
  • Line values, tax and rounding do not add up exactly.
  • Credentials, token or IP whitelisting need attention, not the invoice.

An example: a Hyderabad pharma distributor

Take an illustrative distributor raising 250 invoices a day. On a Monday, 14 invoices were refused. The billing lead went through each check before resubmitting.

The Monday rejections, checked one by one

  • Duplicate document numberTwo retries of invoices that already had IRNs.Checked
  • Buyer GSTIN activeOne chemist's GSTIN had been cancelled.Mismatch
  • Place of supplyFive bills used a ship-to state.Mismatch
  • Totals add upSix bills had a paisa rounding gap.Mismatch
  • HSN codesAll codes valid.Checked
  • API credentialsToken fine; no login issue.Ready
Rounding and place of supply explained most of the day's rejections.

The two retries simply needed their existing IRNs fetched. Six invoices were rebuilt from their lines, five had the place of supply corrected from the buyer's GSTIN, and the cancelled-GSTIN chemist was billed after the sales team confirmed new details. All went out the same afternoon.

Invoice sheets on a string line, most stamped with green seals
With totals rebuilt and states corrected, all fourteen invoices went out the same afternoon.

How Apragya reduces e-invoice error codes before submission

Step 1 of 5

Totals rebuilt from lines

The payload is computed from the lines, and a gap is flagged before sending.

  1. Totals rebuilt from lines: The payload is computed from the lines, and a gap is flagged before sending.
  2. Place of supply from GSTIN: A registered buyer's GSTIN decides the state, not the address.
  3. GSTIN lookup: Buyer GSTIN details can be fetched from the portal.
  4. Errors in plain words: Common portal codes are translated into what to fix.
  5. IRN and QR on the invoice: The IRN, acknowledgement and signed QR are saved on the record.

Handling IRN rejections: by hand or before submission

Fixing rejections one by one at the portal works on a quiet day. Checking the same rules before submission means most invoices go through the first time.

Portal-only e-invoicing, against Apragya

FeatureUpload and retryApragya
TotalsCopied from the invoice headerRecomputed from lines, checked first
Place of supplyTaken from the addressTaken from the buyer's GSTIN
Error messagesCodes to look upPlain explanation of the fix
Portal refusalSometimes taken as successTreated as a failure
CancellationMissed windowRefused after 24 hours, with a credit note prompt

Checked against public information on 16 September 2026.

What keeps IRN generation smooth

One record

Customer GSTIN and address come from the shared customer master.

E-way bill too

An e-way bill can be generated from the IRN.

Credentials kept safe

Portal credentials are stored encrypted.

Access by role

Who can generate and cancel IRNs can be set by role.

Audit log

Generation and cancellation are logged.

Multi-company

Each company keeps its own invoices and GSTIN.

Read the e-invoicing under GST guide and the IRN cancellation guide, and see e-invoicing in Apragya.

Getting started

  1. List last month's rejections by error code.
  2. Fix customer GSTINs and states in the master.
  3. Set up the portal credentials and whitelist the IP.
  4. Generate IRNs from the invoice record.
  5. Review any rejection the same day.

Once masters are clean, most rejections disappear.

What it costs to start

Free
Up to 3 users
CRM, HR and Vendor Onboarding
INR 3,999
Starter, a month
Up to 10 users, CRM and HR plus a choice of apps
INR 7,999
Pro, a month
Up to 25 users and every enterprise app

E-invoice IRN rejection, answered

Can I change the invoice number to get past a duplicate error?
No. The error means the number already has an IRN. Fetch that IRN, or cancel and reissue only if the rules allow it for your case.
How long can an IRN be cancelled?
Only within 24 hours of generation. After that, issue a credit note.
Is there a time limit to report an invoice?
Larger taxpayers face a limit on reporting older invoices. Check the current threshold and number of days on the e-invoice portal.
Why does a rounding difference cause a rejection?
The portal recomputes every line and expects the totals to match exactly.
What does it cost to start?
The free plan covers up to 3 users with CRM, HR and Vendor Onboarding and 1,000 AI Credits a month. Starter is INR 3,999 a month for up to 10 users, with CRM and HR plus a choice of apps such as Sales and POS, Inventory, Payroll, Purchase and Payables, Support and Manufacturing. Pro is INR 7,999 a month for up to 25 users with every enterprise app, including Finance and Accounting, plus 5,000 AI Credits, single sign-on and audit logs.

Get IRNs generated the first time

Check your invoices against the common rejection causes before they reach the portal.