Fatturazione elettronica
Dati SDI richiesti, Codice Destinatario e PEC, validazione dei campi, split payment per la PA e conservazione sostitutiva a norma.
Nota
Questa pagina descrive come la piattaforma gestisce la fatturazione elettronica e non costituisce consulenza fiscale o legale. Il Cliente resta Titolare del trattamento dei propri dati fiscali e responsabile dell'esattezza delle informazioni comunicate. Per l'inquadramento fiscale rivolgiti al tuo commercialista.
Le fatture di Blu Pantheon sono emesse in formato XML FatturaPA e trasmesse tramite il Sistema di Interscambio (SDI) dell'Agenzia delle Entrate. Per ricevere correttamente i documenti devi inserire i dati fiscali completi nella Console.
Dati richiesti
| Dato | Obbligatorio | Esempio |
|---|---|---|
| Ragione sociale o denominazione | Sì | ACME S.r.l. |
| Indirizzo della sede legale | Sì | Via Roma 12 |
| CAP, città, provincia | Sì | 20121 Milano MI |
| Paese | Sì | IT |
| Partita IVA | Sì per soggetti titolari | IT01234567890 |
| Codice Fiscale | Sì | 01234567890 |
| Codice Destinatario SDI | Sì, se non usi la PEC | ABC1234 |
| PEC di ricezione | Sì, se non usi il Codice Destinatario | acme@pec.it |
| Regime fiscale | Sì | RF01 — Ordinario |
| Riferimento amministrativo | No | Centro di costo IT |
| Email per copia di cortesia | Consigliato | amministrazione@acme.it |
Codice Destinatario oppure PEC: uno dei due basta
Se compili entrambi, lo SDI utilizza il Codice Destinatario. La PEC viene usata solo
quando il Codice Destinatario è 0000000. Indicare entrambi è comunque utile: la PEC funge
da recapito di riserva nella nostra procedura interna di riemissione.
Inserimento e modifica dei dati
Prima di iniziare
- Ruolo Amministratore tenant oppure permesso billing:settings:write
- Visura o certificato di attribuzione della Partita IVA per verificare i dati esatti
- Codice Destinatario SDI fornito dal tuo intermediario o dal tuo software gestionale
Apri i dati di fatturazione
Compila l'anagrafica fiscale
Inserisci ragione sociale, indirizzo completo e Paese esattamente come risultano al Registro delle Imprese. Le discrepanze non bloccano lo SDI ma generano contestazioni in sede di controllo.
Inserisci Partita IVA e Codice Fiscale
La Partita IVA va indicata con il prefisso del Paese (IT per l'Italia). Per le società
Codice Fiscale e Partita IVA numerica spesso coincidono.
Indica il recapito SDI
Scegli Codice Destinatario oppure PEC. Se sei una Pubblica Amministrazione, il campo diventa Codice Univoco Ufficio IPA a 6 caratteri.
Seleziona il regime fiscale
Il valore predefinito è RF01 (ordinario). Modificalo se applichi un regime diverso
(es. RF19 forfettario).
Salva e verifica la validazione
La piattaforma esegue i controlli formali in tempo reale. Se un campo è segnalato in rosso, correggilo prima di salvare: i dati non validi bloccano l'emissione.
Modifica i dati prima della fine del mese
Le fatture sono emesse all'inizio del mese successivo al periodo di riferimento. Una modifica effettuata dopo l'emissione non si applica retroattivamente: sarebbe necessaria una nota di variazione. Aggiorna i dati prima della chiusura del periodo.
Regole di validazione dei campi
Validazione dei dati fiscali
| Parametro | Tipo | Obblig. | Default | Descrizione |
|---|---|---|---|---|
vatNumber | string | Sì | — | Partita IVA. Per l’Italia: prefisso IT seguito da 11 cifre, es. IT01234567890. Viene verificata anche la cifra di controllo. |
taxCode | string | Sì | — | Codice Fiscale. 16 caratteri alfanumerici per le persone fisiche, 11 cifre per le persone giuridiche. |
sdiCode | string | No | 0000000 | Codice Destinatario SDI: esattamente 7 caratteri alfanumerici maiuscoli, es. ABC1234. Usa 0000000 per privati, forfettari senza canale e soggetti esteri. |
sdiPec | string | No | — | Indirizzo PEC di ricezione. Obbligatorio se sdiCode è 0000000 e il soggetto è residente in Italia. |
ipaCode | string | No | — | Codice Univoco Ufficio IPA: esattamente 6 caratteri alfanumerici, es. UF1A2B. Solo per la Pubblica Amministrazione. |
taxRegime | string | Sì | RF01 | Codice del regime fiscale secondo il tracciato FatturaPA, da RF01 a RF19. |
splitPayment | boolean | No | false | Scissione dei pagamenti ex art. 17-ter DPR 633/72. Attivabile solo per soggetti PA. |
cig | string | No | — | Codice Identificativo Gara: 10 caratteri alfanumerici. Obbligatorio per gli appalti pubblici tracciabili. |
cup | string | No | — | Codice Unico di Progetto: 15 caratteri alfanumerici. Richiesto per progetti di investimento pubblico. |
orderReference | string | No | — | Numero dell’ordine di acquisto o della determina, riportato nel campo DatiOrdineAcquisto. |
Quando usare 0000000
Il valore 0000000 è corretto per: privati consumatori, soggetti in regime forfettario privi
di canale telematico e soggetti esteri. Nei primi due casi devi indicare anche la PEC.
Per i soggetti esteri il campo Paese diverso da IT esclude automaticamente la trasmissione
allo SDI.
Pubblica Amministrazione e split payment
Se sei un ente pubblico, la fatturazione segue regole specifiche.
Attiva il profilo Ente pubblico
L'interruttore Soggetto della Pubblica Amministrazione abilita i campi dedicati e disattiva il Codice Destinatario ordinario.
Inserisci il Codice Univoco Ufficio IPA
Sei caratteri alfanumerici, per esempio UF1A2B. Lo trovi nell'Indice dei domicili digitali
della Pubblica Amministrazione (IPA) alla scheda del tuo ufficio di fatturazione.
Attiva la scissione dei pagamenti
Con lo split payment la fattura riporta l'annotazione di scissione: l'IVA è versata direttamente dall'ente all'Erario e l'importo da corrispondere al fornitore è il solo imponibile.
Inserisci CIG e CUP quando richiesti
Il CIG è obbligatorio per gli affidamenti soggetti a tracciabilità dei flussi finanziari; il CUP per i progetti di investimento pubblico. Se l'ente li richiede e mancano in fattura, il pagamento viene sospeso.
Indica gli estremi dell'ordine o della determina
Compila il riferimento amministrativo con numero e data della determina o dell'ordine NSO, se il tuo ente ne richiede la citazione.
CIG e CUP mancanti bloccano il pagamento
È il motivo più frequente di ritardo nei pagamenti della PA. Se il tuo ufficio ragioneria richiede il CIG, inseriscilo nei dati di fatturazione prima dell'emissione: aggiungerlo dopo richiede una nota di credito e una riemissione.
Ciclo di vita della fattura
Emissione
Blu Pantheon genera il file XML FatturaPA con i dati presenti in Console alla data di emissione e lo firma digitalmente quando richiesto (obbligatorio verso la PA).
Trasmissione allo SDI
Il file è inviato al Sistema di Interscambio. Lo stato in Console passa a Inviata allo SDI.
Esito dello SDI
Entro pochi minuti (fino a 5 giorni nei casi limite) lo SDI restituisce una ricevuta:
- Consegnata: la fattura è arrivata al tuo canale. Stato in Console: Consegnata.
- Mancata consegna: il canale non era raggiungibile. La fattura è comunque valida ed è messa a disposizione nella tua area riservata dell'Agenzia delle Entrate. Stato: Mancata consegna.
- Scartata: errore formale. La fattura si considera non emessa e viene corretta e ritrasmessa.
Conservazione
Il documento entra nel processo di conservazione sostitutiva a norma per 10 anni.
| Stato in Console | Significato | Azione richiesta |
|---|---|---|
| In preparazione | Fattura generata, non ancora trasmessa | Nessuna |
| Inviata allo SDI | In attesa di esito | Attendi, di norma pochi minuti |
| Consegnata | Recapitata al tuo canale | Nessuna |
| Mancata consegna | Canale non raggiungibile | Scarica la copia dalla Console o dal cassetto fiscale, verifica il recapito |
| Scartata | Errore formale rilevato dallo SDI | Correggi i dati indicati nel messaggio di scarto |
| Annullata | Sostituita da nota di credito | Nessuna |
Reverse charge per clienti UE
Per soggetti passivi IVA stabiliti in un altro Stato membro con numero identificativo VIES valido, la fattura è emessa senza applicazione dell'IVA in regime di inversione contabile (art. 7-ter DPR 633/72), con annotazione “inversione contabile — reverse charge”.
Inserisci il numero identificativo IVA con prefisso del Paese
Per esempio DE123456789. Il campo Paese deve essere coerente con il prefisso.
Attendi la verifica VIES
La validità è controllata automaticamente sul sistema VIES. L'esito è visibile accanto al campo.
Verifica l'anteprima della prossima fattura
Se il numero è valido, l'anteprima mostra imposta pari a zero e l'annotazione di inversione contabile.
Se il VIES non conferma il numero
In assenza di conferma VIES l'operazione è fatturata con IVA italiana. Il numero deve essere iscritto agli archivi VIES: l'iscrizione va richiesta all'autorità fiscale del tuo Paese e non è automatica con l'attribuzione della partita IVA nazionale.
Per i clienti extra-UE l'operazione è fuori campo IVA ai sensi dell'art. 7-ter e non viene trasmessa allo SDI.
Note di credito
Le note di credito (documento di tipo TD04) sono emesse in caso di:
- storno totale o parziale di una fattura errata;
- riduzione del canone a seguito di declassamento del piano nel periodo;
- crediti di servizio riconosciuti per il mancato rispetto dello SLA, secondo quanto previsto in Documenti legali;
- correzione di dati fiscali errati che avevano generato una fattura non valida.
La nota di credito segue lo stesso ciclo SDI della fattura e compare nell'elenco documenti collegata alla fattura di origine.
Dove scaricare le fatture
Per ogni documento sono disponibili:
| Formato | Uso |
|---|---|
| PDF di cortesia | Lettura e archiviazione interna. Non ha valore fiscale sostitutivo dell'XML |
| XML FatturaPA | File originale trasmesso allo SDI, con valore fiscale |
| Ricevuta SDI | Attestazione di consegna o di mancata consegna |
| Esportazione CSV | Riepilogo dei documenti di un periodo, per la riconciliazione contabile |
/console/v1/billing/invoicesBearer JWTElenca le fatture del tenant con stato SDI, importo e periodo di riferimento.
/console/v1/billing/invoices/{invoiceId}/xmlBearer JWTScarica il file XML FatturaPA originale.
Puoi anche attivare l'invio automatico della copia di cortesia a un indirizzo email dedicato, tipicamente quello dell'ufficio amministrativo o del commercialista:
Email per la copia di cortesia (esempio)
amministrazione@acme.itImpostabile in Amministrazione › Fatturazione › Notifiche.
Conservazione sostitutiva a norma
- Tutti i documenti sono sottoposti a conservazione digitale a norma ai sensi del CAD (D.Lgs. 82/2005) e delle Linee guida AgID sulla formazione e conservazione dei documenti informatici.
- Durata: 10 anni dalla data di emissione.
- Il servizio è erogato da un conservatore qualificato con sede in Italia, indicato fra i sub-responsabili.
- Su richiesta viene rilasciato il pacchetto di distribuzione con i documenti e le attestazioni di conservazione, utile in caso di verifica fiscale.
La conservazione riguarda le fatture emesse da noi
Blu Pantheon conserva a norma le fatture che emette verso di te. La conservazione delle fatture che tu emetti verso i tuoi clienti resta a carico tuo, tramite il tuo intermediario o il servizio dell'Agenzia delle Entrate.
Risoluzione dei problemi
Lo scarto è sempre accompagnato da un codice di errore riportato in Console, nel dettaglio del documento, sotto Esito SDI.
| Codice | Significato | Cosa fare |
|---|---|---|
00001 | Nome file non valido | Errore tecnico nostro: apri una richiesta al supporto |
00200 | File non conforme al formato | Errore tecnico nostro: apri una richiesta |
00300 | Partita IVA del cedente non valida | Errore tecnico nostro |
00301 | Partita IVA del cessionario non valida | Correggi la tua Partita IVA nei dati di fatturazione |
00305 | Codice Fiscale del cessionario non valido | Correggi il tuo Codice Fiscale |
00311 | Codice Destinatario non valido | Verifica i 7 caratteri presso il tuo intermediario |
00312 | Codice Destinatario non attivo | Il canale non è più registrato: chiedi il codice aggiornato o passa alla PEC |
00313 | Codice Destinatario non valido per la PA | Serve il Codice Univoco Ufficio IPA a 6 caratteri |
00320 | Codice Ufficio non presente in IPA | Verifica il codice sull'Indice IPA |
00330 | PEC del destinatario non valida | Correggi l'indirizzo PEC |
00400 | Aliquota IVA non coerente con la natura | Errore tecnico nostro |
00417 | Identificativi fiscali non valorizzati | Compila sia Partita IVA sia Codice Fiscale |
Dopo la correzione dei dati la riemissione avviene automaticamente entro 24 ore. Non è necessario aprire una richiesta se il codice indica un dato di tua competenza.
Sintomi tipici: esito 00311 o 00312, oppure fattura in stato Mancata consegna pur avendo
un canale attivo.
Recupera il codice corretto
Il Codice Destinatario è assegnato dal tuo intermediario o dal software gestionale che usi per ricevere le fatture. Non è un dato che puoi inventare o dedurre.
Verifica la lunghezza e i caratteri
Devono essere esattamente 7 caratteri alfanumerici maiuscoli, per esempio ABC1234.
Se il tuo intermediario te ne ha comunicati 6, quello è un codice IPA per la PA, non un
Codice Destinatario.
Aggiorna i dati in Console
In alternativa, passa temporaneamente alla PEC
Imposta il Codice Destinatario a 0000000 e indica la tua PEC, per esempio acme@pec.it.
È una soluzione valida e definitiva, non solo un ripiego.
Le fatture già in stato Mancata consegna restano valide e sono comunque disponibili nella tua area riservata dell'Agenzia delle Entrate.
Cause più frequenti, in ordine di ricorrenza:
- prefisso mancante: inserisci
IT01234567890e non01234567890; - cifra di controllo errata: un carattere trascritto male fa fallire il controllo. Ricontrolla il numero sulla visura camerale;
- spazi o punti: rimuovi qualsiasi separatore, il campo accetta solo lettere e cifre;
- numero cessato: una Partita IVA chiusa risulta non valida. Indica quella attiva;
- VIES non attivo per soggetti UE: il numero è valido a livello nazionale ma non iscritto agli archivi VIES. Richiedi l'iscrizione all'autorità fiscale del tuo Paese;
- confusione fra Codice Fiscale e Partita IVA: per le persone fisiche titolari di partita IVA i due valori sono diversi e vanno entrambi compilati nei rispettivi campi.
Controlla lo stato in Console
Se lo stato è Consegnata, lo SDI ha completato il recapito: il problema è sul tuo canale PEC.
Verifica la casella PEC
Casella piena, scaduta o non rinnovata sono le cause più comuni. Controlla anche la cartella della posta indesiderata.
Scarica la copia dalla Console
Il PDF di cortesia e l'XML sono sempre disponibili in Amministrazione › Fatturazione › Documenti, indipendentemente dall'esito SDI.
Attiva la copia di cortesia via email ordinaria
Imposta un indirizzo email in Notifiche per ricevere sempre una copia, anche in caso di problemi sulla PEC.
Un cambio di ragione sociale senza variazione della Partita IVA si gestisce aggiornando semplicemente i dati in Console.
Un cambio di Partita IVA (fusione, conferimento, trasformazione con nuovo soggetto giuridico) richiede invece l'intervento del supporto: scrivi a support@blupantheon.com allegando la visura aggiornata e indicando la data di efficacia. Il contratto viene volturato al nuovo soggetto e la fatturazione ripartita fra i due periodi.