iDempiere GST E-Invoicing in India: IRN, GSTR-1 & E-Way Bill Automation Guide

GST E-Invoicing Overview

Under the Goods and Services Tax regime, Indian businesses generating B2B invoices above the prescribed turnover threshold must generate a unique Invoice Reference Number (IRN) and a QR code from the GSTN Invoice Registration Portal (IRP) before sending the invoice to the customer. The IRN acts as the authoritative tax receipt, and its real-time validation has made manual GST invoicing obsolete for mid-to-large businesses.

Integrating this flow directly into iDempiere ERP eliminates double-keying, removes format-mismatch errors, and ensures 100% GSTR-1 reconciliation at month-end.

E-Invoicing Thresholds & Applicability

As of 2026, e-invoicing is mandatory for all taxpayers with an aggregate turnover exceeding INR 5 crore in any previous financial year (threshold has progressively lowered since 2020). This covers:

• All B2B invoices, credit notes, and debit notes
• Export invoices (with / without IGST)
• Reverse charge supplies

B2C invoices are exempt from IRN generation but must carry a dynamic QR code for consumer verification where applicable.

iDempiere GST Module Architecture

We build GST compliance as a custom OSGi plugin with the following components:

• Tax configuration master — GST rate slabs (0%, 5%, 12%, 18%, 28%), HSN/SAC mapping per product, place-of-supply rules
• GSTIN validation — real-time API lookup against GSTN registry at customer master creation
• Invoice enrichment — auto-populates GSTIN, state code, reverse charge flags, ITC eligibility
• IRN submission service — posts the invoice JSON to the IRP via GSP or direct API
• Response handler — stores IRN, acknowledgement number, QR code, signed JSON, and error responses
• Print templates — tax invoices with QR code, HSN summary, and statutory declarations

IRN Generation Flow

1. Sales user creates a C_Invoice in iDempiere; Complete action validates tax rules and GSTIN
2. iDempiere builds the e-invoice schema v1.1 JSON payload with all mandatory fields
3. Payload is digitally signed and submitted to the IRP through our GSP (ClearTax, Masters India, or similar)
4. IRP responds with IRN (64-char hash), Acknowledgement Number, signed QR code, and signed invoice
5. Response fields are stored against the invoice, tax invoice PDF is generated with the QR code, and customer receives the invoice

End-to-end latency: ~2–4 seconds per invoice in production. Bulk mode handles 100+ invoices/minute for high-volume operations.

E-Way Bill Automation

For shipments above INR 50,000, an e-way bill is mandatory. Our iDempiere integration auto-generates the e-way bill at shipment creation (M_InOut) by calling the e-way bill portal with invoice details, vehicle number, transporter ID, and distance. The returned EWB number is stored against the shipment and printed on the delivery challan.

Vehicle number updates (Part B) during transit are captured via a mobile app used by the driver or transport coordinator and pushed back to iDempiere.

GSTR-1 Reporting & Reconciliation

Because every invoice is already e-invoiced, GSTR-1 preparation becomes a reconciliation exercise rather than data entry. Monthly workflow:

• Pull all B2B / B2C / exports / credit notes from iDempiere for the filing period
• Cross-check IRN status (all must be ACK'd; any REJECTED are investigated and refiled)
• Generate JSON in GSTR-1 schema and upload to GST Portal via our GSP bridge
• Reconcile with GSTR-2B / 2A for input tax credit matching

GSP vs Direct IRP Integration

Common Errors & Resolution

• Invalid GSTIN — validate at master creation; flag stale GSTINs monthly
• Duplicate IRN submission — idempotent flag + local hash check before submission
• HSN/SAC mismatch with tax rate — auto-derive tax rate from HSN at invoice line
• Place-of-supply errors — ship-to state determines IGST vs CGST+SGST split
• Timing drift — ensure server NTP sync; IRP rejects invoices with future-dated timestamps

Audit Trail & Penalty Protection

Every IRN submission, response, and subsequent amendment is logged in an immutable audit table. This is critical during GST audits — the department can ask for any invoice's submission history, and you need to show the exact payload, timestamp, and response. Our audit trail also helps avoid the 2% penalty on invoices issued without IRN (capped at INR 10,000 per invoice).