NIC – E-invoice & E-Way Bill Projects (Dt: 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, eInovice2, 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 ewaybill generation. Similarly, IRNs generated at e-Invoice1 will be available at eInvoice2.
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.
   1. 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

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, eWaybill1 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 eWaybill2 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 eWaybill 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

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.