Generate E-Waybill by IRN

You can use this API to generate the e-waybill using the Invoice Registration Number (IRN).

Request URL

POST: {{HOST}}/einv/v2/eInvoice/ewaybill

Request Headers

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

Maximum up to 5 E-waybills can be generated in one request.

Sample Request

[
    {
        "Irn": "637562682b152bf0ab84c55af2af983637e4952fb80d77e3a521e4d7fda67a6d",
        "Distance": 0,
        "TransMode": "1",
        "TransId": "12AWGPV7107B1Z1",
        "TransName": "trans name",
        "TransDocDt": "24/06/2024",
        "TransDocNo": "TRAN/DOC/11",
        "VehNo": "KA12ER1234",
        "VehType": "R",
        "ExpShipDtls": {
            "Addr1": "7th block, kuvempu layout",
            "Addr2": "kuvempu layout",
            "Loc": "Banagalore",
            "Pin": 562160,
            "Stcd": "29"
        },
        "DispDtls": {
            "Nm": "ABC company pvt ltd",
            "Addr1": "7th block, kuvempu layout",
            "Addr2": "kuvempu layout",
            "Loc": "Banagalore",
            "Pin": 560027,
            "Stcd": "29"
        },
        "CustomFields": {
            "company number": "104"
        }
    }
]

Sample Response

Valid Response

[
    {
        "TransId": "12AWGPV7107B1Z1",
        "TransName": "trans name",
        "TransMode": "1",
        "Distance": 0,
        "TransDocNo": "TRAN/DOC/11",
        "TransDocDt": "24/06/2024",
        "VehNo": "KA12ER1234",
        "VehType": "R",
        "Irn": "637562682b152bf0ab84c55af2af983637e4952fb80d77e3a521e4d7fda67a6d",
        "ExpShipDtls": {
            "Addr1": "7th block, kuvempu layout",
            "Addr2": "kuvempu layout",
            "Loc": "Banagalore",
            "Pin": 562160,
            "Stcd": "29"
        },
        "DispDtls": {
            "Nm": "ABC company pvt ltd",
            "Addr1": "7th block, kuvempu layout",
            "Addr2": "kuvempu layout",
            "Loc": "Banagalore",
            "Pin": 560027,
            "Stcd": "29"
        },
        "CustomFields": {
            "company number": "104"
        },
        "govt_response": {
            "Success": "Y",
            "AckNo": 112410192675304,
            "AckDt": "2024-07-10 13:17:00",
            "Irn": "637562682b152bf0ab84c55af2af983637e4952fb80d77e3a521e4d7fda67a6d",
            "Status": "GENERATED",
            "EwbNo": 191010506050,
            "EwbDt": "2024-07-10 13:18:00",
            "EwbValidTill": "2024-07-11 23:59:00",
            "info": [
                {
                    "InfCd": "EWBPPD",
                    "Desc": "Pin-Pin calc distance: 61KM"
                }
            ]
        },
        "ewb_status": "GENERATED"
    }
]

Invalid Response

[
    {
        "TransId": "12AWGPV7107B1Z1",
        "TransName": "trans name",
        "TransMode": "1",
        "Distance": 50,
        "TransDocNo": "TRAN/DOC/11",
        "TransDocDt": "17/09/2020",
        "VehNo": "KA12ER1234",
        "VehType": "R",
        "Irn": "df07551a655978d790d4acab84b848afce5dcd3f574b5fdccdc17a3526686bf4",
        "govt_response": {
            "Success": "N",
            "ErrorDetails": [
                {
                    "error_code": "4002",
                    "error_message": "EwayBill is already generated for this IRN",
                    "error_source": "GOVT"
                }
            ]
        },
        "ewb_status": "FAILED"
    }
]