Field mapping management for e-invoice file templates
Guidelines for managing field mapping and configuring e-invoicing templates and profiles for Italy.
In the e-invoicing clearance process in Italy, ensure that the field mapping for e-invoice file templates is complete and correct. The following fields are used in the default e-invoice file template. Remember that you might have to customize the default e-invoice file template if the default field mapping does not align with your business requirements.
E-invoicing business regions configuration for Italy
In the e-invoicing clearance process in Italy, you must configure business regions according to Italy-specific requirements.
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. You must configure e-invoicing business regions for Italy according to Italy-specific requirements.
The following table lists the business region settings you must configure in the Add Business Region dialog.
|
UI section |
UI field |
API field |
Required |
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 of the Seller 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 you do business with. For Italy, the value is the tax identification number for VAT purposes. The first two characters represent the country (IT, DE, ES, and so on), and the remaining characters (up to a maximum of 28) are the actual code which, for Italian residents, corresponds to their VAT number. For example, | ||
|
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. For Italy, Address 1 is the name of the street, road, avenue, way, and so on, to which the number of the corresponding building is attached. | |
|
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. For Italy, Address 2 is an additional street name used to further clarify the address. | ||
|
Postal Code |
postalCode |
Yes |
In the Postal Code field, specify the short code that can identify the business address. For Italy, the value is the postal identifier for this address according to the relevant national postal service, such as a ZIP code or post code. | ||
|
City |
city |
Yes |
In the City field, specify the name of the city where the business is located. For Italy, the value is the name of a city, town, or village. | ||
|
State/Province |
state |
Yes |
In the State/Province field, specify the name of the state or province where the business is located. For Italy, the value must be an abbreviation code of the province, to which the municipality belongs (only to be entered if the registered office is in Italy). The field value must be two characters, such as RM, MI, and so on. | ||
|
Contact Info |
Contact Name |
contactName |
No |
In the Contact Name field, specify the name of the Seller contact to receive e-invoicing data. | |
|
|
|
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 Italy, 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 . | |
|
Billing Document Type |
|
|
Yes |
Select one or more of the following billing document types to be supported:
These document types are selected by default. | |
E-invoicing profiles configuration for accounts in Italy
According to Italy-specific requirements, you must configure e-invoicing profiles for customer accounts involved in the e-invoicing business.
The following table lists the e-invoicing profile settings to configure for a customer account in Italy.
|
UI field |
API field |
Required |
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:
|
|
Business Category |
BusinessCategory |
Yes |
The following three options are available:
For Italy, 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. For Italy, the value is the tax identification number for VAT purposes. The first two characters represent the country (IT, DE, ES, and so on), and the remaining characters (up to a maximum of 28) are the actual code which, for Italian residents, corresponds to their VAT number. For example, |
|
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 |
Yes |
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. For Italy, use CD as the reception method for the reception of the invoice. The CD enables the identification of the communication channel between the SDI and the recipient. |
|
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. |
Sold-to contacts configuration for accounts in Italy
You must configure sold-to contacts for customer accounts involved in the e-invoicing business in Italy.
The following table lists the contact-related fields involved in the e-invoicing business in Italy.
|
UI field |
API field |
Required |
Description |
|---|---|---|---|
|
Country |
country |
Yes |
From the Country list, select Italy . |
|
Address 1 |
addressLine1 |
Yes |
In the Address 1 field, specify the first line of the Buyer’s address, which is often a street address or business name. For Italy, Address 1 is the name of the street, road, avenue, way, and so on, to which the number of the corresponding building is attached. |
|
Address 2 |
addressLine2 |
Yes |
In the Address 2 field, specify the second line of the Buyer’s address, which is often the name of a building. For Italy, Address 2 is an additional street name used to further clarify the address. |
|
Postal Code |
postalCode |
Yes |
In the Postal Code field, specify the short code that can identify the business address. For Italy, the value is the postal identifier for this address according to the relevant national postal service, such as a ZIP code or post code. |
|
City |
city |
Yes |
In the City field, specify the name of the city where the business is located. For Italy, the value is the name of a city, town, or village. |
|
State/Province |
state |
Yes |
In the State/Province field, specify the name of the state or province where the business is located. For Italy, the value must be an abbreviation code of one province, to which the municipality belongs (only to be entered if the registered office is in Italy). The field value must be two characters, such as RM, MI, and so on. The field value must be an abbreviation code of one province in Italy. If you use another field to store the abbreviation code of the state, you have to customize the template. |