Skip to main content

SDI Setup Guide

SDI (Sistema di Interscambio) is the Italian national e-invoicing system managed by the Italian Revenue Agency (Agenzia delle Entrate). All invoices issued in Italy must be transmitted through SDI.

Follow the steps below to obtain the credentials needed to connect Invoicerr to SDI.

1. Obtain your Italian VAT number (Partita IVA)​

Your company must have an Italian Partita IVA (VAT number).

  • If you are registered for VAT in Italy, your Partita IVA is your 11-digit tax ID.
  • Foreign companies must register for a direct Italian VAT number or appoint a fiscal representative (rappresentante fiscale) in Italy.

2. Choose your SDI channel​

SDI supports several transmission channels in general — PEC (certified email), a web service (API), FTP/SFTP, and the Revenue Agency's own SdICoop client. Invoicerr implements exactly one of these: SdICoop, the SOAP web-service channel. There is no PEC, FTP, or generic-API option in Invoicerr's own SDI connection form — if you want to use this integration, register the SdICoop channel with the Revenue Agency.

3. Obtain SDI API credentials​

To use the SDI web service API:

  1. Go to the Fattura Elettronica portal: https://fatturaelettronica.agenziaentrate.gov.it
  2. Log in with your SPID, CIE, or CNS digital identity.
  3. Navigate to Servizi → Ricezione fatture (Invoice reception) and accredit for the SdICoop web-service channel — the one Invoicerr implements (see step 2 above).
  4. Get accredited as an intermediary and obtain:
    • your IdTrasmittente (transmitter ID),
    • the SdIRiceviFile endpoint URL the Agency hands your accredited account,
    • a PFX client certificate (and its password) for that channel.

4. Understand the SDI invoice flow​

SDI acts as a relay — it does not validate invoice content but verifies the format and routes the invoice to the recipient:

flowchart LR
  Sender -->|Invoice XML| SDI
  SDI -->|Forward| Receiver
  SDI -->|Receipt| Sender

Invoice lifecycle:

  1. You send an XML invoice to SDI via your chosen channel.
  2. SDI sends back a ricevuta (receipt): Consegnato (delivered) or Scartato (rejected).
  3. SDI forwards the invoice to the recipient's SDI channel.
  4. The recipient can accept or reject the invoice.

5. Connect Invoicerr to SDI​

Once you have your credentials, configure the SDI channel in Invoicerr:

  1. Go to Settings → E-invoicing. The screen shows legal channels on the left and, for the selected one, the operators that implement it on the right. For an Italian company, Sistema di Interscambio (SdI) is the country's own legal channel; it opens pre-selected and carries a "Mandatory" badge (SdI has been the law since 2019).

  2. Select Sistema di Interscambio (SdI) on the left, then find **Sistema di Interscambio (SdI)

    • direct (SDICoop)** in the operator list on the right and click Connect:
    The SdI legal channel, with the direct SDICoop operator to connect

    A-Cube also appears in this list and builds the same FatturaPA format, but Italy's own SdI mandate is satisfied only by the direct channel or a PEC mailbox, never by A-Cube specifically; connecting it instead would show as refused at send. See the SDICoop accreditation prerequisite above for why the direct operator is what this guide connects.

  3. In the side sheet that opens, fill in the four fields this channel actually asks for:

    • IdTrasmittente — your transmitter ID from step 3 above
    • SdIRiceviFile endpoint URL — the exact URL the Revenue Agency handed your accredited account
    • PFX certificate (base64) — your SdICoop client certificate
    • Certificate password — optional; a real PFX can legitimately carry an empty one
    • Environment — TEST or PRODUCTION (the same selector every channel offers)

  4. Click Connect at the bottom of the side sheet.

This module is implemented but, as of this writing, has never been run against SdI's real production endpoint — see the accreditation note above and "Known limitation" below before relying on it for a live invoice.

Invoicerr will use these credentials to authenticate with the SDI system and transmit invoices on your behalf.

How the recipient is addressed​

SDI routes an invoice to its recipient using a Codice Destinatario: seven characters for an ordinary business, six for a public administration (the Codice Univoco Ufficio, looked up from IndicePA), or a PEC address instead. Record whichever the client gave you on the client's page.

When the client has none of them:

  • an Italian client gets 0000000, and SDI makes the invoice available in the client's own reserved area on the Revenue Agency's portal;
  • a client established abroad gets XXXXXXX, the code SDI keeps for transmitting the data of an invoice to a foreign buyer.

Regime forfettario​

If your company is under the regime forfettario, turn on the VAT exemption toggle in Settings → Company. Your invoices then carry no VAT, and the FatturaPA file declares the forfettario regime (RF19) with the nature code N2.2 on every line, as the Revenue Agency requires.

Additional resources​