SdI / FatturaPA
Il gestionale predispone l’XML FatturaPA dai dati della fattura e lo trasmette via provider SdI configurabile. Gli invii in errore vengono ritentati. Il contratto con il provider e le credenziali sono del laboratorio. Serve a chiudere il ciclo attivo senza passare da un secondo gestionale.
Credenziali del labCosa fa
Predisposizione XML FatturaPA e trasmissione via provider SdI configurabile, con retry.
Categoria: sanità digitale italiana — Adempimenti e interoperabilità con l’ecosistema sanitario nazionale e regionale.
Cosa serve
- Contratto con un intermediario abilitato alla trasmissione verso lo SdI, intestato al laboratorio
- Credenziali dell’intermediario, inserite dal laboratorio in Fatturazione → Impostazioni
- Dati fiscali completi del laboratorio: ragione sociale, partita IVA, sede, PEC
Come funziona
Dalla fattura il gestionale compone il tracciato FatturaPA con dati del cedente, del cessionario, righe e regime IVA.
Il browser non parla mai con il provider. La trasmissione passa da una rotta server che verifica ruolo e struttura di appartenenza della fattura. Il documento viene poi inoltrato all’endpoint configurato con la chiave del laboratorio.
La risposta del provider viene salvata come protocollo. In caso di errore la fattura entra in una coda di ritentativi. Un lavoro pianificato la consuma con intervalli crescenti, fino a un numero massimo di tentativi.
Una fattura già trasmessa non viene reinviata per errore: il secondo tentativo viene bloccato a meno di una forzatura esplicita.
Cosa ottieni
Predisposizione e invio della fattura elettronica dallo stesso posto in cui nasce la prestazione.
Note di credito, solleciti e riconciliazione legati alla stessa anagrafica.
Monitoraggio degli invii bloccati, con segnalazione delle trasmissioni ferme da troppo tempo.
Limiti
La validazione a schema e le regole formali dello SdI sono eseguite dal provider e dal Sistema di Interscambio: un documento accettato dal gestionale può comunque essere scartato a valle.
Senza endpoint configurato la rotta risponde con un errore di configurazione e non scrive alcuno stato “inviata”, nessun protocollo inventato.
I dati anagrafici e fiscali del laboratorio devono essere completi: con un identificativo trasmittente segnaposto lo SdI rifiuta il file.
I lavori pianificati che consumano la coda vanno attivati in installazione: senza di essi i ritentativi non partono da soli e le fatture in errore restano in attesa.
Come si attiva
- Firmate il contratto con un intermediario SdI a nome del laboratorio.
- In LabBox andate su Fatturazione → Impostazioni, scegliete l’intermediario e incollate le credenziali.
- Premete «Verifica connessione»: LabBox prova le credenziali con l’intermediario senza emettere nessuna fattura.
Per il tecnico
- Solo per installazioni precedenti: `SDI_ENDPOINT` e `SDI_API_KEY` restano come ripiego, usate solo se il laboratorio non ha salvato nulla nell’app
- Trasmetti una fattura di prova e controlla protocollo ed esito restituiti dal provider.
- Attiva il monitoraggio delle trasmissioni bloccate per accorgerti degli scarti.
Domande frequenti
Il provider SdI è incluso nel canone?
No. Il contratto è del laboratorio, così come le credenziali. Il gestionale è compatibile con provider diversi.
Il gestionale garantisce che il file sarà accettato?
No. Predispone l’XML e lo trasmette; la validazione formale è del provider e dello SdI. Gli scarti tornano indietro e vengono mostrati.
Cosa succede se non configuro nulla?
Le fatture restano nel gestionale e la trasmissione risponde con un errore esplicito. Nessuna fattura viene marcata come inviata.
Moduli che la usano
SdI / FatturaPA lavora insieme a questi moduli di LabBox.
Vuoi vedere SdI / FatturaPA collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.