E-way bill and e-invoice integration through your GSP
Integration status (ClearTax and MasterGST (Whitebooks)): live.
An e-way bill API lets your software create and manage e-way bills on the government system without typing into the portal. Most businesses use it through a GST Suvidha Provider (GSP). Through a GSP account you connect (ClearTax or MasterGST (Whitebooks)), CommerceOS can generate, update Part-B for, cancel and extend e-way bills, and register and cancel e-invoices (IRNs).
Book a demo →The rules the integration works inside
These are the statutory facts the numbers on this page rest on.
- When an e-way bill is needed. An e-way bill is required to move goods worth more than ₹50,000, under Section 68 of the CGST Act read with Rule 138. Handicraft goods and some job-work movements need one even below that value. (e-way bill portal and FAQ, Nov 2026)
- How long it is valid. One day for every 200 km or part of it, and one day per 20 km for over-dimensional cargo. Validity expires at midnight of the last day, and it starts when Part-B (the vehicle or transport document) is first entered. (e-way bill portal FAQ, Nov 2026)
- Mistakes. An e-way bill can't be edited after submission. The only fix is to cancel it and generate a new one.
- E-invoicing. Taxpayers report B2B invoices to the Invoice Registration Portal (IRP), which returns an Invoice Reference Number (IRN), a digitally signed e-invoice and a QR code. Since 1 August 2023 (Notification 10/2023-Central Tax), this applies to taxpayers with aggregate turnover above ₹5 crore. (e-invoice portal and notifications page, Nov 2026)
- Login security. Two-factor authentication has been mandatory for all taxpayers and transporters on the e-way bill system since 1 April 2025. (e-way bill portal, Nov 2026)
How API access works, and where a GSP fits
The e-way bill API developer portal, run by the National Informatics Centre, describes two routes:
- Direct API access. A taxpayer or transporter must be short-listed by GSTN, test in the sandbox, complete formalities such as IP white-listing, and then create API logins under "For API" in the portal's Registration menu. (e-way bill API on-boarding page, Nov 2026)
- Through a GSP. Taxpayers who use the APIs through a GSP select "For GSP" under Registration, pick their GSP from a dropdown, and create their own username and password.
Most brands take the second route, and CommerceOS works the same way. You connect your own GSP account, tied to one GSTIN. CommerceOS uses it only after the account has authenticated with the GSP.
CommerceOS doesn't issue an e-way bill or IRN number of its own: without a working GSP account, no bill is generated.
GST on each order and invoice
- GST by HSN code. Fretron CommerceOS can work out GST on each order line from the item's HSN code and a dated rate schedule, using the same calculation for the order preview and the invoice.
- Tax invoice at packing. For orders you invoice yourself, Fretron CommerceOS raises the tax invoice automatically when the shipment finishes packing.
- Invoice numbers. Fretron CommerceOS keeps GST invoice numbers in an unbroken series: a retried invoice reuses its number instead of skipping one.
- Courier aggregators. With NimbusPost and ShipClues, Fretron CommerceOS can send NDR actions and push e-way bills to the courier.
What the integration covers
| Operation | Through your GSP account in CommerceOS |
|---|---|
| Generate an e-way bill | Yes |
| Update Part-B when the vehicle changes | Yes |
| Cancel an e-way bill | Yes |
| Extend an e-way bill's validity | Yes |
| Register an e-invoice and get its IRN | Yes |
| Cancel an IRN | Yes |
For Gracious Logistics bookings, the invoice, HSN codes and e-way bill details are sent with the booking. See the Gracious Logistics integration.
Worked example: ₹1.2 lakh over 640 km
Illustrative numbers.
A brand in Bhiwandi ships a B2B order worth ₹1.2 lakh to a retailer in Ahmedabad, 640 km away by road. Its turnover is above ₹5 crore, so e-invoicing applies.
- E-invoice first. The invoice is registered through the brand's GSP account and comes back with its IRN. The IRN is issued by the IRP, not by CommerceOS. (e-invoice portal, Nov 2026)
- Is an e-way bill needed? ₹1.2 lakh is more than ₹50,000, so yes. (e-way bill portal FAQ, Nov 2026)
- Generate the e-way bill. It is generated through the same GSP account with the vehicle number in Part-B.
- Validity. 640 ÷ 200 = 3.2, and any part of 200 km counts as a full day, so validity is 4 days. If Part-B is first entered at 10:30 am on 3 November, the first day ends at midnight between 4 and 5 November, and the fourth at midnight between 7 and 8 November. That is how the portal's FAQ counts days.
- The truck breaks down near Udaipur on day 2. The goods move to a new vehicle, and Part-B is updated with the new vehicle number. Validity isn't recalculated for later Part-B entries, so the 4-day clock keeps running.
- If the trip slips past day 4, the e-way bill's validity is extended before it lapses.
- If the order is cancelled before dispatch, the e-way bill is cancelled, and the IRN too if needed.
CommerceOS keeps the e-way bill and IRN numbers that come back from the GSP, so a later Part-B update, extension or cancellation is made on the same bill.
What isn't covered
- A bill without a GSP account. No e-way bill or IRN is generated without a working GSP account.
- Choosing which GSP does what. Both GSPs are connected for e-way bill and e-invoice operations; this page doesn't split operations by provider.
- Filing returns. The integration covers the operations listed above, not GST return filing.
Frequently asked questions
- What is an e-way bill API?
- It is the government interface that lets software generate, update, extend and cancel e-way bills on the e-way bill system. NIC runs the developer portal, and access is either direct (for short-listed users) or through a GSP. (e-way bill API portal and on-boarding page, Nov 2026)
- Who are the e-way bill API providers (GSPs)?
- GST Suvidha Providers (GSPs) are the providers that give businesses API access to the GST systems. The e-invoice portal lists them under "GST Suvidha Providers / ERPs" in its search menu. CommerceOS connects through ClearTax or MasterGST (Whitebooks), using your own account with either. (e-invoice portal menu, Nov 2026)
- Is the e-way bill API free?
- NIC's on-boarding page doesn't mention a fee for direct API access, but that route is open only to users short-listed by GSTN. Most businesses use a GSP instead, and each GSP sets its own terms, so check your GSP's pricing. (e-way bill API on-boarding page, Nov 2026)
- How do I register for e-way bill API access through a GSP?
- Log in to the e-way bill portal, open Registration, choose "For GSP", select your GSP from the dropdown, and create your API username and password. (e-way bill API on-boarding page, Nov 2026) Then connect that GSP account in CommerceOS. CommerceOS connects through MasterGST, Whitebooks or ClearTax, so pick one of these as your GSP.
- Can CommerceOS generate e-invoices and e-way bills from orders?
- Through a GSP account you connect (ClearTax or MasterGST (Whitebooks)), CommerceOS can generate, update Part-B for, cancel and extend e-way bills, and register and cancel e-invoices (IRNs). CommerceOS doesn't issue an e-way bill or IRN number of its own: without a working GSP account, no bill is generated.
- Does CommerceOS work out GST on each order?
- Fretron CommerceOS can work out GST on each order line from the item's HSN code and a dated rate schedule, using the same calculation for the order preview and the invoice. For orders you invoice yourself, Fretron CommerceOS raises the tax invoice automatically when the shipment finishes packing.
- Does a retried invoice skip a GST invoice number in CommerceOS?
- No. Fretron CommerceOS keeps GST invoice numbers in an unbroken series: a retried invoice reuses its number instead of skipping one.
Sources
Partner and marketplace details were read on their own pages on 5 Nov 2026. Check them before you rely on them.
- e-way bill system home: https://ewaybillgst.gov.in/
- EWB-S2: e-way bill portal FAQ (read 5 Nov 2026)
- e-way bill API developer portal: https://docs.ewaybillgst.gov.in/apidocs/
- EWB-S4: e-way bill API on-boarding process (read 5 Nov 2026)
- EINV-S1: e-invoice system home, https://einvoice1.gst.gov.in/ (read 5 Nov 2026)
- EINV-S2: e-invoice notifications list (read 5 Nov 2026): Notification 10/2023-Central Tax, 10 May 2023
Shipping B2B consignments across states?
See an IRN and an e-way bill attached to one shipment through your own GSP account.
Book a demo →