Overview

This API takes in gstin of Requester(Tax payer or Transporter) to give the Consolidated E-Way bill details of respective gstin.

Endpoint

HTTP Method	Resource
`Post`	/ewb/tax-payer/seller/bills/consolidate

Request

Follow the below guidelines to pass GSTIN in path parameters to call the API.

Headers

Param	Type	Description	Example
x-api-key	`string`	An API key is a public key to identify users when calling any Sandbox API.	key_live_ZUQT5UEf4......
Authorization	`string`	JWT Authorization token which is generated using E-Way Bill Authentication API.	eyJhsebihGyUf......

Body Parameters

Param	Type	Description	Examples
vehicleNo	`string`	Vehicle number Possible value - 1. AB121234 (First 2 char are State Code) 2. AB12A1234 (First 2 char are State Code) 3. AB12AB1234 (First 2 char are State Code) 4. ABC1234 5. AB123A1234 (First 2 char are State Code) 6. AB12ABC1234 (First 2 char are State Code) 7. DFXXXXXX (Defence Vehicle) 8. TMXXXXXXXXXXXXX (Temp RC) At least 7 characters 9. BPXXXXXXXXXXXXX (Bhutan Vehicle) At least 7 characters 10. NPXXXXXXXXXXXXX (Nepal Vehicle) At least 7 characters	KA12BL4567
fromPlace	`num`	Current Place	BANGALORE SOUTH
fromState	`num`	Current State Possible value - `1` : JAMMU AND KASHMIR `2` : HIMACHAL PRADESH `3` : PUNJAB `4` : CHANDIGARH `5` : UTTARAKHAND `6` : HARYANA `7` : DELHI `8` : RAJASTHAN `9` : UTTAR PRADESH `10` : BIHAR `11` : SIKKIM `12` : ARUNACHAL PRADESH `13` : NAGALAND `14` : MANIPUR `15` : MIZORAM `16` : TRIPURA `17` : MEGHALAYA `18` : ASSAM `19` : WEST BENGAL `20` : JHARKHAND `21` : ORRISA `22` : CHATTISGARH `23` : MADHYA PRADESH `24` : GUJARAT `26` : DADAR AND NAGAR HAVELI & DAMAN AND DIU `27` : MAHARASHTRA `29` : KARNATAKA `30` : GOA `31` : LAKSHADWEEP `32` : KERELA `33` : TAMIL NADU `34` : PUDUCHERRY `35` : ANDAMAN AND NICOBAR `36` : TELENGANA `37` : ANDHRA PRADESH `38` : LADAKH `97` : OTHER TERRITORY `99` : OTHER COUNTRY	KARNATAKA
transMode	`num`	Mode of transportation Possible value - `1` : Road `2` : Rail `3` : Air `4` : Ship `5` : inTransit	1
transDocNo	`string`	Transporter Document number	12-86/3
transDocDate	`string`	Transporter Document Date	12/09/2017
tripSheetEwbBills	`array`	Array of E-Way Bill Number	[ { "ewbNo": "131002233845" }, { "ewbNo": "161002233844" } ]

Once the values are added, Your curl will look something like this

curl --request POST \
     --url https://api.sandbox.co.in/ewb/tax-payer/seller/bills/consolidate \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0' \
     --data '
{
  "fromPlace": "BANGALORE SOUTH",
  "fromState": 29,
  "vehicleNo": "KA12AB1234",
  "transMode": "1",
  "transDocNo": "1234",
  "transDocDate": "12/10/2017",
  "tripSheetEwbBills": [
    {
      "ewbNo": "131002233845"
    },
    {
      "ewbNo": "161002233844"
    }
  ]
}
'

Response

Param	Type	Description	Examples
cEwbNo	`num`	Consolidated E-Way Bill Number	1810000387
cEWBDate	`num`	Consolidated E-Way Bill Date	15/12/2017 10:27:00 AM

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Generate E-Way Bill is a Paid API, a wallet charge of INR 0.25 + GST will take place.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here