Skip to main content

Manage country-specific configurations for India


Manage country-specific configurations for India

If you are a business provider selling products or services to public sector companies or other businesses in India, you must comply with the e-invoicing requirements. In India, e-invoice files for billing documents are electronically authenticated by the Goods and Service Tax Network (GSTN) portal. Under the electronic invoicing system, an identification number called the Invoice Reference Number (IRN) and a QR code are issued against each billing document by the Invoice Registration Portal (IRP), managed by the GSTN.

Configure e-invoicing in Sovos for India

To configure e-invoicing for invoice clearance for India, you must create a company profile in Sovos. Zuora handles the configuration process on your behalf in Sovos, ensuring a seamless setup. You have to provide the following information required for the configuration to Zuora:

  • Company Name: Legal name of your business

Manage field mapping for e-invoice file templates

In the e-invoicing clearance process in India, ensure the field mapping for e-invoice file templates.

Specify Business Number fields on business regions and account e-invoicing profiles

In the e-invoicing clearance process in India, both the Seller and the Buyer must provide their GSTIN numbers.

  • You must specify the GSTIN number for the Seller in the Business Number field of the business Region.
  • You must specify the GSTIN number for the Buyer in the Business Number field of the account e-invoicing profile.

Create custom fields specific to e-invoicing

You must create and manage custom fields to store country-specific information for mapping to Sovos. It is best practice to use the objects and custom fields listed in the following table. 

Object Custom field Notes

Product Rate Plan Charge


Create this custom field of the string type to store HSN codes.

While configuring e-invoicing for India, ensure that you configure HSN codes for all your products and services under the Product Catalog. Electronic billing documents can be generated only with an HSN code. The use of HSN codes is mainly for dealers and trades. They must adopt 2-digit, 4-digit, and 8-digit HSN codes depending on the business turnover. For more information, see GST HSN Codes.



Create this custom field of the picklist type to store the type of supply. This picklist field has the following options: 

  • B2B: business to business
  • SEZWP: SEZ with payment
  • SEZWOP: SEZ without payment
  • EXPWP: export with payment
  • EXPWOP: export with payment
  • DEXP: deemed export

Note that the values of the picklist field must use short names like B2B, SEZWP, and so on.

These custom fields are integral to the default e-invoice file templates. If you opt to define custom fields with different names or on alternative objects, you are required to make adjustments to the default templates.

Retrieve e-invoicing results

You can use the "Retrieve e-invoicing results" operation to retrieve e-invoice results according to the ID of a billing document. The document ID can be the ID of an invoice, a credit memo, or a debit memo.

The e-invoicing result fields might be different by country. For example, a QR code and an IRN are returned for the India e-invoicing clearance process.

The e-invoicing result fields on EInvoiceData include the following fields for India:

  • QrCode: This field stores the QR code data that has been Base64 decoded. In India, the code is a signed QR code in the format of JSON Web Token (JWT), consisting of three parts: signature parameters, data, and a signature. 
  • ReferenceNumber: This field stores a unique number generated by the tax authority. In India, it is known as the Invoice Reference Number (IRN). IRN is a distinct code created by the Invoice Reference Portal (IRP) for every electronic invoice (e-invoice) file issued under the Goods and Services Tax (GST) system. This number is essential for verifying and authenticating e-invoice files within the Indian e-invoicing system.
  • DocumentId: This field stores the ID of the billing document, for which the e-invoice file is generated.
  • DocumentType: This field indicates the type of the billing document, for which the e-invoice file is generated.

The eInvoiceFileId field on the Invoice object stores the ID of the Base64-encoded e-invoice file, a cleared document in JSON format.