You can generate bulk EWB for the document types that are not eligible for IRN by sending a PUT request to the E-Invoicing API with the following request headers.
Request Method
PUT
Request URL
{{HOST}}/einv/bulk/v3/ewaybill/generate
Request Headers
Parameter
Data Type
Field Validations
Description
X-Cleartax-Auth-Token
String
NA
Mandatory. The auth token generated from ClearTax user id and password.
Gstin
String
NA
Mandatory. GSTIN number for the user.
Request Path Params
There are no path parameters for this API.
Request Query Params
There are no query parameters for this API.
Request Body
It constitutes of list of EwayBillDocDetailsRequest
EwayBill Doc Details Request
Parameter
Data Type
Field Validations
Description
DocumentNumber
String
Max Length 16
Mandatory. Document number
DocumentType
String
INV = Tax Invoice
BOS = Bill of supply
BOE = Bill of entry
CHL = Delivery challan
OTH = Other
Mandatory Document type
DocumentDate
String
Should in format dd/mm/yyyyy
Mandatory. Document date
SupplyType
String
Inward
Outward
Mandatory. Supply Type
SubSupplyTyp
String
1 or Supply
2 or Import
3 or Export
4 or JOB_WORK
5 or OWN_USE
6 or JOB_WORK_RETURNS
7 or SALES_RETURN
8 or OTH
9 or SKD_CKD_LOTS
10 or LINES_SALES
11 or RECIPIENT_NOT_KNOWN
12 or EXHIBITION_OR_FAIRS
Mandatory. Sub Supply Type
SubSupplyTypeDesc
String
NA
Other Sub Supply Description
TransactionType
String
1 or Regular
2 or Bill to-ship to
3 or Bill from-dispatch from
4 or Combination
Mandatory. Transaction type\
BuyerDtls
Object
NA
Buyer Details
SellerDtls
Object
NA
Seller Details
ExpShipDtls
Object
NA
Shipment Details
DispDtls
Object
NA
Dispatch Details
ItemList
List
NA
Line Item Details
TotalInvoiceAmount
String
Total Invoice value = Taxable amount of the items +
TotalCgstValue + TotalSgstValue + TotalIgstValue
TotalCessAmount + TotalCessNonAdvolAMount +
Other charges at Doc level
(with a grace range of +/- 2)
Mandatory. Total invoice value
TotalCgstAmount
Decimal (18,2)
NA
Conditional. Total CGST value
TotalSgstAmoun
Decimal (18,2)
NA
Conditional. Total SGST value
TotalIgstAmount
Decimal (18,2)
NA
Conditional. Total IGST value
TotalCessAmount
Decimal (18,2)
NA
Optional. Total cess value
TotalCessNonAdvolAmount
Decimal (18,2)
NA
Optional. Cess non Advol value
TotalAssessableAmount
Decimal (18,2)
NA
Optional. Total assessable value
OtherAmount
Decimal (18,2)
NA
Optional. Other values
OtherTcsAmount
Decimal (18,2)
NA
Optional. TCS values
TransId
String
Valid GSTIN
Mandatory for PART-A
Transporter GSTIN or CEN (Common Enrollment Number)
TransName
String
Max Length 100
Mandatory. Transporter name
TransMode
String
Road-1
Rail-2
Air-3
Ship-4
Optional for PART-A otherwise Mandatory
Distance
Number
minimum: 0
maximum: 4000
Mandatory.
Distance between source and destination PIN codes.
If the value is "0" then the distance will be auto-computed by NIC based on the availability of pin-codes in NIC database.
TransDocNo
String
Max Length: 15
Optional when transport mode is ROAD. Transporter document number
TransDocDt
String
Should in format dd/mm/yyyyy
Optional when transport mode is ROAD. Transporter document date
VehNo
String
Valid vehicle number
Mandatory for transport mode ROAD.
VehType
String
REGULAR
ODC
Optional. Vehicle type
Seller, Buyer, Shipping and Dispatch Objects
Parameter
Data Type
Field Validations
Description
Gstin
String
Valid gstin Value/URP
Mandatory. GSTIN number
LglNm
String
Max length of 100
Mandatory. Legal name
TrdNm
String
Max length of 100
Optional. Trade Name
Addr1
String
Max Length 120
Mandatory. Address one
Addr2
String
Max Length 120
Optional. Address two
Loc
String
Max length 50
Mandatory. location
Pin
Integer
valid Pincode
Optional if dispatch details are present otherwise mandatory. Pincode
Stcd
String
valid State code with max value of 2
Mandatory. State code.
Line Item Objects
Parameter
Data Type
Field Validations
Description
ProdName
string
NA
Optional. Product Name
ProdDesc
string
NA
Optional. Product description
HsnCd
Number
NA
Mandatory. Hsn code
Qty
Decimal (8,2)
NA
Mandatory. Quantity
Unit
Text (3)
NA
Mandatory. Unit of measurement
AssAmt
Decimal (18,2)
NA
Mandatory. Assessable amount
CgstRt
Decimal (6,3)
NA
Conditional. CGST rate
CgstAmt
Decimal (18,2)
NA
Optional. CGST Amount
SgstRt
Decimal (6,3)
NA
Conditional. SGST Rate
SgstAmt
Decimal (18,2)
NA
Optional. SGST Amount
IgstRt
Decimal (6,3)
NA
Conditional. IGST Rate
IgstAmt
Decimal (18,2)
NA
Optional. Igst Amount
CesRt
Decimal (6,3)
NA
Optional. Cess Rate
CesAmt
Decimal (18,2)
NA
Optional. Cess amount
OthChrg
Decimal (18,2)
NA
Optional. Other charges
CesNonAdvAmt
Decimal (18,2)
NA
Optional. cess non advol amount
Response Status Codes
HTTP Status Code
Description
200
For a successfully processed request (may be a success or validation error).
401
If the user is not authenticated for the operation.
403
If the user is not authorized for the operation.
500
If there are any unhandled exceptions on the Clear side.
Response Schema
Constitutes of list of EwbDocDetailsResponseBody
Govt response object
Parameter
Data Type
Field Validations
Description
owner_id
String
NA
Its value will be null.
ewb_status
String
Enum: GENERATED, null
Status of generation of EWB
ewb_request
Object
NA
EWB requests details provided in input.
govt_response
Object
NA
Govt response containing EWB generation details.
transaction_id
String
NA
Unique ID created by ClearTax for troubleshooting purposes.
