Navigazione Docs

Fatturazione Elettronica (SDI)

Come generare e inviare fatture conformi al Sistema di Interscambio.

Cos'è il SDI?

Il Sistema di Interscambio (SDI) è l'infrastruttura italiana per lo scambio telematico di fatture. Riceve fatture in formato XML dai fornitori, le valida, le invia ai clienti, traccia consegne.

Generare Fatture in Fatturino

Step 1: Imposta i Dati Aziendali

In Settings → Company:

  • Ragione sociale
  • Partita IVA
  • Indirizzo completo
  • Email PEC (se la usi)
  • Regime fiscale

Step 2: Crea Clienti

In Customers aggiungi:

  • Ragione sociale (o cognome/nome se privato)
  • Partita IVA / Codice Fiscale
  • Indirizzo
  • Email (riceverà copia della fattura)

Step 3: Crea una Fattura

  1. Invoices → New
  2. Scegli cliente
  3. Data e scadenza
  4. Aggiungi linee (descrizione, quantità, prezzo, IVA)
  5. Salva (status: Draft)

Step 4: Anteprima XML

Prima di inviare, vedi l'XML: Fattura → Preview → XML. Controlla:

  • Dati cliente corretti
  • Importi giusti (in centesimi)
  • Causale corrisponde a transazione

Invio al SDI

Requisiti

  1. Account OpenAPI: Registrati su openapi.it
  2. Credito prepagato: Acquista credito (es. €50 per 1000 invii)
  3. Credenziali API: Username e password OpenAPI

Configurare OpenAPI

  1. Settings → Integrations → OpenAPI
  2. Inserisci Username e Password API
  3. Abilita Sandbox Mode per testare (opzionale)
  4. Salva

Inviare una Fattura

  1. Fattura → Send to SDI
  2. Scegli Sandbox (test) o Production (vero)
  3. Conferma

Stati di Invio

DraftFattura locale, non inviata
PendingIn attesa di conferma OpenAPI
SentOpenAPI ha accettato, inoltrato al SDI
DeliveredCliente ha ricevuto dal SDI
FailedErrore in invio, riprovare

Troubleshooting

"Errore validazione XML"

Controlla:

  • Descrizioni linee (no caratteri speciali tranne -, /, (, ), &, ')
  • Aliquota IVA supportata (0%, 4%, 5%, 10%, 22%)
  • Importi in centesimi (no decimali)

"Cliente senza P.IVA/Codice Fiscale"

Le fatture verso privati senza P.IVA richiedono Codice Fiscale. Aggiungi in Customers.

"Timeout OpenAPI"

Se OpenAPI non risponde:

  1. Controlla credito rimanente su openapi.it
  2. Verifica credenziali API (Settings → Integrations)
  3. Riprova dopo pochi minuti

Prossimi Passi