Operating as a transporter

If you're a transporter — moving goods on behalf of a supplier — the EWB lifecycle is split between you and the supplier. The supplier raises the EWB (Part-A) when the invoice is issued; you handle vehicle assignment, transhipments, and validity extensions while the goods are in motion.

This guide is the starting point for transporter-side integrations. If you supply goods yourself, see Generate an EWB instead.

Identifier: GSTIN or TRANSIN

NIC identifies the responsible transporter on an EWB by an identifier called transporterId. It is one of:

A GSTIN (15 chars), if you're a GST-registered transporter.
A TRANSIN (15 chars), if you're a transporter who is not GST-registered. Register on the NIC EWB portal (ewaybillgst.gov.in → For Transporters) to be issued a TRANSIN. The field is named gstin everywhere in OneFinOps' API — it accepts a TRANSIN equally.

Once you have a GSTIN or TRANSIN, upload your EWB-portal credentials to OneFinOps once — see Upload EWB portal credentials. After that, every API call you make passes your GSTIN / TRANSIN in the gstin header and OneFinOps signs to NIC on your behalf.

What you typically do

Action	Endpoint	When
Look up an EWB	`GET /v1/ewaybills/ewbnumber?ewbNumber=…`	A supplier has named you as transporter and you want the full details.
List EWBs assigned to you	`GET /v1/ewaybills/assigned?date=…`	Daily poll of EWBs whose `transporterId` is your GSTIN / TRANSIN.
Update Part-B (assign vehicle)	`POST /v1/ewaybills/partb`	First-time vehicle assignment after a Part-A-only generation, or vehicle changes mid-route.
Extend validity	`POST /v1/ewaybills/extend`	Journey is taking longer than the distance-based default window.
Hand off to another transporter	`POST /v1/ewaybills/transporter`	You're handing the consignment to a long-haul partner.

You don't typically cancel or reject EWBs as a transporter — those are supplier and counter-party actions respectively. See Cancel an E-Way Bill and Reject an E-Way Bill.

A typical day

Pull GET /v1/ewaybills/assigned?date=YYYY-MM-DD to see what suppliers have named you transporter for today.
For each EWB, if Part-B is empty: post POST /v1/ewaybills/partb with the assigned vehicle and lorry receipt.
While in transit: if a vehicle breaks down, post a fresh POST /v1/ewaybills/partb with the replacement vehicle and reasonCode: "1" (Break down).
If validity is running out at a hub: post POST /v1/ewaybills/extend with the remaining distance.

Where to next

Update Part-B — vehicle assignment and changes.
Extend validity — push out validUpto.
Update transporter — hand the EWB to a different transporter.
Upload EWB portal credentials — one-time setup.