Frequently Asked Questions

  • Generation of IRN

  • What is Invoice Reference Number (IRN)?

    The Invoice Reference Number (IRN) is a unique number (also known as hash) generated by the e-invoice system using a hash generation algorithm. For every document viz., an invoice or debit or credit note to be submitted on the e-invoice system, a unique 64-character Invoice Reference Number (IRN) shall be generated which is based on the computation of hash of GSTIN of supplier of document (invoice or credit note etc.), Year, Document type and Document number. This shall be unique to each invoice and hence will be the unique identity for each invoice for the entire financial year in the entire GST System for a taxpayer.

  • How do I generate IRN?

    There are two modes for generation of IRN

    • Using excel offline tool
    • Using API integration
  • Can I generate IRN for an Invoice for which IRN is already generated?

    No, only unique invoice from a taxpayer will be accepted by the e-invoice system. E-invoice system will check in Central Registry of GST system to ensure that same invoice from same supplier pertaining to same financial year is not being uploaded again for generating one more IRN.

  • How long will the generated e-invoice be available in the government portal?

    Once the e-invoice system has validated and registered an IRN, it will be made available to the taxpayer for reference on e-invoice system for only 24 hours.

  • What should I do if state is not auto-populated on entering PIN code?

    If state name is not auto-populated, then select the correct state and continue IRN generation.

  • What are pre-requisites to generate the e-invoice?

    The pre-requisite for generation of e-invoice is that the person who generates e-invoice should be a registered person (active) on GST portal and e-invoice system or e-way bill system. The documents viz., tax invoice or Debit Note or credit Note will be reported by the person who is generating the e-invoice. If a user is generating Bulk invoices, then he/she should have a valid JSON file as per the e-invoice schema to upload on the e-invoice system or he/she has to integrated with API interface and generate the IRN.

  • How can anyone verify the authenticity or the correctness of e-invoice?

    Anyone can verify the authenticity or the correctness of e-invoice by uploading the signed JSON file or Signed QR Code into e-invoice system. The option ‘Verify Signed Invoice’ under Search option can be selected and the signed JSON file can be uploaded and verified. Similarly, the QR Code Verify app may be downloaded and used to verify the QR Code printed on the Invoice.

  • What is the meaning of digitally signed e-invoice?

    The digitally signed invoice is one which has been digitally or electronically signed by the IRP after receiving the invoice details from the supplier. That is, the government is authenticating the genuineness of the invoice details submitted/registered by the taxpayer.

  • What are the different Supply types available in e-Invoice schema?

    The different supply types that can be reported are B2B: Business to Business, SEZWP: To SEZ with Payment, SEZWOP: To SEZ without Payment, EXPWP: Export with Payment, EXPWOP: Export without Payment, DEXP: Deemed Export

  • Cancellation of IRN

  • Can IRN be deleted or cancelled?

    The IRN, once generated cannot be modified or deleted. However, if IRN is generated with wrong information, it can be cancelled. Once cancelled, the same document (with same document number) can’t be reported again for generation of IRN. The cancellation is required to be done within 24 hours from the time of generation.

  • If there is a mistake or wrong entry in the e-invoice, what has to be done?

    If there is a mistake, incorrect or wrong entry in the e-invoice, then it cannot be edited or corrected. Only option is to cancel that invoice/IRN and report a new document (with new number) and generate a fresh IRN.

  • Whether e-invoices generated through GST system can be partially / fully cancelled?
    • E-Invoice/IRN can’t be partially cancelled. It has to be fully cancelled.
    • The e-invoice mechanism enables invoices to be cancelled. This will have to be triggered through the IRP within 24 hours.
  • Signed Invoice & QR Code

  • What is the meaning of digitally signed QR code?

    The digitally signed QR code of the invoice is one which has been digitally or electronically signed and prepared the QR Code by the IRP after receiving the invoice uploaded by the supplier. That is, the government is authenticating the genuineness of the invoice, by preparing the important information of the invoice in QR Code form and signing it so that its authenticity can be verified offline by anyone using offline tools. This will be helpful for tax officers checking the invoice on the roadside where Internet may not be available all the time. The web user will get a printable form with all details including QR code. The QR code will consist of the following e-invoice parameters:

    • GSTIN of Supplier
    • GSTIN of Recipient
    • Invoice number as given by Supplier
    • Date of generation of invoice
    • Invoice value (taxable value and gross tax)
    • Number of line items.
    • HSN Code of main item (the line item having highest taxable value)
    • Unique Invoice Reference Number (IRN)
    • Date of generation of IRN
  • What is the purpose of Signed QR Code?

    The IRP will generate a QR code containing the unique IRN (hash) along with some important particulars of invoice including digital signature so that it can be verified by an Offline App.

  • When would the Signed QR code be available?

    IRP system will provide this ‘Signed QR Code’ as part of the response to the request made by the taxpayer for the IRN generation.

  • How one can use the Signed QR Code?

    The Signed QR Code can be verified by anyone using the offline app provided on the IRP portal. Content of the signed QR code can be easily verified by the tax payers or Tax Officials to ascertain whether the invoice is registered with the IRP and is digitally signed by the IRP itself. By validating the content of the QR code data with the digitally signed content (which is part of the QR code itself) one can check the authenticity of the document contents. If the content of the QR code is tampered with, the signature verification fails and the e-Invoice will become invalid.

  • What will be there in Signed QR Code?

    The QR code will consist of the following e-invoice parameters:

    • GSTIN of Supplier
    • GSTIN of Recipient
    • Invoice number as given by Supplier
    • Date of generation of invoice
    • Invoice value (taxable value and gross tax)
    • Number of line items.
    • HSN Code of main item (the line item having highest taxable value)
    • Unique Invoice Reference Number (IRN)
    • Date of generation of IRN
  • Does tax payer have to print the Signed QR Code?

    The Signed QR Code has to be printed by the tax payer on the invoice copy issued to buyer.
    However, Printing of QR code on separate paper is not allowed.
    Printed QR code shall be clear enough to be readable by a QR Code reader
    Size and its placing on invoice is upto the preference of the businesses.

  • What shall be size of the Signed QR code on the invoice?

    Printed QR code shall be clear enough to be readable by a QR Code reader
    Size and its placing on invoice is upto the preference of the businesses.

  • How to verify the QR code or Signed JSON invoice file?

    There are two methods for this.

    • First mode is download the mobile app from the https://einvoice1.gst.gov.in portal under Help menu and download option. Using this app read QR code and verify the details of e-invoice or upload the signed JSON file and see the e-invoice.
    • Second mode is go to https://einvoice1.gst.gov.in portal and select search and verify signed invoice and upload the file and see the e-invoice.
  • User Management

  • What is the need to create sub-users?

    Many of the businesses have multiple places of business or head office and branch at different locations or work remotely from the principal place of business. Generating IRN with a single login may be a challenge for them. To overcome this challenge business can create multiple sub-users. A sub-user can use the same login credentials created originally and perform the actions as per the access that is given to them. For example, a sub-user may be allowed to generate IRN and restricted to accept IRN.

  • Why do I need sub-users?

    Most of the times, the tax payer or authorized person himself cannot operate and generate IRN’s. He will be dependent upon his staff or operator to do that. He would not like to avoid sharing his user credentials to them. In some firms, the business activities will be operational 24/7 and some firms will have multiple branches. Under these circumstances, the main user can create sub-users and assign the roles to them. He can assign generation of IRN or report generation activities based on requirements. This facility helps him to monitor the activities done by sub-users. However, the main user should ensure that whenever employee is transferred or resigned, the sub-user account is frozen / blocked to avoid misuse of credentials.

  • How many sub-users can be created?

    For every principal/additional place of business, user can create maximum of 10 sub-users. That is, if tax payer has only (one) principal business place (and no additional place of business), he can create 10 sub-users. If tax payer has 3 additional places and one principal place of business (i.e. 4 places), then he can create 40 (4 X 10) sub users.

  • When to freeze the sub-users and the steps to follow?

    The e-invoice system gives an option to the taxpayer to freeze the sub-user i.e. Disable the sub-user from using facilities on the e-invoice system.
    Step 1: Click ‘Freeze Sub-user’ under the option ‘User Management’ on the left-hand side of the dashboard
    Step 2: Select the sub-user you want to Freeze, the below screen opens up. Now click on ‘Freeze’ button appearing at the bottom of the screen. On clicking the ‘Freeze’ button, the sub-user will no longer be able to access any facilities on the e-invoice system.

  • How to generate the IRN from different registered business places?

    The registered person can generate the IRN from his account from any registered business place. However, he/she needs to enter the address accordingly in the e-invoice form. He/she can also create multiple sub-users and assign to these places and generate the IRN accordingly.

  • Why are the reports available only for a particular day?

    The user is allowed to generate report on daily basis. Because of criticality of the system for performance for 24/7 operation, the reports are limited to be generated for a day. The user can change date and generate the report for that date. Hence, the user is advised to generate report daily and save in his system.

  • Bulk Generation Process

  • What are the Modes of Generation of e-invoice, the taxpayer can use?

    Multiple modes can be used for reporting invoices to IRP: • Bulk Upload , • API based, • Mobile app based, • GSP based.

  • How to generate Bulk e-invoices?

    Steps to generate Bulk e-invoice: • Step 1: Login on the e-invoice portal using the username password and entering the captcha code. • Step 2: Select ‘Bulk Upload’ under 'E-Invoice' appearing on the left-hand side of the dashboard. • Step 3: Choose the saved JSON file from your system and click 'Upload’. After processing the JSON file the system generates list of e-invoice or error message.

  • What is bulk generation facility and who can use it?

    Through this facility, user can upload multiple invoices and generate multiple IRNs at one go. This facility can be used by the taxpayers, who can prepare bulk requests for IRN in a JSON file from their automated system, and upload it on the e-invoice system and generate IRN in one go. This avoids duplicate data entry into e-invoice system and avoids data entry mistakes also.

  • How to use the bulk generation facility?

    To use the bulk generation facility, one has to prepare the IRN requests through JSON file. This can be done in two ways – registered taxpayer can prepare the JSON file directly from his automated system. If he is unable do so, he can use excel based bulk generation tool available on the e-invoice portal. The invoice and other details need to enter as per the format and JSON file can be generated. This JSON file needs to be uploaded in the e-invoice portal for generation of multiple IRNs. For more details, please refer to the ‘user manual of the bulk generation’ and ‘bulk generation tools’ under “Tools” section at E-invoice portal and follow the instructions.

  • What are the benefits of the bulk generation facility?

    Benefits of the bulk generation facility are as follows: • Generation of multiple IRN in one go • It avoids duplicate keying in of the invoices to generate IRN • It avoids the data entry mistakes while keying in for generation of IRN

  • API Details

  • What is API Interface?

    API interface is a site-to-site integration of two systems. Using this, the taxpayer can link his IT system with E-Invoice system to generate IRN directly from his IT solution without keying in the details for e-invoice form in the Portal. This reduces duplicate data entry and eliminates the data entry mistakes.

  • What are the pre-requisite for using API interface?

    API interface is a site-to-site integration of website of taxpayer with the E-invoice system. API interface can be used by large taxpayers, who need to generate bulk INR’s per day. However, the taxpayer should meet the following criteria to use the API interface: • His invoicing system should be automated with IT solutions. • He should be ready to change his IT system to integrate with E-invoice system as per API guidelines. • His system should have SSL based domain name. • His system should have Static IP Address. • He should have pre-production system to test the API interface.

  • Where can I get the details of API Integration?

    Please go to the site https://einv-apisandbox.nic.in/ for all the details of API Integration

  • How can the registered person integrate his/her system with e-invoice system to generate the IRN from his/her system?

    The integration between e-invoice system and registered person's system can be done through APIs. For availing this facility, the registered person should register the server details of his/her systems (through which he wants to generate the IRN using the APIs of e-invoice system) with e-invoice system. For further details, please go through the user manual.

  • Where can I get the list of GSPs (GST Suvidha Providers)

    The GSP list is available in Search -> GST Suvidha Provider

  • API Sandbox

  • What is the URL of the sandbox? What can I do there?

    There are two access credentials for APIs. Both credentials/keys required to access the APIs.

  • How can I get access to the sandbox portal?

    On the sandbox portal, there is an option to login. Click on that and register and login and test the APIs as per the procedure provided there.

  • What can I do on the sandbox?

    E-invoice API sandbox portal is tool to test the APIs with step-by-step procedure and understand the flow of the APIs. It helps to prepare the payload request with encryption and understand the responses with decryption, etc. It is reach with various information on API usage, schema, mapping, masters, etc. It also has sample codes to understand to build the APIs for consuming.

  • API Registration

  • What are the API access credentials for e-Invoicing System?

    There are two access credentials for APIs. Both credentials/keys required to access the APIs.

    • Client ID and Client Secret– This is available for GSPs, E-commerce Operators and Company (PAN) with aggregate turnover more than Rs 500.00 Crores. Client credentials are used to reach e-invoice system to access the APIs. But using these alone, one cannot generate IRNs.
    • Username and Password – This is available for the GSTINs. Each GSTIN needs to have this separately to generate IRN. These user credentials are used along with the client credentials to generate the IRN.
  • Who gets the API Client Credentials for e-invoicing system?

    Client ID and Client Secret are available for GSPs, E-commerce Operators and Company (PAN) with aggregate turnover more than Rs 500.00 Crores

  • Who can generate the API user credentials?

    GSTIN, enabled for the e-invoicing system, can generate the API username and password for its GSTIN, after logging into the https://einvoice1.gst.gov.in portal.

  • How many API users can the GSTIN have?

    GSTIN has been enabled to generate multiple API usernames. That is, GSTIN can generate one username for each GSP or direct access. If GSTIN has tie-up with 2 GSPs and also has direct access through it server, then it can have three different usernames; One for direct access and two for two GSPs.

  • Can I use the E-way Bill Credentials for e-invoicing system?

    Yes, If the GSTIN is generating the e-way bills on the web portal or through API, then he/she can use those credentials for e-invoice generation accordingly. That username of E-way bill of web portal can be used for e-invoice web portal and API username of E-way bill can be used for API generating the e-invoicing using API.

  • How to get the API Credentials for the Company on production for direct access?
    • Register on the sandbox portal for one of the GSTINs of the company and test the APIs by changing the internal ERP/accounting system.
    • Login to the https://einvoice1.gst.gov.in portal using web username. If it is not there, then register on the portal and create web username
    • Select API registration and ‘IP Whitelisting’ and enter max 4 Public IPs for whitelisting and upload the test summary report.
    • After scrutiny of the test report, the IP whitelisting will be done and Client credentials will be sent to the registered mobile number through SMS.
    • These Client Credentials are for the company (PAN). These have to be used by all the GSTINs of the company for reaching the e-invoice APIs.
    • Next, select API registration and ‘Create API user’. Here, select the ‘Direct’ and enter the client id and client secret. Then create the username and password for logged in GSTIN and preserve them.
    • Next using the client id and client secret, along with the username and password and access the APIs and generate the IRNs for that GSTIN.
    • Repeat the user creation process for all other GSTINs of the same PAN as per above last 2 steps.
  • How to get the API Credentials for the Company on production through GSP?
    • Register on the sandbox portal for one of the GSTINs of the company and test the APIs by changing the internal ERP/accounting system.
    • Login to the einvoice1.gst.gov.in portal using web username. If it is not there, then register on the portal and create web username
    • Select API registration and ‘Create API user’. Here, select the GSP and GSP name through which the access is required. Then create your username and password and preserve them.
    • Next using the client id and client secret, along with the username and password and access the APIs and generate the IRNs.
    • Here, it may be noted that you may not need to whitelist the IPs and submit the test summary report.
    • It may be noted that one can create separate username and password for separate GSP (Client) for e-invoice generation. However, corresponding username credentials and client credentials to be used for API access and IRN generation.
  • How to generate the API user credentials for the GSTIN?
    • Login to the einvoice1.gst.gov.in portal using web username. If it is not there, then register on the portal and create web username
    • Next, select API registration and ‘Create API user’. Here, select the GSP or ‘Direct’. If you have selected the GSP, select the GSP name. If you have selected the ‘Direct’, enter the client id and client secret. Then create the username and password for logged in GSTIN and preserve them.
    • Next using the client id and client secret, along with the username and password and access the APIs and generate the IRNs for that GSTIN.
    • Repeat the user creation process for all other GSTINs of the same PAN as per above last 2 steps.
    • It may be noted that one can create separate username and password for separate GSP (Client) for e-invoice generation. However, corresponding username credentials and client credentials to be used for API access and IRN generation.
  • How do I get the client credentials in case of direct access? What should I do If I don’t get?

    Once the test summary report is approved, the client id and client secret is sent as SMS to the registered mobile number of the GSTIN. If it not received, you can login to the e-invoice portal and get re-sent.

  • My company (PAN) has 15 GSTINs and we want to do the direct interface with the e-invoicing system, what should we do? How many IPs have to be whitelisted and test report to be submitted?
    • You have to create the one client credentials for your company (PAN) after following the steps mentioned for questions ‘How to get the API Credentials for the Company on production for direct access?’ above.
    • Then create the API usernames for all the 15 GSTINs by linking them with the client id and client secret, generated in the above step.
    • You can whitelist max 4 IPs for your company and all your requests from all GSTINs have to come through them to the e-invoicing system.
    • You have to submit one test report for one of the GSTINs.
  • Can I whitelist any IPs?
    • You can whitelist maximum 4 IPs
    • All these IPs have to be Public IPs.
    • All these IPs are registered in India.
  • Can I generate the IRN through multiple GSPs simultaneously?
    • Yes, you can generate IRN through multiple GSPs simultaneously.
    • However, you have to create different API usernames for each one of GSPs separately.
    • You can generate IRN only using the username created with that GSP along with his/her client credentials.
  • Can I use one GSP account to cancel the IRN generated with other GSP?

    Yes. It is possible, however, you have to use your correct credentials to access your IRN.

Close