# Smart Receipts

<!-- markdownlint-disable MD013 -->

**Who this is for:** The finance or accounting contact at your organisation responsible for fiscal receipts in Italy. **What it covers:** How Smart Receipts work in the Lavanda PMS, the information we need from you, and the steps to enable them on your workspace.

Smart Receipts let you issue the documento commerciale directly from the Lavanda PMS and send it electronically to the Italian Revenue Agency (AdE) at the moment it is issued. Delivered in partnership with Invopop.

## No fiscal printer needed

Italian law requires sales data to be transmitted to the AdE either through a certified fiscal printer (Registratore Telematico, RT) or through the AdE's online service. Smart Receipts use the online service, through Invopop's local partner, so you do **not** need to:

- **Buy** a fiscal printer for each building or point of sale.
- **Maintain** it, including servicing and the periodic checks a certified printer requires.
- **Integrate** it with the PMS or your payment devices.

Receipts are issued and reported from the PMS, with no hardware on site.

______________________________________________________________________

## 1. How Smart Receipts work

1. A payment's receipt is allocated to an issued invoice in the PMS, in full or in part.
2. Lavanda raises a documento commerciale for the amount allocated and sends it to Invopop.
3. Invopop reports it to the AdE in your name, using the AdE credentials you registered.
4. Invopop assigns the document number from your series. The AdE accepts it and adds the Riferimento AdE. Both numbers appear on the PDF, which is produced by Invopop and attached to the document in the PMS.

Each payment gets its own documento commerciale. If more of a payment is allocated later, for example to a second invoice, a further documento commerciale is issued for the extra amount only. A payment that is not allocated to an issued invoice gets none until it is, so you choose when a payment is reported by when you issue its invoice.

The VAT rates come from the invoice the payment is allocated to. A part payment is split across the invoice's rates in proportion. Lines at 0% VAT are reported as exempt with nature code `N4`.

When a payment pays one invoice in full, the documento commerciale repeats the invoice's lines. Otherwise it has one line per VAT rate, described as a payment against the invoice so the guest does not read it as the whole bill paid: for example *Pagamento parziale fattura n. 2026/0142 - Colazione*. A payment that covers its invoices in full is described as *Pagamento* rather than *Pagamento parziale*.

When you credit an invoice and refund the payment that paid it, or a chargeback is recorded against a payment after its invoice is credited, Lavanda voids the payment's documento commerciale with the AdE (an *annullo*). If part of the payment is kept, a new documento commerciale is issued for the amount kept once the AdE accepts the void, citing the voided document's number and date and the refund: for example *sostituisce DC n. 0001-0042 del 10/06/2026, rimborso n. RN-2026/0003*. If the refund is later reversed, the money is certified again once it is allocated to an issued invoice.

Refunds of a payment whose invoice has not been credited are not yet reported automatically. If you make one on a payment that already has a documento commerciale, contact your Account Manager.

______________________________________________________________________

## 2. Information we need from you

Send the following via the PMS chat or to your Account Manager:

- [ ] Workspace name (in the Lavanda PMS)
- [ ] Company legal name
- [ ] Partita IVA (VAT number, without the `IT` prefix)
- [ ] Codice fiscale of the company
- [ ] Email address for AdE notifications (optional)

You also need a company representative who can log in to the [AdE portal (Fatture e Corrispettivi)](https://ivaservizi.agenziaentrate.gov.it/portale/). Please confirm this early: nothing else can be done without it.

______________________________________________________________________

## 3. How to enable Smart Receipts

### Step 1: Request activation

Raise a support ticket via the PMS chat or reach out to your Account Manager.

### Step 2: Send us your company details

Send the information listed in section 2. Lavanda uses it to configure your entity in Invopop.

### Step 3: Generate your AdE password and PIN

A company representative must log in to the [AdE portal (Fatture e Corrispettivi)](https://ivaservizi.agenziaentrate.gov.it/portale/) and generate the **password** and **PIN** that will be used to send receipts in your name. Only a company representative can do this, and it cannot be delegated to Lavanda.

### Step 4: Complete the registration form

Lavanda will send you a secure registration link. Open it, enter the details below and click **Save**:

| Field | What to enter |
| --- | --- |
| Tax ID | Your Partita IVA, without the `IT` prefix |
| Codice Fiscale | The company codice fiscale |
| Password | The AdE password from Step 3 |
| Pin | The AdE PIN from Step 3 |

![Smart Receipts registration form](/assets/docs/italy-smart_receipts_registration_form.png)

Your credentials are passed to the AdE through Invopop's local partner. They are not stored by Lavanda.

### Step 5: Confirm back to Lavanda and test

Let us know once the form is submitted. We will run a test with you to confirm everything is connected.

### Step 6: Go live

Once the test is successful, Lavanda enables Smart Receipts on your workspace and receipts are issued automatically from then on.

______________________________________________________________________

## 4. Renewing your AdE credentials (every 90 days)

AdE credentials expire every **90 days**. If they expire, the next Smart Receipt cannot be issued until they are renewed.

1. Renew your password and PIN in the [AdE portal](https://ivaservizi.agenziaentrate.gov.it/portale/).
2. Lavanda will share the registration link with you again.
3. Submit the renewed credentials through the same form, as in Step 4.
