Generate E-Way Bill

Overview

  • This API takes in GSTIN and generates E-Way Bill.

Problem

  • Having an E-way bill is required to ensure that goods being transported comply with the GST Law and is an effective tool to track movement of goods and check tax evasion.

Solution

  • Use this API to generate E-Way bill which is required to transport all the goods except exempted under the notifications or rules.

Endpoint

HTTP MethodResource
Post

API EndpointAPI Endpoint

Path Parameters

ParamTypeDescriptionExample
gstinstring15-character alpha-numeric unique identifier assigned to business entities registering under the GST regimeAAAAA0000A

Query Parameters

Param

Type

Description

Examples

supplyType

string

Supply whether it is outward/inward.
Possible value -
I : Inward
O : Outward

Outward

subSupplyType

string

Sub types of Supply
Possible value -
1 : Supply
2 : Import
3 : Export
4 : Job Work
5 : For own use
6 : Job Work Returns
7 : Sales Return
8 : Others
9 : SKD/CKD/Lots
10 : Line Sales
11 : Recipient not known
12 : Exhibition or Fairs

Import

subSypplyDesc

string

Sub Supply Description if selected β€œOthers” in subSupplyType

docType

string

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

Delivery Challan

docNo

string

Document No

12

docDate

string

Document Date

12/09/2017

fromGstin

string

GSTIN of the Consignor

29AAAAA0300L1Z8

fromTrdName

string

LegalName of consignor

ABHYUDHYA CO OP BANK

fromAddr1

string

Address of consignor - Line 1

Shambhai Fortune

fromAddr2

string

Address of consignor - Line 2

Behind KSRTC Bus Stop

fromPlace

string

Place of consignor

Bengaluru

fromPincode

num

Pin code of consignor

576101

fromStateCode

num

State of consignor
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY

KARNATAKA

actFromStateCode

num

State of Supply
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY

CHANDIGARH

toGstin

string

GSTIN of consignee

29ACGPI2251K1ZJ

toTrdname

string

Legal name of consignee

INDER CHHAJER

toAddr1

string

Address of consignee - Line 1

PRIYADARSHANI LAYOUT

toAddr2

string

Address of consignee- Line 2

MUDALAYAPALYA

toPlace

string

Place of consignee

Bengaluru

toPincode

num

Pincode of the consignee

560072

toStateCode

num

State of Supply
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY

actToStateCode

num

State of Supply
Possible value -
1 : JAMMU AND KASHMIR
2 : HIMACHAL PRADESH
3 : PUNJAB
4 : CHANDIGARH
5 : UTTARAKHAND
6 : HARYANA
7 : DELHI
8 : RAJASTHAN
9 : UTTAR PRADESH
10 : BIHAR
11 : SIKKIM
12 : ARUNACHAL PRADESH
13 : NAGALAND
14 : MANIPUR
15 : MIZORAM
16 : TRIPURA
17 : MEGHALAYA
18 : ASSAM
19 : WEST BENGAL
20 : JHARKHAND
21 : ORRISA
22 : CHATTISGARH
23 : MADHYA PRADESH
24 : GUJARAT
26 : DADAR AND NAGAR HAVELI & DAMAN AND DIU
27 : MAHARASHTRA
29 : KARNATAKA
30 : GOA
31 : LAKSHADWEEP
32 : KERELA
33 : TAMIL NADU
34 : PUDUCHERRY
35 : ANDAMAN AND NICOBAR
36 : TELENGANA
37 : ANDHRA PRADESH
38 : LADAKH
97 : OTHER TERRITORY
99 : OTHER COUNTRY

transactionType

num

Type of transaction
Possible value -
1 : Regular
2 : Bill To - Ship To
3 : Bill From - Dispatch From
4 : Combination of 2 and 3

1

otherValue

num

Other Charges if any

2000

totalValue

num

Sum of Taxable value

2000

totInvValue

num

Total Invoice Value

cgstValue

num

CGST Amount

0

sgstValue

num

SGST Amount

0

igstValue

num

IGST Amount

240

cessValue

num

CESS Amount

20

cessNonAdvolValue

num

CESS Non Advol Amount

20

transMode

num

Mode of transportation
Possible value -
1 : Road
2 : Rail
3 : Air
4 : Ship
5 : inTransit

1

VehicleType

char

Type of Vehicle
Possible value -
R : Regular
O : ODC(Over Dimensional Cargo)

R

transDistance

num

Distance of transportation

10

transporterId

string

Transporter Id

29BQSPA3829E1Z0

transporterName

string

Transporter Name

TAPURI

transDocNo

string

Transporter Doc No

11

transDocDate

string

Transporter Doc Date

13/09/2017

vehicleNo

string

Vehicle No.
Possible value -

  1. AB121234 (First 2 char are State Code)
  2. AB12A1234 (First 2 char are State Code)
  3. AB12AB1234 (First 2 char are State Code)
  4. ABC1234
  5. AB123A1234 (First 2 char are State Code)
  6. AB12ABC1234 (First 2 char are State Code)
  7. DFXXXXXX (Defence Vehicle)
  8. TMXXXXXXXXXXXXX (Temp RC) At least 7 characters
  9. BPXXXXXXXXXXXXX (Bhutan Vehicle) At least 7 characters
  10. NPXXXXXXXXXXXXX (Nepal Vehicle) At least 7 characters

KA12BL4567

productName

string

Name of the Product

Steel

productDesc

string

Description of the Product

5 mm Rod

hsnCode

num

HSN Code of the Product

10101

quantity

num

Quantity of Product in Numbers

200

qtyUnit

string

Unit of the Product, like Liter,Kg etc
Possible value -
BAG : BAGS
BAL : BALE
BDL : BUNDLES
BKL : BUCKLES
BOU : BILLION OF UNITS
BOX : BOX
BTL : BOTTLES
BUN : BUNCHES
CAN : CANS
CBM : CUBIC METERS
CCM : CUBIC CENTIMETERS
CMS : CENTI METERS
CTN : CARTONS
DOZ : DOZENS
DRM : DRUMS
GGK : GREAT GROSS
GMS : GRAMMES
GRS : GROSS
GYD : GROSS YARDS
KGS : KILOGRAMS
KLR : KILOLITRE
KME : KILOMETRE
LTR : LITRES
MTR : METERS
MLT : MILILITRE
MTS : METRIC TON
NOS : NUMBERS
OTH : OTHERS
PAC : PACKS
PCS : PIECES
PRS : PAIRS
QTL : QUINTAL
ROL : ROLLS
SET : SETS
SQF : SQUARE FEET
SQM : SQUARE METERS
SQY : SQUARE YARDS
TBS : TABLETS
TGM : TEN GROSS
THD : THOUSANDS
TON : TONNES
TUB : TUBES
UGS : US GALLONS
UNT : UNITS
YDS : YARDS

QTS

taxableAmount

num

Taxable Amount

100000

cgstRate

num

CGST Rate

9

sgstRate

num

SGST Rate

9

igstRate

num

IGST Rate

18

cessRate

num

CESS Rate

0

cessNonadvol

num

Cess Non-Advolerum

0

Once the values are added, Your curl will look something like this

curl --request POST \
     --url https://api.sandbox.co.in/13 \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-api-version: 1.0' \
     --data '
{
     "Raw Body": {
          "supplyType": "O",
          "subSupplyType": "1",
          "subSupplyDesc": "",
          "docType": "INV",
          "docNo": "7001-8",
          "docDate": "15/12/2017",
          "fromGstin": "29AKLPM8755F1Z2",
          "fromTrdName": "welton",
          "fromAddr1": "2ND CROSS NO 59  19  A",
          "fromAddr2": "GROUND FLOOR OSBORNE ROAD",
          "fromPlace": "FRAZER TOWN",
          "fromPincode": 560090,
          "actFromStateCode": 29,
          "fromStateCode": 29,
          "toGstin": "02EHFPS5910D2Z0",
          "toTrdName": "sthuthya",
          "toAddr1": "Shree Nilaya",
          "toAddr2": "Dasarahosahalli",
          "toPlace": "Beml Nagar",
          "toPincode": 560090,
          "actToStateCode": 29,
          "toStateCode": 27,
          "transactionType": 4,
          "otherValue": "-100",
          "totalValue": 56099,
          "cgstValue": 0,
          "sgstValue": 0,
          "igstValue": 300.67,
          "cessValue": 400.56,
          "cessNonAdvolValue": 400,
          "totInvValue": 68358,
          "transporterId": "",
          "transporterName": "",
          "transDocNo": "",
          "transMode": "1",
          "transDistance": "100",
          "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": 5609889
               }
          ]
     }
}
'

Response

ParamTypeDescriptionExample
ewaybillnostringRefers to E-way bill number123456789012
ewayBillDatenumRefers to date when E-way bill is generated25/09/2018 10:30:00 AM
validUptonumRefers to valid date of E-way Bill26/09/2018 12.00:00 PM
alertRefers to any kind of alert

Did this page help you?