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