Free E-Invoice Included Premium E-Way Bill Direct Portal Connector

Free E-Invoice & E-Way Bill Plugin

Complete user manual, configuration reference, daily operating workflows, report designer setup, and troubleshooting guide for InventoryPlus.

★ 1. Overview & Business Advantages

The InventoryPlus E-Invoice & E-Way Bill Plugin eliminates expensive monthly intermediary subscription fees by connecting directly to your official Government GST Portal (einvoice1.gst.gov.in). It allows Indian businesses to generate legal IRN (Invoice Reference Number), Official Signed QR Codes, and E-Way Bills in 1–2 seconds right during POS billing.

💰 Zero Intermediary Fees

No per-invoice charges, no monthly API subscription fees, and no third-party cloud data exposure. Operates 100% directly between your local PC and the Government of India portal.

⚡ 2-Minute Onboarding

No need to pay for third-party services, GSP subscriptions, or paid API packages. Simply enter your existing portal username & password, complete 1 morning login, and start billing immediately.

💎 2. Free Edition vs. Premium Features

Standard B2B E-Invoicing is 100% free and permanent for all InventoryPlus users. Advanced logistics and automated E-Way Bill management are activated with an InventoryPlus Premium license.

Feature Capability	Free / Community Edition	Premium Subscription
B2B E-Invoice Generation (IRN + Ack Details)	100% Free	Included
Official Signed Digital QR Code Rendering	100% Free	Included
A4 & 80mm POS Thermal Receipt Printing	100% Free	Included
Offline Billing Queue & 1-Click Sync	100% Free	Included
24-Hour IRN Cancellation & Credit Notes	100% Free	Included
Integrated E-Way Bill Generation (Above ₹50,000)	Upgrade Required	Included
Standalone E-Way Bills (Stock Transfers & Challans)	Upgrade Required	Included
Live 1-Click Vehicle Number / Transporter Update	Optional Add-on	Included

How to Use E-Way Bill Effectively (Comprehensive Guide)

E-Way Bill (Electronic Way Bill) is a mandatory compliance document required under GST laws for the physical movement of goods across India. The InventoryPlus E-Invoice & E-Way Bill Plugin integrates this directly into your point-of-sale billing workflow, automating Part-A, Part-B, transit distance calculation, and emergency vehicle updates.

ℹ️

Mandatory Threshold: An E-Way Bill is legally required whenever total consignment value exceeds ₹50,000 (Taxable Value + CGST + SGST + IGST + Applicable Cess). Generating the E-Way Bill simultaneously with the IRN prevents mismatch between invoice numbers and road transit permits.

1. POS Counter Workflow: Low-Value vs. High-Value Bills

To eliminate billing bottlenecks during peak hours, InventoryPlus applies an intelligent two-tier lifecycle:

Bill Category	Consignment Value	POS Operational Workflow
Low-Value Bills	Under ₹50,000	Instant Print (Zero Delay): The receipt prints immediately at the cash counter. If the customer has a GSTIN (B2B), the IRN is queued and generated silently in the background.
High-Value Bills	₹50,000 and Above	Simultaneous IRN + EWB Verification: Prompts for transport details (Vehicle Number, Transporter ID, Distance) and attempts silent generation via the portal engine in 2–3 seconds.

Create Invoice in POS Billing

Select customer with 15-digit GSTIN and add items with valid 4, 6, or 8-digit HSN codes.

Enter Transport & Vehicle Details

Confirm Distance (KM) auto-calculated from PIN codes, and enter Vehicle Registration Number (e.g. KA04MK1234) or Transporter ID.

Save & Print (F5)

The system submits the payload, captures IRN, Signed QR, and 12-digit E-Way Bill Number, and prints the bill with full road compliance.

2. Semi-Automatic & Manual Fallback (Handling Portal Traffic)

If the government portal experiences high traffic or session expiration, the top toolbar of the Portal Assistant gives you complete manual control:

Copy File Path: Copies the exact local path of the generated government invoice file to your clipboard.
Open Folder: Opens the invoice files folder in Windows Explorer so you can easily select or drag the file onto the portal screen.
[ 🔍 Capture from Page ]: Automatically scans the portal screen and tables for the 64-character IRN, official Signed QR code, Ack Number, and 12-digit E-Way Bill number.
Manual Entry / Paste: Opens a dedicated screen where cashiers can paste confirmation text or response data copied from the portal. The system automatically reads the fields and applies them to the bill.
Import Ack File: Directly imports downloaded government acknowledgment files (.json or .txt).

Part-B & Live Vehicle Updates

An E-Way Bill consists of two distinct components:

Part-A (Consignment Details): Supplier, Recipient, Dispatch & Delivery PIN codes, Invoice Number & Date, Total Value, and HSN codes. (Handled automatically from InventoryPlus invoice data).
Part-B (Transport Details): Mode of transport and Vehicle Registration Number or Transporter Document (LR) Number.

⚠️

Legal Requirement: Generating Part-A alone is only a provisional slip. Moving goods on the road without completing Part-B is deemed illegal transit without an E-Way Bill under Section 129 of the CGST Act. Always complete Part-B before dispatch.

Handling In-Transit Vehicle Changes & Breakdowns

If a delivery truck breaks down or goods are shifted to another vehicle at a logistics hub:

Open Sales History / Bill List in InventoryPlus.
Right-click the relevant invoice and select Update E-Way Bill Vehicle (Part-B).
In the update dialog, verify the 12-digit E-Way Bill Number and enter the New Vehicle Number and From Place / City.
Select the Reason for Change (1 - Due to Breakdown, 2 - Due to Transshipment, or 3 - Others).
Click Update Vehicle on Portal. The government portal records the new vehicle in real time without re-issuing or voiding the original invoice.

Distance Calculation, Validity & Extension

E-Way Bill validity is strictly enforced based on travel distance:

Cargo Type	Distance Tier	Validity Granted
Regular Cargo	Every 200 KM (or part thereof)	1 Day (e.g. 350 KM = 2 Days)
Over Dimensional Cargo (ODC)	Every 20 KM (or part thereof)	1 Day

ℹ️

Validity Extension Rule: If a vehicle is delayed due to severe traffic, natural breakdown, or weather, validity can be extended on the GST portal within 8 hours before or up to 8 hours after the expiry time.

24-Hour Cancellation & Road Inspection Rules

24-Hour Cancellation: An E-Way Bill can be cancelled within 24 hours of generation. However, it cannot be cancelled if it has already been verified or inspected in transit by a GST officer.
Road Inspection Readiness: Drivers can present either the physical printed invoice (`header_fld6..fld9`) or the digital Signed QR code (`header_fld8`) on mobile. The official GST QR Verifier app decrypts the government signature instantly offline.

Configuration Screen - Every Setting Explained

To configure the plugin, open InventoryPlus and navigate to Settings → Plugins → E-Invoice & E-Way Bill Settings, or right-click the Taskbar Tray Icon (Truck icon) and click ⚙ E-Invoice & E-Way Bill Settings...

🏢 Tab 1: General & Portal Setup

Setting Field	Description & Purpose	Recommended Value / Format
Seller GSTIN	Your store or legal business 15-character Goods and Services Tax Identification Number. Must match the registration on the E-Invoice portal.	`29ABCDE1234F1Z5` (Must be exactly 15 alphanumeric characters).
PIN Code	6-digit postal PIN code where your dispatch location or warehouse is physically situated. Used for distance validation.	`560001` (6 numeric digits).
Legal Name	Official legal business name as printed on your GST Registration Certificate.	e.g. `ABC RETAIL ENTERPRISES PRIVATE LIMITED`
State Code	2-digit numerical GST state code corresponding to the first 2 digits of your GSTIN (e.g. 29 for Karnataka, 27 for Maharashtra, 33 for Tamil Nadu).	`29` (2 digits). Auto-derived from your GSTIN.
Trade Name	Commercial trading name or brand shop banner under which you sell goods to customers.	e.g. `ABC SUPERMARKET`
Portal Username & Password	Your official credentials for logging into the Government E-Invoice portal. These are stored locally in Windows Protected Storage (DPAPI) with strong encryption.	Portal credentials used during morning login. Pre-fills login modal automatically.
Environment	Toggle between Production (Legal government server) and Sandbox (NIC staging simulator for practice/testing).	Production for actual business sales; Sandbox for training cashiers.
Auto-generate E-Invoice	When checked, InventoryPlus automatically submits eligible B2B sales invoices silently in the background when clicking Save & Print.	Checked [True] (Recommended). Cashiers never need to leave the billing screen.
Auto-generate EWB > ₹50k	When checked, bills with value above ₹50,000 prompt for transporter distance and vehicle number to generate both IRN and E-Way Bill in 1 click.	Checked [True] (Requires active Premium subscription).
Default Delivery Radius	Default local delivery radius in Kilometers pre-filled when generating local intra-city E-Way Bills.	`25` (KM). Can be modified on individual bills.
POS Timeout Action	Controls cashier experience when portal times out: Silently queue and continue billing (silent offline queue) vs Open Queue Dialog immediately (instant popup).	Silently queue and continue billing for retail; Open Queue Dialog for wholesale.
Keep-Alive Session Heartbeat	Sends lightweight background HTTP keep-alive pings every 10 minutes to maintain your portal session cookies fresh throughout the workday.	Checked [True] (Interval: 10 minutes).
QR Code Print Size	Dimension in pixels for the generated signed QR Code bitmap (used for high-density rendering on thermal rolls and A4 prints).	`180` px (Suitable for 80mm thermal printers and laser invoices).

🧹 Tab 2: Maintenance & Data Cleanup

Maintenance Feature	What it Does	When to Use
Logging Mode	• Errors Only (Default): High performance; records only errors, exceptions, and failed submissions. • Troubleshoot / Detailed (Debug): Records detailed transaction payloads, validation steps, and portal responses.	Keep on Errors Only for standard retail speed. Switch to Troubleshoot only when investigating an issue.
Log Retention Period	Automatically purges older audit logs older than the configured threshold (10, 30, 90, or 180 Days) upon software startup.	Default: 30 Days. Prevents your hard drive from accumulating unnecessary text files.
📂 Open Logs Folder	Opens Windows File Explorer directly to `Plugin\EInvoiceEWB\Logs\Audit\` so you can view or email diagnostic logs.	Click whenever you need to attach log files for InventoryPlus Technical Support.
🧹 Clear Temp QR & Web Cache	Deletes temporary QR image files and temporary portal browser cache.	Run periodically if you want to reclaim disk space after generating thousands of bills.
📦 Archive Financial Year	Packs completed fiscal year records into a secure compressed ZIP archive on your Desktop.	Click at the end of each financial year (e.g. on March 31st) for annual audit compliance.

🧪 4. Sandbox Mode & Connection Testing

The plugin includes a dedicated Sandbox Mode and pre-flight connection diagnostic tool. This allows you to test the entire e-invoicing pipeline safely without risking tax liabilities or creating real government IRNs.

ℹ️

What is Sandbox Mode?
In Sandbox Mode, the plugin routes all requests to the official NIC API Sandbox simulator (https://einv-apisandbox.nic.in). You can generate practice invoices, test QR printing, and train billing operators with complete peace of mind.

How to Run the 1-Click Connection Diagnostic:

Click "🧪 Test Portal Connection"

Located in the Configuration screen (or right-click the taskbar tray icon → 🧪 Test Portal / Sandbox Connection...).

Automated Readiness Checks

The diagnostic engine runs 4 quick verification checks:

Portal Connector Ready: Verifies that the built-in portal connector is installed and ready to communicate with the GST portal.
Government Portal Connection: Verifies live, secure internet connectivity to the official Government GST portal.
Invoice Format Validation: Verifies your store GSTIN, tax codes, and invoice formatting against official GST rules.
Official QR Code Printing Engine: Tests QR code generation to ensure clear barcode printing on receipts and invoices.

Review Result Summary

A diagnostic dialog reports either [PASSED] with green indicators or flags any missing components (such as an incomplete GSTIN or blocked network firewall).

🔍 5. Testing the Plugin Without Launching POS App

You can thoroughly verify the plugin, check portal connection readiness, and run diagnostics without even opening the main InventoryPlus.exe application!

Method A: Standalone Diagnostic Tool

Open Windows File Explorer and navigate to:
<InventoryPlus Folder>\Plugin\EInvoiceEWB\Documents\
Double-click the file named Test_Plugin_Diagnostics.bat.
A diagnostic window will open and perform an automated readiness check:
- Verifies plugin files and system readiness
- Checks built-in portal connector readiness
- Tests configuration file validity (config.json)
- Tests network ping to Government GST Portal / Sandbox
- Verifies audit logging write permissions
- Outputs a clear PASS / FAIL Status Report

●

No Installation Needed: The diagnostic tool is completely portable and can be run by store managers or IT personnel during store setup to guarantee the system is ready for billing.

🔐 6. Daily Workflow 1: Morning Fast-Pass Login

Because the government portal enforces security CAPTCHA protection, the plugin employs a streamlined Morning Fast-Pass Login that only takes 5 seconds once per business day.

Launch Login Window

In the morning when opening the store, right-click the E-Way Truck Tray Icon → Click 🔐 Start Portal Session (Morning Login) (or click Login / Test Session in Plugin Settings).

Instant CAPTCHA Entry

The secure browser modal opens. Your registered Username and Password are automatically filled. The keyboard cursor is already blinking inside the CAPTCHA box.

Press Enter to Complete

Simply type the 4 or 5 characters shown in the CAPTCHA image and press Enter.

Ready for the Day!

The window closes automatically. The taskbar truck icon turns 🟢 Green (Ready & Active). All bills generated during the day will process silently in the background without any further prompts!

🛒 7. Daily Workflow 2: Standard B2B POS Billing

Once morning login is active, cashiers generate E-Invoices completely automatically:

Open Sales Billing in InventoryPlus.
Select a registered B2B Customer (with a valid 15-digit GSTIN).
Scan or add products (ensure items have configured HSN codes, e.g. 8471, 2106).
Click Save & Print (or press F5).
Background Processing (1-2 Seconds):
- The plugin silently submits the invoice to your active portal session.
- Captures the official 64-character IRN, Acknowledgment Number & Date, and Government Signed QR Code.
- The bill is printed instantly on your default printer with the official QR code.

📡 8. Daily Workflow 3: Bulk E-Invoice & E-Way Bill Offline Queue

The Bulk E-Invoice & E-Way Bill Queue provides an end-to-end command center for managing tax invoices, high-value B2C retail sales, and delivery challans without slowing down checkout operations. It completely eliminates third-party paid API dependencies by leveraging official NIC JSON schemas, automated Portal Assistant integration, and manual entry fallbacks.

⚡ Instant Counter Checkout (< ₹50,000)

Standard retail bills under ₹50,000 save and print immediately without waiting for portal network responses. The cashier hands over the receipt instantly to keep customer queues moving fast.

🔍 Unified Invoices & Delivery Challans

Switch effortlessly between Tax Invoices (B2B & B2C) and Delivery Challans (Stock Transfers & Job Work) with automated compliance checks.

1. Document Types Supported in the Queue:

Document Mode	Applicable Scenarios	Legal Rule	Available Actions
Tax Invoices (B2B)	Sales to GST-registered buyers (15-digit GSTIN).	Rule 48(4) E-Invoice IRN + EWB if ≥ ₹50,000.	Generate IRN / Sync B2B, Open Assistant, Manual Ack Entry.
Tax Invoices (B2C ≥ ₹50k)	High-value retail sales to unregistered consumers.	Mandatory standalone E-Way Bill on `ewaybillgst.gov.in`.	Export EWB JSON, EWB Portal Assistant, Enter EWB No.
Delivery Challans (CHL)	Material Out, Inter-Branch Stock Transfers & Job Work.	Rule 55 Challan with mandatory E-Way Bill for transit.	Export EWB JSON, EWB Portal Assistant, Enter EWB No.

2. How to Pull Documents & Generate E-Way Bills / IRNs:

Select Document Type & Enter Reference Number

Open the Queue screen (Tray Icon → Open Bulk E-Invoice Queue...). Select either Tax Invoices or Delivery Challans. Enter the Bill No or Voucher Ref No (e.g. CHL-001) and Date.

Click "🔍 Pull Document Details"

The system queries the sales or stock register database:

For Invoices: Validates B2B GSTIN vs B2C retail, line items, and existing IRN/EWB numbers.
For Challans: Loads consignor/consignee branch details, items, quantities, and rates from Stock_register.

Choose Your Preferred Compliance Action:

💾 Export EWB JSON: Generates and exports the official government NIC JSON (version 1.0.0121) directly to your chosen folder. Ready for 1-click bulk upload on ewaybillgst.gov.in.
⚡ EWB Portal Assistant: Launches the built-in WebView2 modal pointing directly to https://ewaybillgst.gov.in/login.aspx with your store credentials pre-filled and JSON file path attached.
✏️ Enter EWB No: Opens a dedicated dialog to enter the 12-digit government E-Way Bill Number and validity date. Automatically saves into Sales_header.fld9 or Stock_register_header.fld5 so it prints on the document!
Generate IRN / Sync B2B: Batch processes selected B2B tax invoices against the active portal session.

3. Automatic POS Failure Redirect (Never Miss a B2B Bill):

[Note]

Seamless Counter Fallback:
When a high-value B2B invoice is saved at the POS counter, the system attempts background IRN generation. If the portal times out or encounters network latency, the Bulk Queue window automatically pops open with that bill preloaded. The cashier can immediately launch the Assistant, enter the EWB number, or simply close the window to let the bill be synced during end-of-day reconciliation.

⏱️ 9. Daily Workflow 4: 24-Hour Cancellation Rules

The Goods and Services Tax Network (GSTN) enforces strict legal regulations regarding invoice cancellations:

Within 24 Hours of Generation

An IRN can be cancelled directly on the Government Portal within 24 hours.

In InventoryPlus, right-click the invoice in Sales History → Click [Cancel] Cancel E-Invoice → Select mandatory reason (e.g. Duplicate, Data Entry Error, or Order Cancelled).

After 24 Hours (Legally Locked)

The portal strictly forbids deleting or cancelling an IRN once 24 hours elapse.

To adjust or refund the transaction, create an official Credit Note (CRN) in InventoryPlus Sales Return. The plugin generates a legally linked E-Invoice Credit Note.

⚡ 9. Enterprise Batch, Logistics & High-Volume Operations (8 Features)

Designed for high-speed retail counters, wholesale distribution warehouses, and multi-branch logistics hubs, these 8 enterprise features eliminate third-party paid API dependencies while matching the workflow power of dedicated enterprise ERPs.

Continuous Operations

Session heartbeat keep-alive and silent POS timeout policies guarantee that billing counters and cashiers never experience mid-day session expirations or frozen queues.

Advanced Logistics & 3PL

Direct support for Part-A only handover to 3PL logistics carriers, multi-vehicle consignment notes, Form GST EWB-02 Consolidated Trip Sheets, and statutory challan types.

Feature 1: Background Keep-Alive Session Heartbeat (10-Min Auto-Ping)

The Business Problem & How It Works:

The official GST portal automatically logs cashiers out after 15–20 minutes of counter inactivity. If your morning B2B sale happened at 10:00 AM and the next one occurs at 2:00 PM, previous tools required re-entering the CAPTCHA. With the Session Heartbeat Service, the plugin quietly dispatches a lightweight HTTP keep-alive ping every 10 minutes in the background, keeping your session cookies warm and valid across your entire 12-hour business day.

How to Enable: Navigate to Settings → Plugins → E-Invoice & E-Way Bill Settings. Under Maintenance & Network, verify that [x] Keep-Alive Session Heartbeat is checked. The default interval is 10 minutes.

Feature 2: Multi-Bill "From Date - To Date" Filter in Bulk Queue

Consolidated End-of-Day Reconciliation:

Rather than looking up un-synced bills one-by-one, accountants and dispatchers can review and process all un-synced B2B invoices and Delivery Challans across any custom date range in a single consolidated grid.

How to Use: Open the Bulk Queue dialog (Tray icon → Open Bulk E-Invoice Queue...). Set your From Date and To Date, select either Tax Invoices or Delivery Challans, and click [ 🔍 Load Date Range ]. Every document missing an IRN or E-Way Bill within that period is displayed with bill numbers, buyer GSTINs, and total amounts ready for batch sync or JSON export.

Feature 3: 3PL Logistics Handover (Part-A Only) & Multi-Vehicle Tracking

Handing Goods to Transporters (VRL, TCI, Safechem, Delhivery, etc.):

When dispatching goods through third-party logistics (3PL) carriers, the merchant rarely knows the final long-haul truck registration number because the carrier consolidates parcels at their regional hub.

Part-A Only Generation: Enter the Transporter's 15-digit GSTIN (Transporter ID) and distance, but leave the Vehicle Number blank. The plugin generates a legally valid Part-A only JSON / EWB permit, delegating Part-B vehicle completion to the transport carrier.
Multi-Vehicle Consignment Notes: In the manual EWB entry dialog (dlgManualEwbEntry), record vehicle registration numbers or multi-vehicle consignment notes (e.g. MH12AB1234 (Van 1) + MH12CD5678 (Van 2)) in the Vehicle / Notes field for local dispatch documentation.

Feature 4: Configurable POS Timeout Fallback Policy

Balancing Counter Speed vs Immediate Error Visibility:

Configure how POS billing behaves when government servers take longer than 3 seconds or encounter network lag:

Policy Option	Behavior During Slow Network / Timeout	Recommended Business Environment
Silently queue and continue billing	Saves and prints the bill immediately as `Pending_EInvoice`. Zero popups appear. The customer receives their receipt instantly and the queue keeps moving.	High-volume retail counters, supermarkets, busy wholesale desks.
Open Queue Dialog immediately	Pops open the Bulk Queue dialog pre-loaded with the failed bill so the cashier or accountant can review the error reason or enter manual details on the spot.	Back-office billing, wholesale distributors with low transaction volume.

Feature 5: Single-Entry "Fill Portal Web Form" DOM Assistant

Zero-Typing Web Form Autofill in WebView2:

For operators who prefer generating single E-Way Bills directly in the government portal web form (ewaybillgst.gov.in/Entry_Form.aspx) rather than downloading JSON files, the plugin provides automated DOM form injection.

How to Use: From the Queue screen, click [ ⚡ EWB Portal Assistant ]. In the embedded browser, open the E-Way Bill entry form and click the [ ⚡ Fill Web Form ] toolbar button. The script automatically populates Document Number, Date, Buyer GSTIN, PIN Codes, Distance, Vehicle Number, and Item lines directly into the web inputs and triggers DOM change events. Simply review and click Submit!

Feature 6: Statutory Sub-Supply Type Selector for Delivery Challans

Full Compliance with GST Rule 55:

Delivery Challans represent various statutory non-sale movements that require specific sub-supply codes on E-Way Bills. In dlgEInvoiceQueue, selecting Delivery Challans enables the Sub-Supply Type dropdown with the following statutory classifications:

Sub-Supply Type	NIC Code	Statutory Scenario
Job Work	`3`	Raw materials or semi-finished goods sent to job workers or subcontractors for processing.
For Own Use / Branch Transfer	`4`	Stock transfers between warehouses, depots, or retail branches of the same entity.
Exhibition or Fairs	`5`	Consignments dispatched for trade expos, display stalls, or customer demonstrations.
Others	`8`	Internal movements, warranty replacements, promotional samples, or testing materials.
Line Sales	`11`	Goods loaded onto mobile delivery vans for distribution and spot sales to retailers.

Feature 7: 1-Click "Import Bulk Response File" (.json / .csv / .txt)

Instant Reconciliation Across Dozens of Invoices:

When you upload a bulk Excel or JSON file to einvoice1.gst.gov.in or ewaybillgst.gov.in, the portal returns a downloadable response export file containing all generated IRNs, Acknowledgment numbers, and E-Way Bill numbers. Manually copying and pasting these back into individual invoices takes significant time.

How to Use: In dlgEInvoiceQueue, click [ 📂 Import Bulk Response File ]. Select your downloaded .json, .csv, or .txt file. The parser extracts the document numbers and updates Sales_header and Stock_register_header with IRNs, Ack details, and EWB numbers in 1 second. A clear confirmation popup displays the exact number of records updated.

Feature 8: Export Consolidated E-Way Bill (Form GST EWB-02 / Trip Sheet)

Multi-Consignment Trip Sheet Generation for Delivery Trucks:

When a transport vehicle carries goods for multiple customers or branches, GST law mandates a Consolidated E-Way Bill (Form GST EWB-02). Rather than generating trip sheets manually on the portal, InventoryPlus automates the entire process.

How to Use: In the Bulk Queue, select multiple bills assigned to the same delivery truck. Click [ 📑 Export Consolidated E-Way Bill (EWB-02) ]. The plugin verifies that all selected bills have active EWB numbers and share the same vehicle registration, then exports an official Form GST EWB-02 JSON payload (version 1.0.0121). Upload this file directly to ewaybillgst.gov.in under Consolidated EWB → Generate Bulk to print your official Trip Sheet.

🎨 10. How to Add E-Invoice QR & IRN to Bill Templates

InventoryPlus uses the DevExpress Report Designer. Rather than hard-coding print locations, the plugin maps official e-invoice data to standardized custom header fields so you have pixel-perfect layout control.

🏷️ Designated Report Field Mappings

Print Element	Report Field Name	Sample Output Data	Recommended Control & Settings
Signed Digital QR Code	`header_fld8` (or `QRCode`)	`eyJhbGciOiJSUzI1NiIsInR5cCI...` (Signed QR Code Data)	`XRBarCode` control • Symbology: `QRCode` • Compaction: `Byte` • Error Correction: `M` or `Q` • AutoModule: `True` • ShowText: `False`
IRN (Invoice Reference Number)	`header_fld6`	`4a8f9c2d1e67b9a03f4e...` (64-character Official IRN)	`XRLabel` control • Text: `'IRN: ' + [header_fld6]` • WordWrap: `True`, Font: `7.5pt`
Acknowledgment No & Date	`header_fld7`	`Ack No: 1223456789 \\| 06-09-2026 14:30`	`XRLabel` control • Text: `[header_fld7]` • Font: `8pt Regular`
E-Way Bill No & Validity	`header_fld9`	`EWB No: 121234567890 \\| Valid: 08-09-2026`	`XRLabel` control • Text: `[header_fld9]` • Font: `8pt Bold`

Recommended Print Dimensions:

📄 Standard A4 Tax Invoices

Position: Top-right corner of the Report Header.
QR Dimension: 45mm × 45mm (or ~180 × 180 px).
Labels: Position IRN and Ack details immediately underneath QR code.

🧾 80mm POS Thermal Receipts (3-inch)

Position: Report Footer (directly below Total & Tax summary).
QR Dimension: 35mm × 35mm (or ~140 × 140 px).
Ensure thermal print density is clean for optical camera scannability.

📱

How to Verify Your Prints:
Download the official GST E-Invoice QR Verifier app from Google Play Store or Apple App Store. Point your camera at your printed bill. The app validates the Government signature and displays the legal taxpayer details with a green "Signature Valid" banner.

📂 11. Troubleshooting & Diagnostic Logs

The plugin maintains a structured two-tier logging mechanism to ensure complete transparency without wasting storage:

Logging Tiers

Errors Only (Default): Captures only unhandled errors, network dropouts, or portal validation rejections. Keeps billing fast.
Troubleshoot Mode: Comprehensive step-by-step audit details including invoice payloads, validation results, and portal responses.

Log File Location

All logs are kept daily under:

<InventoryPlus Installation>\Plugin\EInvoiceEWB\Logs\Audit\EInvoiceAudit_YYYY-MM-DD.log

Common Portal Response Codes:

Error Code	Portal Message	Troubleshooting Resolution
`2150`	Duplicate IRN / Invoice already uploaded	The invoice number was already processed earlier. The plugin automatically fetches and attaches the existing IRN and signed QR code.
`2184`	Invalid HSN Code	Ensure items in InventoryPlus have valid 4, 6, or 8-digit HSN codes. 2-digit or blank HSNs are strictly rejected by the GST portal.
`SESSION_EXP`	Session Expired / Logged out	Right-click the Taskbar Tray Icon → Click Start Portal Session → Re-enter CAPTCHA to resume silent background billing.
`PORTAL_CONNECTOR`	Portal Browser Component Missing	Install the Microsoft Edge portal connector component (pre-installed on Windows 10/11; available for Windows 7/8).

🧪 12. Complete QA Test Scenarios & Verification Matrix (54 Test Cases across 16 Suites)

The E-Invoice & E-Way Bill Plugin has been comprehensively designed, structured, and verified across 15 Test Suites containing 54 specialized Test Cases. This ensures full compliance with GST Rule 48(4), Rule 138, and official NIC schema v1.0.0121, providing fail-safe operation during peak store hours.

📋

QA Test Script Location:
The exact runnable test plan is deployed directly with the plugin inside Plugin\EInvoiceEWB\Documents\testcase.txt and EInvoiceEWB_QA_TestCases.txt. QA teams and system engineers can use these files to validate store readiness.

Summary of 15 Verification Suites

Suite #	Test Suite Title	Test Cases	Operational Scenarios Verified
Suite 1	Initialization & Discovery	`TC-EINV-01 - 03`	MEF discovery, WebView2 runtime profile isolation, and config persistence.
Suite 2	Pre-Flight Validation	`TC-EINV-04 - 07`	GSTIN Mod-36 checksum, HSN mandatory digits, CGST/SGST/IGST mapping, mathematical reconciliation.
Suite 3	Portal Auth & Fast-Pass	`TC-EINV-08 - 10`	Morning CAPTCHA fast-pass, cookie persistence across reboots, non-blocking status bar fallback.
Suite 4	Silent Background Engine	`TC-EINV-11 - 13`	Headless payload dispatch (< 1.8s), raw network stream JSON interception, duplicate error 2150 auto-linking.
Suite 5	Signed QR Code & Prints	`TC-EINV-14 - 17`	High-density 2D signed QR generation, official mobile QR app validation, 80mm thermal receipt & A4 layouts.
Suite 6	Low-Value POS Checkout	`TC-EINV-18 - 21`	Instant POS print (< ₹50k) with zero delay, on-demand pull by bill no & date in Queue, manual B2B IRN generation.
Suite 7	High-Value B2B POS Billing	`TC-EINV-22 - 24`	POS prompt for distance, vehicle number, transporter ID, combined IRN + 12-digit EWB generation in single call.
Suite 8	POS Failure Fallback	`TC-EINV-25 - 28`	Timeout/portal error auto-redirects POS to Queue with preloaded bill; cashier uses Assistant or enters EWB no; auto-refresh & print.
Suite 9	High-Value B2C Retail Sales	`TC-EINV-29 - 33`	Unregistered buyer (≥ ₹50k) auto-flagged as B2C EWB required; official NIC JSON (URP), EWB Portal Assistant, manual EWB entry.
Suite 10	Delivery Challans & Stock Transfer	`TC-EINV-34 - 40`	Delivery Challan mode, querying Stock_register, item & UOM enrichment, NIC Challan JSON, EWB entry saving to fld5, challan printing.
Suite 11	Official NIC Schema Compliance	`TC-EINV-41 - 43`	Strict NIC schema v1.0.0121 validation, date format dd/MM/yyyy, monetary rounding, Part-A only handover.
Suite 12	Manual EWB Entry Modal	`TC-EINV-44 - 46`	12-digit numeric enforcement, past validity prevention, dual table persistence (Sales_header vs Stock_register_header).
Suite 13	In-Transit Vehicle Update	`TC-EINV-47`	Part-B road update for vehicle breakdown or hub transshipment directly on portal.
Suite 14	Bill Lifecycle & Cancellation	`TC-EINV-48 - 52`	Editing pending bills, 24-hour portal IRN cancellation with mandatory reason, 24-hour locking & Credit Note enforcement.
Suite 15	Offline & Batch Reconnection	`TC-EINV-53 - 54`	Financial year folder partitioning (FY_YYYY_YYYY), disconnected offline billing with interim printing, 1-click batch sync.

Detailed Scenario Execution Guide

Scenario A: Retail Counter Sale Under ₹50,000

Goal: Zero checkout delay for walk-in shoppers while preserving on-demand B2B compliance.

POS Action: Bill is saved and printed immediately without holding the customer.
Accountant Action: If the customer requests a tax invoice with IRN later, open the Bulk Queue, enter Bill No and Date, click Pull Document Details, and click Generate IRN / Sync B2B.

Scenario B: High-Value B2B Sale Exceeding ₹50,000

Goal: Seamless simultaneous generation of IRN and E-Way Bill without third-party API costs.

POS Action: Bill reaches ≥ ₹50,000. System validates Buyer GSTIN, delivery PIN, vehicle registration, and travel distance.
Result: Background engine submits combined payload. Government portal returns 64-char IRN, Signed QR, and 12-digit E-Way Bill in < 2.5 seconds. Printed document includes both official QR and E-Way Bill number.

Scenario C: POS Counter Failure Fallback

Goal: Prevent counter freeze or lost compliance when portal has network latency.

Trigger: Portal timeout, CAPTCHA invalidation, or internet latency during high-value B2B POS save.
System Behavior: Background watchdog catches the issue and automatically opens the Bulk Queue dialog with the active bill preloaded.
Cashier Options:
- Click EWB Portal Assistant to complete via interactive browser.
- Click Export EWB JSON and upload to portal, then click Enter EWB No.
- Or close the dialog: bill prints immediately and remains queued for end-of-day batch sync.

Scenario D: High-Value Retail B2C Sale (≥ ₹50,000)

Goal: Full compliance with GST transit regulations requiring E-Way Bills for high-value unregistered sales.

Execution: Open Bulk Queue, pull retail invoice. System detects unregistered status and marks it as B2C Retail (E-Way Bill Required).
NIC JSON Export: Click Export EWB JSON. Creates compliant NIC schema (v1.0.0121) with toGstin: "URP".
Upload & Record: Upload on portal via Assistant, click Enter EWB No to record the 12-digit number. Saved into Sales_header.fld9 for printing.

Scenario E: Delivery Challans / Material Out (Stock Transfers & Job Work)

Goal: Generate official E-Way Bills for non-sales movements (Rule 55 Challans).

Execution: In Bulk Queue, switch Document Mode to Delivery Challans (Stock Transfer & Job Work).
Pull Challan: Enter Voucher Ref No (e.g. CHL-101) and Date. System loads data from Stock_register_header and Stock_register, enriching item names, HSN codes, and UOM abbreviations.
Export & Record: Export NIC Challan JSON (docType: "CHL", subSupplyType: "4" or "3"). Record 12-digit EWB number via Enter EWB No. Automatically updates Stock_register_header.fld5 for printing.

❓ 13. Frequently Asked Questions (FAQ)

Do I need to pay any monthly API fee or GSP subscription?

No. Standard B2B E-Invoicing in InventoryPlus is 100% free forever. It connects directly to your store's official GST portal account, bypassing third-party API aggregators completely.

What happens if our shop internet goes down during peak billing hours?

Your checkout counter will never stop! Invoices continue to save locally in InventoryPlus with a status of "Pending E-Invoice". Once internet connectivity resumes, open the Bulk E-Invoice Queue from your taskbar icon and click "Generate E-Invoices Now" to sync all pending bills in batch.

Can I test the plugin before using it on legal invoices?

Yes. In the plugin settings screen, set the Environment to "Sandbox". The plugin will communicate with the official Government Sandbox simulator. You can also run the diagnostic connection test or double-click Test_Plugin_Diagnostics.bat in the Documents folder to verify everything without opening InventoryPlus.

How do I enable E-Way Bill generation?

Standard E-Invoice is free for all users. Integrated E-Way Bill generation (for invoices exceeding ₹50,000), standalone Delivery Challans, and Live Vehicle Updates are available for users with an active InventoryPlus Premium license.

Can I edit or cancel an E-Invoice after generating it?

As per GST government rules, an IRN can be cancelled on the portal within 24 hours of generation (by right-clicking the bill and selecting Cancel E-Invoice). After 24 hours, the government portal legally locks the invoice. To modify or refund the transaction, create an official Credit Note (Sales Return) in InventoryPlus.

How often do I need to perform the Morning Login?

Just once at the beginning of each business day. Simply enter the 4-digit CAPTCHA when opening the store. Your secure session tokens remain active for the rest of the day for silent background billing.