Extend E-Waybill Validity

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

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

Request URL

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

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
action	Query	String	Mandatory. Value = EXTEND_VALIDITY

Request Parameter

EXTEND VALIDITY

PARAMETER	DATA TYPE	DESCRIPTION
EwbNumber	Number(min=12, max=12)	Mandatory. EWB Number
VehNo	String(min= 7, max = 15)	Optional. Vehicle Number
FromPlace	String(max = 50)	Mandatory. From Place
FromState	Number(max = 2)	Mandatory. From State Code
ReasonCode	ENUM: Reasons to extend validity: "NATURAL_CALAMITY", "TRANSSHIPMENT", "OTHERS", "ACCIDENT", "LAW_ORDER_SITUATION"	Mandatory. Reason Code
ReasonRemark	String(max = 50)	Mandatory. Reason Remark
TransDocNo	String(max = 15)	Optional. Transport Document Number
TransDocDt	String(dd/mm/yyyy)	Optional. Transport Doucment Date
TransMode	ENUM[ROAD RAIL AIR SHIP IN_TRANSIT]	Mandatory. Transport Mode
VehicleType	Enum[Regular ODC]	Not Required. Vehicle Type
TransporterId	String(max = 15)	Not Required. Transported GSTIN
RemainingDistance	Number	Mandatory. Remaining Distance
FromPincode	Number (min = 6, max = 6)	Mandatory. From Pincode
ConsignmentStatus	Enum[MOVEMENT, TRANSIT]	Mandatory. Consignment Status
TransitType	Enum[ROAD WAREHOUSE OTHERS NONE	Conditional. Transit Type
AddressLine1	String	Conditional. Address 1
AddressLine2	String	Conditional. Address 2
AddressLine3	String	Conditional. Address 3

Sample Request

JSON

{
    "EwbNumber": 251009955228,
    "FromPlace": "Bangalore",
    "FromState": "29",
    "FromPincode" : "560037",
    "ReasonCode": "OTHERS",
    "ReasonRemark": "extend validity",
    "TransDocNo": "TD-3",
    "TransDocDt": "22/02/2023",
    "TransMode": "ROAD",
    "DocumentNumber": "RLK116",
    "DocumentType": "INV",
    "RemainingDistance": "20",
    "ConsignmentStatus" : "MOVEMENT",
    "DocumentDate": "03/09/2021",
    "VehicleType": "REGULAR",
    "VehNo": "MH45YY2356"

}

Sample Response

SUCCESS RESPONSE

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

ERROR RESPONSE

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