Nota di credito

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.

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

Annullamento totale

Da utilizzare quando la fattura originale non avrebbe mai dovuto essere emessa (duplicato, acquirente errato, ordine annullato).

Original Invoice   INV-001   €6,300
     ↓
Credit Note        CN-001    €6,300  (references INV-001)
     ↓
Net result: €0

La fattura originale rimane nel sistema. La nota di credito crea uno storno completo.

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   €6,300
     ↓
Credit Note        CN-002    €600    (references INV-001, affected lines only)
     ↓
Net result: €5,700

Solo le righe accreditate sono incluse nella nota di credito. La fattura originale rimane valida per tutte le righe non accreditate.

Correzione (credito + riemissione)

Da utilizzare quando la fattura originale conteneva dati o importi errati.

Original Invoice   INV-001   €6,300
     ↓
Credit Note        CN-003    €6,300  (full reversal, references INV-001)
     ↓
New Invoice        INV-002   €5,950  (corrected data)
     ↓
Net result: €5,950

Stornate completamente l’originale tramite una nota di credito, quindi emettete una nuova fattura con i dati corretti.

Importo insufficiente (credito + riemissione maggiore)

Da utilizzare quando l’importo della fattura originale era troppo basso.

Original Invoice   INV-001   €5,000
     ↓
Credit Note        CN-004    €5,000  (full reversal, references INV-001)
     ↓
New Invoice        INV-003   €6,300  (correct amount)
     ↓
Net result: €6,300

Regole

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.

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

Il destinatario della nota di credito deve corrispondere al destinatario della fattura originale.

Serie di numerazione separata

Le note di credito devono utilizzare una serie di numerazione sequenziale separata (es. CN-2026-000001). Fornirla tramite il campo series, allo stesso modo delle fatture standard.

Tipo di riga

Ogni riga stornata usa entries[].type = SALE, lo stesso tipo di riga di una fattura ordinaria. È il tipo di documento — non il tipo di riga — a segnalare che gli importi sono note di credito.

Il tipo di riga non veicola alcuna semantica di storno o di reso nella fatturazione elettronica. In Italia non viene letto affatto durante la generazione della FatturaPA: impostare RETURN — il valore usato dai prodotti SIGN in una correzione — non rende quindi il documento una nota di credito. Lo fa soltanto l’operazione che richiami.

Campi di riga che non devono corrispondere

Due campi generano spesso lavoro inutile su una nota di credito:

entries[].details.number non 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, tramite operation.record.id.
entries[].data.text non viene validato e non deve ripetere la dicitura della fattura originale. A differenza di SIGN IT, dove ci si aspetta la corrispondenza, puoi descrivere la riga stornata come deve apparire.

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.

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, usa il flusso nota di credito + riemissione descritto sotto: una nota di credito successiva fa riferimento alla fattura sostitutiva, non alla nota di credito precedente.

Stornare una fattura non trasmessa da fiskaly

⚠️Una fattura emessa esternamente non può essere stornata

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.

Questo deriva dall’attuale design della Unified API e potrà cambiare in una versione futura.

Utilizzo dell’API

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

Chiamate l’endpoint createRecord con un Record di tipo TRANSACTION:

Impostate il tipo di operazione su CORRECTION con data.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",
          "series": "CN"
        },
        "entries": [
          {
            "type": "SALE",
            "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"
            }
          }
        ]
      }
    }
  }
}

💡Nota

Le note di credito vengono create sul sistema E_INVOICE_SERVICE, seguendo lo stesso flusso INTENTION → TRANSACTION delle fatture elettroniche.

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 INVOICE con i dati corretti

Entrambi i record seguono il flusso standard INTENTION → TRANSACTION.