SIGN IT - Come riportare le mance

Da un punto di vista tecnico, le mance non sono soggette a IVA e non rientrano nel corrispettivo imponibile, a condizione che siano volontarie e chiaramente separate dal pagamento del bene o servizio.

Tecnicamente, mentre le mance in contanti non devono essere fiscalizzate, quelle pagate in modalità elettronica richiedono una gestione specifica per evitare che vengano erroneamente trattate come importo imponibile.

Se una mancia viene inclusa nel totale del pagamento con carta senza essere distinta dal costo del bene o servizio, l’intero importo sarà considerato corrispettivo e quindi soggetto a IVA.

Per escludere la mancia dal calcolo dell’IVA, questa distinzione deve essere riportata correttamente nel documento fiscale, tramite l’inserimento di una voce separata (entry) di tipo SALE relativa alla mancia, con:

• una descrizione chiara, ad esempio: "Mancia volontaria"
• la corretta esenzione IVA (N2 - Non soggetto): "VAT_EXEMPTION" > "NOT_SUBJECT"

Caso d’uso (al ristorante) e payload corrispondente:

- Totale servizio: 48 EUR
- Mancia elettronica: 2 EUR

{
    "content": {
        "type": "TRANSACTION",
        "record": {
            "id": "{{intentionId}}"
        },
        "operation": {
            "type": "RECEIPT",
            "document": {
                "number": "INV-12345"
            },
            "entries": [
                {
                    "type": "SALE",
                    "details": {
                        "concept": "SERVICE"
                    },
                    "data": {
                        "type": "ITEM",
                        "text": "Restaurant service",
                        "unit": {
                            "quantity": "1",
                            "price": {
                                "inclusive": "48.00",
                                "exclusive": "39.34426230"
                            }
                        },
                        "value": {
                            "base": "39.34426230",
                            "discount": "0.00"
                        },
                        "vat": {
                            "type": "VAT_RATE",
                            "code": "STANDARD",
                            "percentage": "22.00",
                            "exclusive": "39.34426230",
                            "inclusive": "48.00",
                            "amount": "8.65573770"
                        }
                    }
                },
                {
                    "type": "SALE",
                    "details": {
                        "concept": "SERVICE"
                    },
                    "data": {
                        "type": "ITEM",
                        "text": "Voluntary tip",
                        "unit": {
                            "quantity": "1",
                            "price": {
                                "inclusive": "2.00",
                                "exclusive": "2.00"
                            }
                        },
                        "value": {
                            "base": "2.00",
                            "discount": "0.00"
                        },
                        "vat": {
                            "type": "VAT_EXEMPTION",
                            "code": "NOT_SUBJECT"
                        }
                    }
                }
            ],
            "breakdown": [
                {
                    "type": "VAT_RATE",
                    "code": "STANDARD",
                    "percentage": "22.00",
                    "exclusive": "39.34426230",
                    "inclusive": "48.00",
                    "amount": "8.65573770"
                },
                {
                    "type": "VAT_EXEMPTION",
                    "code": "NOT_SUBJECT",
                    "exclusive": "2.00"
                }
            ],
            "totals": {
                "vat": {
                    "amount": "8.65573770",
                    "exclusive": "41.34426230",
                    "inclusive": "50.00"
                }
            },
            "customer": {
                "type": "EXTERNAL"
            },
            "payments": [
                {
                    "type": "CARD",
                    "details": {
                        "amount": "50.00"
                    },
                    "number": "****",
                    "kind": "CREDIT"
                }
            ]
        }
    }
}

Nota: il payload qui sopra riflette le modifiche alla struttura introdotte con la versione API 2026-06-01. Se stai integrando una versione precedente: sostituisci il campo totals.vat (a livello di operation) con il vecchio total_vat (a livello di document), rimuovi il campo breakdown e usa il formato semplice unit.price come stringa (solo inclusive, es. "price": "48.00") al posto dell'oggetto { inclusive, exclusive } mostrato qui.