🇮🇹 Italy · SDI Sending

Introduction

Electronic invoicing is mandatory for all businesses in Italy. The Sistema di Interscambio (SDI) serves as the Italian government’s central hub for transmitting, validating, and delivering all electronic invoices throughout the country.

The SDI system operates using a standardized XML format called FatturaPA, which ensures all invoices contain the required information and comply with the strict validation rules established by the Italian tax authority (Agenzia delle Entrate). To ensure proper routing of invoices to the correct recipient, the SDI system uses a unique identifier called a Recipient Code, which is assigned to each registered SDI provider.

Invopop simplifies SDI integration by allowing you to work with GOBL format instead of XML, providing synchronous validation before submission, and offering a simple API integration with automatic handling of SDI notifications and status updates. For receiving invoices through SDI, see our companion guide: Italy - SDI: Receiving Invoices.

Setup

Connect the SDI Italy app

Navigate to Configuration → Apps
Locate SDI Italy in the app discovery list
Tap Connect to activate

The initial connection requires no configuration for sending invoices.

Configure sending workflow

First, review our workflows guide to understand the basics of setting up workflows, then create a workflow with these essential steps:

Sign Envelope - Signs the GOBL document. This can be substituted with Add Sequential Code with the Sign Document option enabled.
Generate FatturaPA - Converts the GOBL document to FatturaPA XML format and attaches it to the original invoice entry.
Send to SDI (Italy) - Takes the generated XML attachment and sends it to SDI. If sandbox is chosen as the environment, the simulated response from SDI must be set.

The legacy Send to SDI (Italy) (Legacy) step that combines both generation and sending is still available, but its use is discouraged. It is marked with a legacy tag.

SDI does not have a sandbox environment. When sandbox mode is selected, Invopop’s third-party submission service, A-Cube, simulates a response from SDI.

This JSON can be copied and pasted while editing a Workflow in “developer” mode. The example adds support for setting states on silo entries and handling errors, both of which are strongly recommended.

{
    "name": "Invoice - Send with States",
    "description": "Generate and issue an invoice through SDI and set the state to `sent` if successful",
    "steps": [
        {
            "id": "1a692ae0-cd12-11ef-998c-e97f18c9212e",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            }
        },
        {
            "id": "1855b430-cd12-11ef-998c-e97f18c9212e",
            "name": "Sign Envelope",
            "provider": "silo.close"
        },
        {
            "id": "24f5c340-fd12-11ef-998c-e97f18c9212e",
            "name": "Generate FatturaPA",
            "provider": "sdi-it.generate",
            "summary": "Create XML document"
        },
        {
            "id": "2042f860-cd12-11ef-998c-e97f18c9212e",
            "name": "Send to SDI (Italy)",
            "provider": "sdi-it.send",
            "summary": "Sandbox · Accepted by PA (Notifica esito)",
            "config": {
                "environment": "sandbox",
                "response": "NE"
            }
        },
        {
            "id": "236965b0-cd12-11ef-998c-e97f18c9212e",
            "name": "Generate PDF",
            "provider": "pdf",
            "summary": "Italian",
            "config": {
                "date_format": "%Y-%m-%d",
                "locale": "it",
                "logo_height": 40
            }
        },
        {
            "id": "2b6db450-cd12-11ef-998c-e97f18c9212e",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `sent`{.state .sent}",
            "config": {
                "state": "sent"
            }
        }
    ],
    "rescue": [
        {
            "id": "2d5d7660-cd12-11ef-998c-e97f18c9212e",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            }
        }
    ]
}

Sending Invoices

Invopop uses the GOBL FatturaPA library to process conversions. When creating invoices for SDI, you need to:

Set the regime field to IT in your GOBL invoice
Add the it-sdi-v1 addon to enable Italian-specific validations and extensions

Detailed information about the SDI-specific extensions and validations can be found in:

Example invoices are provided below, or you can use the GOBL Builder to create custom invoices.

How the process works

Generate FatturaPA

This step converts a GOBL invoice into the required FatturaPA XML format and stores it as an attachment to the silo entry.

Send to SDI

This step takes the generated XML attachment and sends it to SDI through our integration partner. The SDI service usually responds within seconds but may take up to 24 hours. While waiting, this step remains in a Queued state.

A legacy combined step that performs both generation and sending in one operation is also available. While still functional, we recommend using the separate steps for better control and error handling.

When the Send step completes, it returns one of three results:

OK if successful
KO for unrecoverable errors
SKIP if the invoice was already sent

Example Invoices

SDI B2B Invoice
{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "IT",
    "$addons": [
        "it-sdi-v1"
    ],
    "$tags": [
        "freelance"
    ],
    "uuid": "0190c0ec-8109-756b-a4f0-88c4b542ab6e",
    "type": "standard",
    "series": "SAMPLE",
    "code": "001",
    "issue_date": "2023-03-02",
    "currency": "EUR",
    "tax": {
        "ext": {
            "it-sdi-document-type": "TD06",
            "it-sdi-format": "FPR12"
        }
    },
    "supplier": {
        "name": "MªF. Services",
        "tax_id": {
            "country": "IT",
            "code": "12345678903"
        },
        "people": [
            {
                "name": {
                    "given": "GIANCARLO",
                    "surname": "ROSSI"
                }
            }
        ],
        "addresses": [
            {
                "num": "1",
                "street": "VIALE DELLA LIBERTÀ",
                "locality": "ROMA",
                "region": "RM",
                "code": "00100",
                "country": "IT"
            }
        ],
        "ext": {
            "it-sdi-fiscal-regime": "RF01"
        }
    },
    "customer": {
        "name": "MARIO LEONI",
        "tax_id": {
            "country": "IT",
            "code": "09876543217"
        },
        "addresses": [
            {
                "num": "32",
                "street": "VIALE DELI LAVORATORI",
                "locality": "FIRENZE",
                "region": "FI",
                "code": "50100",
                "country": "IT"
            }
        ]
    },
    "lines": [
        {
            "i": 1,
            "quantity": "20",
            "item": {
                "name": "Development services",
                "price": "90.00",
                "unit": "h"
            },
            "sum": "1800.00",
            "taxes": [
                {
                    "cat": "VAT",
                    "rate": "standard",
                    "percent": "22.0%"
                }
            ],
            "total": "1800.00"
        }
    ],
    "totals": {
        "sum": "1800.00",
        "total": "1800.00",
        "taxes": {
            "categories": [
                {
                    "code": "VAT",
                    "rates": [
                        {
                            "key": "standard",
                            "base": "1800.00",
                            "percent": "22.0%",
                            "amount": "396.00"
                        }
                    ],
                    "amount": "396.00"
                }
            ],
            "sum": "396.00"
        },
        "tax": "396.00",
        "total_with_tax": "2196.00",
        "payable": "2196.00"
    }
}

SDI B2B Invoice
{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "IT",
    "$addons": [
        "it-sdi-v1"
    ],
    "$tags": [
        "freelance"
    ],
    "uuid": "0190c0ec-8109-756b-a4f0-88c4b542ab6e",
    "type": "standard",
    "series": "SAMPLE",
    "code": "001",
    "issue_date": "2023-03-02",
    "currency": "EUR",
    "tax": {
        "ext": {
            "it-sdi-document-type": "TD06",
            "it-sdi-format": "FPR12"
        }
    },
    "supplier": {
        "name": "MªF. Services",
        "tax_id": {
            "country": "IT",
            "code": "12345678903"
        },
        "people": [
            {
                "name": {
                    "given": "GIANCARLO",
                    "surname": "ROSSI"
                }
            }
        ],
        "addresses": [
            {
                "num": "1",
                "street": "VIALE DELLA LIBERTÀ",
                "locality": "ROMA",
                "region": "RM",
                "code": "00100",
                "country": "IT"
            }
        ],
        "ext": {
            "it-sdi-fiscal-regime": "RF01"
        }
    },
    "customer": {
        "name": "MARIO LEONI",
        "tax_id": {
            "country": "IT",
            "code": "09876543217"
        },
        "addresses": [
            {
                "num": "32",
                "street": "VIALE DELI LAVORATORI",
                "locality": "FIRENZE",
                "region": "FI",
                "code": "50100",
                "country": "IT"
            }
        ]
    },
    "lines": [
        {
            "i": 1,
            "quantity": "20",
            "item": {
                "name": "Development services",
                "price": "90.00",
                "unit": "h"
            },
            "sum": "1800.00",
            "taxes": [
                {
                    "cat": "VAT",
                    "rate": "standard",
                    "percent": "22.0%"
                }
            ],
            "total": "1800.00"
        }
    ],
    "totals": {
        "sum": "1800.00",
        "total": "1800.00",
        "taxes": {
            "categories": [
                {
                    "code": "VAT",
                    "rates": [
                        {
                            "key": "standard",
                            "base": "1800.00",
                            "percent": "22.0%",
                            "amount": "396.00"
                        }
                    ],
                    "amount": "396.00"
                }
            ],
            "sum": "396.00"
        },
        "tax": "396.00",
        "total_with_tax": "2196.00",
        "payable": "2196.00"
    }
}

SDI B2B Invoice with additional fields
{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$regime": "IT",
  "$addons": [
    "it-sdi-v1"
  ],
  "$tags": [
    "freelance"
  ],
  "uuid": "0190c0ec-8109-756b-a4f0-88c4b542ab6e",
  "type": "standard",
  "series": "SAMPLE",
  "code": "001",
  "issue_date": "2023-03-02",
  "currency": "EUR",
  "tax": {
    "ext": {
      "it-sdi-document-type": "TD06",
      "it-sdi-format": "FPR12"
    }
  },
  "supplier": {
    "name": "MªF. Services",
    "tax_id": {
      "country": "IT",
      "code": "12345678903"
    },
    "people": [
      {
        "name": {
          "given": "GIANCARLO",
          "surname": "ROSSI"
        }
      }
    ],
    "addresses": [
      {
        "num": "1",
        "street": "VIALE DELLA LIBERTÀ",
        "locality": "ROMA",
        "region": "RM",
        "code": "00100",
        "country": "IT"
      }
    ],
    "emails": [
      {
        "addr": "billing@example.com"
      }
    ],
    "telephones": [
      {
        "num": "999999999"
      }
    ],
    "registration": {
      "capital": "50000.00",
      "currency": "EUR",
      "office": "RM",
      "entry": "123456"
    },
    "ext": {
      "it-sdi-fiscal-regime": "RF02"
    }
  },
  "customer": {
    "name": "MARIO LEONI",
    "tax_id": {
      "country": "IT",
      "code": "09876543217"
    },
    "people": [
      {
        "name": {
          "prefix": "Dott.",
          "given": "MARIO",
          "surname": "LEONI"
        }
      }
    ],
    "inboxes": [
      {
        "key": "it-sdi-code",
        "code": "ABCDEF1"
      }
    ],
    "addresses": [
      {
        "num": "32",
        "street": "VIALE DELI LAVORATORI",
        "locality": "FIRENZE",
        "region": "FI",
        "code": "50100",
        "country": "IT"
      }
    ],
    "emails": [
      {
        "addr": "leoni@mario.com"
      }
    ]
  },
  "lines": [
    {
      "i": 1,
      "quantity": "20",
      "item": {
        "name": "Development services",
        "price": "90.00",
        "unit": "h"
      },
      "sum": "1800.00",
      "discounts": [
        {
          "reason": "Special discount",
          "percent": "10%",
          "amount": "180.00"
        }
      ],
      "taxes": [
        {
          "cat": "VAT",
          "rate": "standard",
          "percent": "22.0%"
        }
      ],
      "total": "1620.00"
    },
    {
      "i": 2,
      "quantity": "1",
      "item": {
        "name": "Special Untaxed Work",
        "price": "100.00",
        "unit": "h"
      },
      "sum": "100.00",
      "taxes": [
        {
          "cat": "VAT",
          "rate": "exempt",
          "ext": {
            "it-sdi-exempt": "N2.2",
            "it-sdi-vat-liability": "S"
          }
        }
      ],
      "total": "100.00"
    }
  ],
  "discounts": [
    {
      "i": 1,
      "reason": "10th year anniversary discount",
      "base": "1720.00",
      "percent": "50%",
      "amount": "860.00"
    }
  ],
  "charges": [
    {
      "i": 1,
      "reason": "10th year anniversary charge",
      "base": "1720.00",
      "percent": "10%",
      "amount": "172.00"
    }
  ],
  "payment": {
    "instructions": {
      "key": "card",
      "ext": {
        "it-sdi-payment-means": "MP08"
      }
    }
  },
  "totals": {
    "sum": "1720.00",
    "discount": "860.00",
    "charge": "172.00",
    "total": "1032.00",
    "taxes": {
      "categories": [
        {
          "code": "VAT",
          "rates": [
            {
              "key": "standard",
              "base": "1620.00",
              "percent": "22.0%",
              "amount": "356.40"
            },
            {
              "key": "exempt",
              "ext": {
                "it-sdi-exempt": "N2.2",
                "it-sdi-vat-liability": "S"
              },
              "base": "100.00",
              "amount": "0.00"
            }
          ],
          "amount": "356.40"
        }
      ],
      "sum": "356.40"
    },
    "tax": "356.40",
    "total_with_tax": "1388.40",
    "payable": "1388.40"
  }
}

SDI Credit Note
{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "IT",
    "$addons": [
        "it-sdi-v1"
    ],
    "$tags": [
        "freelance"
    ],
    "uuid": "019270f3-513e-71e2-b2e3-47f8321a09ac",
    "type": "credit-note",
    "series": "CN",
    "code": "001",
    "issue_date": "2024-10-09",
    "currency": "EUR",
    "preceding": [
        {
            "uuid": "0190c0ec-8109-756b-a4f0-88c4b542ab6e",
            "type": "standard",
            "issue_date": "2023-03-02",
            "series": "SAMPLE",
            "code": "001"
        }
    ],
    "tax": {
        "ext": {
            "it-sdi-document-type": "TD04",
            "it-sdi-format": "FPR12"
        }
    },
    "supplier": {
        "name": "MªF. Services",
        "tax_id": {
            "country": "IT",
            "code": "12345678903"
        },
        "people": [
            {
                "name": {
                    "given": "GIANCARLO",
                    "surname": "ROSSI"
                }
            }
        ],
        "addresses": [
            {
                "num": "1",
                "street": "VIALE DELLA LIBERTÀ",
                "locality": "ROMA",
                "region": "RM",
                "code": "00100",
                "country": "IT"
            }
        ],
        "registration": {
            "capital": "50000.00",
            "currency": "EUR",
            "office": "RM",
            "entry": "123456"
        },
        "ext": {
            "it-sdi-fiscal-regime": "RF02"
        }
    },
    "customer": {
        "name": "MARIO LEONI",
        "tax_id": {
            "country": "IT",
            "code": "09876543217"
        },
        "people": [
            {
                "name": {
                    "prefix": "Dott.",
                    "given": "MARIO",
                    "surname": "LEONI"
                }
            }
        ],
        "addresses": [
            {
                "num": "32",
                "street": "VIALE DELI LAVORATORI",
                "locality": "FIRENZE",
                "region": "FI",
                "code": "50100",
                "country": "IT"
            }
        ]
    },
    "lines": [
        {
            "i": 1,
            "quantity": "20",
            "item": {
                "name": "Development services",
                "price": "90.00",
                "unit": "h"
            },
            "sum": "1800.00",
            "taxes": [
                {
                    "cat": "VAT",
                    "rate": "standard",
                    "percent": "22.0%"
                }
            ],
            "total": "1800.00"
        }
    ],
    "totals": {
        "sum": "1800.00",
        "total": "1800.00",
        "taxes": {
            "categories": [
                {
                    "code": "VAT",
                    "rates": [
                        {
                            "key": "standard",
                            "base": "1800.00",
                            "percent": "22.0%",
                            "amount": "396.00"
                        }
                    ],
                    "amount": "396.00"
                }
            ],
            "sum": "396.00"
        },
        "tax": "396.00",
        "total_with_tax": "2196.00",
        "payable": "2196.00"
    }
}

FAQ

Invopop handles both Italian tax identification numbers in the supplier and customer sections of invoices:

Partita IVA (VAT number): Automatically extracted from the tax_id/code field.
Codice Fiscale (fiscal code): Must be specified as an identity with the key it-fiscal-code.

Here’s an example showing both identifiers in a supplier object:

Supplier with Partita IVA and Codice Fiscale
{
    "supplier": {
        "name": "MªF. Services",
        "tax_id": {
            "country": "IT",
            "code": "12345678903"
        },
        "identities": [
            {
                "key": "it-fiscal-code",
                "code": "MRTMTT91D08F205J"
            }
        ],
    }
}

For more information on receiving invoices, see our Italy - SDI: Receiving Invoices guide.

Technical Details

When the SDI step processes a document, it returns detailed status codes that provide information about the response from SDI:

Code	Description
`rejected`	Notifica di scarto (NS) SDI has rejected the invoice because it contains errors.
`delivered`	Ricevuta consegna (RC) SDI has successfully delivered a B2B invoice to the recipient.
`delivered-pa`	Ricevuta consegna (RC) SDI has successfully delivered an invoice to a Public Administration (PA).
`not-delivered`	Mancata consegna (MC) SDI could not deliver the invoice to the recipient.
`not-delivered`	Attestazione trasmissione con impossibilità di recapito (AT) SDI couldn’t deliver an invoice to PA after 10 days.
`accepted-pa`	Notifica esito (NE) A PA has decided to accept an invoice (outcome EC01).
`rejected-pa`	Notifica esito (NE) A PA has decided to reject an invoice (outcome EC02).
`deadline-terms`	Notifica decorrenza termini (DT) A PA didn’t reply with acceptance or rejection within 15 days.
`invoice-error`	An error occurred during the acquisition of a notification.
`sent`	The invoice has been submitted to SDI and is awaiting a response.
`not-received`	The invoice was not received by the recipient.

Some SDI notifications (File metadati - MT, Esito committente - EC, Scarto esito committente - SE) don’t directly change the code of the invoice.

These codes map to different step results as follows:

OK Result: delivered, not-delivered, not-received, accepted-pa
KO Result: rejected, rejected-pa, invoice-error, deadline-terms
QUEUED Result: sent, delivered-pa

When a step returns QUEUED, the workflow will check again later for updates from SDI.

Getting Started

Use Cases

Feature Guides

Country Guides

Integrations

🇮🇹 Italy · SDI Sending

Introduction

Setup

Sending Invoices

How the process works

Example Invoices

FAQ

Technical Details

Getting Started

Use Cases

Feature Guides

Country Guides

Integrations

​Introduction

​Setup

​Sending Invoices

​How the process works

​Example Invoices

​FAQ

​Technical Details

Introduction

Setup

Sending Invoices

How the process works

Example Invoices

FAQ

Technical Details