ADT / MPI / XDS
ADT, MPI e XDS sono i tre pezzi che tengono allineate anagrafiche e documenti con l’ospedale: i movimenti del paziente, l’indice unico delle identità e il repository dei documenti clinici. Ogni collegamento usa indirizzo e token del laboratorio. Servono a chi lavora dentro una rete sanitaria più grande.
Cosa fa
Gestione anagrafiche e documenti clinici.
Categoria: strumenti e altri sistemi sanitari — Analizzatori, imaging e altri programmi sanitari, senza ribattere i dati.
Cosa serve
- Accordo tecnico con l’ente che espone i servizi ADT, MPI e XDS
- Rete e firewall configurati per raggiungere i servizi
- Base giuridica e consensi definiti per la condivisione dei documenti
Come funziona
ADT porta i movimenti del paziente — accettazione, trasferimento, dimissione — così l’anagrafica resta allineata senza reinserimenti.
MPI è l’indice unico delle identità: serve a riconoscere che lo stesso paziente è già noto con un altro identificativo.
XDS è il repository dei documenti clinici: il referto pubblicato viene versato e reso reperibile agli altri attori della rete.
Tutte e tre le chiamate passano dal proxy server: il browser non vede mai i token e l’indirizzo chiamato deve appartenere al sistema configurato.
Quando servono
Quando il laboratorio è parte di una rete ospedaliera o di un gruppo con anagrafica condivisa.
Quando i referti devono essere reperibili dagli altri sistemi senza invii manuali.
Limiti
Il dialogo avviene via HTTP verso il gateway configurato. I profili di trasporto IHE — PIX e PDQ su HL7 v2, ITI-41 e ITI-43 su SOAP — non sono implementati: il gateway deve accettare il contratto HTTP concordato.
Sono integrazioni di rete: richiedono un progetto con la controparte, indirizzi raggiungibili e collaudo congiunto.
Senza credenziali le funzioni rispondono con un errore di configurazione e non viene registrato alcun invio o allineamento.
Le regole di riconciliazione delle identità vanno concordate: un indice mal configurato produce doppioni anziché eliminarli.
Come si attiva
Se ne occupa chi installa LabBox: il vostro tecnico informatico oppure noi.
Per il tecnico
- `ADT_HL7_TOKEN` e `NEXT_PUBLIC_ADT_HL7_URL` — token e indirizzo del gateway ADT
- `MPI_TOKEN` e `NEXT_PUBLIC_MPI_URL` — token e indirizzo del Master Patient Index
- `XDS_REPOSITORY_TOKEN` e `NEXT_PUBLIC_XDS_REPOSITORY_URL` — token e indirizzo del repository documentale
- Apri il progetto di integrazione con l’ente e raccogli indirizzi, token e specifiche.
- Imposta i token nella forma solo server e gli indirizzi nelle variabili corrispondenti.
- Rimuovi le vecchie varianti dei token esposte al browser e rifai il deploy.
- Collauda un ciclo completo: movimento ADT, riconciliazione su MPI, versamento su XDS.
- Definisci con la controparte cosa fare in caso di identità ambigua prima di andare in produzione.
Domande frequenti
Posso attivarne solo una?
Sì. Sono indipendenti: si configura solo quella che serve e le altre restano spente.
Cosa succede se il gateway non risponde?
L’operazione viene segnalata come non riuscita e non viene registrata come completata. Nessun invio fittizio.
Chi rilascia i token?
L’ente che espone i servizi, al laboratorio. Non sono credenziali del fornitore del software.
Moduli che la usano
ADT / MPI / XDS lavora insieme a questi moduli di LabBox.
I risultati arrivano dagli analizzatori senza ribatterli; i referti vanno al Fascicolo Sanitario.
Accettazione, CUP e agendePrenotazioni, code e front-office senza attriti.
Refertazione e firma elettronicaRedazione, firma e consegna dei referti in un unico flusso.
Vuoi vedere ADT / MPI / XDS collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.