Overview

This method provides the eway bill details for a given eway bill number.

The format and detals of GetEwayBilll API request is depicted in following table.

URL

<URL>/ewayapi/GetEwayBill

Content-Type

application/json

Method

GET

URL Parameters

ewbNo

Request Payload

Request Header

Attributes Description

client-id

clientid to be provided by E-WAY BILL SYSTEM

client-secret

Secret to be provided by E-WAY BILL SYSTEM

Gstin

GSTIN of Requester(Tax payer or Transporter)

authtoken

Authentication token returned by the E-way bill system

Response Payload

Attributes Description Value
Status Status of request 1 – Success ; 0 - Error

Encrypt(Base64(Response JSON),rek)

Response of E-way bill Json string.

Encrypt(rek,sek)

Random encryption key which is encrypted using sek

Hmac ( Base64(JSON data ))

HMAC-SHA256 of Base64 data using AES key (rek) as HMAC Key

Sample Json for GetEwayBill

{
  "ewbNo":131001298692,
  "ewayBillDate":"26/09/2018 02:40:00 PM",
  "genMode":"API",
  "userGstin":"29AKLPM8755F1Z2",
  "supplyType":"O",
  "subSupplyType":"1 ",
  "docType":"INV",
  "docNo":"7007-8",
  "docDate":"10/09/2018",
  "fromGstin":"29AKLPM8755F1Z2",
  "fromTrdName":"welton",
  "fromAddr1":"4556",
  "fromAddr2":"hulimavu",
  "fromPlace":"bannargatta",
  "fromPincode":560090,
  "fromStateCode":29,
  "toGstin":"02EHFPS5910D2Z0",
  "toTrdName":"test2",
  "toAddr1":"Shree Nilaya",
  "toAddr2":"Dasarahosahalli",
  "toPlace":"Beml Nagar",
  "toPincode":560090,
  "toStateCode":29,
  "totalValue":56099.00,
  "totInvValue":68358.00,
  "cgstValue":1.00,
  "sgstValue":1.00,
  "igstValue":0.00,
  "cessValue":400.56,
  "transporterId":"",
  "transporterName":"",
  "status":"ACT",
  "actualDist":2500,
  "noValidDays":25,
  "validUpto":"27/09/2018 11:59:00 PM",
  "extendedTimes":0,
  "rejectStatus":"N",
  "actFromStateCode":29,
  "actToStateCode":29,
  "vehicleType":"R",
  "transactionType":4,
  "otherValue":-10.00,
  "cessNonAdvolValue":400.00,
  "itemList":[{
  "itemNo":1,
  "productId":0,
  "productName":"CEMENT",
  "productDesc":" ",
  "hsnCode":25210010,
  "quantity":2.00,
  "qtyUnit":"BOX",
  "cgstRate":0.050,
  "sgstRate":0.050,
  "igstRate":0.000,
  "cessRate":3.000,
  "cessNonAdvol":0,
  "taxableAmount":56.00
   },
  {
  "itemNo":2,
  "productId":0,
  "productName":"steel",
  "productDesc":"steel rods",
  "hsnCode":2402,
  "quantity":4.00,
  "qtyUnit":"NOS",
  "cgstRate":10.000,
  "sgstRate":10.000,
  "igstRate":0.000,
  "cessRate":3.000,
  "cessNonAdvol":0.00,
  "taxableAmount":0.00
}],
  "VehiclListDetails":[{
  "updMode":"API",
  "vehicleNo":"PQR1234",
  "fromPlace":"Bengaluru",
  "fromState":29,
  "tripshtNo":1810002031,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "enteredDate":"26/09/2018 02:40:00 PM",
  "transMode":"1 ",
  "transDocNo":"1234",
  "transDocDate":"03/05/2018",
  "groupNo":"1"
  },
  {
  "updMode":"API",
  "vehicleNo":"PQR1234",
  "fromPlace":"Bengaluru",
  "fromState":29,
  "tripshtNo":1110002030,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "enteredDate":"26/09/2018 02:40:00 PM",
  "transMode":"1 ",
  "transDocNo":"1234",
  "transDocDate":"03/05/2018",
  "vehicleType":"",
  "groupNo":"0"
  },
  {
  "updMode":"API",
  "vehicleNo":"KA25AB3456",
  "fromPlace":"BANGALORE SOUTH",
  "fromState":29,
  "tripshtNo":1510002029,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "enteredDate":"26/09/2018 02:40:00 PM",
  "transMode":"1 ",
  "transDocNo":"1234",
  "transDocDate":"12/10/2017",
  "vehicleType":"",
  "groupNo":"0"
  },
  {
  "updMode":"API",
  "vehicleNo":"KA25AB3456",
  "fromPlace":"BANGALORE SOUTH",
  "fromState":29,
  "tripshtNo":1810002028,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "enteredDate":"26/09/2018 02:40:00 PM",
  "transMode":"1 ",
  "transDocNo":"1234",
  "transDocDate":"12/10/2017",
  "vehicleType":"",
  "groupNo":"0"
  },
  {
  "updMode":"API",
  "vehicleNo":"RJ191G5024",
  "fromPlace":"bannargatta",
  "fromState":29,
  "tripshtNo":0,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "enteredDate":"26/09/2018 02:40:00 PM",
  "transMode":"1 ",
  "transDocNo":"12345",
  "transDocDate":null,
  "vehicleType":"R",
  "groupNo":"0"
  }]
  }

Validations

  1. E-way bill number should be 12 digit and valid.
  2. Requestor GSTIN has to be supplier GSTIN or recipient GSTIN or transporter GSTIN/TRANSIN in that e-way bill.
  3. Get E Way Bill Response will have additional parameter transactionType indicating the Transaction type.