Risposta breve: DiagnosticReport è la risorsa FHIR per un referto: l'insieme dei risultati che un laboratorio, un reparto di imaging o un servizio di patologia emettono insieme, con uno stato, una categoria, chi lo ha emesso e quando, una conclusione, le Osservazioni risultato che raggruppa, lo studio di imaging che descrive e una forma presentata (il PDF firmato). Un emocromo è un DiagnosticReport con una dozzina di Osservazioni; una TAC è un DiagnosticReport con una conclusione narrativa e un collegamento alle immagini. Un'Osservazione è un singolo valore; un DiagnosticReport è il documento che ne fornisce molti.
Un esempio valido di FHIR R4
Un DiagnosticReport FHIR R4 valido richiede uno stato e un codice, e in pratica include anche il soggetto, la categoria, l'ora dell'evento, l'ora di emissione, l'esecutore e le Observation dei risultati che raggruppa. L'esempio seguente è un referto ematologico finale per un emocromo completo, codificato con un pannello LOINC, che collega tre Observation, una conclusione con un codice SNOMED CT e il PDF firmato.
{
"resourceType": "DiagnosticReport",
"id": "cbc-2026-03-14",
"identifier": [{"system": "https://lab.example.org/reports", "value": "RPT-2026-77812"}],
"basedOn": [{"reference": "ServiceRequest/order-778812"}],
"status": "final",
"category": [{"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v2-0074", "code": "HM", "display": "Hematology"}]}],
"code": {"coding": [{"system": "http://loinc.org", "code": "58410-2", "display": "CBC panel - Blood by Automated count"}]},
"subject": {"reference": "Patient/example"},
"encounter": {"reference": "Encounter/visit-2026-03-14"},
"effectiveDateTime": "2026-03-14T08:40:00+01:00",
"issued": "2026-03-14T13:05:00+01:00",
"performer": [{"reference": "Organization/central-lab"}],
"resultsInterpreter": [{"reference": "Practitioner/haematologist-7"}],
"specimen": [{"reference": "Specimen/edta-1"}],
"result": [
{"reference": "Observation/hgb-2026-03-14"},
{"reference": "Observation/wbc-2026-03-14"},
{"reference": "Observation/plt-2026-03-14"}
],
"conclusion": "Mild normocytic anaemia; other parameters within reference ranges.",
"conclusionCode": [{"coding": [{"system": "http://snomed.info/sct", "code": "271737000", "display": "Anemia"}]}],
"presentedForm": [{"contentType": "application/pdf", "url": "https://lab.example.org/reports/RPT-2026-77812.pdf", "title": "CBC report"}]
}
Ogni Osservazione referenziata in result ha il proprio codice LOINC, valore, unità e intervallo di riferimento, come descritto in FHIR Observation spiegato.
Stato: il ciclo di vita del referto
Lo stato di un DiagnosticReport FHIR segue il ciclo di vita di un referto: registrato quando ordinato, parziale man mano che arrivano i risultati, preliminare quando completo ma non verificato, finale quando firmato, poi modificato, corretto o integrato se cambia in seguito; annullato e inserito in errore lo chiudono altrimenti. I consumatori devono prestare attenzione ai referti modificati e corretti, perché un valore finale della settimana scorsa potrebbe essere cambiato.
registered (ordinato, nulla ancora) → partial (alcuni risultati in) → preliminary (tutto dentro, non verificato) → final (firmato) → amended o corrected (modificato dopo la firma, con la motivazione in una nota) o appended (aggiunto altro). cancelled e entered-in-error lo chiudono altrimenti. I consumatori devono prestare attenzione ad amended e corrected: un valore che era finale la settimana scorsa potrebbe essere cambiato, e l'ora di issued del referto si sposta.
Categoria e codice
DiagnosticReport.category indica quale servizio diagnostico ha emesso il referto, utilizzando codici della tabella 0074 di HL7 v2 come LAB, HM ematologia, CH chimica, MB microbiologia, RAD radiologia e PAT patologia. DiagnosticReport.code indica di cosa si tratta il referto, normalmente un codice di pannello LOINC per i referti di laboratorio e un codice di studio radiologico o patologico LOINC, o un codice di procedura locale, per l'imaging e la patologia.
category utilizza la tabella HL7 v2 0074 sezione diagnostica: LAB, HM ematologia, CH chimica, MB microbiologia, RAD radiologia, PAT patologia, CG citogenetica e altri; US Core richiede LAB per i referti di laboratorio. code indica di cosa si tratta il referto: per i laboratori, un codice di pannello LOINC (CBC 58410-2, pannello metabolico completo 24323-8, pannello lipidico 57698-3); per l'imaging, un codice radiologico LOINC o un codice di procedura locale; per la patologia, un codice di studio patologico LOINC. Vedi Cos'è un codice LOINC?.
Referti di laboratorio, imaging e patologia
I referti di laboratorio, imaging e patologia utilizzano la stessa risorsa FHIR DiagnosticReport con elementi diversi. Un referto di laboratorio raggruppa un'Observation per analita con risorse Specimen; un referto di imaging contiene la conclusione del radiologo, un riferimento all'ImagingStudy e le immagini chiave; un referto di patologia contiene il testo della diagnosi, le Observation di stadiazione e i campioni di tessuto. Tutti e tre allegato un PDF firmato in presentedForm.
| Laboratorio | Imaging | Patologia | |
|---|---|---|---|
| result | Una Osservazione per analita | Solitamente nessuno; a volte misurazioni | Osservazioni per la classificazione, marcatori, margini |
| conclusion | Commento opzionale | L'impressione del radiologo | Il testo della diagnosi |
| imagingStudy | — | Riferimento all'ImagingStudy | Immagini intere digitali |
| media | — | Immagini chiave | Immagini di vetrini rappresentative |
| presentedForm | PDF firmato | PDF firmato | PDF firmato |
| specimen | Sangue, urina… Risorse Specimen | — | Risorse Specimen tissutali |
Per l'imaging, le immagini stesse rimangono in DICOM; vedi FHIR ImagingStudy vs DICOMweb. Per il significato di questi referti per il paziente, vedi Come leggere i risultati delle tue analisi e Referto TAC spiegato.
DiagnosticReport vs DocumentReference
Un DiagnosticReport FHIR è un referto strutturato i cui risultati sono, o possono essere, Observation codificate, mentre un DocumentReference è un puntatore a un documento di qualsiasi tipo con metadati e il file. I risultati di laboratorio strutturati diventano un DiagnosticReport; un PDF scansionato senza dati strutturati diventa un DocumentReference, e molti sistemi creano entrambi per lo stesso referto.
Un DiagnosticReport è un referto strutturato i cui risultati sono (o possono essere) Osservazioni codificate; un DocumentReference è un puntatore a un documento di qualsiasi tipo, con metadati e il file. Un referto di laboratorio che arriva come HL7 v2 ORU diventa un DiagnosticReport con Osservazioni. Un PDF scansionato di un referto da un altro paese, senza dati strutturati, è un DocumentReference. Molti sistemi creano entrambi: il DiagnosticReport per i dati, con presentedForm o un DocumentReference per il file firmato. Vedi DocumentReference vs DiagnosticReport vs Binary.
Errori che compromettono i referti
Gli errori che più spesso compromettono i DiagnosticReport FHIR sono l'invio di Observation senza un referto che le raggruppi, la marcatura di un referto come finale mentre le sue Observation sono ancora preliminari, la duplicazione della conclusione in un'Observation con un codice inventato, l'omissione del timestamp di emissione in modo che le correzioni non possano essere rilevate e l'invenzione di codici di pannello locali dove esiste già un pannello LOINC.
- Risultati scritti come Osservazioni senza DiagnosticReport, quindi un consumatore non può dire quali valori sono stati emessi insieme o quale referto è stato modificato.
status: finalsu un referto le cui Osservazioni sono ancorapreliminary.- La conclusione duplicata in un'Osservazione con un codice inventato.
issuedmancante, quindi il consumatore non può ordinare i referti o rilevare correzioni.- Codici di pannello inventati localmente quando esiste un pannello LOINC.
In Anpheros
Anpheros Platform trasforma i risultati di laboratorio che arrivano tramite il suo connettore di laboratorio, come HL7 v2 ORU, CSV o JSON, in Observation FHIR raggruppate sotto un DiagnosticReport, con il laboratorio come esecutore e il file originale come presentedForm dove disponibile. Un referto che una persona scansiona nell'app viene conservato come un unico referto con i suoi singoli risultati e l'immagine originale.
Il connettore di laboratorio documenta i formati accettati. Poiché l'originale scansionato viene conservato con il referto, un medico può verificare qualsiasi valore rispetto alla fonte. I referti modificati mantengono la loro cronologia attraverso le versioni delle risorse.
Pagine correlate
- FHIR Observation spiegato
- DocumentReference vs DiagnosticReport vs Binary
- FHIR ImagingStudy vs DICOMweb
- Connettore di laboratorio: HL7 v2, CSV o JSON a FHIR
- Cos'è un codice LOINC?
- Esempio di DiagnosticReport sul sito per sviluppatori
Fonti
- HL7 FHIR R4: DiagnosticReport
- HL7 Terminology: v2-0074 diagnostic service section
- HL7 US Core: DiagnosticReport for laboratory results
- HL7 IPS: DiagnosticReport profile
- LOINC: panels and forms
Domande frequenti
Ho bisogno di un DiagnosticReport per un singolo test?
Strettamente parlando, una singola Osservazione può stare da sola, e le misurazioni domestiche di solito lo fanno. Qualsiasi cosa emessa da un laboratorio è meglio racchiuderla in un DiagnosticReport, anche con un solo risultato, in modo che lo stato, l'emittente e la forma firmata viaggino con essa.
Come rappresento un risultato modificato?
Aggiorna l'Osservazione (la sua versione cambia), imposta lo stato del DiagnosticReport su amended o corrected, aggiorna issued e registra la motivazione in una nota. Non creare mai un secondo referto con lo stesso identificatore.
Dove va l'intervallo di riferimento?
Su ogni Osservazione, in referenceRange, perché gli intervalli differiscono per analita e per laboratorio. Il referto non ha un proprio intervallo.
Un DiagnosticReport può contenere altri referti?
Non direttamente in R4; i referti correlati si referenziano a vicenda tramite basedOn o estensioni, e i sotto-pannelli di un pannello sono solitamente modellati come Osservazioni con hasMember. R5 mantiene lo stesso approccio.
Provalo gratis nella sandbox
La tua prima chiamata FHIR in 5 minuti. Un'API HL7 FHIR R4 con il consenso del paziente integrato: provala nella sandbox, poi collega la tua app o il sistema della tua clinica.
Gratis · 30 pazienti sintetici · senza carta
Anpheros sviluppa una cartella clinica che il paziente controlla e può condividere con qualsiasi studio medico, su una piattaforma HL7 FHIR R4, con sede in UE. Queste guide ti aiutano a comprendere e organizzare la tua salute; non sostituiscono il tuo medico.
Chi siamo →