e-Invoice APIEnvironment:
API Reference
Overview
Authentication
Get GSTN Details
Get Sync GSTIN From CP
Generate IRN
Get EInvoice Details
Get IRN details by Doc Details
Cancel IRN
Get Rejected IRNs
Generate Ewaybill
Generate EwaybillPOST
Get Ewaybill Details by IRN
Get B2C QR Code Details

Generate e-Way Bill from IRN

POSThttps://apisandbox.whitebooks.in/einvoice/type/GENERATE_EWAYBILL/version/V1_03

Generate the e-waybill using Invoice Reference Number (IRN).

Parameters

query parameters
emailstringrequired
User Email
irpstringoptional
e-Invoice Server Type(NIC1/NIC2),given at the time of e-Invoice generation
header parameters
ip_addressstringrequired
IP Address
client_idstringrequired
Client ID
client_secretstringrequired
Client Secret
usernamestringrequired
User name
auth-tokenstringrequired
Token
gstinstringrequired
GSTIN number

Request Body

application/jsonrequired
Irnstringoptional
Irn number
Example: "47d7ba1814b6ca6123c780ad289b0a24e30c1baed59a7417d29a54e7b00a6bdf"
Distancenumberoptional
Distance
Example: 100
TransModestringoptional
Transaction Mode
Example: "1"
TransIdstringoptional
Transaction Id
Example: "12AWGPV7107B1Z1"
TransNamestringoptional
Transaction Name
Example: "trans name"
TransDocDtstringoptional
Transaction Date
Example: "01/08/2020"
TransDocNostringoptional
Transaction Documnet number
Example: "TRAN/DOC/11"
VehNostringoptional
Vehical Number
Example: "KA12ER1234"
VehTypestringoptional
Vehical Type
Example: "R"
ExpShipDtlsobjectoptional
Addr1stringoptional
Address1
Example: "7th block, kuvempu layout"
Addr2stringoptional
Address2
Example: "kuvempu layout"
Locstringoptional
Location Name
Example: "Banagalore"
Pinnumberoptional
Pincode Number
Example: 562160
Stcdstringoptional
State Name
Example: "29"
DispDtlsobjectoptional
Nmstringoptional
Name
Example: "ABC company pvt ltd"
Addr1stringoptional
Address1
Example: "7th block, kuvempu layout"
Addr2stringoptional
Address2
Example: "kuvempu layout"
Locstringoptional
Location Name
Example: "Banagalore"
Pinnumberoptional
Pincode Number
Example: 562160
Stcdstringoptional
State Name
Example: "29"

Response

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

Frequently Asked Questions

Use this endpoint when an IRN has already been generated without transport details. Instead of re-transmitting buyer, seller, and line-item tax details, you pass the existing Irn along with transport parameters, auto-populating Part-A from the invoice data.
The request payload requires Irn (64-character hash), Distance (numeric transit distance in kilometers), TransMode (1=Road, 2=Rail, 3=Air, 4=Ship), and transporter identification (TransId or VehNo depending on mode).
The IRP verifies distance against PIN-to-PIN transit limits computed by the NIC master database. Passing 0 or a distance exceeding permitted tolerance flags an error unless transit involves multi-hop transportation.
On success, the response returns the EwbNo (12-digit e-way bill number), EwbDt (generation timestamp), and EwbValidTill indicating the validity expiration date and time based on the transit distance.
POST/einvoice/type/GENERATE_EWAYBILL/version/V1_03
1const response = await fetch('https://apisandbox.whitebooks.in/einvoice/type/GENERATE_EWAYBILL/version/V1_03?email=value&irp=value', {
2 method: 'POST',
3 headers: {
4 ip_address: "value",
5 client_id: "value",
6 client_secret: "value",
7 username: "value",
8 auth-token: "value",
9 gstin: "value",
10 Content-Type: "application/json"
11},
12 body: JSON.stringify({
13 "Irn": "47d7ba1814b6ca6123c780ad289b0a24e30c1baed59a7417d29a54e7b00a6bdf",
14 "Distance": 100,
15 "TransMode": "1",
16 "TransId": "12AWGPV7107B1Z1",
17 "TransName": "trans name",
18 "TransDocDt": "01/08/2020",
19 "TransDocNo": "TRAN/DOC/11",
20 "VehNo": "KA12ER1234",
21 "VehType": "R",
22 "ExpShipDtls": {
23 "Addr1": "7th block, kuvempu layout",
24 "Addr2": "kuvempu layout",
25 "Loc": "Banagalore",
26 "Pin": 562160,
27 "Stcd": "29"
28 },
29 "DispDtls": {
30 "Nm": "ABC company pvt ltd",
31 "Addr1": "7th block, kuvempu layout",
32 "Addr2": "kuvempu layout",
33 "Loc": "Banagalore",
34 "Pin": 562160,
35 "Stcd": "29"
36 }
37}),
38});
39
40const data = await response.json();
41console.log(data);
No example available.