Ri-emettere una fattura scartata

Quando invii una fattura allo SDI tramite API, lo SDI può scartarla (stato DISCARDED). In questo caso la fattura non è stata accettata: devi correggerla e ri-emetterla, tipicamente mantenendo lo stesso numero progressivo (la normativa consente di ri-emettere con lo stesso numero, entro i termini previsti, dopo uno scarto).

Per ri-emettere via API devi prima eliminare la fattura scartata

Una fattura in stato DISCARDED mantiene occupato il suo numero progressivo: finché la fattura scartata esiste, una nuova richiesta via API con lo stesso numero viene bloccata.

Sull'API il rilascio del numero non avviene da solo: ri-emettere una fattura scartata richiede di eliminarla prima. L'eliminazione è il passaggio necessario che libera il numero e ti permette di ri-emettere la fattura corretta.

Dalla WebApp, invece, il rinvio (resend) della fattura scartata gestisce il numero per te (vedi più sotto).

Flusso di ri-emissione

1. Emetti la fattura con POST /companies/{company_id}/documents/invoice.
2. Lo SDI scarta la fattura → lo stato del documento diventa DISCARDED (puoi intercettarlo via webhook o leggendo il documento).
3. Elimina la fattura scartata con DELETE /companies/{company_id}/documents/{id} per liberare il numero progressivo. È il prerequisito della ri-emissione.
4. Ri-emetti la fattura corretta con una nuova POST .../documents/invoice, riutilizzando lo stesso numero se necessario.

In alternativa: ri-emettere dalla WebApp

Una fattura scartata emessa via API può essere corretta e ri-emessa anche dall'interfaccia web di Sibill, tramite il normale processo di rinvio (resend) della fattura scartata: apri il documento in stato DISCARDED, correggi i dati e rinvialo allo SDI. In questo caso non serve alcuna chiamata API e non devi eliminare nulla.

informazioni

Per la procedura passo passo dalla WebApp fai riferimento all'articolo Stati delle fatture emesse su Sibill del centro assistenza.

Quali fatture si possono eliminare

Una fattura elettronica è eliminabile via API solo quando si trova in uno di questi stati:

• DRAFT (bozza non ancora inviata), oppure
• DISCARDED (scartata dallo SDI), oppure
• REFUSED (rifiutata), se non ha ancora scritture contabili collegate.

In qualsiasi altro stato — inclusa una fattura SENT (inviata e in attesa di riscontro dallo SDI) — la fattura non è eliminabile.

attenzione

Non puoi eliminare una fattura già inviata e in attesa di riscontro dallo SDI (es. SENT) o già consegnata/accettata (es. DELIVERED): sono documenti in uno stato non modificabile via DELETE. Per stornare una fattura consegnata si emette una nota di credito/variazione, non la si elimina. Un tentativo di DELETE su una fattura non eliminabile viene rifiutato.

In sintesi

• Fattura scartata ⇒ il numero resta occupato; via API il rilascio richiede un'eliminazione esplicita.
• Ri-emettere via API con lo stesso numero richiede prima il DELETE della fattura scartata, poi il nuovo POST.
• In alternativa puoi ri-emetterla dalla WebApp con il processo di rinvio, che gestisce il numero automaticamente.
• Elimina solo fatture in DRAFT/DISCARDED (o REFUSED senza scritture), mai quelle consegnate.