Configurare lo SdI con credenziali Agenzia delle Entrate in Odoo 19 (guida PMI italiane)

Ottava guida operativa Odoo 19 per PMI italiane. Dopo aver coperto tutto il ciclo emissione + incasso + riconciliazione, qui chiudiamo il cerchio con il pezzo più tecnico ma critico: la configurazione dello SdI (Sistema di Interscambio) con le credenziali dell’Agenzia delle Entrate per trasmettere realmente le fatture elettroniche.

Senza queste configurazioni, ogni fattura emessa è bloccata in “Invia (Demo)” e non parte mai allo SdI. Con queste configurazioni, ogni conferma fattura genera la trasmissione automatica al SdI, riceve la notifica RC (consegnata) o NS (scartata) e aggiorna lo stato in tempo reale. Esempio reale su G Tech Group S.R.L.S. (P.IVA IT01654010345, regime ordinario RF01).

Cosa serve per trasmettere allo SdI

Step 1 — Verifica i dati anagrafici aziendali

Vai in Impostazioni → Utenti e aziende → Aziende e apri la tua azienda.

I campi obbligatori per la trasmissione SdI:

• Nome azienda: la ragione sociale come in visura
• Indirizzo: Via Roma 1, 00184 Roma, Italia (sede legale)
• Telefono + E-mail: contatti aziendali
• Partita IVA: IT01654010345 (con prefisso paese)
• Codice Fiscale: 01654010345 (per società = P.IVA senza prefisso)
• Regime Fiscale: [RF01] Ordinario (vedi tabella codici sotto)
• Valuta: EUR

I codici regime fiscale italiani (RF01-RF19)

Step 2 — Tab “Fatturazione elettronica” dell’azienda

Sulla scheda azienda clicca il tab Fatturazione elettronica:

Le sezioni:

Indice Economico e Amministrativo (REA)

“Il venditore/fornitore è una società iscritta nel registro delle imprese e come tale deve indicare i dati di iscrizione su tutti i documenti (art. 2250, Codice Civile italiano)”.

Checkbox “Azienda iscritta nel registro delle imprese”: spuntalo se sei SRL, SPA, SAPA, cooperativa. Si aprono i campi:

• Ufficio Camera di Commercio: provincia di iscrizione (es. RM per Roma)
• Numero REA: numero di iscrizione REA (es. 1234567)
• Capitale sociale: capitale versato (es. 10.000,00 EUR)
• Stato di liquidazione: “Non in liquidazione” / “In liquidazione”
• Socio unico: SU / SM (società unipersonale o pluripersonale)

Questi dati appaiono automaticamente sulla fattura PDF e nell’XML SdI come richiesto dal Codice Civile.

Rappresentante fiscale

“Il venditore/fornitore è un soggetto non residente che effettua operazioni in Italia rilevanti ai fini IVA e che si avvale di un rappresentante fiscale in Italia”.

Spunta solo se sei un’azienda non residente con rappresentante fiscale italiano. Per la maggioranza delle PMI italiane NON spuntare.

Step 3 — Configurazione globale Fatturazione

Vai in Impostazioni → Fatturazione (dalla sidebar):

Sezioni rilevanti per SdI:

Localizzazione fiscale

• Pacchetto: Italia 🇮🇹 (con bandiera)
• “Imposte, posizioni fiscali, piano dei conti e documenti legali per la tua nazione”
• Il modulo l10n_it + l10n_it_edi aggiunge: codici TD01-TD27, codici natura N1-N7, codici metodo pagamento MP01-MP23, codici IPA, formato XML FatturaPA 1.2.2

Imposte predefinite

• Imposta su vendite: 22% (sarà preimpostata sui prodotti nuovi)
• Imposta su acquisti: 22% M (Magazzino)
• Metodo arrotondamento: “Arrotonda per imposta” (calcolo IVA per riga prima di sommare)

Opzioni avanzate

• Verificare le partite IVA 🔘: attiva la verifica VIES UE in tempo reale all’inserimento di P.IVA cliente UE
• Vendita a distanza intracomunitaria EU: per e-commerce vendita beni B2C UE oltre soglia €10.000 annui
• Per cassa ✅: regime IVA per cassa (versamento IVA al momento dell’incasso, non emissione)
• Nazione fiscale: Italia

Step 4 — Credenziali OAuth2 dell’Agenzia delle Entrate

Le credenziali per la trasmissione SdI si configurano in Configurazione → Registri → Banca/Vendita oppure tramite il modulo aggiuntivo l10n_it_edi_sdicoop. La sequenza per ottenere le credenziali OAuth2:

1. Vai sul Cassetto Fiscale AdE (entratel.agenziaentrate.gov.it) con SPID/CIE
2. Menu “Servizi” → “Fatturazione Elettronica”
3. Sezione “Configurazione” → “Web Service”
4. Click “Crea nuova credenziale”
5. Compila:
   • Nome applicativo: “Odoo G Tech Group”
   • Scopi: “Trasmissione fatture B2B/B2C” + “Ricezione notifiche”
   • Endpoint callback (opzionale per Odoo Self-Hosted)
6. Conferma → AdE genera client_id + client_secret
7. Salva subito il client_secret (l’AdE lo mostra una sola volta)

Inserire le credenziali in Odoo

In Odoo, modulo Fatturazione → Configurazione → Impostazioni → Fatturazione elettronica:

• Modalità: Test (sandbox AdE) per i primi 5-10 invii, poi Production
• SdI Client ID: copia dal portale AdE
• SdI Client Secret: copia dal portale AdE
• SdI Endpoint URL: https://sdi.fatturapa.gov.it/... (in production) o https://testservizi.fatturapa.gov.it/... (in test)
• Conservazione sostitutiva: spunta per accettare il servizio gratuito AdE (10 anni)

Click Salva. Da quel momento, ogni fattura confermata viene trasmessa automaticamente al SdI.

Step 5 — Verifica sulla fattura: il codice TD01

Apri una fattura confermata e clicca sul tab Fatturazione elettronica:

Vediamo i campi:

• Dati Bollo: 0,00 — sotto soglia €77,47 oppure non applicabile
• DDT: vuoto (nessun documento di trasporto collegato)
• Tipo documento: TD01 – Fattura ← il codice SdI principale!
• Metodo di pagamento: MP05 – Bonifico bancario ← codice metodo pagamento SdI
• Tipo / Nome / Data documento di origine: per fatture collegate a precedenti (es. note di credito)
• CIG (Codice Identificativo Gara): per fatture verso PA con gara d’appalto
• CUP (Codice Unico di Progetto): per fatture su progetti finanziati (es. PNRR)

I 27 codici TD SdI in 30 secondi

Odoo seleziona automaticamente il codice TD giusto in base a: tipo fattura (vendita/credito/debito), regime cliente (italiano/UE/ExtraUE), tipo prodotto, presenza di DDT.

Step 6 — Trasmissione SdI: cosa succede al “Invia”

Cliccando il pulsante Invia sulla fattura confermata, Odoo esegue:

1. Generazione XML: produce il file XML formato FatturaPA 1.2.2 secondo specifiche AdE
2. Firma elettronica: applica firma CAdES con il certificato configurato (o usa direttamente i web service AdE)
3. Trasmissione: POST HTTPS verso sdi.fatturapa.gov.it con OAuth2
4. Attesa ricevuta: SdI risponde con codice di ricezione (sempre entro 5 giorni lavorativi)
5. Aggiornamento stato:
   • RC (Ricevuta di consegna): fattura consegnata al destinatario ✅
   • NS (Notifica di scarto): SdI ha rifiutato la fattura (errore formato/dati) ❌
   • MC (Mancata consegna): SdI accettata ma destinatario non raggiungibile → conservata 10 anni in cassetto fiscale + invito al destinatario di scaricarla
   • EC (Esito committente): destinatario accetta/rifiuta esplicitamente
   • DT (Decorrenza termini): destinatario non si esprime entro 15 gg → automatica accettazione

Errori SdI comuni e come risolverli

Errore 00400 – “Dati anagrafici incompleti”

Causa: manca un campo obbligatorio (P.IVA, CF, indirizzo, regime fiscale).
Soluzione: torna in Impostazioni → Aziende e completa tutti i campi.

Errore 00404 – “P.IVA non trovata su VIES”

Causa: P.IVA UE non verificabile in VIES (servizio EU).
Soluzione: verifica P.IVA su VIES EU. Se è valida ma non trovata, attendi 24h (database VIES si aggiorna giornalmente).

Errore 00301 – “Codice destinatario errato”

Causa: il codice destinatario del cliente non esiste su SdI.
Soluzione: contatta cliente, verifica codice. Se non lo sa, usa 0000000 + PEC.

Errore 00408 – “Documento già trasmesso”

Causa: stai trasmettendo una fattura già inviata (duplicato).
Soluzione: verifica chatter fattura – se SdI ha già emesso ricevuta, non re-trasmettere. Se serve correzione, emetti nota di credito TD04.

Conservazione sostitutiva 10 anni

La legge italiana richiede di conservare le fatture elettroniche per 10 anni con garanzia di:

• Autenticità (firma digitale)
• Integrità (no modifica successiva)
• Leggibilità (formato XML + visualizzazione PDF)

Due opzioni:

1. Servizio AdE (gratuito): spunta nelle impostazioni “Conservazione sostitutiva AdE”. Le fatture vengono conservate automaticamente nel Cassetto Fiscale per 10 anni. Servizio gratuito ma richiede opt-in esplicito.
2. Provider privato (Aruba, Register, InfoCert): 30-200 €/anno, offre interfaccia migliore + ricerche avanzate + integrazione con altri tool aziendali.

Per la maggioranza delle PMI, l’opzione AdE è sufficiente. Considera privato solo se hai esigenze documentali avanzate (es. recupero veloce per audit).

FAQ

Quanto tempo serve per attivare lo SdI in Odoo da zero?

Per una PMI italiana con SPID/CIE personale: 1-2 ore (richiesta credenziali OAuth2 + configurazione Odoo + 5 fatture test). Per chi non ha SPID o credenziali AdE: 2-3 giorni (tempi attivazione SPID + verifica AdE). Pianifica 1 settimana di transizione tra ambiente test e production.

Posso usare Odoo per ricevere anche le fatture passive dai fornitori?

Sì. Configura il tuo codice destinatario aziendale (lo ottieni dal portale AdE Fatture e Corrispettivi → “Registra l’indirizzo telematico”). Comunica questo codice ai tuoi fornitori. Le loro fatture verranno automaticamente caricate in Odoo come fatture fornitore (bozza), pronte da confermare. Le PMI italiane risparmiano in media 30 minuti/giorno con questa automazione.

Cosa succede se il SdI è in manutenzione e la mia fattura non parte?

Lo SdI ha un SLA ufficiale del 99,5% di disponibilità (raramente in manutenzione – di solito mercoledì notte). Se è giù, Odoo mette la fattura in coda e ritrasmette automaticamente quando torna operativo. Il chatter della fattura mostra “Attesa SdI”. Non perdi nessuna trasmissione.

Tra emissione e trasmissione SdI quanto tempo passa?

Legalmente hai 12 giorni dalla data di effettuazione operazione per trasmettere (D.Lgs 119/2018). Per fatture immediate il termine è 12 giorni dalla data fattura. Per fatture differite (TD24) è il 15 del mese successivo al DDT. Odoo trasmette di default al momento della conferma fattura – rispetti automaticamente i termini.

Conviene usare il provider PEC della banca o privato?

Le PEC bancarie (es. Intesa Sanpaolo, Unicredit) costano 0 €/anno per i clienti business ma hanno limiti di archiviazione (1-2 GB). Le PEC private (LegalMail Aruba a 7,50 €/anno) hanno archiviazione 30+ GB + supporto integrazione con Odoo. Per uso intensivo (>500 fatture passive/anno) consiglio una PEC privata dedicata.

Prossimi passi

Nelle prossime guide vedremo come impostare i solleciti automatici per crediti scaduti, come generare il modello F24 per le liquidazioni IVA, e come configurare il modulo HR-Payroll per la gestione dipendenti.

Vuoi attivare lo SdI in Odoo senza errori e con full assistenza?
G Tech Group è partner ufficiale Odoo Italia: configuriamo da zero l’integrazione SdI con AdE, formazione team, gestione delle prime trasmissioni con monitoring.
Richiedi un preventivo gratuito oppure prova la nostra demo Odoo 19 live. Oppure prova Odoo direttamente su odoo.com (link partner Brentasoft).