Documentazione tecnica - Azienda Ospedaliera S.Croce e Carle
Transcript
Documentazione tecnica - Azienda Ospedaliera S.Croce e Carle
DOCUMENTAZIONE TECNICA Standard HL7 – Order Entry SPECIFICHE DEI MESSAGGI Redazione: Zanella Gianpaolo Data: 24/02/2010 Archivio : H:\Area_SWSanitari\Progetti\2004-04-03-Standard HL7\[DOCUMENTAZIONE GPI\Order Entry\GPI][HL7][v-2.3] Specifiche Order Entry.doc STORIA DELLE MODIFICHE APPORTATE Data Versione 21/10/2009 04/12/2009 2.0 2.1 Zanella Gianpaolo Zanella Gianpaolo Autore 29/01/2010 2.2 Zanella Gianpaolo 24/02/2010 2.3 Zanella Gianpaolo SFW\MD04-02 – Documentazione tecnica Note Unificazione documenti order entry Estensione documento per trasmissione prenotazioni CUP Estensione documento per integrazione laboratorio Estensione documento per trasmissione prenotazioni CUP Pagina 1 di 28 Standard HL7 – Specifiche Order Entry DETTAGLIO REVISIONI DOCUMENTO Versione 2.0 2.1 2.2 2.3 Descrizione delle modifiche Revisione e unificazione delle precedenti versioni del documento Aggiunta informazioni per gestione messaggi OMG^O19: • definizione PV1-5; • aggiunto dettaglio in ORC-9; • aggiunto dettaglio in ORC-12; • adeguato campo OBR-46. Tabelle di riferimento: • aggiunta HL7 table 0203; • aggiunta User-defined table 0363; • aggiunti nuovi coding system in HL7 Table 0396. Aggiunta struttura OML^O21 e relative informazioni collegate: • aggiunto segmento OBX; • aggiunto segmento SPM. Aggiunta struttura ORL^O22. Aggiunta passaggio codice ricetta nel campo OBR-18 SFW\MD04-02 – Documentazione tecnica Pagina 2 di 28 Standard HL7 – Specifiche Order Entry INDICE DEGLI ARGOMENTI CONTENUTO DEL DOCUMENTO...............................................................................4 MODALITÀ DI COMUNICAZIONE................................................................................5 EVENTI GESTITI...........................................................................................................6 STRUTTURA MESSAGGI............................................................................................9 STRUTTURA SEGMENTI...........................................................................................14 TABELLE DI RIFERIMENTO......................................................................................25 SFW\MD04-02 – Documentazione tecnica Pagina 3 di 28 Standard HL7 – Specifiche Order Entry CONTENUTO DEL DOCUMENTO Il presente documento riporta gli elementi di analisi inerenti l’integrazione tra sistema dipartimentali esterni e il middleware HL7-Manager mediante utilizzo di messaggi HL7 in base alle specifiche HL7. Tale documento descrive esclusivamente la sintassi dei messaggi gestiti, per consultare i contesti di applicazione dei vari messaggi fare riferimento al documento GPI sulle transazioni. 1.1Documentazione e riferimenti HL7 v 2.5 Standards www.hl7.org IHE Laboratory Technical Framework – Revision 2.1 http://www.ihe.net/Technical_Framework/index.cfm#laboratory IHE Radiology Technical Framework – Revision 8.0 http://www.ihe.net/Technical_Framework/index.cfm#radiology Localizzazione Italiana per i Domini di OrderEntry e Scheduling (DRAFT) 1.2Definizioni Order placer: l’applicazione che origina un messaggio HL7. Order filler: l’applicazione che elabora o che risponde ad un messaggio HL7. Message: unità atomica di dati trasferiti fra due sistemi. E’ composto da un gruppo di segmenti posti in una determinata sequenza. Ogni messaggio è definito da un tipo che ne determina lo scopo. Ad esempio il messaggio SIU è usato per trasmettere schedulazioni. Segment: raggruppamento logico di data fields. I segmenti possono essere obbligatori o facoltativi. Possono apparire in modo ripetuto o essere unici. Ogni segmento è identificato da un codice a tre caratteri. Data field: un campo è una stringa di caratteri. Il valore nullo “” è diverso dall’omissione del campo (non presente). I campi hanno una posizione predefinita all’interno del segmento. I campi sono separati da un carattere delimitatore e possono avere lunghezza variabile nonostante sia definita una lunghezza massima raccomandata. I campi possono essere obbligatori (R), facoltativi (O), da valorizzare se si desidera compatibilità con versioni precedenti (B) – dipende (C). Delimiters: Il carattere che termina un segmento deve essere sempre CR (in ASCII, esadecimale 0D). Gli altri delimitatori sono definiti nel segmento di intestazione (MSH). Delimitatore di campo nel 4° carattere e gli altri come definito nel primo campo dopo il segmento ID. In mancanza di altre considerazioni HL7 raccomanda l’utilizzo dei caratteri presenti in tabella. Esempio: MSH|^~\&| …………<cr> L’applicazione ricevente dovrà utilizzare i caratteri delimitatori presenti nel segmento di intestazione. SFW\MD04-02 – Documentazione tecnica Pagina 4 di 28 Standard HL7 – Specifiche Order Entry Delimiter Suggested Value Encoding Character Position Usage <cr> hex 0D | - Terminates a segment record. This value cannot be changed by implementors. - Component Separator ^ 1 Repetition Separator ~ 2 Escape Character \ 3 Subcomponent Separator & 4 Separates two adjacent data fields within a segment. It also separates the segment ID from the first data field in each segment. Separates adjacent components of data fields where allowed. Separates multiple occurrences of a field where allowed. Escape character for use with any field represented by an ST, TX or FT data type, or for use with the data (fourth) component of the ED data type If no escape characters are used in a message, this character may be omitted. However, it must be present if subcomponents are used in the message. Separates adjacent subcomponents of data fields where allowed. If there are no subcomponents, this character may be omitted. Segment Terminator Field Separator Modalità di comunicazione Lo scambio dati avverrà attraverso canale di comunicazione socket con protocollo TCP/IP su porte appositamente concordate. Sul server sarà attivo un servizio HL7 costituito da: 1) listener in grado di interpretare i messaggi in arrivo e di fornire il necessario acknowledge. 2) processo in grado di inviare in modo controllato le notifiche di variazioni anagrafiche e le richieste di esami diagnostici. Il sistema gestirà opportunamente l’acknowledge o la condizione di errore garantendo l’invio successivo del messaggio o la notifica dell’eventuale anomalia in apposito log. Il servizio utilizzerà un’apposita tabella di configurazione in cui saranno censiti i sistemi destinatari dei messaggi con indirizzo del server di riferimento, porta di comunicazione e versione HL7 in uso per quel sistema. SFW\MD04-02 – Documentazione tecnica Pagina 5 di 28 Standard HL7 – Specifiche Order Entry Eventi Gestiti Gli eventi di order entry gestiti dal middleware HL7Manager sono i seguenti: EVENT DESCRIPTION NOTE CHAPTER HL7 ORM^O01 General order message Messaggio per una Ordine di Radiologia 4.4.1 ORR^O02 General order response message Risposta Applicativa all’ORM response to any ORM 4.4.2 OMG^O19 General clinical order message Messaggio per Ordine Clinico Generico 4.4.4 OML^O21 Laboratory order message Messaggio per Ordine di Laboratorio 4.4.6 ORL^O22 General laboratory order response message to any OML Risposta applicativa all'OML 4.4.7 1.3 Evento ORM^O01 Il messaggio O01 viene utilizzato per trasmettere tutte le informazioni relative ad ordini radiologici. Tale messaggio è utilizzato per inoltrare nuove richieste, modificarle o cancellarle e per gestire l'avanzamento dello stato di lavorazione. La struttura semplificata di questo messaggio è la seguente: Segmento Descrizione MSH Message Header [ PID ] Dati anagrafici assistito [ PV1 ] Dati relativi alla visita { Blocco di segmenti relativi ad ogni prestazione presente all'interno dell'ordine ORC Utilizzato per trasmettere dati che risultano comuni per uno o più ordini. [ OBR ] Utilizzato per trasmettere specifiche informazioni relative a studi diagnostici o osservazioni, esami o valutazioni. [ { OBX } ] Utilizzato per trasmettere dati complementari, quali peso ed altezza, necessari la per valutazione dei risultati. } 1.4 Evento ORR^O02 Il messaggio O02 viene utilizzato per estendere il paradigma degli acknowledge, restituendo contestualmente alla valutazione generica di un ordine (del tipo accettato / rifiutato), anche informazioni relative alle prestazioni. SFW\MD04-02 – Documentazione tecnica Pagina 6 di 28 Standard HL7 – Specifiche Order Entry Ad esempio possono essere specificate quali prestazioni sono effettivamente accettate e quali no, informazioni necessarie per stampa di codici a barre generati dal dipartimentale o la data di prevista refertazione. La struttura semplificata di questo messaggio è la seguente: Segmento Descrizione MSH Message Header MSA Message Acknowledgment [{ERR}] Error [ Blocco opzionale di estensione dell'acknowledge [ PID ] Dati anagrafici assistito { Blocco di segmenti relativi ad ogni prestazione presente all'interno dell'ordine ORC Utilizzato per trasmettere dati che risultano comuni per uno o più ordini. [ OBR ] Utilizzato per trasmettere specifiche informazioni relative a studi diagnostici o osservazioni, esami o valutazioni. } ] 1.5 Evento OMG^O19 Il messaggio O19 viene utilizzato per trasmettere tutte le informazioni relative ad ordini generici, ovvero senza definire informazioni particolari di dominio. Tale messaggio è utilizzato per inoltrare nuove richieste o cancellazioni da parte del CUP verso ambulatori o dipartimentali. La struttura semplificata di questo messaggio è la seguente: Segmento Descrizione MSH Message Header MSA Message Acknowledgment [{ERR}] Error [ Blocco opzionale di estensione dell'acknowledge [ PID ] Dati anagrafici assistito { Blocco di segmenti relativi ad ogni prestazione presente all'interno dell'ordine ORC Utilizzato per trasmettere dati che risultano comuni per uno o più ordini. [ { TQ1 } ] Contiene i riferimenti di tempo, quantità e priorità dell'ordine. OBR Utilizzato per trasmettere specifiche informazioni relative a studi diagnostici o osservazioni, esami o valutazioni. } ] SFW\MD04-02 – Documentazione tecnica Pagina 7 di 28 Standard HL7 – Specifiche Order Entry 1.6 Evento OML^O21 Il messaggio O21 viene utilizzato per trasmettere tutte le informazioni relative ad ordini di laboratorio o di anatomia patologica. Tale messaggio è utilizzato per inoltrare nuove richieste, modificarle o cancellarle e per gestire l'avanzamento dello stato di lavorazione. La struttura semplificata di questo messaggio è la seguente: Segmento Descrizione MSH Message Header PID Dati anagrafici assistito [ PV1 ] Dati relativi alla visita { Blocco di segmenti relativi ad ogni prestazione presente all'interno dell'ordine ORC Utilizzato per trasmettere dati che risultano comuni per uno o più ordini. [ { TQ1 } ] [ Utilizzato per trasmettere specifiche informazioni relative a studi diagnostici o osservazioni, esami o valutazioni. OBR Utilizzato per trasmettere specifiche informazioni relative a studi diagnostici o osservazioni, esami o valutazioni. [ { NTE } ] [{ SPM Contiene le informazioni relative al campione. [ { OBX } ] Utilizzato per trasmettere dati complementari, quali peso ed altezza, necessari la per valutazione dei risultati. }] ] } 1.7 Evento ORL^O22 Il messaggio O22 viene utilizzato per estendere il paradigma degli acknowledge, restituendo contestualmente alla valutazione generica di un ordine (del tipo accettato / rifiutato), anche informazioni relative alle prestazioni. Ad esempio possono essere specificate quali prestazioni sono effettivamente accettate e quali no, informazioni necessarie per stampa di codici a barre generati dal dipartimentale o la data di prevista refertazione. La struttura semplificata di questo messaggio è la seguente: Segmento Descrizione MSH Message Header MSA Message Acknowledgment [{ERR}] Error [ Blocco opzionale di estensione dell'acknowledge SFW\MD04-02 – Documentazione tecnica Pagina 8 di 28 Standard HL7 – Specifiche Order Entry Segmento Descrizione PID Dati anagrafici assistito { Blocco di segmenti relativi ad ogni prestazione presente all'interno dell'ordine ORC Utilizzato per trasmettere dati che risultano comuni per uno o più ordini. [ OBR Utilizzato per trasmettere specifiche informazioni relative a studi diagnostici o osservazioni, esami o valutazioni. [ { SPM } ] Contiene le informazioni relative al campione. ] } ] Struttura messaggi Di seguito viene presentata la struttura completa dei messaggi gestiti. Struttura completa ORM^O01 ORM^O01 General Order Message MSH Message Header [ { NTE } ] Notes and Comments (for the Headed) [ --- PATIENT begin PID Patient Identification [ PD1 ] Additional Demographics [ { NTE } ] Notes and Comments (for Patient ID) [ --- PATIENT_VISIT begin Chapter HL7 Utilizzato 2.15.9 x 2.15.10 x 3.4.2 x PV1 Patient Visit 3.4.3 x [ PV2 ] Patient Visit - Additional Info 3.4.4 x ] --- PATIENT_VISIT end [{ --- INSURANCE begin IN1 Insurance [ IN2 ] Insurance Additional Info [ IN3 ] Insurance Add'l Info – Cert. }] --- INSURANCE end [ GT1 ] Guarantor [{ AL1 }] Allergy Information SFW\MD04-02 – Documentazione tecnica Pagina 9 di 28 Standard HL7 – Specifiche Order Entry ORM^O01 General Order Message ] --- PATIENT end { --- ORDER begin ORC Common Order [ --- ORDER_DETAIL begin <OBR| Order Detail Segment OBR, etc. Chapter HL7 Utilizzato 4.5.1 x 4.5.3 x 7.4.2 x Chapter HL7 Utilizzato 2.15.9 x 2.15.10 x 3.4.2 x RQD| RQ1| RXO| ODS| ODT> [{ NTE }] Notes and Comments (for Detail) [ CTD ] Contact Data [{ DG1 }] Diagnosis [{ --- OBSERVATION begin OBX Observation/Result [{ NTE }] Notes and Comments (for Results) }] --- OBSERVATION end ] --- ORDER_DETAIL end [{ FT1 }] Financial Transaction [{ CTI }] Clinical Trial Identification [ BLG ] Billing Segment } --- ORDER end Struttura completa ORM^O19 ORM^O19 MSH General Clinical Order Message Message Header [ { NTE } ] Notes and Comments (for the Headed) [ --- PATIENT begin PID Patient Identification [ PD1 ] Additional Demographics [ { NTE } ] Notes and Comments (for Patient ID) SFW\MD04-02 – Documentazione tecnica Pagina 10 di 28 Standard HL7 – Specifiche Order Entry ORM^O19 General Clinical Order Message [ { NK1 } ] Next of Kin/Associated Parties [ --- PATIENT_VISIT begin Chapter HL7 Utilizzato PV1 Patient Visit 3.4.3 x [ PV2 ] Patient Visit - Additional Info 3.4.4 x 4.5.1 x 4.5.4 x 4.5.3 x 7.4.2 x ] --- PATIENT_VISIT end [{ --- INSURANCE begin IN1 Insurance [ IN2 ] Insurance Additional Info [ IN3 ] Insurance Add'l Info – Cert. }] --- INSURANCE end [ GT1 ] Guarantor [{ AL1 }] Allergy Information ] --- PATIENT end { --- ORDER begin ORC Common Order [{ --- TIMING begin TQ1 Timing/Quantity [{ TQ2 }] Timing/Quantity Order Sequence }] --- TIMING end OBR Observation [{ NTE }] Notes and Comments (for Detail) [ CTD ] Contact Data [{ DG1 }] [{ OBX Diagnosis --- OBSERVATION begin Observation/Result [{ NTE }] Notes and Comments (for Results) }] --- OBSERVATION end [{ --- SPECIMEN begin SPM Specimen [{ OBX }] Specimen [{ --- CONTAINER begin SAC Specimen Container [{ OBX }] bservation/Result }] --- CONTAINER end }] --- SPECIMEN end ... --- PRIOR_RESULT (IGNORED) [{ FT1 }] Financial Transaction SFW\MD04-02 – Documentazione tecnica Pagina 11 di 28 Standard HL7 – Specifiche Order Entry ORM^O19 General Clinical Order Message [{ CTI }] Clinical Trial Identification [ BLG ] Billing Segment } --- ORDER end Chapter HL7 Utilizzato Chapter HL7 Utilizzato 2.15.9 x 2.15.10 x 3.4.2 x Struttura completa ORM^O21 OML^O21 MSH Laboratory Order Message Message Header [ { STF } ] Software [ { NTE } ] Notes and Comments (for the Headed) [ --- PATIENT begin PID Patient Identification [ PD1 ] Additional Demographics [ { NTE } ] Notes and Comments (for Patient ID) [ { NK1 } ] Next of Kin/Associated Parties [ --- PATIENT_VISIT begin PV1 Patient Visit 3.4.3 x [ PV2 ] Patient Visit - Additional Info 3.4.4 x 4.5.1 x 4.5.4 x ] --- PATIENT_VISIT end [{ --- INSURANCE begin IN1 Insurance [ IN2 ] Insurance Additional Info [ IN3 ] Insurance Add'l Info – Cert. }] --- INSURANCE end [ GT1 ] Guarantor [{ AL1 }] Allergy Information ] --- PATIENT end { --- ORDER begin ORC Common Order [{ --- TIMING begin TQ1 [{ TQ2 }] Timing/Quantity Timing/Quantity Order Sequence }] --- TIMING end [ --- OBSERVATION_REQUEST begin SFW\MD04-02 – Documentazione tecnica Pagina 12 di 28 Standard HL7 – Specifiche Order Entry OML^O21 OBR Observation [ TCD ] Test Code Details [{ NTE }] Notes and Comments (for Detail) [ CTD ] Contact Data [{ DG1 }] Diagnosis [{ --- OBSERVATION begin OBX Observation/Result [ TCD ] Test Code Detail [ { NTE } ] Notes and Comments (for Results) }] --- OBSERVATION end [{ --- SPECIMEN begin Chapter HL7 Utilizzato 4.5.3 x SPM Specimen 7.4.3 x [ { OBX } ] Observation/Result 7.4.2 x [{ --- CONTAINER begin SAC Specimen Container [ { OBX } ] Observation/Result }] }] ... } Laboratory Order Message --- CONTAINER end --- SPECIMEN end --- PRIOR_RESULT (IGNORED) [ { FT1 } ] Financial Transaction [ { CTI } ] Clinical Trial Identification [ BLG ] Billing Segment --- ORDER end SFW\MD04-02 – Documentazione tecnica Pagina 13 di 28 Standard HL7 – Specifiche Order Entry Struttura segmenti Nota sulle tabelle dei segmenti Le tabelle che rappresentano la struttura dei messaggi contengono la seguente classe di informazioni: SEQ: numero di sequenza, ovvero la posizione del campo all'interno del messaggio considerato; LEN: lunghezza massima del campo; DT: Datatype del campo, che descrive quali informazioni contiene al suo interno; OPT: indica se il campo è obbligatorio (R - required) o opzionale (O - optional) all'interno del messaggio; TBL: indica la tabella di riferimento per i valori che può assumere un campo, se si tratta di un dato tabellato; ELEMENT NAME: descrizione del contenuto del campo; VALORE: contenuto atteso del campo. MSH - Message Header (obbligatorio) Segmento di testata del messaggio, contiene le informazioni generali del messaggio (mittente, destinatario tipo di messaggio). SEQ LEN DT OPT 1 1 ST 2 4 3 RP/# TBL# ELEMENT NAME VALORE R Field Separator | ST R Encoding Characters ^~\& 227 HD R 0361 Sending Application <sistema inviante> 4 227 HD R 0362 Sending Facility <azienda inviante> 5 227 HD R 0361 Receiving Application <sistema ricevente> 6 227 HD R 0362 Receiving Facility <azienda ricevente> 7 26 TS R Date/Time Of Message <yyyymmddhhmmss> 9 15 MSG R Message Type ORM^O01^ORM_O01 10 20 ST R Message Control ID <id univoco del messaggio> 11 3 PT R Processing ID P 12 60 VID R Version ID 2.5 NTE – Notes And Comment Segment SEQ LEN DT OPT 1 4 SI O 2 8 ID O 3 65536 FT O 4 250 CE O RP/# TBL# ELEMENT NAME VALORE Set ID - NTE 0105 Source of Comment Comment 0364 Comment Type SFW\MD04-02 – Documentazione tecnica Pagina 14 di 28 Standard HL7 – Specifiche Order Entry NTE-1 Set ID – NTE (SI) Questo campo contiene il numero progressivo della nota. NTE-2 Source of Comment (ID) Questo campo identifica la sorgente del commento. Per i possibili valori fare riferimento alla tabella [HL7 table 0105]. NTE-3 Comment (FT) Questo campo contiene il testo della nota. NTE-4 Comment Type (CE) Questo campo identifica la tipologia della nota. I fields da considerare sono i seguenti: • CE.1 (identifier): contiene il codice della tipologia del commento. Per i possibili valori fare riferimento alla tabella [User-defined table 0364]; • CE.2 (text): contiene la descrizione della tipologia del commento; • CE.3 (name of coding system): nome del sistema di codifica utilizzato. Per i possibili valori fare riferimento alla tabella [HL7 Table 0396]. PID - Patient Identification Segment Contiene i dati anagrafici del paziente. Per la specifica fare riferimento al documento di Patient Administration. PV1 - Patient Visit Segment Contiene i dati della visita. Per la specifica fare riferimento al documento relativo all'allineamento anagrafico. Campi in evidenza di particolare interesse per l'order entry: SEQ LEN DT OPT 1 4 SI O 2 1 IS R 3 80 PL O 8 250 XCN O 11 80 PL O 19 250 CX O 51 1 IS O RP/# TBL# 0004 Y 0010 0326 ELEMENT NAME VALORE Set ID - PV1 Progressivo segmento Patient Class Classificazione paziente Assigned Patient Location Reparto di ricovero Referring Doctor Medico richiedente Temporary Location Reparto d'appoggio Visit Number Identificativo visita Visit Indiricator Indica se i dati si riferiscono alla visita o al paziente (fisso a 'V') Per la lista completa dei campi di questo segmento fare riferimento al documento di Patient Administration. SFW\MD04-02 – Documentazione tecnica Pagina 15 di 28 Standard HL7 – Specifiche Order Entry PV2 - Patient Visit – Additional Information Segment Contiene i dati aggiuntivi della visita. Per la specifica fare riferimento al documento di Patient Administration. ORC – Common Order Segment Il segmento ORC contiene le informazioni generali relative all’appuntamento che viene fissato. SEQ LEN DT OPT 1 2 ID R 2 22 EI 3 22 4 RP/# TBL# 0119 ELEMENT NAME VALORE Order Control <tipo evento relativo all'esame> C Placer Order Number <codice progressivo esame placer> EI C Filler Order Number <codice richiesta filler> 22 EI O Placer Group Number <codice richiesta placer> 5 2 ID O Order Status <stato dell'esame> 7 200 TQ B Quantity/Timing <urgenza, data prenotazione> 9 26 TS O Date/Time of Transaction <data della richiesta> 10 250 XCN O Y Entered By <utente ultima modifica> 12 250 XCN O Y Ordering Provider <medico richiedente> 18 250 CE O Entering Device <terminale inserimento richiesta> 21 250 XON O Ordering Facility Name <struttura richiedente> 27 26 TS O Filler's Expected Availability Date/Time <data risultati da filler> 0038 Y Y ORC-1 Order Control (ID) Il campo Order Control definisce l'azione da fare per ogni esame presente all'interno dell'ordine. In particolare, questo campo può comunicare l'aggiunta di una nuova prestazione, il cambio dello stato di lavorazione o la cancellazione. Per i possibili valori fare riferimento alla tabella [HL7 table 0119]. ORC-2 Placer Order Number (EI) Contiene il numero identificativo univoco della richiesta di un esame fatta dall'applicazione placer. Nel caso specifico è composto dal codice della richiesta GPI + progressivo su due cifre. ORC-3 Filler Order Number (EI) Contiene il numero univoco della richiesta assegnato dal filler, al momento della ricezione dell'ordine. SFW\MD04-02 – Documentazione tecnica Pagina 16 di 28 Standard HL7 – Specifiche Order Entry ORC-4 Placer Group Number (EI) Contiene il numero della richiesta generata all'interno degli applicativi GPI (in funzione di Placer). ORC-5 Order Status (ID) Campo valorizzato dal dipartimentale (in funzione di Placer), per comunicare lo stato attuale delle prestazioni all'interno dell'ordine. Per i possibili valori fare riferimento alla tabella [HL7 table 0038]. Attenzione che la notifica di cambio stato può essere definita un informazione composta. Infatti, affinché questa informazione venga letta, il campo ORC-1 (Order Control) deve essere valorizzato a SC. Inoltre, lo stato CM (Completed) può essere esteso con la valorizzazione del campo ORC-25 (Result Status), per indicare la refertazione di una prestazione. ORC-7 Quantity/Timing (TQ) (Deprecato) Questo campo è deprecato, e deve essere utilizzato solo nei messaggi che non contengono il segmento TQ1 (come ad esempio il messaggio ORM^O01). Nel caso di messaggi O01 sono valorizzati i seguenti fields: • TQ.1 (quantity): contiene la quantità dell'esame, ad esempio in termini di ripetizioni. Tendenzialmente è valorizzato ad 1; • TQ.4 (start date/time): contiene la data e l'ora di prenotazione della richiesta; • TQ.6 (priority): contiene il livello di priorità dell'esame. Per i possibili valori fare riferimento alla tabella [User-defined table 0485]. ORC-9 Date/Time of Transaction (TS) Questo campo contiene la data o l'ora della richiesta da parte del placer. Nel caso di trasmissione di prenotazioni, contiene la data della ricetta. ORC-10 Entered By (XCN) Questo campo contiene il codice dell'ultimo utente che ha modificato la richiesta, preceduto dal prefisso “GPI”, all'interno del field XCN.1 (idNumber). ORC-12 Ordering Provider (XCN) Questo campo contiene le informazioni della persona responsabile della richiesta (ad esempio il medico richiedente o il medico prescrittore). Sono valorizzati i seguenti fields: • XCN.1 (idNumber): contiene l'identificato del richiedente (ad esempio la matricola del medico); • XCN.2 (family name): contiene il cognome del richiedente; • XCN.3 (given name): contiene il nome del richiedente. SFW\MD04-02 – Documentazione tecnica Pagina 17 di 28 Standard HL7 – Specifiche Order Entry Nota: il campo ORC-12 ha lo stesso significato del campo ORC-16 (ordering provider). Se tale informazione non è presente nell'ORC-12 deve essere riportata nell'ORC-16, ad esempio per i messaggi come gli ORU dove il segmento ORC non è obbligatorio. ORC-18 Entering Device (CE) Questo campo può indicare il device utilizzato per inserire la richiesta, o più in generale dare informazioni relative alla location. ORC-21 Ordering Facility Name (XON) Questo campo contiene i dati della struttura richiedente, all'interno dei seguenti fields: • XON.1 (organization name): contiene la descrizione della struttura richiedente; • XON.7 (identifier type code): deve contenere il codice “FI” (Facility ID); • XON.10 (organization identifier): contiene il codice della struttura richiedente. ORC-27 Filler Expected Availability Date/Time (TS) Questo campo contiene la data nella quale l’applicazione che riveste il ruolo di filler si aspetta che la prestazione sia disponibile; indica ad esempio quando ci si aspetta che sia disponibile un risultato. TQ1 – Timing / Quantity Segment Il segmento TQ1 contiene informazioni relative al tempo, alle quantità e alle priorità. SEQ LEN DT OPT RP/# 1 4 SI O Set ID – TQ1 <numero di sequenza> 2 20 CQ O Quantity <quantità> 7 26 TS O Start date / time <data> 9 250 CWE O Priority <codice priorità> Y TBL# 0485 ELEMENT NAME SFW\MD04-02 – Documentazione tecnica VALORE Pagina 18 di 28 Standard HL7 – Specifiche Order Entry OBR – Observation Request Segment Il segmento OBR viene usato per trasmettere specifiche informazioni relative a studi diagnostici o osservazioni, esami o valutazioni. SEQ LEN DT OPT RP/# TBL# 1 4 SI O Set ID – OBR <numero di sequenza> 2 22 EI C Placer Order Number <codice progressivo esame placer> 3 22 EI C Filler Order Number <codice richiesta filler> 4 250 CE R Universal Service Identifier <codice richiesta placer> 6 26 TS B Requested Date/Time <data richiesta> 13 300 ST O Relevant Clinical Information <quesito clinico> 16 250 XCN O Ordering Provider <medico richiedente> 18 60 ST O Placer Field 1 19 60 ST O Placer Field 2 20 60 ST O Filler Field 1 + 21 60 ST O Filler Field 2 + 24 10 ID O 0074 Diagnostic Serv Sect ID <codice ambulatorio erogante> 25 1 ID C 0123 Result Status + <stato dei risultati> 27 200 TQ B Quantity/Timing <data richiesta> 30 20 ID O Transportation Mode <modalità trasporto paziente> 36 26 TS O Scheduled Date/Time + <data e ora schedulazione appuntamento> 46 250 CE O Y 0411 Placer Supplemental Service Information 47 250 CE O Y 0411 Filler Supplemental Service Information Y Y 0124 ELEMENT NAME VALORE OBR-1 Set ID – OBR (SI) Il presente campo indica il valore progressivo del segmento all’interno della transazione. OBR-2 Placer Order Number (EI) Questo campo contiene la stessa informazione del campo ORC-2. Per ulteriori dettagli fare riferimento al paragrafo [ORC-2 Placer Order Number]. OBR-3 Filler Order Number (EI) Questo campo contiene la stessa informazione del campo ORC-3. Per ulteriori dettagli fare riferimento al paragrafo [ORC-3 Filler Order Number]. SFW\MD04-02 – Documentazione tecnica Pagina 19 di 28 Standard HL7 – Specifiche Order Entry OBR-4 Universal Service Identifier (CE) Questo campo contiene il codice dell'esame richiesto all'interno dell'ordine. I fields da considerare sono i seguenti: • CE.1 (identifier): contiene il codice dell'esame; • CE.2 (text): contiene la descrizione dell'esame; • CE.3 (name of coding system): nome del sistema di codifica utilizzato. Per i possibili valori fare riferimento alla tabella [HL7 Table 0396]. OBR-6 Requested Date/Time (TS) (Deprecato) Questo campo è mantenuto solo per garantire la compatibilità con le precedenti versioni. Fare riferimento al campo OBR-27, o la segmento TQ1 qualora sia previsto. OBR-13 Relevant Clinical Information (ST) Questo campo può contenere dati clinici (in formato testuale), quali: • quesito clinico; • sospetto diagnostico; • indicazioni terapeutiche; • informazioni utili alla esecuzione della prestazione richiesta. OBR-16 Ordering Provider (XCN) Questo campo contiene la stessa informazione del campo ORC-12. Per ulteriori dettagli fare riferimento al paragrafo [ORC-12 Ordering Provider]. OBR-18 Placer Field 1 (ST) E’ un campo di testo libero che il placer può inviare al filler utile per trasmettere informazioni non già previste negli altri campi. Nel caso di passaggio di prenotazioni, questo campo può contenere il numero della ricetta. OBR-19 Placer Field 2 (ST) E’ un campo di testo libero che il placer può inviare al filler utile per trasmettere informazioni non già previste negli altri campi. Questo campo contiene la struttura destinataria, ossia quella di esecuzione della prestazione. OBR-20 Filler Field 1 (ST) E’ un campo di testo libero che il filler può inviare al placer utile per trasmettere informazioni non già previste negli altri campi. SFW\MD04-02 – Documentazione tecnica Pagina 20 di 28 Standard HL7 – Specifiche Order Entry OBR-21 Filler Field 2 (ST) E’ un campo di testo libero che il filler può inviare al placer utile per trasmettere informazioni non già previste negli altri campi. Questo campo contiene la struttura destinataria, ossia quella di esecuzione della prestazione. Questa informazione viene popolata dal filler, quindi può essere utilizzata come conferma o modifica del luogo di esecuzione nei confronti di quanto proposto dal placer. OBR-25 Result Status (ID) Campo utilizzato in concomitanza con l’ORC-5 (Order Status). Può essere utilizzato, ad esempio, per comunicare lo stato di refertazione relativo ad un ordine completato. Per i possibili valori fare riferimento alla tabella [HL7 table 0123]. OBR-27 Quantity/Timing (TQ) (Deprecato) Questo campo contiene la stessa informazione del campo ORC-7. Per ulteriori dettagli fare riferimento al paragrafo [ORC-7 Quantity/Timing (TQ) (Deprecato)]. OBR-30 Transportation Mode (ID) Questo campo identifica la modalità di trasporto del paziente. Per i possibili valori fare riferimento alla tabella [HL7 table 0124]. OBR-36 Scheduled Date/Time (TS) Contiene la data e ora programmata per l’appuntamento. Il campo viene valorizzato dall’order filler per informare l’order placer della data e ora dell’appuntamento. OBR-46 Placer Supplemental Service Information (CE) E’ un campo codificabile che il placer può inviare al filler, utile per trasmettere informazioni strutturate non già previste negli altri campi. Questo campo può essere riempito, per esempio, con il dettaglio relativo alla zona / sede di prelievo del campione nel caso di richieste di laboratorio. I fields da considerare sono i seguenti: • CE.1 (identifier): contiene il codice dell'informazione da trasmmettere (ad esempio relativo alla zona/sede di prelievo). Per i possibili valori fare riferimento alla tabella [User-defined table 0411]; • CE.2 (text): contiene la descrizione dell'informazione; • CE.3 (name of coding system): nome del sistema di codifica utilizzato. Per i possibili valori fare riferimento alla tabella [HL7 Table 0396]. I coding system che possono essere utilizzati sono i seguenti: • 99GPIZONAPRE: Zone di prelievo; • 99GPIDESTINAT: Codice ambulatorio o servizio diagnostico di destinazione;ss • 99GPITIMESLOT: Codice del timeslot di prenotazione; SFW\MD04-02 – Documentazione tecnica Pagina 21 di 28 Standard HL7 – Specifiche Order Entry • 99GPICONVSSN: Codice delle convezione applicata alla prenotazione. OBR-47 Filler Supplemental Service Information (CE) E’ un campo codificabile che il filler può inviare al placer, utile per trasmettere informazioni strutturate non già previste negli altri campi. Questo campo può essere riempito, per esempio, con il dettaglio relativo alla zona / sede di prelievo del campione nel caso di richieste di laboratorio. I fields da considerare sono i seguenti: • CE.1 (identifier): contiene il codice della zona/sede di prelievo. Per i possibili valori fare riferimento alla tabella [User-defined table 0411]; • CE.2 (text): contiene la descrizione della zona/sede di prelievo; • CE.3 (name of coding system): nome del sistema di codifica utilizzato. Per i possibili valori fare riferimento alla tabella [HL7 Table 0396]. SPM – Specimen Segment Questo segmento contiene le informazioni relative ad un campione contenuto nella richiesta trasmessa. SEQ LEN DT OPT 1 4 SI O 4 250 CWE R 8 250 CWE O RP/# TBL# 0487 ELEMENT NAME VALORE Set ID - SPM Progressivo del segmento Specimen Type Tipologia del campione (materiale) Specimen Source Site Sede del materiale SPM-1 Set ID - SPM (SI) Questo campo contiene il progressivo di ripetizione del segmento. SPM-4 Specimen Type (CWE) Questo campo contiene le informazioni sulla tipologia del campione. I fields da considerare sono i seguenti: • CWE.1 (identifier): codice della tipologia (o materiale); • CWE.2 (text): descrizione della tipologia (o materiale). SPM-8 Specimen Source Site (CWE) Questo campo contiene le informazioni relative alla sede del campione. I fields da considerare sono i seguenti: • CWE.1 (identifier): codice della sede; • CWE.2 (text): descrizione della sede. OBX – Observation Segment Usage SFW\MD04-02 – Documentazione tecnica Pagina 22 di 28 Standard HL7 – Specifiche Order Entry Il segmento OBX viene utilizzato in modo opzionale per la comunicazione di informazioni cliniche rilevanti ai fini della determinazione di certi risultati o degli intervalli di riferimento da applicare. Alcuni esempi di tali informazioni sono: diuresi, altezza, peso, settimana di gravidanza. SEQ LEN DT OPT 1 4 SI O 2 2 ID R 3 250 CE R 5 * * C/R 6 250 CE O 11 1 ID R/NA RP/# TBL# 0125 ELEMENT NAME VALORE Set ID - OBX Progressivo del segmento Value Type Tipo dato presente in OBX-5 Observation Identifier Observation Value Units 0085 Observation Result Status OBX-1 Set ID - OBX (SI) Questo campo contiene il progressivo di ripetizione del segmento. OBX-2 Value Type (ID) Questo campo specifica la tipologia di informazione presente all'interno del campo OBX-5. Per i possibili valori fare riferimento alla tabella [HL7 Table 0125]. OBX-3 Observation Identifier (CE) Questo campo contiene l'identificatore univoco dell'osservazione. I fields da considerare sono i seguenti: • CE.1 (identifier): contiene il codice dell'osservazione; • CE.2 (text): contiene la descrizione dell'esame; • CE.3 (name of coding system): nome del sistema di codifica utilizzato. Per i possibili valori fare riferimento alla tabella [HL7 Table 0396]. OBX-5 Observation Value (varies) Questo campo contiene il valore dell'osservazione identificata nel campo OBX-3. Il data type di questo campo è definito nel campo OBX-2. Ad esempio se il campo OBX-2 contiene il valore 'NM' e il campo OBX-3 identifica il parametro '[VOLNE] VOL.URINE 24H', questo campo conterrà il formato delle urine in formato numerico. Se invece questo segmento OBX si trova all'interno di un messaggio MDM, e il campo OBX2 contiene il valore 'ED', questo campo conterrà un datatype ED, valorizzato come segue: • ED.1 (soruce application): applicazione che ha generato il documento; • ED.2 (type od data): tipo del dato; • ED.3 (data subtype): ulteriore specifica sul tipo del dato; • ED.4 (encoding): tipo di codifica applicata al documento; • ED.5 (data): documento codificato. OBX-6 Units (CE) SFW\MD04-02 – Documentazione tecnica Pagina 23 di 28 Standard HL7 – Specifiche Order Entry Questo campo specifica l'unità di misura utilizzata per la rappresentazione dell'informazione nel campo OBX-5. OBX-11 Observation Result Status (ID) Questo campo specifica lo stato del risultato, nel caso in cui il segmento OBX venga utilizzato per trasmettere risultati o referti. Ad esempio può essere utilizzato lo stato 'F' per indicare che il referto trasmesso è firmato. Per i possibili valori fare riferimento alla tabella [HL7 Table 0085]. SFW\MD04-02 – Documentazione tecnica Pagina 24 di 28 Standard HL7 – Specifiche Order Entry Tabelle di riferimento HL7 table 0038 – Order status Value CM HD IP SC Description Comment Order is completed Order is on hold In process, unspecified In process, scheduled HL7 table 0085 – Observation result status codes interpretation Value F Description Final results; Can only be changed with a corrected result. Comment Nel caso di referti, indica che il referto è firmato HL7 table 0105 – Source of comment Value L Description Ancillary (filler) department is source of comment Orderer (placer) is source of comment Other system is source of comment P O Comment Commento generato dal filler Commento generato dal placer Commento generato da altri sistemi HL7 table 0119 – Order control rules Value NW CA SC RP Description New order/service Cancel order/service request Status changed Order/service replace request Comment Inoltro di una nuova richiesta Cancellazione di una richiesta Modifica stato di una richiesta Modifica delle informazioni di una richiesta HL7 table 0123 – Result status Value F Description Final results; results stored and verified. Can only be changed with a corrected result. Comment Utilizzare per indicare lo stato di refertazione di un esame HL7 table 0124 – Transportation mode SFW\MD04-02 – Documentazione tecnica Pagina 25 di 28 Standard HL7 – Specifiche Order Entry Value CART PORT WALK WHLC Description Cart - patient travels on cart or gurney Comment The examining device goes to patient's location Patient walks to diagnostic service Wheelchair HL7 table 0125 – Value Type Value AD CE DT Description Address Coded Entry Date ED Encapsuled Data NM Numeric SN Structured Numeric ST String Data Comment Data-ora. Da utilizzare ad esempio per comunicare la data di ultima mestruazione. Da utilizzare ad esempio per la trasmissione di referti codificati in base64. Numerico. Per comunicare qualunque valore numerico, intero o decimale. Numerico Strutturato. Per comunicare ad esempio valori del tipo : “>300 mg/L” Per la comunicazione di osservazioni in formato testuale. HL7 table 0203 – Identifier type Value Description Comment User-defined table 0362 – Facility Value IE-DEGENTI IE-RICHIESTE IE-DEA Description Comment IPPOCRATE-DEGENTI IPPOCRATE-RICHIESTE IPPOCRATE-DEA User-defined table 0363 – Assigning authority Value Description Comment Nessun valore di suggerimento. Le singole implemetazioni devo definire una propria voce locale. User-defined table 0364 – Comment Type SFW\MD04-02 – Documentazione tecnica Pagina 26 di 28 Standard HL7 – Specifiche Order Entry Value N5 Coding System 99GPICOMMTYPE Description Comment Anamnesi DEA [GPI] HL7 Table 0396 - Coding system Value Description Comment 99zzz or L Local general code (where z is an alphanumeric character) HL7 Defined Codes where nnnn is the HL7 table number Sistema di codifica locale, ad esempio per codifiche proprietarie di esami, etc Riferimento ad altra HL7 table, ad esempio per utilizzare elementi userdefine Riferimento alla codifica ISO General code Riferimento alla codifica LOINC Specific Non- Drug Code HL7nnnn ISOnnnn LN ISO Defined Codes where nnnn is the ISO table number Logical Observation Identifier Names and Codes (LOINC ®) SFW\MD04-02 – Documentazione tecnica Category General code General code Pagina 27 di 28 Standard HL7 – Specifiche Order Entry Codifiche GPI Value Description 99GPICOMMTYPE GPI Comment Type 99GPIZONAPRE GPI Zone prelievo 99GPIDESTINAT GPI Destinatari 99GPITIMESLOT GPI Timeslot prenotazione 99GPICONVSSN GPI Convenzione SSN Comment Category Coding system delle note generate da sistemi di GPI Coding system delle zone di prelievo Coding system degli ambulatori o dei servizi diagnostici destinatari della richiesta Coding system dei timeslot delle prenotazioni Coding system delle convenzioni SSN applicate alla prenotazione General code General code General code General code General code User-defined table 0411 – Supplemental Service Information Values Value Description Comment Nessun valore di suggerimento. Le singole implemetazioni devo definire una propria voce locale. User-defined table 0485 – Extended Priority Codes Value S R Description Stat Routine SFW\MD04-02 – Documentazione tecnica Comment Esame con priorità alta Esame di routine Pagina 28 di 28
Documenti analoghi
Documentazione tecnica - Azienda Ospedaliera S.Croce e Carle
segmento ID. In mancanza di altre considerazioni HL7 raccomanda l’utilizzo dei
caratteri presenti in tabella.
Esempio:
MSH|^~\&| …………