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, importo insufficiente o destinatario errato.
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 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 |
| Destinatario errato — fattura inviata all’acquirente sbagliato | Accreditare l’importo totale al destinatario originale, quindi fatturare al destinatario 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, ordine annullato). Se è stata inviata all’acquirente sbagliato, vedi Destinatario errato.
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.00Destinatario errato (credito + nuova fattura)
Sezione intitolata “Destinatario errato (credito + nuova fattura)”Da utilizzare quando la fattura è stata inviata al destinatario sbagliato.
Original Invoice INV-056 €119.00 (sent to the wrong recipient) ↓Credit Note CN-012 €119.00 (references INV-056, same recipient as INV-056) ↓New Invoice INV-057 €119.00 (correct recipient)La nota di credito storna integralmente la fattura originale. Va allo stesso destinatario della fattura originale, cioè a quello sbagliato, perché è a lui che la fattura era indirizzata. Poi emetti una nuova fattura, con un nuovo numero di fattura, al destinatario corretto.
Nota di credito + riemissione
Sezione intitolata “Nota di credito + riemissione”Per gli scenari di correzione, importo insufficiente e destinatario errato, 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”La nota di credito deve usare lo stesso destinatario della fattura originale: gli stessi dati del destinatario, lo stesso canale di consegna (invoicing.type), lo stesso indirizzo email o ID Peppol e lo stesso invoicing.format.
Se qualcosa è diverso, la richiesta viene comunque accettata e il record risulta COMPLETED, ma non viene inviato nulla. Il record riceve un log ERROR in content.logs: invoice correction recipients do not match the original invoice. Controlla i log di ogni nota di credito che crei.
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.
fiskaly non verifica questo totale: una nota di credito superiore all’importo residuo viene accettata e inviata. Tenere traccia del totale stornato è tua responsabilità.
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. Non puoi emettere una CORRECTION su una nota di credito: la richiesta fallisce con 405. L’unico modo per annullare una nota di credito è una nuova fattura che la richiami.
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.
Regole specifiche per paese
Sezione intitolata “Regole specifiche per paese”- Germania: i dati da inviare di nuovo su ogni nota di credito e come indicare i rimborsi in
payments. Vedi Germania: note di credito.