Extend E-Waybill Validity

You can Extend Validity an EWB by sending a POST request to E-Invoicing API with the following request headers.

Request Method

POST

Request URL

{{HOST}}/einv/v1/ewaybill/update?action={{action}}

Request Headers

Parameter	Data Type	Field Validations	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 Path Params

There are no path parameters for this API.

Request Query Params

Parameter	Data Type	Field Validations	Description
Parameter	Data Type	Field Validations
action	String	NA	Mandatory = EXTEND_VALIDITY

Request Body

Parameter	Data Type	Field Validations	Description
EwbNumber	Number	12 Digits	Mandatory. E-Way Bill Number
VehNo	Number	15 Digits	Conditional. Required where mode of transport is Road. Vehicle Number
FromPlace	String	12 Characters	Mandatory. From Place
FromState	Number	2 Digits	Mandatory. From State Code
ReasonCode	Enum	"NATURAL_CALAMITY", "TRANSSHIPMENT", "OTHERS", "ACCIDENT", "LAW_ORDER_SITUATION"	Mandatory, Reasons code
ReasonRemark	String	50 Characters	Mandatory. Reason Remark
TransDocNo	String	15 Characters	Optional. Transport Document Number
TransDocDt	String	dd/mm/yyyy	Optional. Transport Document Date
TransMode	Enum	[ROAD RAIL AIR SHIP IN_TRANSIT]	Mandatory. Transport Mode
RemainingDistance	Number	NA	Mandatory. Remaining Distance
FromPincode	Number	2 Digits	Mandatory. From Pincode
ConsignmentStatus	Enum	[MOVEMENT TRANSIT]	Mandatory. Consignment Status
TransitType	Enum	[ROAD WAREHOUSE OTHERS NONE]	Optional. Transit Type
AddressLine1	String	NA	Optional. Address 1
AddressLine2	String	NA	Optional. Address 1
AddressLine3	String	NA	Optional. Address 3

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 authorised for the operation.
500	If there are any unhandled exceptions on the Clear side.

Response Schema

Parameter	Data Type	Field Validations	Description
EwbNumber	Number	12 Digits	E-Way Bill number
UpdatedDate	String	NA	Date and time of update. This will be null in case of failure.
ValidUpto	String	NA	Date and time of upto which EWB is valid. This will be null in case of failure.
errors	List	NA	This will be null if there will be no error.

Errors Object

Parameter	Data Type	Field Validations	Description
error_code	Number	NA	Error Code. If there is no error, then this field will not be present.
error_message	String	NA	Error message. If there is no error, then this field will not be present.
error_source	String	NA	Error Source. If there is no error, then this field will not be present.

Sample Request and Response

Request

{
    "EwbNumber": 251009955228,
    "FromPlace": "Bangalore",
    "FromState": "29",
    "FromPincode": "560037",
    "ReasonCode": "OTHERS",
    "ReasonRemark": "extend validity",
    "TransDocNo": "TD-3",
    "TransDocDt": "22/02/2023",
    "TransMode": "ROAD",
    "RemainingDistance": "20",
    "ConsignmentStatus": "MOVEMENT",
    "VehNo": "MH45YY2356"
}

Response - Success:

HTTP Status Code - 200

{
    "EwbNumber": 251009955228,
    "UpdatedDate": "24/02/2023 01:14:00 PM",
    "ValidUpto": "25/02/2023 11:59:00 PM",
    "errors": null
}

Response - Failure:

HTTP Status Code - 200

{
    "errors": {
        "error_code": "7001",
        "error_message": "Invalid Vehicle Number, Vehicle number length should be between 7 and 15 ",
        "error_source": "CLEARTAX"
    }
}

API Validations

Currently there are no known validations for this API.

API Constraints

1. The Validity of EWB can be extended only by the current transporter. If the transporter is not assigned, then the generator can update.

2. The validity of EWB can be extended between 8 hours before expiry time and 8 hours after expiry time.