SIGN IT - Come rappresentare un articolo in omaggio (GIFT)

Quando un commerciante fornisce beni o servizi a titolo gratuito, le autorità fiscali richiedono solitamente che l’IVA venga calcolata sul valore originale di tali beni o servizi. Di conseguenza, anche se il cliente non effettua alcun pagamento, la transazione deve includere tutti i dettagli relativi all’IVA. 

La modalità corretta per rappresentare un articolo in omaggio in SIGN IT è la seguente:

• inserire il prezzo pieno e i relativi dettagli IVA a livello di entry, come se l’articolo fosse stato venduto a prezzo pieno;
• specificare la natura dell’articolo impostando il campo entries[].details.purpose su "GIFT".

Mentre gli sconti parziali possono essere applicati normalmente a livello di entry, un articolo scontato al 100% deve essere rappresentato come GIFT. Questo garantisce una gestione corretta dell’IVA e assicura la conformità normativa.

Di seguito è riportato un esempio di rappresentazione di un articolo offerto gratuitamente ("GIFT").

{
    "content": {
        "type": "TRANSACTION",
        "record": {
            "id": "{{intentionId}}"
        },
        "operation": {
            "type": "RECEIPT",
            "document": {
                "number": "0001"
            },
            "entries": [
                {
                    "type": "SALE",
                    "details": {
                        "concept": "GOOD",
                        "purpose": "GIFT"
                    },
                    "data": {
                        "type": "ITEM",
                        "text": "Caffè",
                        "unit": {
                            "quantity": "1.00",
                            "price": {
                                "inclusive": "1.20",
                                "exclusive": "1.0909091"
                            }
                        },
                        "value": {
                            "base": "1.0909091",
                            "discount": "0.00"
                        },
                        "vat": {
                            "type": "VAT_RATE",
                            "code": "REDUCED_1",
                            "percentage": "10.00",
                            "exclusive": "1.0909091",
                            "inclusive": "1.20",
                            "amount": "0.10909091"
                        }
                    }
                }
            ],
            "breakdown": [
                {
                    "type": "VAT_RATE",
                    "code": "REDUCED_1",
                    "percentage": "10.00",
                    "exclusive": "1.0909091",
                    "inclusive": "1.20",
                    "amount": "0.10909091"
                }
            ],
            "totals": {
                "vat": {
                    "amount": "0.10909091",
                    "exclusive": "1.0909091",
                    "inclusive": "1.20"
                }
            },
            "payments": [
                {
                    "type": "CASH",
                    "details": {
                        "amount": "0.00"
                    }
                }
            ]
        }
    }
}

Nota: l'esempio qui sopra riflette le modifiche alla struttura introdotte con la versione API 2026-06-01. Se stai integrando una versione precedente: usa il formato semplice unit.price come stringa (solo inclusive, es. "price": "1.20") al posto dell'oggetto { inclusive, exclusive } mostrato qui.