Initiate Multi-Vehicle E-Waybills

You can update Multi-Vehicle E-Waybills by sending a PUT request to E-Invoicing API with the following request headers.

Request URL

PUT: {{HOST}}/einv/v1/ewaybill/multi-vehicle

Request Headers

x-cleartax-auth-token: {{USER_AUTH_TOKEN}}
gstin:{{gstin_number}}

PARAMETER	PARAM TYPE	TYPE	DESCRIPTION
X-Cleartax-Auth-Token	Header	String	Mandatory. The auth token generated from ClearTax user id and password. Know how.
gstin	Header	String	Mandatory. GSTIN number for the user

Request Parameter

PARAMETER	DESCRIPTION	DATA TYPE	MULTI-VEHICLE EWB
VehNo	Vehicle Number	String(min= 7, max = 15)	Conditional
FromPlace	From Place	String(max = 50)	Mandatory
FromState	From State Code	Number(max = 2)	Mandatory
ToPlace	To Place	String(max = 50)	Mandatory
ToState	To State Code	Number(max = 2)	Mandatory
ReasonCode	Reason Code	BREAKDOWN TRANSSHIPMENT OTHERS FIRST_TIME NATURAL_CALAMITY LAW_ORDER_SITUATION ACCIDENT	Not Required
ReasonRemark	Reason Remark	String(max = 50)	Not Required
TransMode	Transport Mode	ROAD RAIL AIR SHIP	Mandatory
TotalQuantity	Total Quantity	Number	Mandatory
UnitOfMeasurement	Unit of measurement	String	Mandatory
GroupNumber	Group number	Number	Mandatory. Group number should always be 0 to initiate multivehicle EWB.

Sample Request

{
    "EwbNumber": 171009166265,
    "FromPlace": "Bangalore",
    "FromState": 29,
    "ToPlace": "Mumbai",
    "ToState": 33,
    "ReasonCode": "BREAKDOWN",
    "ReasonRemark": "random",
    "TransMode": "ROAD",
    "TotalQuantity": 100.345,
    "UnitOfMeasurement": "BAG",
    "GroupNumber": 0,
    "VehicleListDetails": [
      {
        "VehicleNo": "KA12AS1234",
        "DocumentNumber": "23DF34FG45",
        "DocumentDate": "12/12/2020",
        "Quantity": 100.345
      }
    ]
}

Sample Response

JSON Response - SUCCESS

{
    "EwbNumber": 171009166265,
    "GroupNumber": 1,
    "UpdatedDate": "08/02/2021 12:03:00 PM",
    "errors": null
}

JSON Response - FAILURE

{
    "EwbNumber": null,
    "GroupNumber": 0,
    "UpdatedDate": null,
    "errors": [
        {
            "error_code": "2000",
            "error_message": "Quantity in Group cannot exceed total quantity in E-Way Bill.",
            "error_source": "CLEARTAX"
        }
    ]
}