Connect NIC E-invoice Portal to Apragya: IRN, Signed QR and E-way Bills From the Invoice
For finance heads and tax teams who generate e-invoices every day: get the IRN, signed QR and e-way bill from the invoice itself, without uploading JSON files by hand.
To connect NIC e-invoice portal to Apragya, you register for API access on the e-invoice portal, add the API username, password, client ID and client secret against your GSTIN, and test the connection. Invoices then get their IRN and signed QR straight from NIC.
Many Indian businesses still export a JSON file, upload it on the portal, download the result and attach it to the invoice. Each step is a place for a mismatch.
This page covers the credentials, sandbox testing, an illustrative example and what to check before going live.
What manual e-invoice uploads cost
Queues at dispatch
Trucks wait while someone uploads, downloads and prints.
Mismatched details
The portal copy and the books drift when either is edited.
Unclear rejections
Portal errors are cryptic, so fixes take several attempts.
Cancellations missed
An IRN cancelled on the portal stays live in the books.
An example: an Ahmedabad chemicals trader
Take an illustrative trader raising about forty B2B invoices a day, most of them interstate with an e-way bill. The accounts clerk spent the first hour of every day on portal uploads.
One interstate invoice, reported from the record
Tax invoice
NIC issues its token for this GSTIN.
Checked before the request is sent.
No retyping at invoice time.
Stored on the invoice record.
Decoded and shown on the invoice copy.
Vehicle details added before dispatch.
After the switch, the clerk's morning upload disappeared. Rejections came back as plain messages on the invoice, so a wrong pincode was fixed in minutes rather than after three portal attempts.
How the e-invoice API integration works
Step 1 of 5
Register for API access
On the e-invoice portal, under API registration, per NIC's current eligibility rules.
- Register for API access: On the e-invoice portal, under API registration, per NIC's current eligibility rules.
- Add credentials: API username, API password, client ID and client secret, with the GSTIN.
- Add e-way bill access: E-way bill API access is a separate registration, added if you need it.
- Test in sandbox: Sandbox is a setting with its own credentials, using the same code.
- Go live: Switch to production credentials and generate the first IRN.
Choosing an e-way bill API integration and e-invoice link
A connection that talks to NIC directly removes the upload step, but only if it handles NIC's token rules and explains its errors. That is where most home-grown scripts fail.
Portal uploads, against Apragya
| Feature | Manual portal upload | Apragya NIC connection |
|---|---|---|
| Credentials | Portal login shared | API credentials, encrypted |
| Tokens | Not applicable | Cached per GSTIN |
| Errors | Portal codes | Translated on the invoice |
| Cancellation | On the portal only | Cancel IRN and e-way bill from the record |
| Sandbox | Separate habit | A setting on the connection |
Checked against public information on 16 September 2026.
What sets the NIC IRP API registration flow apart
Checks before sending
GSTIN, place of supply and HSN are checked first.
Several GSTINs
One connection per GSTIN, each with its own token.
Signed QR on the copy
The signed invoice is decoded and the QR printed.
GSTIN lookup
Party GSTIN details can be fetched through the same link.
Audit log
Who changed the connection, and when, is recorded.
Agents on exceptions
An agent can summarise rejections for review.
The invoice side is covered in e-invoicing and GSTR-1; for the rules themselves, see the e-invoicing guide.
Getting started
- Check on the e-invoice portal whether your GSTIN can register for direct API access.
- Register and note the API username, password, client ID and client secret.
- Add them in Apragya against the GSTIN and test in sandbox.
- Generate a sandbox IRN and e-way bill for a sample invoice.
- Switch to production credentials and run both methods side by side for a few days.
Keep the portal login for manual fallbacks; it is not the API password.
What it costs to start
Connecting the NIC e-invoice portal, answered
Is the API password the same as our portal login?
Do we need a GSP?
We have several GSTINs. How does that work?
Can we cancel an IRN from Apragya?
What does it cost to start?
Generate your first IRN from the invoice
Add your NIC API credentials, test in sandbox, and report one invoice end to end.