Some of the services of e-Invoice & E Way Bill can be used across the two instances (E Way Bill 1 & E Way Bill 2 and e-Invoice1 & e-Invoice2).
Please refer to the general information on E Way Bill interoperable services here and for e-Invoice here
To enable testing the interoperable services through APIs, 2 separate instances each for E Way Bill and e-Invoice are created. Please login into https://einv-apisandbox.nic.in/einvapiclient/ to get the URLs of the four instances.
In view of introduction of the above new test environments, current test URLs will be withdrawn shortly.
Date :24/08/2023
As per the Notification No. 78/2020 dated 15th Oct 2020,
the tax payers, having Aggregate Annual Turn Over (AATO) above Rs 5 Crore, shall use
atleast 6 digit HSN code in the e-Invoices and e-Waybills and other tax payers
shall use atleast 4 digit HSN code in E-Invoices and E-Way Bills.
Most of the tax payers are already follwing this, Other tax payers are requested to adapt
to the change and comply by the due date. This will be made Mandatory from 1st
October 2023 in e-Waybill and e-Invoice Systems.
Date :20/05/2023
Sometimes IRPs may fail to check duplicate IRN from de-dup system for technical reasons. Under this circumstance, it is possible for tax payers to register the same document/invoice at different IRPs. Whenever the de-duplication system comes back to live, only one of the IRP will be able to successfully register the IRN. All other IRPS will fail to register on de-duplication system the IRNs generated with them for the same document. In such cases, the status of these IRNs will be updated as ‘REJ’ by these IRPs. This will be reflected in the ‘Get IRN Details’ API when the tax payers pull the IRNs.
New API to get the list of such IRNs which are marked as 'REJ' has been provided. The supplier can send the date of rejection and if any IRNs are marked as rejected (REJ), the list of IRNs will be provided through this API. The details of the API are available here
The new validation has been added in IRN generation - Providing the country code has been made mandatory under category ‘EXPWP and EXPWOP export details ("ExpDtls"."CntCode") for the export transactions.
It is being observed that many tax payers’ applications generate large number of erroneous hits to the GST E Way Bill and GST eInvoice Systems. In case of any error due to validation or data of data type or format or otherwise, appropriate error codes and error messages are provided in response to such requests by GST system. The tax payer application has to capture these error codes and facilitate to take action in correcting the issue and only then re-send the requests. Distinct error codes with detailed descriptions are provided in response for various types of failures, so that the tax payer application can take appropriate measures to correct the request payload. But many tax payer applications are ignoring the response error codes but continue to send the same erroneous request payloads multiple times, sometimes, lakhs of times.
To handle the large number of errors which would affect the overall performance of the system, measures are being to block the access to such users and added with two new error codes. The details and process of blocking and unblocking are provided in the document.
Date :08/05/2023
It is to inform you that implementation of Time limit for reporting invoices on the IRP Portal (Not allowing to report invoices older than 7 days on the date of reporting) has been deferred by the government for three months.
Date : 17/04/2023
Time limit for Reporting Invoices on the IRP Portal for taxpayers with AATO greater than or equal to Rs 100 Crores. Please click here for more details
e-Invoice voluntary enablement released for FY 2022-23.
As per the Notification No.78/2020 – Central Tax dated 15th October, 2020 ,
it is mandatory for the taxpayers to mention 6-digit HSN Codes for their outward supplies having AATO more than Rs 5 Crores.
After a few weeks of time , e-Invoice System will not accept 4-digit HSN codes.
The date for blocking e-Invoice generation having HSN code as 4-digits will be intimated shortly in this portal.
So, please make necessary changes in your system to report 6-digit HSN codes to e-Invoice Portal and comply by the notification.
You may verify all your HSN codes in the (https://einvoice1.gst.gov.in) portal under Search-->Master-->HSN Codes and also test in the sandbox system ( https://einv-apisandbox.nic.in ).
In case the 6 digit HSN code is not available, you may raise a ticket at Helpdesk so that it can be included in the system.
New public key for sandbox Verification of signed content is available for download. Please login to download the same(23/02/2023).
Date : 27/01/2023
With reference to the circular https://cbic-gst.gov.in/pdf/circular-184.pdf a new validation has been incorporated.
For all B2B transactions, selection of PoS State Code as ‘96- Other Country’ is enabled for HSN related to the Services by way of transportation of goods, including by mail or courier .
The list of items should have only the items with HSNs belonging to 9965 and 9968
For all transactions, the document date 01/10/2021 onwards only will be accepted.
With reference to integration of GST Look Up System, a new Error code 2295 is added for Duplicate requests apart from 2150. If an IRN is already generated with other IRP and the same request is again sent to NIC-IRP, error code 2295 will be responded with description as “IRN is already generated and registered with GSTN Lookup Portal by other IRP”.
Date : 10/10/2022
The e-Invoices may be generated by the e-Commerce operator (having tax payer type as ‘TCS’ ) on behalf of the Suppliers.
The e-Commerce operator need not be enabled for e-Invoicing.
The e-Invoices generated by e-Commerce operators should include “EcmGstin” attribute and should be the same as their GSTIN.
For e-Invoices generated by Suppliers, the “EcmGstin” attribute should be blank.
The e-Invoices generated by e-Commerce operators are also accessible to the Suppliers for all the operations such as Viewing of IRN, Cancellation of IRN and Generation of E-Waybill.
E-Waybills generated by e-Commerce operators can be cancelled by Suppliers also.
Only e-Commerce operators can generate e-Invoices pertaining to e-Commerce transactions.
Date : 28/07/2022
Taxpayers having TO more than Rs. 5Cr. are eligible for testing on sandbox system.
Date : 18/07/2022
Taxpayers having TO more than Rs. 10Cr. are eligible for testing on sandbox system.
The following validations are implemented.
Reverse charge is not applicable for transactions if recipient taxpayer type is ISD
Deemed exports is allowed for recipient taxpayers with taxpayer type as Regular or Casual
Tax rate 0.5% is withdrawn
Date : 03/03/2022
Taxpayers having TO more than Rs. 20Cr. are eligible for e-invoicing System from 1st April 2022, and enabled for testing on sandbox system.
Version 1.04:
24/06/2021
When SEZ Developer is Supplier, only IGST is applicable irrespective of Supplier State code POS Code.
In these cases, no need to set 'IGSTonIntra' flag to 'Y' (which would have mandated RCM = 'Y') since this is not applicable.
eivital APIs (Date : 06/04/2021)
New version for authentication has been released. The request payload has been slightly changed. Please click here to get the API details.
The current authentication API version 1.03 will be withdrawn from 20/04/2021 on Sandbox.
IRNs can be generated only if the Supplier GSTNs is 'Active'. IRN cannot be generated if the status of Supplier GSTINs is 'Suspended' or ‘Provisional’ or ‘Inactive’ or ‘Cancelled’.
However, IRN can be generated if the Recipient GSTIN is 'Active' or 'Suspended' but not 'Provisional' or 'Inactive' or 'Cancelled'
(Updated on 04/06/2021).
If the status of the Supplier GSTIN or Recipient GSTIN is ‘Cancelled’, the document date should be between date of registration (‘DtReg’) and Date of De-Registration (‘DtDReg’) for generation of IRN
If the Recipient GSTN is of type SEZ Unit or SEZ Developer, Supply type (‘SupTyp‘) should be either ‘SEZWP’ or ‘SEZWOP’.
Other supply types are not allowed
Minimum 6 digits HSN codes for tax payers having turnover more than Rs. 5 crore.
If IGST on Intra (‘IgstOnIntra‘) value is set to ‘Y’, then Reverse Charge applicable (‘RegRev’) value should be ‘Y’
While generating E Way Bill, Vehicle Type (‘VehType’) can be set to ‘O’ (Over Dimension Vehicle) if the Transportation mode (‘TransMode’) is set as ‘4’ (Ship)
Heartbeat API can now be accessed as <URL>/eivital/v1.04/heartbeat/ping
Above changes have been deployed on production on 10th June 2021.
Date : 30/12/2020
As per the notification dated 22 December 2020, No. 94 /2020. the validity period of e-waybill is changed from 100 KM per day to 200 KM per day.
Date : 21/11/2020
Updated Date : 27/11/2020
Additional information is being provided in "InfoDtls" in the response JSON. The values for this attribute have been improved further to provide more meaningful information.
The following improvements will not affect the ongoing IRN generations. These improvements are made to handle the exceptional cases of invoices which needs the IRN generation.
These improved versions of APIs will be released on the production on 7-Dec 2020. You are requested to test these APIs on the sandbox.
The Direct E-Waybill generation through Web/Offline/API will be blocked for the taxpayers who are generating IRN as per the notification. However, they will be allowed to generate the e-waybill directly which are not covered under IRN generation like Import/Job Work/Exhibition/Own Use etc
There are some changes in validations for direct e-waybill generation using e-waybill APIs. Please click here https://docs.ewaybillgst.gov.in/apidocs for more details.
E-way bill print will have the IRN , Acknowledgement no. and date
Detailed E-waybill print will also have the IRN , Acknowledgement no. and date , but it will not have the Item details. Officers will be intimated to see the IRN copy for the item details.
A new API GetIRNByDocDetails is made available in the Sandbox. This will help in fetching the details of IRN based on Document type, document date and document number.
A Health API is made available in the Sandbox.
JSON Schema of the ‘Generate IRN’ and ‘Generate EWB by IRN’ APIs have been improved by adding the “Patterns” for some of the attributes.
Descriptions for some of Error Codes have been improved & also new Error Codes have been defined in the APIs.
The following changes have been made in ‘Generate IRN’ API
IRN requests with Document Date from 01/10/2020 only will be accepted and processed for IRN generation. IRN requests belonging to previous dates will be rejected.
The Item serial number i.e attribute "SlNo" can be numeric only.
"Reverse Charges" can be set as "Y" in case of B2B and SEZ invoices also.
Recipient GSTIN should be registered and active, on the date of preparation of the document by the supplier.
If the PIN Code does not exist in the master database of the e-invoicing system but however if the first 3 digits of the PIN code matches with the respective State as per the pattern of PIN code-to-State mapping pattern defined by postal department, then IRN gets generated .
In case of Reverse charge and Export transactions (EXPWP), Total value of Item should match either with tax values or without tax values. That is, the total value of item can include or exclude the tax values as per the business requirements.
The distance of transportation is validated against the auto-calculated PIN-PIN distance stored in the system. The allowed distance for transportation should be between +/- 10 % of auto-calculated PIN-PIN distance. If the auto-calculated distance is less than 100 KMs, then the allowed distance for transportation should be between 1 and +10 % of auto-calculated PIN-PIN distance.
IRN details can be fetched using 'Get IRN' API within 3 days from the date of generation of IRN.
The following improvements in 'Generate EWB by IRN' API
If the PIN Code does not exist in the master database of the e-invoicing system and the first 3 digits of the PIN code matches with the respective State as per the pattern of PIN code-to-State mapping pattern defined by postal department, then IRN gets generated.
The distance of transportation is validated against the auto-calculated PIN-PIN distance stored in the system. The allowed distance for transportation should be between +/- 10 % of auto-calculated PIN-PIN distance. If the auto-calculated distance is less than 100 KMs, then The allowed distance for transportation should be between 1 and +10 % of auto-calculated PIN-PIN distance.
If the distance of transportation is passed as 0 (zero), then the system will consider it as request made by the tax payer, to consider the auto-calculated PIN-PIN distance for the generation of e-way bill and generate the e-way bill along with IRN. The actual distance is passed in "Info. Message" column for reference.
If the dispatching address and/or shipping address have not been passed during generation of IRN, then the respective addresses can be passed here.
Date: 21/10/2020
New API for Get e-Waybill Details for a given IRN 'Get e-Waybill Details by IRN' is made available in the Sandbox, Please refer to the API documentation here.
Date: 09/09/2020
New API for updating the GSTIN details from the GST Common portal 'Sync GSTIN Details from CP' is made available in the Sandbox, Please refer to the API documentation here.
Date: 26/08/2020
The following improvements have been made in the validations of IRN generation:
‘Version’ attribute in the Schema should be passed as ‘1.1’.
The attributes in the JSON schema have been defined with column length, format and data types. Where-ever the data format is not defined for the attribute having data type as string, then for these attributes, the alphanumeric and special characters are allowed except the special characters “ (double quote) and \ (back slash).
In case of GSTIN of supplier or recipient belonging to state of ‘OTHER TERRITORY’ (with state code as 97), then PIN code can be 999999.
If the PIN Code does not exist in the master in the e-invoicing system, then that PIN code is not validated, however, the ‘info. Message’ is returned in the response payload indicating accordingly, so that user can check the PIN code.
Tax rates are being validated. Only the allowed tax rates will be accepted for all types of document including Credit Note and Debit Note.
In case of CREDIT NOTE AND DEBIT NOTE, the ‘IGST/CGST/SGST/CESS value of item’ is not validated with corresponding tax rates and taxable values.
Date: 08/09/2020
Help section of e Invoice portal has been updated with new documents.
The following Improvements have been done in Validations in IRN Generation API.
In case of Credit Note and Debit Note, tax rate can be passed with any value.
Passed IGST Value of Item will not be validated even actual tax rate is passed in case of EXPWOP and SEZWOP, if the passed value of IGST for that is ZERO.
Tolerance limit: The passed value should be between minimum and maximum values as explained here. Minimum value is considered as the rupee part of the calculated value minus one rupee and maximum value is taken as the rounded up to next rupee value of the calculated value plus one rupee.
Example 1: if calculated value for IGST of item A is 2345.34 then tolerance limit for passed value of that item is between 2344.00 and 2347.00.
Example 2: if calculated value of IGST of all items is 10241.00 then tolerance limit for passed value of IGST of all items is between 10240.00and 10242.00
The ERPs shortlisted by GSTN have been enabled to register and test the APIs on the sandbox system. They will work like GSP in using the e-invoicing system.
The E-Commerce Operator (ECO) have been enabled to register and test the APIs on the sandbox system. The brief note on operations of the e-commerce operator has been published on the https://einvoice1.gst.gov.in portal.
The tax payers have been enabled to self-register for the e-invoice system, if they have crossed the aggregate turnover of the business with Rs 500.00 Crores during any of the previous 3 financial years of GST regime.
‘Generate EWB by IRN’ has been improved to enable the generation of EWB in case of export by passing the address of the port from where it is getting exported later.
Mobile app for verification of QR code and signed e Invoice file has been released.
Date: 27/08/2020
The following improvements have been made in the validations of IRN generation:
Document Number accepts alphabets in small cases.
Check “The Document Date can be yesterday or today’s date” has been withdrawn.
In case, Recipient is SEZ unit or SEZ developer, the ‘Bill to’ State code should match with the state code of the Recipient.
In case of export transactions for goods, if e-way bill is required along with IRN, then the ‘Ship-To’ address should be of the address of the place/port in India from where the goods are being exported. Otherwise E-way bill can be generated later based on IRN, by passing the ‘Ship-To’ address as the address of the place/port of India from where the goods are being exported.
Check “Gross Amount of Item = Quantity X Selling Unit Price” has been withdrawn temporarily.
The round-off value for ' Round_off_amount' attribute to adjust final 'Total_Invoice_Value_INR' attribute can be between -99.99 and +99.99
The distance of transportation is validated against the auto-calculated PIN-PIN distance stored in the system. The allowed distance for transportation should be between +/- 10 % of auto-calculated PIN-PIN distance.
If the distance of transportation is passed as 0 (zero), then the system will consider it as request made by the tax payer, to consider the auto-calculated PIN-PIN distance for the generation of e-way bill and generate the e-way bill along with IRN.
The actual distance has to be passed in case the source and destination PIN codes are same and the allowed range of value is from 1 to 100.
In case of export of goods, if e-way bill has to be generated, then the address of port should have been passed as shipping address during generation of IRN.
Tolerance limit for ‘Passed value / amount’ has been improved by setting the value between actual calculated value / amount and calculated value / amount rounded up to next rupee.
Auto calculated PIN-PIN distance is passed in the attribute ‘Remarks’ in the response payload, if the request has been made to get the auto calculated PIN-PIN distance for e-way bill generation.
‘Cancel IRN’ API can be used to cancel the IRN within 24 hours of generation of IRN.
Date: 05/08/2020
Updated the JSON Schema for the generation of IRN as per the schema notified by the Government on 30th July 2020.
For the end points of the version 1.03 APIs, please login into the portal and visit "API End Points" in the menu
Version 1.02:
Date: 25/06/2020
In 'Generate e-Waybill by IRN' API response JSON, the attribute 'EwayBillNo' is changed to 'EwbNo', attribute 'EwayBillDate' changed to 'EwbDt', “ValidUpto” changed to “EwbValidTill”.
Date: 02/06/2020
In 'Generate e-Waybill by IRN' API, the attribute 'TrnDocNo' is changed to 'TransDocNo', attribute 'TrnDocDt' changed to 'TransDocDt' and data type of 'Distance' is changed to String.
Sandbox Release Date - 14/05/2020.
e Invoice API version 1.02 is available for testing on the Sandbox. Notable changes in this version are,
Generation of E Way Bill as part of IRN generation API enabled
API for generation of E Way Bill using the IRN is operational
"Status" will be ‘0’ for failure, ‘1’ for success, If success, “Data” will have values, if failure, “ErrorDetails” will have values. Any additional information, will be provided through “InfoDtls” as follows.
a. If the Generate IRN is called with same document details more than once, the “InfoDtls” will have an
object as follows.
b. If the Generate IRN request has details related to E Way Bill generation and if the E Way Bill could
not be generated, the “InfoDtls” will have an object as follows.
API for generation of E Way Bill for a given IRN is being provided (will be operational by 01/04/2020).
Generation of E Way Bill as part of IRN registration will be operational by 01/04/2020.
GetGSTINDetails API is enabled.
“ErrorDetails” and the “InfoDtls” will be in plain text and not as Base64 encoded format as mentioned in
earlier documentation.
Version 1.00:
As the version 1.00 need not co-exist with the latest version, documentation and APIs for old version are discarded in the sandbox.
Updated Date : 27/01/2023
Additional information is being provided in "InfoDtls" in the response JSON. The values for this attribute have been improved further to provide more meaningful information.
2295
First time IRN was generated with other IRP than NIC-IRP and second attempt is being made to generate IRN for the same document with NICIRP.
When the IRN is Active, response will show
“Status”:”A” and
"CnclTime":null
{
"Status": 0,
"ErrorDetails": [{
"ErrorCode": "2295",
"ErrorMessage": "IRN is already generated and registered
with GSTN Lookup Portal by other IRP"
}],
"Data": null,
"InfoDtls": [{
"InfCd": "DUPIRNGLP",
"Desc": {
"Irn": "8ae80bccf8c819f30f77564ca29510df8a74fd1d0b3aad931e516cbb1b50c717",
"IrnDtl": {
"RegIrp": "IRP",
"Status": "A",
"Statecd": "29",
"RegTime": "2023-01-07 10:32:37",
"CnclTime": null
}
}
}]
}
When the IRN is Active, response will show
“Status”:”C” and
"CnclTime":"2023-01-07 10:36:05"
{
"Status": 0,
"ErrorDetails": [{
"ErrorCode": "2295",
"ErrorMessage": "IRN is already generated and registered
with GSTN Lookup Portal by other IRP"
}],
"Data": null,
"InfoDtls": [{
"InfCd": "DUPIRNGLP",
"Desc": {
"Irn": "8ae80bccf8c819f30f77564ca29510df8a74fd1d0b3aad931e516cbb1b50c717",
"IrnDtl": {
"RegIrp": "IRP",
"Status": "C",
"Statecd": "29",
"RegTime": "2023-01-07 10:32:37",
"CnclTime": "2023-01-07 10:36:05"
}
}
}]
}
Updated Date : 27/11/2020
Additional information is being provided in "InfoDtls" in the response JSON. The values for this attribute have been improved further to provide more meaningful information.
If the Generate IRN is called with same document details more than once, the Desc will have an object as follows.
If the Generate IRN request has details related to E Way Bill generation and if the E Way Bill could not be generated, the Desc will have an array as follows.