Overview

This method provides the list of E-way bills assigned to requesting GSTIN/TRANSIN for transportation by a given GSTIN, based on generated date.

The format and details of GetEwayBillsForTransporterByGstin API request is depicted in following table.

URL

<URL>/ewayapi/GetEwayBillsForTransporterByGstin

Content-Type

application/json

Method

GET

URL Parameters

Gen_gstin, date (DD/MM/YYYY)

URL Parameter Description

Gen_gstin – GSTIN of E-way bill generator date – E-way bill generated Date Parameters needs to be passed in the order in which it is listed

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(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 assigned to a Transporter for a specific GSTIN 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 Get Eway Bills for Transporter

[
{

"ewbNo": 151000256262,
  "ewbDate": "10/12/2017 10:45:00 AM ",
     "genGstin": "29AMRPV8729L1Z1",
     "docNo": " ",
     "docDate": "22/09/2017",
     "delPinCode": 560056,
     "delStateCode": 29,
     "validUpto":"17/12/2017 12.00:00 PM",
     "extendedTimes":0,
     "delPlace":"Bangalore",
     "status": "ACT",
     "rejectStatus":"Y"
   },
  {    "ewbNo": 121000359898,
     "ewbDate": "10/12/2017 10:45:00 AM ",
     "genGstin": "29AAECP2371C1ZL",
     "docNo": "TA120",
     "docDate": "20/09/2017",
     "delPinCode":560013,
     "delStateCode": 29,
     "validUpto":"17/12/2017 12.00:00 PM",
     "extendedTimes":0,
     "delPlace":"Bangalore",
     "status": "ACT",
     "rejectStatus":"Y"
  }
  ]

Validations

  1. Valid date has to be passed.
  2. Valid GSTIN of the generator of the e-way bill has to be passed.