Configure e-invoicing business regions
After the e-invoicing service provider is configured, create a business region for your e-invoicing service provider through the Zuora UI or REST API to store the business detail information as a seller.
If you have multiple GSTINs for different states in India, you can create multiple business region objects.
To configure and manage a business region for your e-invoicing service provider through the REST API, use the following operations:
- Create an e-invoicing business region
- List e-invoicing business regions
- Retrieve an e-invoicing business region
- Update an e-invoicing business region
- Delete an e-invoicing business region
Create e-invoicing business regions through the Zuora UI
To create a business region for your e-invoicing service provider through the Zuora UI, perform the following steps:
- Click your avatar in the upper right and click Settings > Billing.
- On the Billing Settings page, click E-Invoice.
- On the E-Invoice Settings page, click + Add in the Business Regions section.
- In the displayed Add Business Region dialog, configure the business region settings, and then click Save to save the settings.
An e-invoicing business region is created.
Business region settings
The business region objects can be looked up according to the country and state, and their related fields can be mapped accordingly within the e-invoicing template.
The following table lists the business region settings that you have to configure in the Add Business Region dialog.
| UI section | UI field | API field | Required by India | Required by Saudi Arabia | Required by Italy | Description |
|---|---|---|---|---|---|---|
|
Basic Info |
Country |
country |
Yes |
Yes |
Yes |
From the Country list, select a country or region where you must comply with e-invoicing requirements. |
|
Legal Business Name |
businessName |
Yes |
Yes |
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 |
Yes |
Yes |
In the Legal Business Number field, specify the unique identifier number of the legal entity or person that you do business with. For example, you must use a GSTIN for India. |
|
|
Business Number Schema Id |
businessNumberSchemeId |
No |
No |
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 |
No |
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 |
No |
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 |
No |
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 |
No |
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 | Yes | 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 | Yes | 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 | Yes | Yes |
In the Postal Code field, specify the short code that can identify the business address. |
|
|
City |
city |
Yes | Yes | Yes |
In the City field, specify the name of the city where the business is located. |
|
|
State/Province |
state |
No |
Yes |
Yes |
In the State/Province field, specify the name of the state or province where the business is located. |
|
|
Contact Info
|
Contact Name |
contactName |
No |
No |
No |
In the Contact Name field, specify the name of the Seller contact to receive e-invoicing data. |
|
|
|
No |
No |
No |
In the Email field, specify the email address of the Seller contact to receive e-invoicing data. |
|
|
Business Phone Number |
phoneNumber |
No |
No |
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 |
Yes |
Yes |
From the Provider list, select your e-invoicing service provider. |
| Digital Signature | Enable PDF Digital Signature | digitalSignatureEnable | No | No | 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 | No | 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 | No | 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. |
What's next
You are now ready to configure an e-invoicing profile for your customer account that must comply with e-invoicing business requirements.