Country & TaxFree generatorPDF, Excel, Word exportIndia

E-Way Bill Bulk Upload JSON Generator

Many factories generate e-way bills in bulk from an ERP, either by uploading a JSON file or by calling the e-way bill API. This generator builds a clean sample JSON from your own values so you can see which fields the file needs and test your ERP export.

Fill in

Your GSTIN (generator)

Invoice number

Invoice date (dd/mm/yyyy)

Consignor name

Dispatch place

Dispatch PIN code

Dispatch state code

Consignee GSTIN

Consignee name

Delivery place

Delivery PIN code

Delivery state code

HSN code

Product name

Quantity

Taxable value (Rs)

IGST rate (%)

Distance in km

Vehicle number

Generated code

Download:

Bulk generation JSON (single invoice, inter-state, by road)

{
  "version": "1.0.0621",
  "billLists": [
    {
      "userGstin": "29ABCDE1234F1Z5",
      "supplyType": "O",
      "subSupplyType": 1,
      "docType": "INV",
      "docNo": "INV/26-27/00418",
      "docDate": "19/10/2026",
      "fromGstin": "29ABCDE1234F1Z5",
      "fromTrdName": "Acme Precision Components Pvt Ltd",
      "fromAddr1": "Bengaluru",
      "fromPlace": "Bengaluru",
      "fromPincode": 560058,
      "fromStateCode": 29,
      "actualFromStateCode": 29,
      "toGstin": "33AAAAA0000A1Z5",
      "toTrdName": "Southern Drives Ltd",
      "toAddr1": "Chennai",
      "toPlace": "Chennai",
      "toPincode": 600032,
      "toStateCode": 33,
      "actualToStateCode": 33,
      "transactionType": 1,
      "totalValue": 185000,
      "cgstValue": 0,
      "sgstValue": 0,
      "igstValue": 0,
      "cessValue": 0,
      "totInvValue": 185000,
      "transMode": "1",
      "transDistance": "350",
      "vehicleNo": "KA01AB1234",
      "vehicleType": "R",
      "itemList": [
        {
          "productName": "Bearing housing",
          "productDesc": "Bearing housing",
          "hsnCode": 84829900,
          "quantity": 250,
          "qtyUnit": "NOS",
          "taxableAmount": 185000,
          "sgstRate": 0,
          "cgstRate": 0,
          "igstRate": 18,
          "cessRate": 0
        }
      ]
    }
  ]
}

Before you upload

Replace the zero tax amounts in the header with your computed IGST (or CGST and SGST for an intra-state move) and set totInvValue to the full invoice value. Add one object to itemList for each HSN line. Validate the file with the offline JSON tool on the e-way bill portal.

Field names follow the structure of the portal's bulk upload format as commonly published, but the schema version changes. Download the current sample from the e-way bill portal and compare names, data types and master codes before use. Not for submission without validation.

E-way bill integration review

Optional: a short review of how your ERP produces e-way bill data and where it breaks.

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

How to use the generator

Fill in the invoice, the two parties, the item, and the vehicle. The JSON updates as you type. Copy it into a file, replace the zero tax values in the header with your computed amounts, then upload it with the offline tool on the e-way bill portal or use it as the model for your own export program. For many invoices, repeat the object inside billLists.

Set supplyType O for outward and I for inward
subSupplyType 1 means supply
docType INV is a tax invoice
transMode 1 is road

How the bill is structured

The bill has a header with parties, document, values, and transport fields. Each item sits in itemList with its HSN, quantity, unit and taxable amount. Place of dispatch and delivery use PIN codes and state codes, and distance is the approximate road distance used to set validity. Supplying Part B (vehicle number) can be deferred if you use a transporter ID instead of a vehicle number.

Common upload errors

Frequent rejections include a wrong date format (it must be dd/mm/yyyy), a PIN code that does not match the state code, an HSN missing digits, and totals that do not equal the sum of the items plus taxes. Keep rounding consistent between the ERP and the file. Mixing intra-state and inter-state tax in one bill also causes failures.

Check PIN to state code match
Confirm the units against the master list
Keep total value equal to items plus tax

ERP notes

SAP, Oracle, Tally, Busy and Dynamics solutions typically offer a GST add-on or localisation that sends e-way bills directly. If you build your own export, produce the JSON from the billing document, not from a manual sheet, so the invoice number and amounts always match.

Frequently Asked Questions

Is an e-way bill needed for every consignment?

Generally for movement of goods above a value limit, with various exceptions listed in the rules. The value limit and the exemptions change, so check the current rule. Many states also have their own thresholds for intra-state movement.

Can I use this JSON for the API?

The API uses similar fields, but the exact payload, authentication and encryption differ from the bulk upload file. Use this as a field reference and follow the API documentation from the e-way bill system for the live call.

What does transDistance control?

The distance is used to calculate how long the e-way bill is valid, with a fixed number of days per set number of kilometres. If the portal calculates a different distance from the one you enter, it may warn you or reject the entry.

How do I add more items?

Add one more object to the itemList array for each HSN line, with its own quantity and taxable amount. Make sure the header totals equal the sum of all items plus the taxes, or the portal will flag a mismatch.

If your ERP does not generate e-way bills cleanly, we can help design an export or API integration with human review before submission.

Talk to an Expert Explore More Free Tools

Related Tools

Country & Tax

More Country & Tax tools

See all

Back to All Tools