Flowie
Conformità · 🇮🇹 Italia

Italia — Sistema di Interscambio (SDI)

In sintesi

Contesto — il flusso SDI

L'Italia è stato il primo paese al mondo a imporre la fatturazione elettronica B2B tramite un hub centralizzato. Il flusso:

ERP mittente → Intermediario (Flowie) → SDI → Destinatario
                                          ↓
                                    Ricevute (RC/NS/MC) ← di ritorno tramite Flowie

Flowie agisce come tuo intermediario registrato. Trasmettiamo le fatture per tuo conto, le conserviamo per i 10 anni di legge e inoltriamo le ricevute SDI al tuo webhook.

Codice Destinatario

Ogni destinatario italiano ha un Codice Destinatario (CD) — un codice di routing di 7 caratteri che indica a SDI dove consegnare. Tre varianti:

Tipo destinatarioFormato del codiceFonte
Ha un proprio canale SDI7 caratteri alfanumerici (es. M5UXCR1)Fornito dal destinatario.
Pubblica amministrazioneCodice a 6 cifre (es. UFY9MC)Indice PA — indicepa.gov.it.
Solo PEC0000000 + campo recipientPecSDI usa il fallback PEC.
Sconosciuto / privato0000000SDI consegna tramite il portale dell'Agenzia.

Per risolvere un CD da un Codice Fiscale italiano:

curl …/v1/companies/resolve?countryCode=IT&vatNumber=IT01234567890 \
  -H "Authorization: Bearer $KEY"
# → response.additionalIdentifiers includes "codiceDestinatario"

FatturaPA & UBL — quando importa

SDI accetta solo FatturaPA XML 1.2.2. Se invii a Flowie UBL o JSON, transcodifichiamo in FatturaPA prima della trasmissione a SDI. L'inverso vale in ricezione: trascriviamo FatturaPA → UBL così il tuo stack lavora sempre con un solo formato.

Se devi inviare FatturaPA grezza (es. il tuo ERP la genera già):

curl -X POST …/v1/documents/send \
  -H "Authorization: Bearer $KEY" \
  -d '{
    "type":"invoice",
    "format":"ubl-xml",
    "from":"comp_…",
    "to":"0211:01234567890",
    "xml":"<?xml version=\"1.0\"?><p:FatturaElettronica …>…</p:FatturaElettronica>"
  }'

Campi obbligatori per le fatture italiane

Ciclo di vita & ricevute SDI

SDI restituisce una di quattro ricevute asincrone. Ognuna mappa a un evento Flowie:

Ricevuta SDISignificatoEvento Flowie
RC (Ricevuta di Consegna)Consegnata al destinatario.document.delivered
NS (Notifica di Scarto)Rifiutata da SDI per motivi di formato/schema.document.failed
MC (Mancata Consegna)Destinatario irraggiungibile — SDI l'ha resa disponibile sul portale dell'Agenzia.document.delivered con deliveryStatus="delivered_via_portal"
EC (Esito Committente)L'acquirente ha accettato o rifiutato a livello di business (solo B2G).lifecycle.updated

Codici di errore SDI (selezionati)

CodiceSignificatoCorrettivo
00200Errore di validazione di schema.Ispezionare error.details[].
00306Codice Destinatario sconosciuto.Usare Indice PA per gli enti pubblici; altrimenti chiedere al cliente.
00311Formato Codice Destinatario non valido.Esattamente 6 (PA) o 7 (privati) caratteri alfanumerici.
00400End-date dello sconto pagamento successiva alla data di scadenza.Riordinare le date.
00404Documento già esistente (stesso numero + mittente + anno).Dedupe SDI — incrementare la numerazione.
00417Calcolo IVA non corrispondente.Ricontrollare gli arrotondamenti su quantity * unitPrice * vatRate.
00471Mittente estero — usare TD17/TD18/TD19.Impostare il giusto TipoDocumento.

Testare la tua integrazione italiana

Cosa vuoi testareCome
Cas standard SDIVAT mittente IT00000000010, destinatario 0211:00000000099 con CD FLOWIE0.
Rifiuto Codice DestinatariosimulateCompliance: "reject_00306".
Mismatch IVAInviare una riga con quantity: 0.333 e forzare l'arrotondamento → genera 00417.
Fallback MC (consegna su portale)Destinatario CD 0000000 senza PEC → arriva come document.delivered_via_portal.

FAQ

Serve un'autorizzazione separata in Italia?

No. Le credenziali di intermediario di Flowie coprono tutti i nostri clienti. Devi solo concedere a noi la delega SDI nel tuo Fisconline una volta — la dashboard ti accompagna.

E il requisito di archiviazione di 10 anni?

La legge italiana richiede che ogni fattura B2B sia archiviata per 10 anni in un ambiente di "conservazione sostitutiva". L'archivio di Flowie è conforme alle specifiche tecniche dell'Agenzia delle Entrate (DPCM 03/12/2013). Senza costi aggiuntivi.

Posso inviare in parallelo una fattura cartacea?

Per legge no — solo la versione trasmessa via SDI ha valore. Puoi inviare una copia di cortesia in PDF via email, ma non ha valore fiscale.

Riferimenti

Fonti primarie (governo italiano & regolatore UE):

Analisi settoriali (riferimenti incrociati per il funzionamento dello SDI):