Per correggere una fattura elettronica precedentemente trasmessa, emettete una nota di credito utilizzando il tipo di operazione CORRECTION con data.type = INVOICE. Una nota di credito storna gli importi della fattura originale — totalmente o parzialmente. Se i dati originali devono essere sostituiti, viene emessa una nuova fattura dopo la nota di credito.
La nota di credito fa sempre riferimento alla fattura originale e deve essere inviata allo stesso destinatario.
Utilizzo dell'API
INTENTION e TRANSACTION, con richiesta di esempio.
Quando emettere una nota di credito
Annullamento, credito parziale, correzione o importo insufficiente.
Flussi di correzione
Il flusso di ogni scenario.
Regole
Importi, riferimenti, numerazione e tipo di riga.
Utilizzo dell’API
Sezione intitolata “Utilizzo dell’API”INTENTION
Sezione intitolata “INTENTION”Il passo INTENTION segue lo stesso schema di una fattura standard. Chiamate l’endpoint createRecord con un Record di tipo INTENTION associato al Sistema E_INVOICE_SERVICE.
TRANSACTION
Sezione intitolata “TRANSACTION”Chiamate l’endpoint createRecord con un Record di tipo TRANSACTION:
- Impostate il tipo di operazione su
CORRECTIONcondata.type = INVOICE - Fate riferimento alla fattura originale tramite
operation.record.id - Includete le righe accreditate (con importi positivi)
- Utilizzate lo stesso destinatario della fattura originale
Esempio di richiesta — nota di credito parziale
{ "content": { "type": "TRANSACTION", "record": { "id": "<intention-record-id>" }, "operation": { "type": "CORRECTION", "record": { "id": "<original-invoice-transaction-record-id>" }, "data": { "type": "INVOICE", "document": { "number": "CN-2026-000001" }, "entries": [ { "type": "RETURN", "details": { "concept": "GOOD" }, "data": { "type": "ITEM", "text": "White sugar", "unit": { "quantity": "1.00", "price": { "inclusive": "1220.00", "exclusive": "1000.00" } }, "value": { "base": "1000.00" }, "vat": { "type": "VAT_RATE", "code": "STANDARD", "percentage": "22.00", "exclusive": "1000.00", "inclusive": "1220.00", "amount": "220.00" } } } ], "breakdown": [ { "type": "VAT_RATE", "code": "STANDARD", "percentage": "22.00", "exclusive": "1000.00", "inclusive": "1220.00", "amount": "220.00" } ], "totals": { "vat": { "amount": "220.00", "exclusive": "1000.00", "inclusive": "1220.00" } }, "recipients": [ { "type": "BUSINESS", "name": "Dolci Italiani S.r.l.", "identification": { "type": "VAT", "value": "IT12345678901" }, "address": { "street": "Via Roma 1", "city": "Milano", "code": "20121", "region": "MI", "country": "IT" }, "invoicing": { "type": "SDI", "destination_code": "ABC1234" } } ] } } }}Le note di credito vengono create sul sistema E_INVOICE_SERVICE, seguendo lo stesso flusso INTENTION → TRANSACTION delle fatture elettroniche.
Quando emettere una nota di credito
Sezione intitolata “Quando emettere una nota di credito”| Scenario | Azione | Documenti emessi |
|---|---|---|
| Annullamento totale — duplicato, acquirente errato o transazione annullata | Accreditare l’importo totale | Solo nota di credito |
| Credito parziale — reso, sconto o sovrafatturazione | Accreditare solo le righe o gli importi interessati | Solo nota di credito |
| Correzione — dati o importi errati sulla fattura originale | Accreditare l’importo totale, quindi riemettere corretta | Nota di credito + nuova fattura |
| Importo insufficiente — l’importo originale era troppo basso | Accreditare l’importo totale, quindi riemettere con l’importo corretto | Nota di credito + nuova fattura |
Flussi di correzione
Sezione intitolata “Flussi di correzione”Annullamento totale
Sezione intitolata “Annullamento totale”Da utilizzare quando la fattura originale non avrebbe mai dovuto essere emessa (duplicato, acquirente errato, ordine annullato).
Original Invoice INV-001 €6300.00 ↓Credit Note CN-001 €6300.00 (references INV-001) ↓Net result: €0.00La fattura originale rimane nel sistema. La nota di credito crea uno storno completo.
Credito parziale
Sezione intitolata “Credito parziale”Da utilizzare quando solo una parte della fattura originale deve essere stornata (articolo reso, sconto concordato, sovrafatturazione su righe specifiche).
Original Invoice INV-001 €6300.00 ↓Credit Note CN-002 €600.00 (references INV-001, affected lines only) ↓Net result: €5700.00Solo le righe accreditate sono incluse nella nota di credito. La fattura originale rimane valida per tutte le righe non accreditate.
Correzione (credito + riemissione)
Sezione intitolata “Correzione (credito + riemissione)”Da utilizzare quando la fattura originale conteneva dati o importi errati.
Original Invoice INV-001 €6300.00 ↓Credit Note CN-003 €6300.00 (full reversal, references INV-001) ↓New Invoice INV-002 €5950.00 (corrected data) ↓Net result: €5950.00Stornate completamente l’originale tramite una nota di credito, quindi emettete una nuova fattura con i dati corretti.
Importo insufficiente (credito + riemissione maggiore)
Sezione intitolata “Importo insufficiente (credito + riemissione maggiore)”Da utilizzare quando l’importo della fattura originale era troppo basso.
Original Invoice INV-001 €5000.00 ↓Credit Note CN-004 €5000.00 (full reversal, references INV-001) ↓New Invoice INV-003 €6300.00 (correct amount) ↓Net result: €6300.00Nota di credito + riemissione
Sezione intitolata “Nota di credito + riemissione”Per gli scenari di correzione e importo insufficiente, sono necessarie due transazioni separate:
- Create un record
CORRECTION(nota di credito) che fa riferimento alla fattura originale - Create un nuovo record
INVOICEcon i dati corretti
Entrambi i record seguono il flusso standard INTENTION → TRANSACTION.
Gli importi devono essere positivi
Sezione intitolata “Gli importi devono essere positivi”Tutti gli importi su una nota di credito devono essere positivi. Il tipo di documento indica che gli importi positivi delle righe rappresentano crediti. I valori negativi causeranno errori di validazione. Emetti sempre una nota di credito come CORRECTION. Una INVOICE con importi negativi non è una nota di credito.
Il riferimento al documento precedente è obbligatorio
Sezione intitolata “Il riferimento al documento precedente è obbligatorio”Ogni nota di credito fa riferimento alla fattura originale. Nella richiesta CORRECTION::INVOICE, fornite l’ID del record di transazione originale nel campo content.operation.record.id. fiskaly risolve automaticamente i dettagli del documento precedente.
{ "content": { "type": "TRANSACTION", "record": { "id": "<intention-record-id>" }, "operation": { "type": "CORRECTION", "record": { "id": "<original-transaction-record-id>" }, "data": { "type": "INVOICE", ... } } }}Il destinatario deve corrispondere
Sezione intitolata “Il destinatario deve corrispondere”Usa lo stesso destinatario della fattura originale, con lo stesso canale di consegna e formato.
Serie di numerazione separata
Sezione intitolata “Serie di numerazione separata”Le note di credito devono utilizzare una serie di numerazione sequenziale separata (es. CN-2026-000001). Includi il prefisso della serie in document.number e lascia document.series non impostato.
Tipo di riga
Sezione intitolata “Tipo di riga”Il tipo di documento non lo imposti tu: deriva dall’operazione della Unified API che chiami. Una CORRECTION produce una nota di credito e una INVOICE produce una fattura, qualunque sia il tipo di riga.
Imposta entries[].type = RETURN su ogni riga stornata, con importi positivi. Le righe della fattura originale usano SALE.
Per addebitare nuovi articoli, emetti una fattura separata.
Campi di riga che non devono corrispondere
Sezione intitolata “Campi di riga che non devono corrispondere”Due campi di entries[] generano spesso lavoro inutile su una nota di credito:
entries[].details.numbernon viene usato nella fatturazione elettronica. Esiste per i prodotti di fiscalizzazione, dove identifica la riga originale da correggere. Non riportare i numeri di riga originali su una nota di credito: il collegamento alla fattura originale si stabilisce una sola volta, a livello di documento, tramiteoperation.record.id.entries[].data.textnon viene validato e non deve ripetere la dicitura della fattura originale.
Una fattura, più note di credito
Sezione intitolata “Una fattura, più note di credito”Più note di credito possono fare riferimento alla stessa fattura originale — ad esempio quando la merce di una stessa fattura viene resa in più spedizioni, o quando righe diverse vengono stornate in momenti diversi. Ciascuna è un record CORRECTION indipendente con lo stesso operation.record.id, contenente solo le righe che storna. La fattura originale resta valida per le righe non stornate. Assicurati che le note di credito di una stessa fattura non sommino più della fattura. Una nota di credito annullata con una nuova fattura non rientra più in questo totale.
Una nota di credito non viene mai stornata
Sezione intitolata “Una nota di credito non viene mai stornata”Una nota di credito fa sempre riferimento a una fattura, mai a un’altra nota di credito. Se è la nota di credito stessa a dover essere corretta, emetti invece un nuovo documento. Quale, dipende da cosa era sbagliato:
| Cosa era sbagliato | Azione | Documenti emessi |
|---|---|---|
| Credito insufficiente | Storna l’importo mancante | Un’altra nota di credito, che fa riferimento alla fattura originale |
| Credito eccessivo o emessa per errore | Fattura la differenza | Nuova fattura che fa riferimento alla nota di credito |
| Dati errati sulla nota di credito | Fattura l’importo della nota di credito, poi storna di nuovo correttamente | Nuova fattura che fa riferimento alla nota di credito + nuova nota di credito che fa riferimento alla fattura originale |
Credito insufficiente
Sezione intitolata “Credito insufficiente”Original Invoice INV-001 €6300.00 ↓Credit Note CN-001 €300.00 (references INV-001, should have been €600.00) ↓Credit Note CN-002 €300.00 (references INV-001, the missing amount) ↓Net result: €5700.00Credito eccessivo o emessa per errore
Sezione intitolata “Credito eccessivo o emessa per errore”Original Invoice INV-001 €6300.00 ↓Credit Note CN-001 €6300.00 (references INV-001, should have been €600.00) ↓New Invoice INV-002 €5700.00 (references CN-001, the difference) ↓Net result: €5700.00Per una nota di credito emessa per errore, la nuova fattura è per l’intero importo della nota di credito.
Dati errati sulla nota di credito
Sezione intitolata “Dati errati sulla nota di credito”Original Invoice INV-001 €6300.00 ↓Credit Note CN-001 €600.00 (references INV-001, wrong data) ↓New Invoice INV-002 €600.00 (references CN-001, reverses it) ↓Credit Note CN-002 €600.00 (references INV-001, correct data) ↓Net result: €5700.00La nuova fattura riporta in document.references.preceding_document il numero e la data di emissione della nota di credito che annulla.
Stornare una fattura non trasmessa da fiskaly
Sezione intitolata “Stornare una fattura non trasmessa da fiskaly”Il tipo di documento deriva dall’operazione e non viene impostato da te: una CORRECTION produce una nota di credito, una INVOICE produce una fattura. Referenziare una fattura emessa esternamente come documento precedente in un’operazione INVOICE verrà trasmesso correttamente, ma il documento porta il tipo fattura — e quindi aumenta l’importo dovuto invece di azzerarlo.
Se stai migrando a fiskaly, mantieni disponibile il tuo precedente sistema di fatturazione elettronica finché ogni fattura da esso emessa non è stata saldata o stornata. Dove una correzione una tantum è inevitabile, alcune autorità fiscali consentono all’esercente di emettere una nota di credito manualmente, al di fuori del proprio fornitore: disponibilità e procedura variano da paese a paese, quindi consulta la pagina del paese di riferimento.