New contracts for GST E-Way Bill API
New API contracts for GST E-Way Bill API have been published along with improvements and bug fixes.
New contracts
Change in endpoints
At a high level, the endpoints have changed in the fashion below. However, for specific APIs, please refer to the API reference for complete details.
| New endpoints | Deprecated endpoints |
|---|---|
| {sandbox_host}/gst/compliance/e-way-bill/tax-payer/{endpoint} | {sandbox_host}/ewb/tax-payer/{endpoint} |
POST to GET
Some API contracts have changed as per our thought-process about which you can read here. Below APIs have changed as per our design choice.
Improvements
Schema validation
As a high number of requests are invalid as per NIC schemas, we have enabled schema validation on the E-Way Bill APIs. The API which will return Invalid request body if request body does not match the schema. We have added the schemas on our E-Way Bill APIs documentation for reference.
How to validate the request body with schema
- Go to JSON Schema Validator.
- Copy the schema from API reference page and paste in the Select Schema box (left).
- Paste your request body in the Input JSON box (right).
- The validator will show you errors if any. Change the request body accordingly until no errors are found.
Change in issuer for E-Way Bill access token
Issuer has been changed to "irp1.gst.gov.in" in the access token.
GSTIN transformation
GSTIN passed in lowercase will be transformed to uppercase and then request will be executed.
Bug Fixes
- E-Way Bill access token: Wrong expiry has been corrected.