Generate E-Way Bill

Generate E-Way Bill

curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/e-way-bill/consignor/bill \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "supplyType": "O",
  "subSupplyType": "1",
  "subSupplyDesc": "",
  "docType": "INV",
  "docNo": "7001-11",
  "docDate": "15/12/2017",
  "fromGstin": "29AAACQ3770E000",
  "fromTrdName": "welton",
  "fromAddr1": "2ND CROSS NO 59 19 A",
  "fromAddr2": "GROUND FLOOR OSBORNE ROAD",
  "fromPlace": "FRAZER TOWN",
  "fromPincode": 400027,
  "actFromStateCode": 27,
  "fromStateCode": 27,
  "toGstin": "27AAACQ3770E000",
  "toTrdName": "sthuthya",
  "toAddr1": "Shree Nilaya",
  "toAddr2": "Dasarahosahalli",
  "toPlace": "Beml Nagar",
  "toPincode": 560090,
  "actToStateCode": 29,
  "toStateCode": 29,
  "transactionType": 4,
  "otherValue": 0,
  "totalValue": 56099,
  "cgstValue": 0,
  "sgstValue": 0,
  "igstValue": 1682.97,
  "cessValue": 1682.97,
  "cessNonAdvolValue": 0,
  "totInvValue": 59464.94,
  "transporterId": "27AAACQ3770E004",
  "transporterName": "",
  "transDocNo": "",
  "transMode": "1",
  "transDistance": "1000",
  "transDocDate": "",
  "vehicleNo": "PVC1234",
  "vehicleType": "R",
  "itemList": [
    {
      "productName": "Wheat",
      "productDesc": "Wheat",
      "hsnCode": 1001,
      "quantity": 4,
      "qtyUnit": "BOX",
      "cgstRate": 0,
      "sgstRate": 0,
      "igstRate": 3,
      "cessRate": 3,
      "cessNonadvol": 0,
      "taxableAmount": 56099
    }
  ]
}
'

{
  "code": 200,
  "data": {
    "alert": null,
    "data": {
      "alert": "",
      "ewayBillDate": "01/05/2024 07:04:00 PM",
      "ewayBillNo": 201010077008,
      "validUpto": "06/05/2024 11:59:00 PM"
    },
    "status": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "36c013cf-1fc3-4f4e-80e9-bd30ed519375"
}

POST

gst

compliance

e-way-bill

consignor

bill

Generate E-Way Bill

curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/e-way-bill/consignor/bill \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "supplyType": "O",
  "subSupplyType": "1",
  "subSupplyDesc": "",
  "docType": "INV",
  "docNo": "7001-11",
  "docDate": "15/12/2017",
  "fromGstin": "29AAACQ3770E000",
  "fromTrdName": "welton",
  "fromAddr1": "2ND CROSS NO 59 19 A",
  "fromAddr2": "GROUND FLOOR OSBORNE ROAD",
  "fromPlace": "FRAZER TOWN",
  "fromPincode": 400027,
  "actFromStateCode": 27,
  "fromStateCode": 27,
  "toGstin": "27AAACQ3770E000",
  "toTrdName": "sthuthya",
  "toAddr1": "Shree Nilaya",
  "toAddr2": "Dasarahosahalli",
  "toPlace": "Beml Nagar",
  "toPincode": 560090,
  "actToStateCode": 29,
  "toStateCode": 29,
  "transactionType": 4,
  "otherValue": 0,
  "totalValue": 56099,
  "cgstValue": 0,
  "sgstValue": 0,
  "igstValue": 1682.97,
  "cessValue": 1682.97,
  "cessNonAdvolValue": 0,
  "totInvValue": 59464.94,
  "transporterId": "27AAACQ3770E004",
  "transporterName": "",
  "transDocNo": "",
  "transMode": "1",
  "transDistance": "1000",
  "transDocDate": "",
  "vehicleNo": "PVC1234",
  "vehicleType": "R",
  "itemList": [
    {
      "productName": "Wheat",
      "productDesc": "Wheat",
      "hsnCode": 1001,
      "quantity": 4,
      "qtyUnit": "BOX",
      "cgstRate": 0,
      "sgstRate": 0,
      "igstRate": 3,
      "cessRate": 3,
      "cessNonadvol": 0,
      "taxableAmount": 56099
    }
  ]
}
'

{
  "code": 200,
  "data": {
    "alert": null,
    "data": {
      "alert": "",
      "ewayBillDate": "01/05/2024 07:04:00 PM",
      "ewayBillNo": 201010077008,
      "validUpto": "06/05/2024 11:59:00 PM"
    },
    "status": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "36c013cf-1fc3-4f4e-80e9-bd30ed519375"
}

Headers

Authorization

string

required

E-Way Bill access token

x-api-version

string

default:1.0.0

API version

x-api-key

string

required

API key for identification

Body

application/json

RAW_BODY

object

required

JSON Body to generate E-Way Bill

Show child attributes

RAW_BODY.supplyType

string

required

Supply Type. Possible values: O, I

RAW_BODY.subSupplyType

string

required

Sub types of Supply

RAW_BODY.docType

string

required

Document Type Possible value - INV : Tax Invoice BIL : Bill of Supply BOE : Bill of Entry CHL : Delivery Challan OTH : Others

RAW_BODY.docNo

string

required

Document No

RAW_BODY.docDate

string

required

Document Date

RAW_BODY.fromGstin

string

required

GSTIN of the supplier/consignor

RAW_BODY.actFromStateCode

integer<int32>

required

Actual From State Code

RAW_BODY.fromPincode

integer<int32>

required

From Pincode

RAW_BODY.fromStateCode

integer<int32>

required

From State Code

RAW_BODY.toGstin

string

required

GSTIN of the recipient/consignee. In case of unregistered person, pass "URP"

RAW_BODY.toPincode

integer<int32>

required

To Pincode

RAW_BODY.actToStateCode

integer<int32>

required

Actual To State Code

RAW_BODY.toStateCode

integer<int32>

required

To State Code

RAW_BODY.transactionType

integer<int32>

required

Transaction type

RAW_BODY.totInvValue

number<float>

required

Total Invoice Value

RAW_BODY.transDistance

string

required

Distance (<4000 km)

RAW_BODY.subSypplyDesc

string

Sub Supply Description if selected “Others” in subSupplyType

RAW_BODY.fromTrdName

string

Trade Name of supplier/consignor

RAW_BODY.fromAddr1

string

From Address Line 1

RAW_BODY.fromAddr2

string

From Address Line 2

RAW_BODY.fromPlace

string

From Place

RAW_BODY.toTrdName

string

Trade name of the recipient/consignee

RAW_BODY.toAddr1

string

To Address Line 1

RAW_BODY.toAddr2

string

To Address Line 2

RAW_BODY.toPlace

string

To Place

RAW_BODY.totalValue

number<float>

Sum of Taxable value

RAW_BODY.cgstValue

number<float>

CGST value

RAW_BODY.sgstValue

number<float>

SGST value

RAW_BODY.igstValue

number<float>

IGST value

RAW_BODY.cessValue

number<float>

Cess value

RAW_BODY.cessNonAdvolValue

number<float>

Cess Non Advol value

RAW_BODY.otherValue

number<float>

Other charges, if any

RAW_BODY.transMode

string

Mode of transport. Possible values: 1 - Road, 2 - Rail, 3 - Air, 4 - Ship

RAW_BODY.transporterName

string

Name of the transporter

RAW_BODY.transporterId

string

15 Digit Transporter GSTIN/TRANSIN

RAW_BODY.transDocNo

string

Transport Document Number (Alphanumeric with / and – are allowed)

RAW_BODY.transDocDate

string

Transport Document Date

RAW_BODY.vehicleNo

string

Vehicle Number

RAW_BODY.vehicleType

string

Vehicle Type

RAW_BODY.itemList

object[]

Array of items

Show child attributes

RAW_BODY.itemList.hsnCode

integer<int32>

required

HSN Code

RAW_BODY.itemList.taxableAmount

number<float>

required

Taxable Amount

RAW_BODY.itemList.productName

string

Product / Item Name

RAW_BODY.itemList.productDesc

string

Product / Item description

RAW_BODY.itemList.quantity

integer<int32>

Quantity

RAW_BODY.itemList.qtyUnit

string

Unit

RAW_BODY.itemList.sgstRate

number<float>

SGST Rate

RAW_BODY.itemList.cgstRate

number<float>

CGST Rate

RAW_BODY.itemList.igstRate

number<float>

IGST Rate

RAW_BODY.itemList.cessRate

number<float>

Cess Rate

RAW_BODY.itemList.cessNonadvol

number<float>

Cess Non-Advolerum

Response

200 - application/json

212 Invalid Consignee GSTIN / 702 Distance between pincodes is too high or low / 200 EWB generated with alert / 604 Duplicate EWB / 620 Invoice value cannot be less than sum of items / 200 EWB generated / 359 User GSTIN should match from GSTIN / 619 Transporter Id is mandatory for Part A

code

number

Example:

200

data

object

Show child attributes

data.alert

unknown

data.data

object

Show child attributes

data.data.alert

string

Example:

"Total invoice value is more than the sum of total assessible value and tax values, "

data.data.ewayBillDate

string

Example:

"01/05/2024 07:00:00 PM"

data.data.ewayBillNo

number

Example:

291010077005

data.data.validUpto

string

Example:

"06/05/2024 11:59:00 PM"

data.error

object

Show child attributes

data.error.errorCodes

string

Example:

"212,"

data.info

string

Example:

""

data.status

string

Example:

"0"

timestamp

number

Example:

1763446641000

transaction_id

string

Example:

"52d7e713-2b65-4a8f-9126-16af4e28ec59"

E-Way Bill Authentication

Get E-Way Bills By Date

⌘I

Analytics

Compliance

Headers

Body

Response