SDI Italy

Description
Actions
Workflows
Documents

SDI Sending

SDI Receiving


Developer	Invopop
Category	Government
Country	Italy
Docs	Implementation guide

The SDI (Sistema di Interscambio) is Italy’s central hub for transmitting, validating, and delivering all electronic invoices throughout the country. It is managed by the Italian tax authority (Agenzia delle Entrate).Electronic invoicing is mandatory for all businesses in Italy. 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.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. Invopop has partnered with A-Cube to provide SDI integration services.Key Features

Workflow Automation: This app provides automated workflows for sending and receiving invoices through the SDI system.
FatturaPA XML Generation: Automatically converts GOBL documents into compliant FatturaPA XML format.
Real-Time Status Updates: Automatically handles SDI notifications and status updates, including delivery confirmations and acceptance/rejection notifications.
Bidirectional Support: Send invoices to SDI and receive invoices from suppliers through the same app.
Customer Registration: Register companies to receive invoices through SDI with a simple workflow step.
GOBL FatturaPA Integration: Uses the open-source GOBL FatturaPA library for conversions.

Make sure to check out our SDI Italy Sending Guide and SDI Italy Receiving Guide for instructions on how to issue and receive invoices.

The following workflows are available to make your integration easier. Use them as templates to build upon.

SDI Italy send invoice workflow

This workflow automates FatturaPA invoice generation and submission to SDI.

Example SDI send invoice workflow with states

{
  "name": "SDI send invoice",
  "description": "Generate and issue an invoice through SDI",
  "schema": "bill/invoice",
  "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": "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"
      }
    }
  ]
}

Add to my workspace →

SDI Italy register customer workflow

This workflow registers a company to receive invoices through SDI.

Example SDI supplier registration workflow with states

{
  "name": "SDI register customer",
  "description": "Register a company to receive invoices through SDI",
  "schema": "org/party",
  "steps": [
    {
      "id": "2a34f560-fd13-11ef-998c-e97f18c9212e",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `processing`{.state .processing}",
      "config": {
        "state": "processing"
      }
    },
    {
      "id": "3b5c7890-fd13-11ef-998c-e97f18c9212e",
      "name": "Register SDI Customer (Italy)",
      "provider": "sdi-it.register",
      "summary": "Register company as receiver",
      "config": {
        "environment": "production"
      }
    },
    {
      "id": "4c6d8910-fd13-11ef-998c-e97f18c9212e",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `registered`{.state .registered}",
      "config": {
        "state": "registered"
      }
    }
  ],
  "rescue": [
    {
      "id": "5d7e9a20-fd13-11ef-998c-e97f18c9212e",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `error`{.state .error}",
      "config": {
        "state": "error"
      }
    }
  ]
}

Add to my workspace →

SDI Italy import invoices workflow

This workflow imports and processes invoices received through SDI.

Example SDI import invoice workflow with states

{
  "name": "Import SDI Invoices",
  "description": "Import and process invoices received through SDI",
  "schema": "bill/invoice",
  "steps": [
    {
      "id": "6e8f0b30-fd13-11ef-998c-e97f18c9212e",
      "name": "Import from SDI (Italy)",
      "provider": "sdi-it.import",
      "summary": "Convert received FatturaPA to GOBL",
      "config": {
        "environment": "production"
      }
    },
    {
      "id": "7f9a1c40-fd13-11ef-998c-e97f18c9212e",
      "name": "Generate PDF",
      "provider": "pdf",
      "summary": "Italian",
      "config": {
        "date_format": "%Y-%m-%d",
        "locale": "it",
        "logo_height": 40
      }
    },
    {
      "id": "8a0b2d50-fd13-11ef-998c-e97f18c9212e",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `sent`{.state .sent}",
      "config": {
        "state": "sent"
      }
    }
  ],
  "rescue": [
    {
      "id": "9b1c3e60-fd13-11ef-998c-e97f18c9212e",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `error`{.state .error}",
      "config": {
        "state": "error"
      }
    }
  ]
}

Add to my workspace →

SDI Italy B2C Invoice

SDI B2C Invoice

{
  "$schema": "https://gobl.org/draft-0/envelope",
  "head": {
    "uuid": "8a51fd30-2a27-11ee-be56-0242ac120002",
    "dig": {
      "alg": "sha256",
      "val": "0444abdd6581a1523df9db5d2ab9c4acc4032a839524adfaf044fa5427061d86"
    }
  },
  "doc": {
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "IT",
    "$addons": [
      "it-sdi-v1"
    ],
    "uuid": "0190a63a-1a80-7e1e-a868-08c7859b6470",
    "type": "standard",
    "series": "FT",
    "code": "020",
    "issue_date": "2024-07-12",
    "currency": "EUR",
    "tax": {
      "prices_include": "VAT",
      "ext": {
        "it-sdi-document-type": "TD01",
        "it-sdi-format": "FPR12"
      }
    },
    "supplier": {
      "name": "Company Name S.r.l.",
      "tax_id": {
        "country": "IT",
        "code": "12345678903"
      },
      "addresses": [
        {
          "num": "102",
          "street": "Via California",
          "locality": "Palermo",
          "region": "PA",
          "code": "33213",
          "country": "IT"
        }
      ],
      "registration": {
        "capital": "50000.00",
        "currency": "EUR",
        "office": "RM",
        "entry": "123456"
      },
      "ext": {
        "it-sdi-fiscal-regime": "RF01"
      }
    },
    "customer": {
      "name": "Monica Bellucci",
      "tax_id": {
        "country": "IT"
      },
      "identities": [
        {
          "key": "it-fiscal-code",
          "code": "RSSGNN60R30H501U"
        }
      ],
      "addresses": [
        {
          "num": "23",
          "street": "Via dei Mille",
          "locality": "Firenze",
          "region": "FI",
          "code": "00100",
          "country": "IT"
        }
      ]
    },
    "lines": [
      {
        "i": 1,
        "quantity": "1",
        "item": {
          "name": "Cleaning services",
          "price": "125.00"
        },
        "sum": "125.00",
        "taxes": [
          {
            "cat": "VAT",
            "rate": "standard",
            "percent": "22.0%"
          }
        ],
        "total": "125.00"
      }
    ],
    "totals": {
      "sum": "125.00",
      "tax_included": "22.54",
      "total": "102.46",
      "taxes": {
        "categories": [
          {
            "code": "VAT",
            "rates": [
              {
                "key": "standard",
                "base": "102.46",
                "percent": "22.0%",
                "amount": "22.54"
              }
            ],
            "amount": "22.54"
          }
        ],
        "sum": "22.54"
      },
      "tax": "22.54",
      "total_with_tax": "125.00",
      "payable": "125.00"
    }
  }
}

SDI Italy B2B Invoice

SDI B2B Invoice

{
    "$schema": "https://gobl.org/draft-0/envelope",
    "head": {
        "uuid": "8a51fd30-2a27-11ee-be56-0242ac120002",
        "dig": {
            "alg": "sha256",
            "val": "2b18783af475c77b4cdb71836d64b31d3044588601a164c019b3c71f17add07b"
        }
    },
    "doc": {
        "$schema": "https://gobl.org/draft-0/bill/invoice",
        "$regime": "IT",
        "$addons": [
            "it-sdi-v1"
        ],
        "uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
        "type": "standard",
        "series": "SAMPLE",
        "code": "002",
        "issue_date": "2023-05-21",
        "currency": "EUR",
        "tax": {
            "prices_include": "VAT",
            "ext": {
                "it-sdi-document-type": "TD01",
                "it-sdi-format": "FPR12"
            }
        },
        "supplier": {
            "name": "Hotel California",
            "tax_id": {
                "country": "IT",
                "code": "12345678903"
            },
            "addresses": [
                {
                    "num": "102",
                    "street": "Via California",
                    "locality": "Palermo",
                    "region": "PA",
                    "code": "33213",
                    "country": "IT"
                }
            ],
            "registration": {
                "capital": "50000.00",
                "currency": "EUR",
                "office": "RM",
                "entry": "123456"
            },
            "ext": {
                "it-sdi-fiscal-regime": "RF01"
            }
        },
        "customer": {
            "name": "Mela S.r.l.",
            "tax_id": {
                "country": "IT",
                "code": "13029381004"
            },
            "inboxes": [
                {
                    "key": "it-sdi-code",
                    "code": "M5UXCR5"
                }
            ],
            "addresses": [
                {
                    "num": "23",
                    "street": "Via dei Mille",
                    "locality": "Firenze",
                    "region": "FI",
                    "code": "00100",
                    "country": "IT"
                }
            ]
        },
        "lines": [
            {
                "i": 1,
                "quantity": "1",
                "item": {
                    "name": "Tassa di Soggiorno",
                    "price": "1.00"
                },
                "sum": "1.00",
                "taxes": [
                    {
                        "cat": "VAT",
                        "rate": "exempt",
                        "ext": {
                            "it-sdi-exempt": "N4"
                        }
                    }
                ],
                "total": "1.00"
            },
            {
                "i": 2,
                "quantity": "1",
                "item": {
                    "name": "Camera Matrimoniale",
                    "price": "125.00"
                },
                "sum": "125.00",
                "taxes": [
                    {
                        "cat": "VAT",
                        "rate": "intermediate",
                        "percent": "10.0%"
                    }
                ],
                "total": "125.00"
            }
        ],
        "totals": {
            "sum": "126.00",
            "tax_included": "11.36",
            "total": "114.64",
            "taxes": {
                "categories": [
                    {
                        "code": "VAT",
                        "rates": [
                            {
                                "key": "exempt",
                                "ext": {
                                    "it-sdi-exempt": "N4"
                                },
                                "base": "1.00",
                                "amount": "0.00"
                            },
                            {
                                "key": "intermediate",
                                "base": "113.64",
                                "percent": "10.0%",
                                "amount": "11.36"
                            }
                        ],
                        "amount": "11.36"
                    }
                ],
                "sum": "11.36"
            },
            "tax": "11.36",
            "total_with_tax": "126.00",
            "payable": "126.00"
        }
    }
}

SDI Italy B2B Invoice with Additional Fields

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": "[email protected]"
      }
    ],
    "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": "[email protected]"
      }
    ]
  },
  "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 Italy Credit Note

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"
    }
}

🇮🇹 Invopop resources for Italy


Compliance	Invoicing compliance in Italy Compliance timeline
Apps	SDI Italy Smart Receipts Italy
Guides	SDI Sending Guide SDI Receiving Guide Ticket Guide
FAQ	Italy FAQ
GOBL	Italy Tax Regime Italy SDI FatturaPA Addon Italy AdE Ticket Addon
GitHub	gobl.fatturapa

Participate in our community

Ask and answer questions about SDI Italy App →

Government

Notify

Format

Document

Storage

Integrations

SDI Sending

SDI Receiving

Send FatturaPA to SDI (Italy)

Register party with SDI (Italy)

Import FatturaPA from SDI (Italy)

Participate in our community