Generate EWB by IRN

post

https://api.in.onefinops.com/v1/einvoices/ewaybill

Generate an e-Way Bill against a previously-generated IRN. NIC IRP returns the EWB linkage; we persist it on the IRN row so subsequent Get-by-IRN returns the combined shape without another live NIC hit.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Body for POST /v1/einvoices/ewaybill. Mirrors the NIC IRP "Generate EWB by IRN" payload.

irn

string

required

length between 64 and 64

^[0-9a-f]{64}$

The 64-character IRN to attach the EWB to.

distance

integer

required

0 to 4000

Defaults to 0

Consignment distance in km, used by NIC to compute EWB validity. Pass 0 to let NIC auto-calculate the pin-to-pin road distance from the source and destination pincodes (recommended when the exact road distance is unknown). Any non-zero value is validated against NIC's pin-to-pin reference and is rejected if it deviates beyond NIC's tolerance (≈10% above the calculated value) with "The distance between the pincodes given is too high". For a small number of pincode pairs NIC has not mapped, 0 is rejected with "The distance between the given pincodes are not available in the system. Please provide distance". Retry with the actual road distance (a positive value up to 4000 km; NIC accepts your value on these unmapped routes). The field is mandatory; omitting it returns "Invalid Approximate Distance". The applied distance is returned on generation and on Get E-Way Bill.

transportMode

string | null

enum

1=Road, 2=Rail, 3=Air, 4=Ship.

Allowed:

transporterId

string | null

Transporter GSTIN or NIC TRANSIN. Required when vehicleNumber is not supplied (Part-A only).

transporterName

string | null

transportDocumentNumber

string | null

transportDocumentDate

date | null

vehicleNumber

string | null

Vehicle number — required for road movements when generating Part-B in the same call.

vehicleType

string | null

enum

R Regular or O Over-Dimensional Cargo.

Allowed:

Headers

gstin

string

required

length between 15 and 15

^[0-9]{2}[A-Z]{5}[0-9]{4}[A-Z][A-Z0-9]{3}$

GSTIN whose NIC IRP / EWB-portal credential authorizes the call.
Seed each GSTIN's credential through the Developer Console.

X-Request-Id

uuid

Optional client-supplied UUID for correlation across logs and dashboards. If omitted, OneFinOps mints one and echoes it back on the response.

Responses

200EWB generated and linked to the IRN.

400Request rejected.

404Resource not found.

409State conflict — see code for the specific reason.

422Body or query failed validation.