Manage country-specific configurations for India
If you are a business provider selling to public sector companies or other businesses in India, you can configure the e-invoicing feature to generate e-invoice. E-invoices are electronically authenticated by the Goods and Service Tax Network (GSTN) portal. An identification number called the Invoice Reference Number (IRN) and a QR code is issued against each invoice by the Invoice Registration Portal (IRP) to be managed by the GSTN.
Configure e-invoicing in Sovos 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 GSTN portal. Under the electronic invoicing system, an identification number and a QR code are issued against each billing document by the IRP, managed by GSTN.
Therefore, you must complete the following tasks to meet the following e-invoicing requirements:
- Obtain GSTIN and IRP API credentials
You must register with the GSTN e-invoicing portal to obtain valid Goods and Services Tax Identification Number (GSTIN) and IRP API credentials. For more information, see the Sovos eInvoice Registration process. - Configure e-invoicing in Sovos for India
You must follow the Sovos eInvoice Configuration steps to register your company and branches. The configuration requires GSTIN and IRP API credentials that you have obtained.
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 |
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:
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.