Home › iDempiere E-Invoice Plugin
iDempiere 13 · India GST · Whitebooks APIIndia GST e-invoicing, built into iDempiere
An installable plugin that sends completed sales invoices, credit memos and debit notes from iDempiere to the Indian e-invoice system (IRP), then stores the IRN, signed invoice and QR code on the document. Validation, cancellation and recovery are handled, so your team does not have to key invoices into a portal.
Request a quote or demoSee what it doesFrom completed invoice to IRN
Complete the invoice
Fill the few e-invoice fields that apply: supply type, reverse charge, export or e-way details.
Run the process
"Generate E-Invoice (IRN)" for one invoice, or a date range for many.
Map & validate
The invoice becomes the IRP request and is checked field by field, with readable errors.
Register with IRP
Authenticates, calls GENERATE through Whitebooks and handles token expiry.
Stored on the invoice
IRN, acknowledgement, signed invoice, QR and e-way bill details are saved.
What you get
Generate IRN
Sales invoices, credit memos and debit notes. B2B, SEZ, export and deemed export supply types, reverse charge and IGST on intra-state supply.
Batch registration
Register every completed sales invoice in a date range that has no IRN yet. Each invoice succeeds or fails on its own, with a log line per invoice.
Cancel IRN
Cancel the IRN of a reversed invoice within the IRP's 24-hour window, with cancel reason and remarks.
Duplicate recovery
If the IRP says the IRN already exists, the plugin fetches it and verifies document type, number, date, GSTINs and total before attaching it.
Invoice protection
Blocks void or reverse of an invoice with an active IRN after 24 hours and blocks reactivation, steering users to a credit memo.
Clear validation
Missing GSTIN, address, HSN, tax or state mismatches and rounding problems are reported in plain language, naming the invoice line.
Tax and discount handling
CGST/SGST/IGST/cess split by supply type, foreign-currency invoices converted to INR, and discount lines deducted from matching taxed lines.
E-way bill details
Part A transport details are sent with the IRN when the shipment carries them, and the returned e-way bill number is stored.
Per-organization setup
IRP credentials are kept per client or per organization in an E-Invoice Configuration window, restricted to administrator roles.
Made for iDempiere teams in India
Indian companies on iDempiere
Businesses that issue GST invoices from iDempiere and want IRNs, signed invoices and QR codes created automatically instead of keyed into a portal.
iDempiere partners and consultants
Implementers serving Indian clients who need a ready e-invoicing integration with documented setup, instead of building one per project.
In-house ERP teams
Teams who want clear validation messages, a full audit trail of every IRP call and safeguards that stop invoices with an active IRN being voided by mistake.
What you need, what you receive
You need
- iDempiere 13 on Java 17 with PostgreSQL
- A GSTIN enabled for e-invoicing and an API user on the e-invoice portal
- A Whitebooks account (client ID, secret and registered email)
- Server access to the Whitebooks host over HTTPS; production IPs must be whitelisted with the provider
- HSN/SAC codes on products and charges, and GST state codes on regions
You receive
- The OSGi plugin bundle for iDempiere 13
- A re-runnable database setup script (tables, columns, window, processes, menus, access)
- Full documentation: installation, configuration, master data, mapping rules and troubleshooting
- A stand-alone test runner to check requests against the sandbox without touching your database
Honest about scope
Not included yet
- Buttons on the invoice window and QR code on the printed invoice
- A separate e-way bill plugin (planned)
- Dispatch-from and additional-document sections
- IRP error-code mapping
Worth knowing
- Debit notes use a custom document base type, so test accounting posting before relying on it
- Child taxes must carry CGST, SGST, IGST or CESS in their names
- Developed and tested against the Whitebooks sandbox; confirm production requirements with your provider
Common questions
Does the plugin work with iDempiere 13?
Yes. It is built for iDempiere 13 on Java 17 and PostgreSQL, as an OSGi plugin installed like any other iDempiere bundle.
Which API provider does it use?
Whitebooks GSP. You use your own Whitebooks credentials and your own GSTIN; the plugin does not route invoices through anyone else.
Does it replace my GST Suvidha Provider (GSP)?
No. It is the integration between iDempiere and the e-invoice system. You still need a Whitebooks account and an API user on the e-invoice portal.
Is B2C supported?
No. The IRP does not accept B2C invoices, so in batch mode they are skipped, and a single invoice without a buyer GSTIN returns a clear error (exports excepted).
What if an invoice was sent by mistake?
Reverse it and cancel the IRN within 24 hours. After that, issue a credit memo. The plugin enforces this so users do not end up with an inconsistent state.
Are my IRP credentials safe?
Password, client ID and secret are stored in encrypted columns and kept out of the change log. Encryption depends on your iDempiere Secure class, so the documentation explains how to verify it before entering production credentials.
Can it be customized for my setup?
Mapping rules, extra fields and workflow changes can be discussed. Tell me what you need when you get in touch.
Want it for your iDempiere?
Tell me your iDempiere version, volume of invoices and API provider, and I'll reply with pricing and next steps.
Email for pricing LinkedIn 8148974874