# E-Way Bill Bulk Upload JSON Generator

> Source: https://netray.co/tools/e-way-bill-bulk-upload-json-generator-india
> Publisher: Netray (netray.co), AI and integration engineering for ERP and manufacturing systems.
> Section: Free Tools

## Short answer

Fill in the invoice, parties, vehicle and one item line to produce the JSON structure used for bulk generation of e-way bills.

## Category

regional

## Region

India

## Audience

- ERP developer
- Logistics manager
- GST accountant

## Tool

**Kind:** template

**Output:** code

**Language:** json

**Fields:**

#### Your GSTIN (generator)

**Key:** user_gstin

**Type:** text

**Default:** 29ABCDE1234F1Z5

#### Invoice number

**Key:** doc_no

**Type:** text

**Default:** INV/26-27/00418

#### Invoice date (dd/mm/yyyy)

**Key:** doc_date

**Type:** text

**Default:** 19/10/2026

#### Consignor name

**Key:** from_name

**Type:** text

**Default:** Acme Precision Components Pvt Ltd

#### Dispatch place

**Key:** from_place

**Type:** text

**Default:** Bengaluru

#### Dispatch PIN code

**Key:** from_pin

**Type:** text

**Default:** 560058

#### Dispatch state code

**Key:** from_state

**Type:** text

**Default:** 29

#### Consignee GSTIN

**Key:** to_gstin

**Type:** text

**Default:** 33AAAAA0000A1Z5

#### Consignee name

**Key:** to_name

**Type:** text

**Default:** Southern Drives Ltd

#### Delivery place

**Key:** to_place

**Type:** text

**Default:** Chennai

#### Delivery PIN code

**Key:** to_pin

**Type:** text

**Default:** 600032

#### Delivery state code

**Key:** to_state

**Type:** text

**Default:** 33

#### HSN code

**Key:** hsn

**Type:** text

**Default:** 84829900

#### Product name

**Key:** product

**Type:** text

**Default:** Bearing housing

#### Quantity

**Key:** qty

**Type:** number

**Default:** 250

#### Taxable value (Rs)

**Key:** taxable

**Type:** number

**Default:** 185000

#### IGST rate (%)

**Key:** igst_rate

**Type:** number

**Default:** 18

#### Distance in km

**Key:** distance

**Type:** number

**Default:** 350

#### Vehicle number

**Key:** vehicle

**Type:** text

**Default:** KA01AB1234

**Blocks:**

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

**Body:** {
  "version": "1.0.0621",
  "billLists": [
    {
      "userGstin": "{{user_gstin}}",
      "supplyType": "O",
      "subSupplyType": 1,
      "docType": "INV",
      "docNo": "{{doc_no}}",
      "docDate": "{{doc_date}}",
      "fromGstin": "{{user_gstin}}",
      "fromTrdName": "{{from_name}}",
      "fromAddr1": "{{from_place}}",
      "fromPlace": "{{from_place}}",
      "fromPincode": {{from_pin}},
      "fromStateCode": {{from_state}},
      "actualFromStateCode": {{from_state}},
      "toGstin": "{{to_gstin}}",
      "toTrdName": "{{to_name}}",
      "toAddr1": "{{to_place}}",
      "toPlace": "{{to_place}}",
      "toPincode": {{to_pin}},
      "toStateCode": {{to_state}},
      "actualToStateCode": {{to_state}},
      "transactionType": 1,
      "totalValue": {{taxable}},
      "cgstValue": 0,
      "sgstValue": 0,
      "igstValue": 0,
      "cessValue": 0,
      "totInvValue": {{taxable}},
      "transMode": "1",
      "transDistance": "{{distance}}",
      "vehicleNo": "{{vehicle}}",
      "vehicleType": "R",
      "itemList": [
        {
          "productName": "{{product}}",
          "productDesc": "{{product}}",
          "hsnCode": {{hsn}},
          "quantity": {{qty}},
          "qtyUnit": "NOS",
          "taxableAmount": {{taxable}},
          "sgstRate": 0,
          "cgstRate": 0,
          "igstRate": {{igst_rate}},
          "cessRate": 0
        }
      ]
    }
  ]
}

#### Before you upload

**Body:** 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.

**Notes:** 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.

## Content

**Intro:** 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.

**Sections:**

#### How to use the generator

**Body:** 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.

**Bullets:**

- 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

**Body:** 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

**Body:** 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.

**Bullets:**

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

#### ERP notes

**Body:** 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.

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

**Faq:**

#### Is an e-way bill needed for every consignment?

**Answer:** 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?

**Answer:** 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?

**Answer:** 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?

**Answer:** 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.

## Search terms

e-way bill json format, e-way bill bulk upload json, ewb json generator, e-way bill api json sample, generate e-way bill from erp, e-way bill json file upload, e-way bill supply type subsupply type, e-way bill json for sap

---
Talk to an engineer: https://netray.co/contact?intent=erp_ai | Machine catalog: https://netray.co/agent/catalog.json