Salta ai contenuti

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.

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.

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"
},
"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"
}
}
]
}
}
}
}
ScenarioAzioneDocumenti emessi
Annullamento totale — duplicato o transazione annullataAccreditare l’importo totaleSolo nota di credito
Credito parziale — reso, sconto o sovrafatturazioneAccreditare solo le righe o gli importi interessatiSolo nota di credito
Correzione — dati o importi errati sulla fattura originaleAccreditare l’importo totale, quindi riemettere correttaNota di credito + nuova fattura
Importo insufficiente — l’importo originale era troppo bassoAccreditare l’importo totale, quindi riemettere con l’importo correttoNota di credito + nuova fattura
Destinatario errato — fattura inviata all’acquirente sbagliatoAccreditare l’importo totale al destinatario originale, quindi fatturare al destinatario correttoNota di credito + nuova fattura

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

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

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

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

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

Stornate 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.00

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.

Per gli scenari di correzione, importo insufficiente e destinatario errato, 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.

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", ... }
}
}
}

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.

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.

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.

Due campi di entries[] 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.

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 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 sbagliatoAzioneDocumenti emessi
Credito insufficienteStorna l’importo mancanteUn’altra nota di credito, che fa riferimento alla fattura originale
Credito eccessivo o emessa per erroreFattura la differenzaNuova fattura che fa riferimento alla nota di credito
Dati errati sulla nota di creditoFattura l’importo della nota di credito, poi storna di nuovo correttamenteNuova fattura che fa riferimento alla nota di credito + nuova nota di credito che fa riferimento alla fattura originale
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.00
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.00

Per una nota di credito emessa per errore, la nuova fattura è per l’intero importo della 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.00

La nuova fattura riporta in document.references.preceding_document il numero e la data di emissione della nota di credito che annulla.

  • Germania: i dati da inviare di nuovo su ogni nota di credito e come indicare i rimborsi in payments. Vedi Germania: note di credito.