e-Way Bill Generation API
POST
https://apisandbox.whitebooks.in/ewaybillapi/v1.03/ewayapi/genewaybillGenerate Eway Bill
Dispatch Feature
Explore FeatureOutward Sales e-Way Bill Automation
Auto-generate Part-A and Part-B e-Way Bills directly from sales invoices with pin-to-pin distance auto-calculation.
Parameters
query parameters
emailstringrequiredUser Email
irpstringoptionale-WayBill Server Type(NIC1/NIC2)
header parameters
ip_addressstringrequiredIP Address
client_idstringrequiredClient ID
client_secretstringrequiredClient Secret
usernamestringrequiredUser Name
gstinstringrequiredGSTIN number
Request Body
application/jsonrequired
supplyTypestringrequiredSupply Type
Enum:
OIExample: "O"
subSupplyTypestringrequiredSub Supply Type
Example: "1"
subSupplyDescstringoptionalOther Sub Supply Description
Example: " "
docTypestringrequiredDocument Type
Enum:
INVCHLBILBOECNTOTHExample: "INV"
docNostringrequiredDocument Number (Alphanumeric with / and - are allowed)
Example: "ebill/12/2024"
docDatestringrequiredDocument Date
Example: "11/12/2024"
fromGstinstringrequiredFrom GSTIN (Supplier or Consignor)
Example: "29AAGCB1286Q000"
fromTrdNamestringoptionalFrom Trade Name (Consignor Trade name)
Example: "welton"
fromAddr1stringoptionalFrom Address Line 1 (Valid Special Chars #,-,/)
Example: "2ND CROSS NO 59 19 A"
fromAddr2stringoptionalFrom Address Line 2(Valid Special Chars # , - ,/)
Example: "GROUND FLOOR OSBORNE ROAD"
fromPlacestringoptionalFrom Place
Example: "FRAZER TOWN"
actFromStateCodeintegerrequiredActual From State Code
Example: 29
fromPincodeintegerrequiredFrom Pincode
Example: 560001
fromStateCodeintegerrequiredFrom State Code
Example: 29
toGstinstringrequiredTo GSTIN (Consignee or Recipient)
Example: "05AAACH6188F1ZM"
toTrdNamestringoptionalTo Trade Name (Consignee Trade name or Recipient Trade name)
Example: "sthuthya"
toAddr1stringoptionalTo Address Line 1 (Valid Special Chars #,-,/)
Example: "Shree Nilaya"
toAddr2stringoptionalTo Address Line 2 (Valid Special Chars #,-,/)
Example: "Dasarahosahalli"
toPlacestringoptionalTo Place
Example: "Beml Nagar"
toPincodeintegerrequiredTo Pincode
Example: 263652
actToStateCodeintegerrequiredActual To State Code
Example: 5
toStateCodeintegerrequiredTo State Code
Example: 5
transactionTypeintegerrequiredTransaction type
Example: 4
totalValuenumberoptionalSum of Taxable value and Tax value
Example: 56099
cgstValuenumberoptionalCGST value
Example: 0
sgstValuenumberoptionalSGST value
Example: 0
igstValuenumberoptionalIGST value
Example: 300.67
cessValuenumberoptionalCess value
Example: 400.56
cessNonAdvolValuenumberoptionalCess value
Example: 400
totInvValuenumberrequiredTotal Invoice Value
Example: 57200.23
otherValuenumberoptionalOther charges, if any
Example: 0
transModestringrequiredMode of transport (Road-1, Rail-2, Air-3, Ship-4)
Enum:
1234Example: "1"
transDistancestringrequiredDistance (<4000 km)
Example: "2487"
transporterNamestringoptionalName of the transporter
Example: ""
transporterIdstringoptional15 Digit Transporter GSTIN/TRANSIN
Example: "05AAACG0904A1ZL"
transDocNostringoptionalTransport Document Number (Alphanumeric with / and – are allowed)
Example: "12"
transDocDatestringoptionalTransport Document Date
Example: ""
vehicleNostringoptionalVehicle Number
Example: "APR3214"
vehicleTypestringoptionalVehicle Type
Example: "R"
itemListarray<object>requiredArray items:
productNamestringoptionalProduct / Item Name
Example: "Wheat"
productDescstringoptionalProduct / Item description
Example: "Wheat"
hsnCodenumberoptionalHSN Code
Example: 33030010
quantitynumberoptionalQuantity
Example: 4
qtyUnitstringoptionalUnit
Example: "BOX"
taxableAmountnumberoptionalTaxable Amount
Example: 56099
sgstRatenumberoptionalSGST Rate of Tax
Example: 0
cgstRatenumberoptionalCGST Rate of Tax
Example: 0
igstRatenumberoptionalIGST Rate of Tax
Example: 3
cessRatenumberoptionalCess Rate of Tax
Example: 0
cessNonadvolnumberoptionalCess Non-Advolerum
Example: 0
Response
Not Found. If requested entity is not found or if requested API is not found.
Frequently Asked Questions
Mandatory fields include:
supplyType (e.g. O for Outward, I for Inward), subSupplyType, docType (e.g. INV, CHL), docNo, docDate, fromGstin, fromStateCode, actFromStateCode, fromPincode, toGstin, toStateCode, actToStateCode, toPincode, totInvValue, transDistance, transMode, and itemList.If the vehicle number is unknown at generation time, leave
vehicleNo empty and provide transporterId (15-character GSTIN or TRANSIN). This generates a Part-A slip, allowing the transporter to update vehicle details prior to movement.The sum of
cgstValue, sgstValue, igstValue, cessValue, and line item values in itemList must equal totInvValue within allowed rounding tolerances. Discrepancies between line items and total values cause immediate rejection.All requests require the WhiteBooks Bearer token in the
Authorization header and x-api-key, alongside standard parameters (username, gstin, ip_address). The taxpayer must be registered with WhiteBooks as an active GSP user on the e-Way Bill portal.No example available.