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).

Fattura originale   INV-001   €6.300
     ↓
Nota di credito     CN-001    €6.300  (riferimento INV-001)
     ↓
Risultato netto: €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).

Fattura originale   INV-001   €6.300
     ↓
Nota di credito     CN-002    €600    (riferimento INV-001, solo righe interessate)
     ↓
Risultato netto: €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.

Fattura originale   INV-001   €6.300
     ↓
Nota di credito     CN-003    €6.300  (storno completo, riferimento INV-001)
     ↓
Nuova fattura       INV-002   €5.950  (dati corretti)
     ↓
Risultato netto: €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.

Fattura originale   INV-001   €5.000
     ↓
Nota di credito     CN-004    €5.000  (storno completo, riferimento INV-001)
     ↓
Nuova fattura       INV-003   €6.300  (importo corretto)
     ↓
Risultato netto: €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.

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
• Includete il riferimento al documento precedente della fattura originale
• Includete le righe accreditate (con importi positivi)
• Utilizzate lo stesso destinatario della fattura originale

💡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:

1. Create un record CORRECTION (nota di credito) che fa riferimento alla fattura originale
2. Create un nuovo record INVOICE con i dati corretti

Entrambi i record seguono il flusso standard INTENTION → TRANSACTION.