Smart receipts Italy

Description
Actions
Workflows
Documents

Smart Receipts Italy


Developer	Invopop
Category	Government
Scope	B2C
Country	Italy

The AdE (Agenzia delle Entrate) is Italy’s tax authority responsible for managing tax collection and fiscal compliance. The documento commerciale (also known as scontrino elettronico) is a digital fiscal document that records sales transactions and transmits them to the AdE.Italian law requires businesses to transmit sales data digitally through either a certified Registratore Telematico (RT) or the AdE’s online portal. Smart Receipts streamlines this process by providing a secure interface to relay your sales data to the AdE through a local provider.Important distinctions for the Documento Commerciale:

It is not an invoice (fattura) - invoices require detailed buyer information and follow different tax rules.
It does not replace transport documents (documento di trasporto).
It is not a simple internal receipt - it serves an official fiscal function requiring AdE transmission.
It must include VAT at the time of sale - deferred VAT payment is not permitted.

The AdE portal provides functionality to create tickets, void them entirely, and process refunds at the item level. Invopop’s Smart Receipts implementation supports all these operations, allowing you to manage your electronic tickets programmatically through our API or manually via the Console.

Smart Receipts (AdE CF) is not a substitute for SDI. Invopop works with SDI to issue electronic invoices using the FatturaPA and is the main tool available to issue electronic invoices in Italy. AdE CF should only be used when customer information is not available, like in online B2C scenarios.

Key Features

Workflow Automation: This app provides automated workflows for issuing receipts, voiding receipts, and processing refunds through the AdE system.
Real-Time Transmission: Receipts are transmitted to the AdE in real-time, ensuring compliance with Italian e-receipt regulations.
Legally Compliant PDF Receipts: Receipts are generated with all mandatory fields and AdE document numbers, as required by Italian fiscal legislation.
Supplier Registration: Register suppliers with AdE credentials to enable receipt issuance on their behalf.
Item-Level Refunds: Process refunds at the item level using corrective invoices.
GOBL Integration: Uses the open-source GOBL format with the it-ticket-v1 addon for validation and compliance.

Make sure to check out our Smart Receipts Guide for instructions on how to issue receipts and set up your workflows.

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

Smart Receipts issue receipt workflow

This workflow automates Italian documento commerciale processing and transmission to AdE.

Example Smart Receipts issue receipt workflow with states

{
  "name": "Smart Receipts issue receipt",
  "description": "Issue an Italian documento commerciale",
  "schema": "bill/invoice",
  "steps": [
    {
      "id": "0b0bdb00-25b5-11f0-864a-193f213df097",
      "name": "Sign Envelope",
      "provider": "silo.close"
    },
    {
      "id": "04427d60-25b5-11f0-864a-193f213df097",
      "name": "Send a receipt to AdE",
      "provider": "ticket-it.send"
    },
    {
      "id": "9e973e00-2b2d-11f0-984e-0542d5f28f0b",
      "name": "Generate PDF",
      "provider": "pdf",
      "summary": "Italian - A4",
      "config": {
        "logo_height": 40,
        "locale": "it",
        "date_format": "%Y-%m-%d",
        "layout": "A4"
      }
    },
    {
      "id": "112326b0-25b5-11f0-864a-193f213df097",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `sent`{.state .sent}",
      "config": {
        "state": "sent"
      }
    }
  ],
  "rescue": [
    {
      "id": "194a66a0-25b5-11f0-864a-193f213df097",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `error`{.state .error}",
      "config": {
        "state": "error"
      }
    }
  ]
}

Add to my workspace →

Smart Receipts void receipt workflow

This workflow voids receipts that were issued in error through the AdE system.

Example Smart Receipts void receipt workflow with states

{
  "name": "Smart Receipts void receipt",
  "description": "Voids an Italian 'documento commerciale'",
  "schema": "bill/invoice",
  "steps": [
    {
      "id": "02a62be0-2b2e-11f0-984e-0542d5f28f0b",
      "name": "Void a receipt in AdE",
      "provider": "ticket-it.void"
    },
    {
      "id": "1583e220-2b2e-11f0-984e-0542d5f28f0b",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `void`{.state .void}",
      "config": {
        "state": "void"
      }
    }
  ],
  "rescue": [
    {
      "id": "25c98860-2b2e-11f0-984e-0542d5f28f0b",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `error`{.state .error}",
      "config": {
        "state": "error"
      }
    }
  ]
}

Add to my workspace →

Smart Receipts register supplier workflow

This workflow registers a supplier with AdE credentials to enable receipt issuance.

Example Smart Receipts register supplier workflow with states

{
  "name": "Smart Receipts register supplier",
  "description": "Registers a supplier on AdE",
  "schema": "org/party",
  "steps": [
    {
      "id": "1a1be400-2b32-11f0-984e-0542d5f28f0b",
      "name": "Sign Envelope",
      "provider": "silo.close"
    },
    {
      "id": "de116bb0-25b4-11f0-864a-193f213df097",
      "name": "Register a supplier for AdE",
      "provider": "ticket-it.register"
    },
    {
      "id": "e0a1b380-25b4-11f0-864a-193f213df097",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `processing`{.state .processing}",
      "config": {
        "state": "processing"
      }
    }
  ],
  "rescue": [
    {
      "id": "1deb1470-2b32-11f0-984e-0542d5f28f0b",
      "name": "Set State",
      "provider": "silo.state",
      "summary": "Set state to `error`{.state .error}",
      "config": {
        "state": "error"
      }
    }
  ]
}

Add to my workspace →

Smart Receipts Italy B2C Receipt

Documento Commerciale

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": ["it-ticket-v1"],
  "series": "XXIT",
  "code": "001",
  "currency": "EUR",
  "tax": {
    "prices_include": "VAT"
  },
  "type": "standard",
  "supplier": {
    "name": "Cleaning SRL",
    "tax_id": {
      "country": "IT",
      "code": "74230430451"
    }
  },
  "lines": [
    {
      "quantity": "1",
      "item": {
        "name": "Cleaning services",
        "price": "125.00",
        "ext": {
            "it-ticket-product": "services"
        }
      },
      "taxes": [
        {
          "cat": "VAT",
          "ext":{
            "it-ticket-exempt": "N3"
          }
        }
      ]
    },
    {
      "quantity": "3",
      "item": {
        "name": "Cleaning products",
        "price": "137.50",
        "ext": {
            "it-ticket-product": "goods"
        }
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "standard"
        }
      ]
    }
  ]
}

Smart Receipts Italy Corrective Receipt

Corrective Documento Commerciale

{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "IT",
    "$addons": [
        "it-ticket-v1"
    ],
    "uuid": "0196ed40-b4ec-7001-a390-2b3a0b0fab58",
    "type": "corrective",
    "series": "REFUND",
    "code": "001",
    "issue_date": "2025-05-20",
    "currency": "EUR",
    "preceding": [
        {
            "uuid": "0196ed2c-3ca6-7000-b87f-8fb532b45250",
            "type": "standard",
            "issue_date": "2025-05-20",
            "series": "XXIT",
            "code": "001",
            "stamps": [
                {
                    "prv": "ade-ref",
                    "val": "ACUBE2025/0000-7816"
                }
            ]
        }
    ],
    "tax": {
        "prices_include": "VAT"
    },
    "supplier": {
        "name": "Cleaning SRL",
        "tax_id": {
            "country": "IT",
            "code": "74230430451"
        }
    },
    "lines": [
        {
            "i": 1,
            "quantity": "2",
            "item": {
                "name": "Cleaning products",
                "price": "137.50",
                "ext": {
                    "it-ticket-product": "goods"
                }
            },
            "sum": "275.00",
            "taxes": [
                {
                    "cat": "VAT",
                    "rate": "standard",
                    "percent": "22.0%"
                }
            ],
            "total": "275.00",
            "ext": {
                "it-ticket-line-ref": "557647"
            }
        }
    ],
    "totals": {
        "sum": "275.00",
        "tax_included": "49.59",
        "total": "225.41",
        "taxes": {
            "categories": [
                {
                    "code": "VAT",
                    "rates": [
                        {
                            "key": "standard",
                            "base": "225.41",
                            "percent": "22.0%",
                            "amount": "49.59"
                        }
                    ],
                    "amount": "49.59"
                }
            ],
            "sum": "49.59"
        },
        "tax": "49.59",
        "total_with_tax": "275.00",
        "payable": "275.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 Smart Receipts Italy App →

Network

Government

Notify

Format

Document

Storage

Integrations

Smart receipts Italy

Smart Receipts Italy

Send a receipt to AdE

Void a receipt in AdE

Register Issuer in AdE

Participate in our community