e-Invoice & e-Way Bill connection

Advanced · 9 min · GST & tax

This screen connects Stockivio to a GSP / NIC API account so you can generate and cancel e-invoice IRNs and e-way bills straight from your sales invoices.

Open this screen in Stockivio →

e-Invoice & e-Way Bill connection

Screen layout sketch — the screenshot will appear here once it is added.

Why and when you use it

If your turnover is above the government threshold for e-invoicing, each B2B invoice needs an IRN (invoice reference number) from the government system. Doing it on a portal by hand for every invoice is slow. Once an administrator connects a GSP (GST Suvidha Provider, an approved API provider) or NIC API account here, the accountant can generate IRNs and e-way bills from each invoice row. Whether e-invoicing applies to you depends on your turnover; check with your CA.

Before you start

An administrator login; the screen is visible to admins only when live e-invoicing is switched on for your account
An API account with a GSP or NIC, and its API username, password, client ID and client secret
Your GSTIN, and customers with correct GSTINs

Step by step

Get API accessGet an API account from a GSP or from NIC for your GSTIN. They give you an API username and password and a client ID and secret.
Open the connection screenAs an administrator, open 🧾 e-Invoice & e-Way Bill connection under 🏢 Stockivio ERP.
Enter the detailsFill in your GSTIN, API username and password, and client ID and secret exactly as given, then press Save settings.
Test the connectionPress Test connection. Fix any detail it rejects. Until connected, the invoice IRN panel says e-Invoice (IRN): not connected yet.
Generate an IRNIn Sales Invoices, press the IRN button on an invoice row and choose Generate IRN. Use Refresh status if the reply is slow.
Cancel an IRN if neededUse Cancel IRN only within 24 hours of generation. After that, issue a credit note instead.
Work with e-way billsFrom the same IRN panel use Generate e-Way Bill, Cancel e-Way Bill, or Update vehicle (Part-B) when the truck changes.

Worked example

Patel Engineering Works' CA has told them that e-invoicing applies to them. On 12 Nov 2026 they invoice a Pune customer ₹2,36,000 for machine parts going by truck GJ03AB4521.

The administrator saves the GSP details and presses Test connection: connected.
The accountant saves the invoice in Sales Invoices and presses IRN, then Generate IRN.
The IRN comes back; the accountant prints the invoice.
From the IRN panel, press Generate e-Way Bill for the ₹2,36,000 consignment.
On the way, the truck breaks down and goods move to GJ03CD7788; the accountant uses Update vehicle (Part-B).

Result: The invoice carries a valid IRN and an e-way bill without anyone logging in to a government portal, and the vehicle change is recorded on the e-way bill.

💡 Tips

Only administrators should hold the API credentials; do not share them in chat or email.
Generate the IRN before printing and sending the invoice.
If you do not have API access, use the 🚛 e-Way Bills desk to prepare e-way bill JSON for the portal instead.

⚠️ Common mistakes

Trying to cancel an IRN after 24 hours. The system will not allow it; issue a credit note.
Saving invoices with wrong customer GSTINs. The IRN request will fail. Fix the customer first.
Leaving test credentials in place. Confirm with Test connection that the live account is saved.

Questions

Do I need this screen?

Only if you want IRN and e-way bills generated from Stockivio through an API. Whether e-invoicing applies to you depends on turnover; check with your CA.

Who sets it up?

An administrator, once, with the GSP or NIC API account details.

🎬 Video walkthrough (script — recording coming soon)

Scene 1: Admin opens e-Invoice & e-Way Bill connection.
Scene 2: Fields filled with masked sample values, Save settings.
Scene 3: Test connection shows success.
Scene 4: Sales Invoices row, IRN button, Generate IRN.
Scene 5: Generate e-Way Bill from the same panel.
Scene 6: Update vehicle (Part-B).
Scene 7: Note: Cancel IRN only within 24 hours.