Skip to main content

Manage country-specific configurations for Italy

Zuora

Manage country-specific configurations for Italy

  1. Last updated
  2. Save as PDF

If you are a business provider selling products and services in Italy, you must be registered for value-added tax (VAT) and have a VAT number. Additionally, to receive documents inbound, your clients must provide a VAT number and Codice Destinatario. The Codice Destinatario enables the identification of the communication channel between the Sistema di Interscambio (SDI) and the recipient.

Configure e-invoicing in Sovos for Italy

To configure e-invoicing for invoice clearance for Italy, you must require the creation of a company in Sovos. After obtaining authentication keys from Sovos, and retrieving your organization ID from Sovos, you can call a dedicated configuration endpoint to create a company and assign a product.

For more information about how to register your company, see Sovos eInvoice configuration steps.

Manage field mapping for e-invoice file templates

In the e-invoicing clearance process in Italy, ensure that the field mapping for e-invoice file templates is complete and correct.

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

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

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

Specify states on contacts and business regions

In the e-invoicing clearance process in Italy, both the seller and the buyer must provide their states.

  • The state field stores the political or administrative division of an address, such as the county, province, or state, in text format.
  • For Italy, this field must contain a 2-character abbreviation code for the province where the municipality is located. It is only required if the registered office is in Italy. For example, RM, MI, and so on.
  • The state field is mandatory for the business region, which holds the business details of the Seller, and mandatory for the bill-to contact, which contains the address of the Buyer.

Create custom fields specific to e-invoicing

You must create and manage custom fields to store country-specific information for mapping to Sovos. The e-invoicing in Italy requires an identifier for the referenced document for credit memos and debit memos.

The e-invoicing in Italy requires an additional document about a billing document. The following values are allowed for the additional document: 

  • OrdineAcquisto (Purchase Order) 
  • Contratto (Contract) 
  • Convenzione (Convention) 
  • Ricezione (Reception) 
  • FattureCollegate (Connected Invoices).

Assume that Contract is used for the default e-invoicing mapping. It is best practice to use the objects and custom fields listed in the following table, while you have the flexibility to use different objects or names.

Object Custom field Notes

Subscription

AgreementLink__c

Create this custom field of the string type for the invoices generated from subscriptions. 

E-invoicing in Italy requires a contract number that is a reference to an additional document. Use the AgreementLink__c custom field on the Subscription object for subscription invoices.

Invoice

AgreementLink__c

Create this custom field of the string type for standalone invoices.

E-invoicing in Italy requires a contract number. Use the AgreementLink__c custom field on the Invoice object for standalone invoices.

Credit Memo

AgreementLink__c

Create this custom field of the string type for standalone credit memos created from product rate plan charges.

Credit memos and debit memos require an identifier for the referenced document. 

If a credit memo or debit memo is created from an invoice, the referenced document is retrieved from the associated invoice.

Debit Memo

AgreementLink__c

Create this custom field of the string type for standalone debit memos created from product rate plan charges.

Credit memos and debit memos require an identifier for the referenced document. 

If a credit memo or debit memo is created from an invoice, the referenced document is retrieved from the associated invoice.

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.

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

  • QrCode: This field is empty for Italy. 
  • ReferenceNumber: This field stores a unique number generated by the tax authority. In Italy, it is a unique identifier assigned to each electronically submitted invoice by the Italy tax authority, known as Agenzia delle Entrate. The information is obtained from the IdentificativoSdI field in the cleared document.
  • 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 the format of FatturaPA (XML).