e-Way Bill APIGenerate Eway BillGenerate Eway Bill

Generate Eway Bill

POSThttps://apisandbox.whitebooks.in/ewaybillapi/v1.03/ewayapi/genewaybill

Generate Eway Bill

Parameters

query parameters

emailstringrequired

User Email

irpstringoptional

e-WayBill Server Type(NIC1/NIC2)

header parameters

ip_addressstringrequired

IP Address

client_idstringrequired

Client ID

client_secretstringrequired

Client Secret

gstinstringrequired

GSTIN number

Request Body

application/jsonrequired

supplyTypestringrequired

Supply Type

Enum:OI

Example: "O"

subSupplyTypestringrequired

Sub Supply Type

Example: "1"

subSupplyDescstringoptional

Other Sub Supply Description

Example: " "

docTypestringrequired

Document Type

Enum:INVCHLBILBOECNTOTH

Example: "INV"

docNostringrequired

Document Number (Alphanumeric with / and - are allowed)

Example: "ebill/12/2024"

docDatestringrequired

Document Date

Example: "11/12/2024"

fromGstinstringrequired

From GSTIN (Supplier or Consignor)

Example: "29AAGCB1286Q000"

fromTrdNamestringoptional

From Trade Name (Consignor Trade name)

Example: "welton"

fromAddr1stringoptional

From Address Line 1 (Valid Special Chars #,-,/)

Example: "2ND CROSS NO 59 19 A"

fromAddr2stringoptional

From Address Line 2(Valid Special Chars # , - ,/)

Example: "GROUND FLOOR OSBORNE ROAD"

fromPlacestringoptional

From Place

Example: "FRAZER TOWN"

actFromStateCodeintegerrequired

Actual From State Code

Example: 29

fromPincodeintegerrequired

From Pincode

Example: 560001

fromStateCodeintegerrequired

From State Code

Example: 29

toGstinstringrequired

To GSTIN (Consignee or Recipient)

Example: "05AAACH6188F1ZM"

toTrdNamestringoptional

To Trade Name (Consignee Trade name or Recipient Trade name)

Example: "sthuthya"

toAddr1stringoptional

To Address Line 1 (Valid Special Chars #,-,/)

Example: "Shree Nilaya"

toAddr2stringoptional

To Address Line 2 (Valid Special Chars #,-,/)

Example: "Dasarahosahalli"

toPlacestringoptional

To Place

Example: "Beml Nagar"

toPincodeintegerrequired

To Pincode

Example: 263652

actToStateCodeintegerrequired

Actual To State Code

Example: 5

toStateCodeintegerrequired

To State Code

Example: 5

transactionTypeintegerrequired

Transaction type

Example: 4

totalValuenumberoptional

Sum of Taxable value and Tax value

Example: 56099

cgstValuenumberoptional

CGST value

Example: 0

sgstValuenumberoptional

SGST value

Example: 0

igstValuenumberoptional

IGST value

Example: 300.67

cessValuenumberoptional

Cess value

Example: 400.56

cessNonAdvolValuenumberoptional

Cess value

Example: 400

totInvValuenumberrequired

Total Invoice Value

Example: 57200.23

otherValuenumberoptional

Other charges, if any

Example: 0

transModestringrequired

Mode of transport (Road-1, Rail-2, Air-3, Ship-4)

Enum:1234

Example: "1"

transDistancestringrequired

Distance (<4000 km)

Example: "2487"

transporterNamestringoptional

Name of the transporter

Example: ""

transporterIdstringoptional

15 Digit Transporter GSTIN/TRANSIN

Example: "05AAACG0904A1ZL"

transDocNostringoptional

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

Example: "12"

transDocDatestringoptional

Transport Document Date

Example: ""

vehicleNostringoptional

Vehicle Number

Example: "APR3214"

vehicleTypestringoptional

Vehicle Type

Example: "R"

itemListarray<object>required

Array items:

productNamestringoptional

Product / Item Name

Example: "Wheat"

productDescstringoptional

Product / Item description

Example: "Wheat"

hsnCodenumberoptional

HSN Code

Example: 33030010

quantitynumberoptional

Quantity

Example: 4

qtyUnitstringoptional

Unit

Example: "BOX"

taxableAmountnumberoptional

Taxable Amount

Example: 56099

sgstRatenumberoptional

SGST Rate of Tax

Example: 0

cgstRatenumberoptional

CGST Rate of Tax

Example: 0

igstRatenumberoptional

IGST Rate of Tax

Example: 3

cessRatenumberoptional

Cess Rate of Tax

Example: 0

cessNonadvolnumberoptional

Cess Non-Advolerum

Example: 0

Response

Not Found. If requested entity is not found or if requested API is not found.

POST/ewaybillapi/v1.03/ewayapi/genewaybill

1const response = await fetch('https://apisandbox.whitebooks.in/ewaybillapi/v1.03/ewayapi/genewaybill?email=value&irp=value', {

2 method: 'POST',

3 headers: {

4 ip_address: "value",

5 client_id: "value",

6 client_secret: "value",

7 gstin: "value",

8 Content-Type: "application/json"

9},

10 body: JSON.stringify({

11 "supplyType": "O",

12 "subSupplyType": "1",

13 "subSupplyDesc": " ",

14 "docType": "INV",

15 "docNo": "ebill/12/2024",

16 "docDate": "11/12/2024",

17 "fromGstin": "29AAGCB1286Q000",

18 "fromTrdName": "welton",

19 "fromAddr1": "2ND CROSS NO 59 19 A",

20 "fromAddr2": "GROUND FLOOR OSBORNE ROAD",

21 "fromPlace": "FRAZER TOWN",

22 "actFromStateCode": 29,

23 "fromPincode": 560001,

24 "fromStateCode": 29,

25 "toGstin": "05AAACH6188F1ZM",

26 "toTrdName": "sthuthya",

27 "toAddr1": "Shree Nilaya",

28 "toAddr2": "Dasarahosahalli",

29 "toPlace": "Beml Nagar",

30 "toPincode": 263652,

31 "actToStateCode": 5,

32 "toStateCode": 5,

33 "transactionType": 4,

34 "totalValue": 56099,

35 "cgstValue": 0,

36 "sgstValue": 0,

37 "igstValue": 300.67,

38 "cessValue": 400.56,

39 "cessNonAdvolValue": 400,

40 "totInvValue": 57200.23,

41 "otherValue": 0,

42 "transMode": "1",

43 "transDistance": "2487",

44 "transporterName": "",

45 "transporterId": "05AAACG0904A1ZL",

46 "transDocNo": "12",

47 "transDocDate": "",

48 "vehicleNo": "APR3214",

49 "vehicleType": "R",

50 "itemList": [

51 {

52 "productName": "Wheat",

53 "productDesc": "Wheat",

54 "hsnCode": 33030010,

55 "quantity": 4,

56 "qtyUnit": "BOX",

57 "taxableAmount": 56099,

58 "sgstRate": 0,

59 "cgstRate": 0,

60 "igstRate": 3,

61 "cessRate": 0,

62 "cessNonadvol": 0

63 }

64 ]

65}),

66});

68const data = await response.json();

69console.log(data);

No example available.