0% found this document useful (0 votes)
4 views

API Features

Shyam narayan plastic recycling ENT.. 7223009026

Uploaded by

sagarbendale35
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
4 views

API Features

Shyam narayan plastic recycling ENT.. 7223009026

Uploaded by

sagarbendale35
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 2

NIC - E-invoice & E-Way Bill Projects

(Dated: 18.07.2024)

A. New API Features of E-Invoice Interoperable services

1. Authentication token can be generated from any of the Portals – e-Invoice1, e-


Inovice2, e-Waybill1 or e-Waybill2, and once generated the same token can be used
to access services across portals. No need to generate separate token for einvoice1
and einvoice2 as it was before.

2. At e-Invoice1 portal, you can access services of einvoice2 and vice versa. That is, IRNs
generated at e-Invoice2 Portal will be available at e-Invoice1 for cancellation and e-
waybill generation. Similarly, IRNs generated at e-Invoice1 will be available at e-
Invoice2.

3. To access the services of einvoice2, namely ‘Get IRN’, ‘Cancel IRN’ and ‘Eway bill by
IRN’ from einvoice1, the URL and end points are same as of einvoice1, an additional
header parameter ‘irp’ with value ‘NIC2’ needs to be passed, which indicates that
service requested is from e-Invoice2. Similarly ‘irp’ should be ‘NIC1’ to access these
services of e-Invoice1 from e-Invoice2.

In the absence of ‘irp’ header parameter, APIs will work for the data available locally
or the URL accessed.

4. APIs available for criss-cross operations between these sites are.


 Get IRN Details
 Cancel IRN
 Get IRN Details by Doc. Details
 Generate e-Waybill by IRN
 Get e-Waybill details by IRN

5. The following error code has been added


3098 Invalid IRP code

6. Please visit https://einv-apisandbox.nic.in/ for changes in API Specification. Login to


the sandbox portal for testing URLs.

7. Please test these APIs on sandbox, before moving to the production.


B. API Features of E-Way Bill Interoperable services

1. For direct e-Waybill operations, e-Waybill1 and e-Waybill2 API systems are made
operational in sandbox environment. e-Waybill2 runs in parallel with e-Waybill1
System, but with the following critical functionalities.
 Generate E-Way Bill
 Update Vehicle Details
 Update Transporter Details
 Get E-Way Bill
 Cancel E-Way Bill

2. Authentication token can be common for all Portals – e-Invoice1, e-Inovice2, e-


Waybill1 or e-Waybill2.

3. At e-Waybill1 System, you can access the services namely ‘Get E-way bill’, ‘Part B
updation’ of e-Waybill2 System and vice versa. That is, e-Waybills generated at e-
Waybill2 System can be retrieved and part B can be updated from e-Waybill1 System.
Similarly, e-waybills of e-Waybill1 can be retrieved and part B can be updated from e-
Waybill 2. e-Waybill2 system synchronises the e-Waybill details with e-Waybill1
System within a few seconds.

4. APIs available for criss-cross operations between these sites are.


 Get E way bill
 Part B updation

5. New Error Codes

117 This option is not enabled in Eway Bill2


118 Try after 5 minutes
444 This Ewaybill cannot be cancelled as it is generated from NIC1
445 This Ewaybill cannot be cancelled as it is generated from NIC2
446 Transport details cannot be updated here as it is generated from NIC1
447 Transport details cannot be updated here as it is generated from NIC2
448 Part B cannot be updated as this Ewaybill Part A is generated in NIC1
449 Part B cannot be updated as this Ewaybill Part A is generated in NIC2
452 Consolidate Ewaybill cannot be generated as this Ewaybill Part A is
generated in NIC2

6. Please visit https://einv-apisandbox.nic.in/ for changes in API Specification. Login to


the sandbox portal for testing URLs.

7. Please test these APIs on sandbox, before moving to the production.


---

You might also like