Availability of alternate NIC IRP pass-through API for testing through TaxPro GSP

96 views
Skip to first unread message

Chartered Information Systems Pvt. Ltd.

unread,
Apr 7, 2023, 9:29:07 AM4/7/23
to TaxPro GSP

  Dear ASPs,

 Greetings from TaxPro GSP!

 Management Summary:

 

This week NIC has started eInvoice API from it’s second IRP setup (NIC IPR-2), viz. https://einvoice2.gst.gov.in/.  This is supposed to be completely alternate and independent setup and would continue to serve even in case there is any issue in NIC IRP-1 (first setup).  TaxPro GSP is pleased to provide pass-through access to NIC IRP-2, initially for trial basis for few days, through special endpoint (temporary) as explained below.  We request ASPs to make minor required changes to their application and take advantage of the alternative setup NIC IRP has provided.  Once we have tested this trial setup with sufficient ASPs, we would move this to all our servers under mainline url https://einvapi.charteredinfo.com/.

 

Technical Details:

1.    

  1.           Complete change is backword compatible and API requests are routed by default to NIC IRP-1 setup.  Base url with this feature has been temporarily provisioned as https://a2einvapi.charteredinfo.com
 
2.      ASPs using TaxPro libraries (.dll or .jar) for eInvoice shall wait for further notification regarding availability of updated libraries (after testing in production).
 
3.      ASPs using url based API (url with ‘/dec/’) may start testing this feature by passing IRP value as either “1” or “2” in Request Header (or Url query parameter).
 
4.      ASPs may modify their software UI to include IRP Selection, drop-down as below or else, so that user can manually switch IRP in case there is no response or timeouts form one IRP.

Capture.PNG


5.      IRN generated on particular IRP would be recognized only by that IRP. (i.e.Invoice IRN generated by IRP 1 would not be recognized by IRP 2 and vice versa.) Thus, on the backend, ASP needs to store IRP value along with Invoice (or say IRN) and always pass this IRP value to get IRN details or to cancel IRN or GenEWB by IRN or any further IRN operations.

In other words, modify your Invoice database to add IRP (Tiny Integer field) which will store 1 or 2 value depending on the IRP used to generate IRN for that Invoice.  This field will supply value for IRP request header or query parameter for further requests related to that IRN or Invoice database table row.
 
6.      API response error codes are already prefixing ‘NICxxx” (viz. ‘NIC504’) to IRP timeout errors and GSP time-out error is ‘GSP032’, use these error-codes to put checks on unavailability of IRP setup.  (We would refine this as per experienced gained on an on-going basis…)
 

 

We hope to provide Enhanced Up-Time to eInvoice API users..!!


Thanks & Regards,
TaxPro GSP.

eInvoice | eWayBill | GST API

Bulk Signing | Free PDF Signing

Browser Extension | PKI Component

ePass Tokens | Digital Signatures

Income Tax | TDS | XBRL Softwares

Biometric | Gate Automation

Bulk SMS | WhatsApp Business

 

Chartered Information Systems Pvt. Ltd.

unread,
Apr 14, 2023, 6:36:42 AM4/14/23
to TaxPro GSP

  Dear ASPs,

  Greetings from TaxPro GSP!


Management Summary:

We have tested multiple IRP support and deployed required changes to all our servers under mainline url https://einvapi.charteredinfo.com/. All ASPs must use https://einvapi.charteredinfo.com as base url for high availability.

 

Technical Details:

 

  1. Complete change is backword compatible and API requests are routed by default to NIC IRP-1 setup.  All eInvoice Production Servers now supports IRP-1 and IRP-2. Use base url
    https://einvapi.charteredinfo.com
    (Don’t use https://a2einvapi.charteredinfo.com since this server is having some maintenance activity and down time of 15 minutes between 4:00 am to 5:00 am on 15 April, 2023)

 

  1. There will be no effect of IRP Parameter in Sandbox and would be ignored.

 

  1. ASPs using TaxPro libraries (.dll or .jar) for eInvoice shall wait for further notification regarding availability of updated libraries and user guide.

 

  1. ASPs using url based API (url with ‘/dec/’) may start testing this feature by passing IRP value as either “1” or “2” in Request Header (or Url query parameter).

 

  1. ASPs may modify their software UI to include IRP Selection, drop-down as below or else, so that user can manually switch IRP in case there is no response or timeouts form one IRP.
Capture.PNG

 

  1. IRN generated on particular IRP would be recognized only by that IRP. (i.e.Invoice IRN generated by IRP 1 would not be recognized by IRP 2 and vice versa.) Thus, on the backend, ASP needs to store IRP value along with Invoice (or say IRN) and always pass this IRP value to get IRN details or to cancel IRN or GenEWB by IRN or any further IRN operations.

    In other words, modify your Invoice database to add field IRP (Tiny Integer field: tinyint(2) in mysql) which will store 1 or 2 value depending on the IRP used to generate IRN for that Invoice.  This field will supply value for IRP request header or query parameter for further requests related to that IRN or Invoice database table row.

 

  1. API response error codes are already prefixing ‘NICxxx” (viz. ‘NIC504’) to IRP timeout errors and GSP time-out error is ‘GSP032’, use these error-codes to put checks on unavailability of IRP setup.  (We would refine this as per experienced gained on an on-going basis…)


We hope to provide Enhanced Up-Time to eInvoice API users..!!



Thanks & Regards,
TaxPro GSP.

eInvoice | eWayBill | GST API

Bulk Signing | Free PDF Signing

Browser Extension | PKI Component

ePass Tokens | Digital Signatures

Income Tax | TDS | XBRL Softwares

Biometric | Gate Automation

Bulk SMS | WhatsApp Business

Reply all
Reply to author
Forward
0 new messages