Country & TaxFree generatorPDF, Excel, Word exportIndia

E-Invoice JSON Payload Generator for the GST IRP

E-invoicing in India means an ERP sends a JSON payload to the Invoice Registration Portal (IRP), which returns an Invoice Reference Number (IRN), a signed QR code and the signed JSON. This generator shows the shape of that payload so developers and finance teams can see what each section needs.

Fill in

Invoice number

Invoice date (dd/mm/yyyy)

Supply type

Seller GSTIN

Seller legal name

Seller address line

Seller location

Seller PIN code

Seller state code

Buyer GSTIN

Buyer legal name

Place of supply state code

Buyer address line

Buyer location

Buyer PIN code

Item description

HSN code

Quantity

Unit price (Rs)

GST rate (%)

Generated code

Download:

E-invoice JSON for an inter-state B2B sale (IGST)

{
  "Version": "1.1",
  "TranDtls": {
    "TaxSch": "GST",
    "SupTyp": "B2B",
    "RegRev": "N",
    "IgstOnIntra": "N"
  },
  "DocDtls": {
    "Typ": "INV",
    "No": "INV/26-27/00418",
    "Dt": "19/10/2026"
  },
  "SellerDtls": {
    "Gstin": "29ABCDE1234F1Z5",
    "LglNm": "Acme Precision Components Pvt Ltd",
    "Addr1": "Plot 12, Peenya Industrial Area",
    "Loc": "Bengaluru",
    "Pin": 560058,
    "Stcd": "29"
  },
  "BuyerDtls": {
    "Gstin": "33AAAAA0000A1Z5",
    "LglNm": "Southern Drives Ltd",
    "Pos": "33",
    "Addr1": "14 SIDCO Estate",
    "Loc": "Chennai",
    "Pin": 600032,
    "Stcd": "33"
  },
  "ItemList": [
    {
      "SlNo": "1",
      "PrdDesc": "Bearing housing, machined",
      "IsServc": "N",
      "HsnCd": "84829900",
      "Qty": 250,
      "Unit": "NOS",
      "UnitPrice": 740,
      "TotAmt": 0,
      "AssAmt": 0,
      "GstRt": 18,
      "IgstAmt": 0,
      "CgstAmt": 0,
      "SgstAmt": 0,
      "TotItemVal": 0
    }
  ],
  "ValDtls": {
    "AssVal": 0,
    "CgstVal": 0,
    "SgstVal": 0,
    "IgstVal": 0,
    "TotInvVal": 0
  }
}

Fill the computed amounts

The amount fields are shown as zero on purpose. Compute them in your ERP: TotAmt is quantity times unit price, AssAmt is TotAmt less discount, the tax amounts are AssAmt times the rate (IGST for inter-state, or CGST and SGST halves for intra-state), and TotItemVal adds them. ValDtls sums the items, and TotInvVal includes round-off and other charges.

Follows the commonly published structure of the e-invoice schema (version 1.1). Mandatory and optional fields, enumerations and length limits can change. Validate against the current schema from the e-invoice portal before sending any real document. Not for production without testing in the sandbox.

E-invoice payload mapping review

Optional: we can check your ERP billing document mapping against the IRP schema.

Optional. The tool and every export work without this. No spam.

How to use it

Choose the supply type, enter the seller and buyer, add one item, then copy the JSON. Use it as a reference when mapping your ERP billing document to the schema. For more items, repeat the object in ItemList with the next SlNo. The tool does not call the portal. Test real payloads in the sandbox that the e-invoice system provides.

What each block carries

TranDtls says what kind of transaction it is, including the tax scheme, the supply type and whether reverse charge applies. DocDtls has the type, number and date. SellerDtls and BuyerDtls hold GSTIN, legal name, address, PIN and state code, and the buyer also has the place of supply. ItemList holds the lines, and ValDtls gives the invoice totals. The IRP checks the totals against the lines.

SupTyp B2B, SEZ and export variants change validation
Pos must match the tax type used
Pin must be consistent with the state code

Common rejections

The IRP rejects documents when the invoice number has more than 16 characters or unsupported symbols, when the document is a duplicate, when the GSTIN is not valid or not active, when the date is wrong, and when the totals do not reconcile within the tolerance it allows. Keep invoice numbering within the allowed length and character set, and test the round-off logic.

ERP notes

Most ERP vendors and GST suites provide a connector to the IRP, either directly or through a GST Suvidha Provider. Use this generator to verify what your connector sends. Store the returned IRN and acknowledgement number on the billing document, because credit notes and cancellations refer to them.

Frequently Asked Questions

Who must issue e-invoices?

Registered persons whose aggregate turnover crosses the notified threshold in any year since 2017-18, with some exceptions. The threshold has been lowered in steps, so check the latest notification for your turnover and class of taxpayer.

Is the IRN generated by my ERP?

No. The IRN is generated by the IRP as a hash of key fields, and the portal returns it with a signed QR code. Your ERP creates the JSON and stores the response. Print the QR code on the invoice as required.

Can I cancel an e-invoice?

Cancellation is allowed within a short time limit after generation and must be done through the portal or the API. After that, use a credit note. Check the current time limit and whether an e-way bill was already generated on the invoice.

Do credit notes need e-invoicing?

Yes, credit and debit notes are reported on the IRP like invoices when the taxpayer is covered. Use the document type CRN or DBN in DocDtls, and refer to the original invoice in the reference section of the schema.

If your e-invoice posting fails often or needs manual clean-up, we can help review the payload mapping and add checks before submission.

Talk to an Expert Explore More Free Tools

Related Tools

Country & Tax

More Country & Tax tools

See all

Back to All Tools