Manage country-specific configurations for India

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
GSTIN

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.

Configure e-invoicing business regions for India

You must specify the GSTIN number for the Seller in the Business Number field of the business Region.

The following table lists the business region settings you must configure in the Add Business Region dialog.

section	UI field	API field	Required by India	Description
Basic Info	Country	country	Yes	From the Country list, select a country or region where you must comply with e-invoicing requirements.
	Legal Business Name	businessName	Yes	In the Legal Business Name field, specify the full official name that the Seller is registered with the relevant legal authority.
	Legal Business Number	businessNumber	Yes	In the Legal Business Number field, specify the unique identifier number of the legal entity or person that you do business with. You must specify the GSTIN number for the Seller.
	Business Number Schema Id	businessNumberSchemeId	No	In the Business Number Schema Id field, specify the identification scheme identifier that an official registrar issues to identify the Seller as a legal entity or person.
	Trade Name	tradeName	Yes	In the Trade Name field, specify the name that the Seller is known as, other than the legal business name.
	Tax Register Number	taxRegisterNumber	No	In the Tax Register Number field, specify the Seller's VAT identifier (also known as Seller VAT identification number) or the local identification (defined by the Seller’s address) of the Seller for tax purposes, or a reference that enables the Seller to state the registered tax status.
	E-Invoice Destination Code	endpointId	No	In the E-Invoice Destination Code field, specify the Seller's electronic address, to which the application-level response to the e-invoice file might be delivered.
	E-Invoice Destination Code Schema Id	endpointSchemeId	No	In the E-Invoice Destination Code Schema Id field, specify the identification scheme identifier of the Seller’s electronic address.
Business Address	Address 1	addressLine1	Yes	In the Address 1 field, specify the first line of the Seller’s address, which is often a street address or business name.
	Address 2	addressLine2	Yes	In the Address 2 field, specify the second line of the Seller’s address, which is often the name of a building.
	Postal Code	postalCode	Yes	In the Postal Code field, specify the short code that can identify the business address.
	City	city	Yes	In the City field, specify the name of the city where the business is located.
	State/Province	state	Yes	In the State/Province field, specify the name of the state or province where the business is located. The state name needs to be converted to a GST code, as Sovos requires GST codes for states. The Zuora default e-invoicing file template includes a method for converting state names to GST codes. See Create custom objects for storing state names and codes.
Contact Info	Contact Name	contactName	No	In the Contact Name field, specify the name of the Seller contact to receive e-invoicing data.
	Email	email	No	In the Email field, specify the email address of the Seller contact to receive e-invoicing data.
	Business Phone Number	phoneNumber	No	In the Business Phone Number field, specify the business phone number of the Seller contact to receive e-invoicing data.
Service Provider	Provider	serviceProviderId	Yes	From the Provider list, select your e-invoicing service provider. For India, if the service provider is Sovos, the E-Invoice Process automatically changes to Clearance Only.
Digital Signature	Enable PDF Digital Signature	digitalSignatureEnable	No	Specify whether the e-invoicing service provider signs PDF files for billing documents. Click Yes to enable the setting. The default setting is NO. For more information, see Digital Signature.
	Show Signature Box	digitalSignatureBoxEnable	No	Specify whether the digital signature box is displayed on PDF files for billing documents. Click Yes to enable the setting. The default setting is NO.
	Coordination on PDF	digitalSignatureBoxPosX, digitalSignatureBoxPosY	No	In the text box, specify the position of the on-page signature box. If the coordinates are set to (0,0), the signature box will appear in the lower-left corner of the page, while the coordinates (595,842) place the signature box in the upper-right corner of the page.
Billing Document Type	Invoice Credit Memo Debit Memo	invoiceEnabled creditMemoEnabled debitMemoEnabled	Yes	Select one or more of the following billing document types to be supported: Invoice Credit Memo Debit Memo These document types are selected by default.

Configure e-invoicing profiles for accounts in India

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

The following table lists the e-invoicing profile settings to configure for a customer account.

UI field	API field	Required by India	Description
Generate E-Invoice for Customer	enabled	Yes	Enable the e-invoicing profile for the customer account. If the following conditions are met, all billing documents for one account can be submitted to an e-invoicing service provider to be generated in electronic format: The account must be configured to generate e-invoice files for billing documents. The billing document must be in Posted status. A business region must be created for the billing country contact, and be linked to an e-invoicing service provider.
Business Category	BusinessCategory	No	The following three options are available: B2B (Business to Business) B2C (Business to Consumer) B2G (Business to Government) For India, specify the field as B2B or B2G.
Legal Business Name	businessName	Yes	In the Legal Business Name field, specify the full official name that the Buyer is registered with the relevant legal authority.
Legal Business Number	businessNumber	Yes	In the Legal Business Number field, specify the unique identifier number of the legal entity or person that you do business with. You must specify the GSTIN number for the Buyer.
Business Number Schema Id	businessNumberSchemeId	No	In the Business Number Schema Id field, specify the identification scheme identifier that an official registrar issues to identify the Buyer as a legal entity or person.
Tax Register Number	taxRegisterNumber	No	In the Tax Register Number field, specify the Buyer's VAT identifier (also known as the Buyer's VAT identification number) or the local identification (defined by the Buyer’s address) of the Buyer for tax purposes, or a reference that enables the Buyer to state the registered tax status.
E-Invoice Destination Code	endpointId	No	In the E-Invoice Destination Code field, specify the Buyer's electronic address, to which the application-level response to the invoice/billing document might be delivered.
E-Invoice Destination Code Schema Id	endpointSchemeId	No	In the E-Invoice Destination Code Schema Id field, specify the identification scheme identifier of the Buyer’s electronic address.

Configure sold-to contacts for accounts in India

You must configure sold-to contacts for customer accounts involved in the e-invoicing business in India.

The following table lists the contact-related fields involved in the e-invoicing business in India.

UI field	API field	Required by India	Description
Country	country	Yes	Specify a country or region where you must comply with e-invoicing requirements.
Address 1	addressLine1	Yes	Specify the first line of the Buyer’s address, which is often a street address or business name.
Address 2	addressLine2	Yes	Specify the second line of the Buyer’s address, which is often the name of a building.
Postal Code	postalCode	Yes	Specify the short code that can identify the business address.
City	city	Yes	Specify the name of the city where the business is located.
State/Province	state	Yes	Specify the name of the state or province where the business is located. The state name needs to be converted to a GST code, as Sovos requires GST codes for states. The Zuora default e-invoicing file template includes a method for converting state names to GST codes. See Create custom objects for storing state names and codes.

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	HSN__c	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.
Account	SupplyType__c	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.

Object

Custom field

Notes

Product Rate Plan Charge

HSN__c

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.

Account

SupplyType__c

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.

Create custom objects for storing state names and codes

The state name needs to be converted to a GST code, as Sovos requires GST codes for states.

You can use the Object Manager to create a custom object named CountryStateCodes for storing state names and codes since CountryStateCodes is already available in the default e-invoicing file template. If you prefer to use another custom object name, ensure to replace CountryStateCodes in the default e-invoicing file template with your custom object API name.

During the object creation, add the following country and state fields:

Field name or Label name API name Description

Country Name CountryName__c This field is optional. The field value is India.

Field name or Label name	API name	Description
Country Name	`CountryName__c`	This field is optional. The field value is India.
State Name	`StateName__c`	This field is required. The field value must be a state name value listed on the India e-Way billing website: https://docs.ewaybillgst.gov.in/apid...tate-code.html. The API name`StateName__c`is already available in the default e-invoicing file template. If you prefer to use another field name, ensure to replace `StateName__c` in the default e-invoicing file template with your field API name.
State Code	`StateCode__c`	This field is required. The field value must correspond to the value of the State Name field. The state name and code are listed in pairs on the India e-Way billing website: https://docs.ewaybillgst.gov.in/apid...tate-code.html. The API name`StateCode__c`is already available in the default e-invoicing file template. If you prefer to use another field name, ensure to replace `StateCode__c` in the default e-invoicing file template with your field API name.

State Name

StateName__c

This field is required.

The field value must be a state name value listed on the India e-Way billing website: https://docs.ewaybillgst.gov.in/apid...tate-code.html.

The API nameStateName__cis already available in the default e-invoicing file template. If you prefer to use another field name, ensure to replace StateName__c in the default e-invoicing file template with your field API name.

State Code

StateCode__c

This field is required.

The field value must correspond to the value of the State Name field. The state name and code are listed in pairs on the India e-Way billing website: https://docs.ewaybillgst.gov.in/apid...tate-code.html.

The API nameStateCode__cis already available in the default e-invoicing file template. If you prefer to use another field name, ensure to replace StateCode__c in the default e-invoicing file template with your field API name.

Testing recommendations

Zuora has tested various billing document types and operations using the default e-invoice file templates. The test cases cover the following scenarios:

Billing document types: invoices, credit memos, and debit memos.
Each billing document can include one or multiple charges.
Billing document creation scenarios include standalone documents, such as creating an invoice, credit memo, or debit memo from a product rate plan charge, or generating a credit or debit memo from an invoice.
Billing operations cover invoice write-offs and reversals, resulting in credit memo creation.
Tax scenarios include both interstate and intrastate taxation.

Please note that the testing was performed in the Sovos Sandbox with a testing account, and the following assumptions are applied:

Zuora uses the Sovos-provided dummy credentials, including GSTIN, user name, and password for both the business supplier and buyer. However, these credentials do not include the real GSTIN.
All billing documents have taxation enabled. The documents without taxation have not been tested. If you have business scenarios where documents have no taxation, you need to test those scenarios and modify the default e-invoice file template accordingly.
The taxation addresses are test address data and do not represent the addresses of real business entities.
Zuora tests the supply type B2B-Business to Business only. The testing does not cover other supply types: SEZWP - SEZ with payment, SEZWOP - SEZ without payment, EXPWP - Export with Payment, EXPWOP - Export without payment, and DEXP - Deemed EXport.
The billing documents include only regular charges, without discount charges. If you use Zuora discount charges, you must customize the default e-invoicing file template.

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.