Thank you for your response
Thank you for your response
Our representative will get in touch with you shortly.
Get up and running in 3 mins
Integrate with Tally (or any other) ERP
24/7 customer support
Send einvoices to all your customers over email
99.99% uptime with multi-GSP redundancies in place
API, SFTP with any ERP, standard govt template, custom mapper
Application Programming Interface (API) enables taxpayers or their GSPs to interact with the e-invoice system. This article covers details about API registration in e invoice generation.
API is an Application Programming Interface. Every taxpayer should ensure to obtain API registration in e invoice. API is a software intermediary which enables two applications to interact with each other. Under e-invoicing, APIs help in communication between taxpayers or their GSPs (GST Suvidha Providers) and the e-invoice system.
The API integration are of three types for API registration in e invoice –
Smooth data transmission
APIs facilitate the smooth transmission of data between the taxpayers’ accounting system and the e-invoice system. A taxpayer needs to just enter the data in its accounting software, and thereafter the APIs will transfer data to the e-way bill and GST portals and back to the ERP or accounting software. Following are the benefits of API registration in e invoice –
Lower manual intervention
API for e invoicing enables seamless integration of the ERP or accounting system of the businesses with the e-Invoice portal. The e invoicing api system facilitates the automatic or scheduled transfer of invoice details from the ERP to the e-invoice portal or the Invoice Registration Portal (IRP). One can avoid manual entry of data for reporting e-invoices.
Lower scope for errors
A one-time entry for obtaining e-invoices will also facilitate the generation of e-way bills and auto-fills most details in GSTR-1, thus avoiding multiple manual entries. Moreover, using API for e invoicing, taxpayer can avoid the manual submission of data. Accordingly, it helps the entity avoid data entry errors and transmission errors.
The taxpayer can enjoy a 24/7 self-help service from the e-invoicing system.
Configuring the ERP/accounting software as per the requirements of the e-invoicing system is a must.
Uses- The e-invoicing sandbox system provides essential information to the developers for integration of e-invoicing operations by NIC-IRP through APIs with the taxpayers’ accounting system. The main purpose is to allow testing in a simulated environment.
The developer can understand the process involved in the preparation, encryption and decryption of the request payload. He can upload the request payload and then check the results.
A developer can use the material available in the resource section to get himself familiarised with Invoice Reference Number generation among others. He can understand the attributes used in JSON and map it with their technical name, masters for the country, currency, port and state, General master, etc.
Actions to be taken on the API sandbox testing portal for e-invoicing
IP whitelisting provides network access to specific IP addresses. Basically, it helps to control access to the e-invoice network.
Note that if a taxpayer is already integrated with the API under the e-way bill system, then the same credentials can be used for e-invoice as well. If not, the taxpayer can apply for IP whitelisting as mentioned in the topic below. The network team will scrutinise the IP addresses and whitelist the IP address.
Maximum number of IPs that can be whitelisted on the e-invoice portal and requirements
A maximum of only four public IPs registered in India can be whitelisted for IRN generation under the e-invoice system. Also, the request for all GSTINs should flow through these four IP addresses only.
e Invoice API registration process involves the following steps-
Step 1: Log in to the e-invoice portal.
Step 2: Go to API registration and then click on IP whitelisting.
Step 3: After scrutiny of the test report, the IP whitelisting will be done.
Step 4: The client ID and client secret will be sent to the registered mobile number of the taxpayer via SMS. In case the same is not received, the taxpayer can log in to the e-invoice portal and click on resend.
Note: These credentials are for a PAN that is the Company as a whole. So, all the GSTINs registered under the same PAN need to use these credentials.
Follow the below steps to create multiple users for each GSTIN under the same PAN:
Step 1: Log in to the e-invoice portal and click on Create API user.
Step 2: On the API registration page, enter the client ID and client secret. Select the mode for registration with API as “direct” or “through GST Suvidha Provider”. In case the taxpayer selects GSP, he will have to update the name of GSP from the drop-down list and click submit. Here are the steps to select GST Suvidha Provider for e-invoicing.
Step 3: Now, create the username, password and re-enter the password and save it. The taxpayer can repeat the same process for all other GSTINs under the same PAN for which he needs separate credentials.
An Application Programming Interface (API) has been developed for third-party developers to interface their applications with the e-invoice portal.
After whitelisting the IP address of your system on the e-invoice portal, you receive an acknowledgement number. Go to the dashboard on the e-invoice portal and navigate to API registration -> User credentials-> Click on ‘Create API user’ and enter the credentials. Select as direct or GSP as the case may be. On successful registration, Client ID and the secret to your registered mobile number. Verify using OTP and you will get a confirmation for successful API registration for e-invoice and get the auth token issued.
Taxpayers must test all APIs on the e-invoicing sandbox environment and each API must be tested with at least 50 success cases and 50 failed cases with different errors.
No. There is no requirement to whitelist the IPs to test on the e-Invoicing Sandbox.
There are two kinds of API credentials – one being the Client ID and Client Secret, and the other referring to the Username and Password. Client ID and Secret is given to the notified taxpayer and they can use the same for all the business units registered in different states for the same PAN. However, the Username and Password are created for every GSTIN and each business unit registered in different states must create a separate username and password for each GSTIN.
The e-Invoice system is using the email ID and mobile number used on the GST Portal, for communication. If it is outdated, contact the e-Invoicing team of the GST Network to cross-verify and update the Sandbox for accessing the credentials.