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}}
PARAMETERPARAM TYPETYPEDESCRIPTION

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

PARAMETERDATA TYPEDESCRIPTION

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

{
    "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

{
    "EwbNumber": 251009955228,
    "UpdatedDate": "24/02/2023 01:14:00 PM",
    "ValidUpto": "25/02/2023 11:59:00 PM",
    "errors": null
}
{
  "errors": {
    "error_code": "7001",
    "error_message": "Invalid Vehicle Number, Vehicle number length should be between 7 and 15 ",
    "error_source": "CLEARTAX"
  }
}

Last updated