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

POST

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":161001046722,
  "ewayBillDate":"03/05/2018 11:03:00 AM",
  "genMode":"API",
  "userGstin":"29AKLPM8755F1Z2",
  "supplyType":"O",
  "subSupplyType":"1 ",
  "docType":"INV",
  "docNo":"65656565",
  "docDate":"10/03/2018",
  "fromGstin":"29AKLPM8755F1Z2",
  "fromTrdName":"test",
  "fromAddr1":"4556",
  "fromAddr2":"hulimavu",
  "fromPlace":"bannargatta",
  "fromPincode":545454,
  "fromStateCode":29,
  "toGstin":"29AAAAA1799H1ZK",
  "toTrdName":"test2",
  "toAddr1":"toaddress1",
  "toAddr2":"toaddress2",
  "toPlace":"toplace",
  "toPincode":899879,
  "toStateCode":29,
  "totalValue":68000.00,
  "totInvValue":10.00,
  "cgstValue":10.00,
  "sgstValue":10.00,
  "igstValue":0.00,
  "cessValue":1800.00,
  "transporterId":"",
  "transporterName":"",
  "status":"ACT",
  "actualDist":2500,
  "noValidDays":25,
  "validUpto":"28/05/2018 11:59:00 PM",
  "extendedTimes":0,
  "rejectStatus":"N",
  "actFromStateCode":29,
  "actToStateCode":29,
  "vehicleType":"R",
  "itemList":[{
  "itemNo":1,
  "productId":0,
  "productName":"CEMENT",
  "productDesc":" ",
  "hsnCode":25210010,
  "quantity":2.00,
  "qtyUnit":"",
  "cgstRate":10.000,
  "sgstRate":10.000,
  "igstRate":0.000,
  "cessRate":1.000,
  "cessAdvol":0.00,
  "taxableAmount":0.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,
  "cessAdvol":0.00,
  "taxableAmount":0.00
}],
  "VehiclListDetails":[{
  "updMode":"API",
  "vehicleNo":"PQR1234",
  "fromPlace":"Bengaluru",
  "fromState":29,
  "tripshtNo":1810002031,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "transMode":"1 ",
  "transDocNo":"1234",
  "transDocDate":"03/05/2018",
  "groupNo":"1"
  },
  {
  "updMode":"API",
  "vehicleNo":"PQR1234",
  "fromPlace":"Bengaluru",
  "fromState":29,
  "tripshtNo":1110002030,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "transMode":"1 ",
  "transDocNo":"1234",
  "transDocDate":"03/05/2018",
  "vehicleType":"",
  "groupNo":"0"
  },
  {
  "updMode":"API",
  "vehicleNo":"KA25AB3456",
  "fromPlace":"BANGALORE SOUTH",
  "fromState":29,
  "tripshtNo":1510002029,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "transMode":"1 ",
  "transDocNo":"1234",
  "transDocDate":"12/10/2017",
  "vehicleType":"",
  "groupNo":"0"
  },
  {
  "updMode":"API",
  "vehicleNo":"KA25AB3456",
  "fromPlace":"BANGALORE SOUTH",
  "fromState":29,
  "tripshtNo":1810002028,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "transMode":"1 ",
  "transDocNo":"1234",
  "transDocDate":"12/10/2017",
  "vehicleType":""
  "groupNo":"0"
  },
  {
  "updMode":"API",
  "vehicleNo":"RJ191G5024",
  "fromPlace":"bannargatta",
  "fromState":29,
  "tripshtNo":0,
  "userGSTINTransin":"29AKLPM8755F1Z2",
  "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.