Transcript HL7 Batch Client - RFC 85, 86, 87 - OSCAT

Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
HL7 Batch Client - RFC 85, 86, 87
Versione del 27/06/2014
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
Pagina 1 di 13
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
1.
Introduzione
In questo documento è riportata la descrizione del formato dei file di input per l’applicativo HL7 Batch Client. Obiettivo dell’applicativo è estrarre informazione da
tali file, comporre messaggi HL7 e inviarli all’anagrafe regionale. In particolare:
• esegue aggiornamenti dei dati anagrafici o di assistenza per soggetti già censiti in anagrafe utilizzando i servizi RFC 85 o 86;
• esegue scelte e revoche del medico utilizzando i servizi RFC 87.
I file, che devono essere codificati in UTF-8, contengono le informazioni riportate nelle sezioni seguenti, nell’ordine riportato nelle tabelle e separate dal carattere
‘|’.
Come descritto nelle tabelle che seguono, alcuni campi sono obbligatori, altri opzionali. Le obbligatorietà sono quelle previste da RFC 85, 86, 87 e documentate
nelle guide all’implementazione. Se un campo è opzionale non deve essere omesso ma deve invece essere riportato nel tracciato come campo vuoto. Ad
esempio:
REG99999920090000000134|MARIO|ROSSI|M|19580502|||||||048017|100|VIA G.VERDI, 139 int.4|048018|100|VIA V.ALFIERI, 83R|050010|100
I campi vuoti ‘||’ sono corrispondenti agli opzionali.
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
Pagina 2 di 13
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
2.
Tracciati per aggiornamento dati anagrafici - RFC 85
Il nome del file ha il seguente formato:
RFC85A090NNN000AAAAMMGGHHMISS.txt
Dove:
•
•
•
A = valore fisso a ‘0’ (variazioni anagrafiche)
NNN = Codice ASL a 3 cifre
AAAAMMGGHHMISS = data di produzione del tracciato.
Formato del file
I campi previsti dal tracciato sono i seguenti, come da guida all’implementazione RFC 85. In verde i dati obbligatori.
POSIZIONE
NOME
RICHIESTO (R)/
OPZIONALE (O)
FORMATO
1
2
ID UNIVERSALE
NOME
R
R
Lunghezza 24 caratteri
Lunghezza Max 50
3
COGNOME
R
Lunghezza Max 50
4
SESSO
R
Lunghezza 1, valori ammessi: M/F
5
DATA NASCITA
R
6
DATA MORTE
O
7
CODICE FISCALE
O
8
CODICE STP
O
TESSERA TEAM
O
9
O
10
STATO CIVILE
11
CITTADINANZA
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
O
ESEMPIO
REG999999200400013013169
Lunghezza 8: AAAAMMGG
19370426
Lunghezza 10: AAAAMMGG
Se il campo non è valorizzato si assume che la data non sia disponibile.
Il valore 00010101 deve essere utilizzato per indicare la volontà di annullare la data di
morte eventualmente presente (viene inviato al servizio <v3:deceasedTime
nullFlavor="NI"/>).
Il codice fiscale deve essere formalmente valido. Ammessi anche codici fiscali temporanei
a 11 cifre.
Formato STP + 11 cifre
20050331
STP1100000242132
80380000900048371882
Lunghezza 1. Valori ammessi:
•
S
CELIBE/NUBILE
•
M
CONIUGATO/A
•
L
SEPARATO/A
•
D
DIVORZIATO/A
•
W
VEDOVO/A
Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100.
Pagina 3 di 13
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
R
Lunghezza 6. Valori ammessi: codice ISTAT dei comuni. 999999 per i nati all’estero
12
COMUNE NASCITA
13
STATO NASCITA
R
Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100.
14
IND. RESIDENZA
O
Lunghezza Max 255
15
COMUNE RESIDENZA
R
Lunghezza 6. Valori ammessi: codice ISTAT dei comuni. 999999 per i residenti all’estero.
16
STATO RESIDENZA
R
Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100.
17
IND. DOMICILIO
O
Lunghezza Max 255
18
COMUNE DOMICILIO
O
Lunghezza 6. Valori ammessi: codice ISTAT dei comuni. 999999 per i domiciliati all’estero
19
STATO DOMICILIO
O
Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100.
File prodotti a seguito dell’elaborazione
A seguito dell’elaborazione del file sono creati tre tracciati:
1 RFC85A090NNN000AAAAMMGGHHMISS_successo.txt contenente i record elaborati correttamente.
2 RFC85A090NNN000AAAAMMGGHHMISS_errori.txt contenente i record inviati al servizio anagrafico ma per i quali la comunicazione non si è conclusa
con successo o che sono stati rifiutati dal servizio anagrafico con un codice di errore.
3 RFC85A090NNN000AAAAMMGGHHMISS_scarti.txt contenente i record scartati per validazione.
I file “successo” e “errori” sono composti dai seguenti campi riportati in tabella:
POSIZIONE
Da 1 a 19
NOME
ID_SPCOOP
21
DATA INVIO
Da 23 a 41
ESEMPIO
Campi corrispondenti a quelli
forniti in input
20
22
FORMATO
Id spcoop della comunicazione anagrafica inviata
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
CODICE ESITO
Campi risultanti in anagrafe a
seguito dell’aggiornamento
ASL5Pisa_ASL5PisaSPCoopIT_0004457_201
4-06-17_12:35
20140625235732
Nel file “successo” è sempre valorizzato con OK000
Nel file degli “errori” contiene il codice dell’errore riscontrato secondo la codifica prevista da RFC
85. Lunghezza 5. valori ammessi: documentati in
http://oscat.rete.toscana.it/docman/view.php/42/1617/RFC85-8687_Specifiche_di_Implementazione_Allegato+Errori_v1.3.doc
Valorizzati solo nel file “successo” per dare evidenza se le variazioni comunicate sono state
acquisite dall’anagrafe.
Il file degli “scarti” è invece composto da 21 campi secondo il formato seguente:
POSIZIONE
Da 1 a 19
NOME
FORMATO
ESEMPIO
Campi corrispondenti a quelli
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
Pagina 4 di 13
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
forniti in input
20
21
DATA ELABORAZIONE
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
DESCRIZIONE MOTIVO SCARTO
Lunghezza Max 512. Descrizione del motivo dello scarto.
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
Pagina 5 di 13
20140625235732
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
3.
Tracciati per aggiornamento dati anagrafici e di assistenza - RFC 86
Il nome del file ha il seguente formato:
RFC86A090NNN000AAAAMMGGHHMISS.txt
Dove:
•
A = Tipo tracciato:
‘0’ per variazioni anagrafiche e di asssitenza
‘1’ per chiusura di assistenza (in questi casi è sufficiente un set ridotto di informazioni)
NNN = Codice ASL a 3 cifre
AAAAMMGGHHMISS = data di produzione del tracciato.
o
o
•
•
3.1
Tracciato tipo ‘0’ - variazioni anagrafiche e di assistenza
Formato del file
POSIZIONE
NOME
RICHIESTO (R)/
OPZIONALE (O)
FORMATO
ESEMPIO
1
ID UNIVERSALE
R
2
NOME
R
Lunghezza 24 caratteri
Lunghezza Max 50
3
COGNOME
R
Lunghezza Max 50
4
SESSO
R
Lunghezza 1, valori ammessi: M/F
5
DATA NASCITA
R
Lunghezza 8: AAAAMMGG
19370426
Lunghezza 10: AAAAMMGG
Se il campo non è valorizzato si assume che la data non sia disponibile e viene inviato al
servizio <v3:deceasedTime nullFlavor="NAV"/>.
Il valore 00010101 deve essere utilizzato per indicare la volontà di annullare la data di
morte eventualmente presente (viene inviato al servizio <v3:deceasedTime
nullFlavor="NI"/>).
Il codice fiscale deve essere formalmente valido. Ammessi anche codici fiscali temporanei
a 11 cifre.
20050331
6
DATA MORTE
O
7
CODICE FISCALE
R
8
TESSERA TEAM
O
9
STATO_CIVILE
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
O
REG999999200400013013169
80380000900048371882
Lunghezza 1. Valori ammessi:
•
S
CELIBE/NUBILE
•
M
CONIUGATO/A
Pagina 6 di 13
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
10
CITTADINANZA
O
•
L
SEPARATO/A
•
D
DIVORZIATO/A
•
W
VEDOVO/A
Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100.
11
COMUNE NASCITA
R
Lunghezza 6. Valori ammessi: codice ISTAT dei comuni. 999999 per i nati all’estero
12
STATO NASCITA
R
Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100.
13
IND. RESIDENZA
R
Lunghezza Max 255
14
COMUNE RESIDENZA
R
Lunghezza 6. Valori ammessi: codice ISTAT dei comuni. 999999 per i residenti all’estero.
15
STATO RESIDENZA
R
Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100.
16
IND. DOMICILIO
O
Lunghezza Max 255
17
COMUNE DOMICILIO
R
Lunghezza 6. Valori ammessi: codice ISTAT dei comuni. 999999 per i domiciliati all’estero
18
STATO DOMICILIO
DATA INIZIO
ASSISTENZA
R
Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100.
DATA FINE ASSISTENZA
DATA FINE ASSISTENZA
SSN
R
19
20
21
22
TIPOLOGIA ASSISTENZA
Lunghezza 8: AAAAMMGG
R
Lunghezza 8: AAAAMMGG
Lunghezza 8: AAAAMMGG
R
R
Lunghezza 1. Valori ammessi:
•
1 = assistibile non a termine
•
2 = assistibile a termine per straniero con permesso di soggiorno
•
3 = assistibile a termine per motivo diverso da straniero con permesso di
soggiorno
•
4 = deceduto
•
5 = irreperibile o emigrato
File prodotti a seguito dell’elaborazione
A seguito dell’elaborazione del file sono creati tre tracciati:
• RFC860090NNN000AAAAMMGGHHMISS_successo.txt contenente i record elaborati correttamente.
• RFC860090NNN000AAAAMMGGHHMISS_errori.txt contenente i record inviati al servizio anagrafico ma per i quali la comunicazione non si è conclusa
con successo o che sono stati rifiutati dal servizio anagrafico con un codice di errore.
• RFC860090NNN000AAAAMMGGHHMISS_scarti.txt contenente i record scartati per validazione.
I file “successo” e “errori” per il tracciato di tipo “0” sono composti dai campi documentati in tabella:
POSIZIONE
Da 1 a 22
23
NOME
FORMATO
ESEMPIO
Stessi campi forniti in input
ID_SPCOOP
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
ASL5Pisa_ASL5PisaSPCoopIT_0004457_201
Id spcoop della comunicazione anagrafica inviata
Pagina 7 di 13
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
4-06-17_12:35
24
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
DATA INVIO
25
CODICE ESITO
Da 26 a 44
20140625235732
Nel file “successo” è sempre valorizzato con OK000
Nel file degli “errori” contiene il codice dell’errore riscontrato secondo la codifica prevista da RFC
86. Lunghezza 5. valori ammessi: documentati in
http://oscat.rete.toscana.it/docman/view.php/42/1617/RFC85-8687_Specifiche_di_Implementazione_Allegato+Errori_v1.3.doc
Valorizzati solo nel file “successo” per dare evidenza se le variazioni comunicate sono state
acquisite dall’anagrafe.
Campi risultanti in anagrafe a
seguito dell’aggiornamento
Il file degli “scarti” è invece composto da 24 campi secondo il formato seguente:
POSIZIONE
Da 1 a 22
23
24
3.2
NOME
FORMATO
ESEMPIO
Stessi campi forniti in input
DATA ELABORAZIONE
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
DESCRIZIONE MOTIVO SCARTO
Lunghezza Max 512. Descrizione del motivo dello scarto.
20140625235732
Tracciato tipo ‘1’ - chiusure di assistenza
Formato del file
POSIZIONE
NOME
1
ID UNIVERSALE
2
DATA MORTE
DATA INIZIO
ASSISTENZA
3
4
5
6
DATA FINE ASSISTENZA
DATA FINE ASSISTENZA
SSN
RICHIESTO (R)/
OPZIONALE (O)
FORMATO
Lunghezza 24 caratteri
R
se
Lunghezza 10: AAAAMMGG
TIPOLOGIA_ASSISTENZA=4
allora “R”, altrimenti “O”.
Lunghezza 8: AAAAMMGG
R
Lunghezza 8: AAAAMMGG
R
TIPOLOGIA ASSISTENZA
REG999999200400013013169
20050331
Lunghezza 8: AAAAMMGG
R
R
Lunghezza 1. Valori ammessi:
•
4 = deceduto
•
5 = irreperibile o emigrato
File prodotti a seguito dell’elaborazione
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
ESEMPIO
Pagina 8 di 13
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
A seguito dell’elaborazione del file sono creati tre tracciati:
• RFC861090NNN000AAAAMMGGHHMISS_successo.txt contenente i record elaborati correttamente.
• RFC861090NNN000AAAAMMGGHHMISS_errori.txt contenente i record inviati al servizio anagrafico ma per i quali la comunicazione non si è conclusa
con successo o che sono stati rifiutati dal servizio anagrafico con un codice di errore.
• RFC861090NNN000AAAAMMGGHHMISS_scarti.txt contenente i record scartati per validazione.
I file “successo” e “errori” per il tracciato di tipo “1” sono composti dai campi documentati in tabella:
POSIZIONE
Da 1 a 6
NOME
ID_SPCOOP
8
DATA INVIO
Da 10 a 15
ESEMPIO
Stessi campi forniti in input
7
9
FORMATO
Id spcoop della comunicazione anagrafica inviata
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
CODICE ESITO
Campi risultanti in anagrafe a
seguito dell’aggiornamento
ASL5Pisa_ASL5PisaSPCoopIT_0004457_201
4-06-17_12:35
20140625235732
Nel file “successo” è sempre valorizzato con OK000
Nel file degli “errori” contiene il codice dell’errore riscontrato secondo la codifica prevista da RFC
86. Lunghezza 5. valori ammessi: documentati in
http://oscat.rete.toscana.it/docman/view.php/42/1617/RFC85-8687_Specifiche_di_Implementazione_Allegato+Errori_v1.3.doc
Valorizzati solo nel file “successo” per dare evidenza se le variazioni comunicate sono state
acquisite dall’anagrafe.
Il file degli “scarti” è invece composto da 8 campi secondo il formato seguente:
POSIZIONE
Da 1 a 6
7
8
NOME
FORMATO
ESEMPIO
Stessi campi forniti in input
DATA ELABORAZIONE
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
DESCRIZIONE MOTIVO SCARTO
Lunghezza Max 512. Descrizione del motivo dello scarto.
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
Pagina 9 di 13
20140625235732
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
4.
Tracciati per la scelta e revoca del medico - RFC 87
Il nome del file ha il seguente formato:
RFC87A090NNN000AAAAMMGGHHMISS.txt
Dove:
•
A = Tipo tracciato
‘0’ per assegnazione medico
‘1’ per chiusura medico
NNN = Codice ASL a 3 cifre
AAAAMMGGHHMISS = data di produzione del tracciato.
o
o
•
•
4.1
Tracciato tipo ‘0’ – assegnazione medico
Formato del file
POSIZIONE
NOME
RICHIESTO (R)/
OPZIONALE (O)
1
ID UNIVERSALE ASSISTITO
R
2
ID UNIVERSALE MEDICO
R
FORMATO
Lunghezza 24 caratteri
Lunghezza 24 caratteri
ESEMPIO
REG999999200400013013169
REG999999200400013013169
Lunghezza 2:
•
01 = MMG
3
TIPOLOGIA DEL MEDICO
R
4
DATA SCELTA
R
•
02 = PLS
Lunghezza 8: AAAAMMGG
5
DATA REVOCA
R
Lunghezza 8: AAAAMMGG
File prodotti a seguito dell’elaborazione
A seguito dell’elaborazione del file sono creati tre tracciati:
• RFC870090NNN000AAAAMMGGHHMISS_successo.txt contenente i record elaborati correttamente.
• RFC870090NNN000AAAAMMGGHHMISS_errori.txt contenente i record inviati al servizio anagrafico ma per i quali la comunicazione non si è conclusa
con successo o che sono stati rifiutati dal servizio anagrafico con un codice di errore.
• RFC870090NNN000AAAAMMGGHHMISS_scarti.txt contenente i record scartati per validazione.
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
Pagina 10 di 13
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
I file “successo” e “errori” per il tracciato di tipo “0” sono composti dai campi documentati in tabella:
POSIZIONE
Da 1 a 5
NOME
FORMATO
ESEMPIO
Stessi campi forniti in input
6
ID_SPCOOP
7
DATA INVIO
8
Id spcoop della comunicazione anagrafica inviata
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
CODICE ESITO
Da 9 a 13
Campi risultanti in anagrafe a
seguito dell’aggiornamento
ASL5Pisa_ASL5PisaSPCoopIT_0004457_201
4-06-17_12:35
20140625235732
Nel file “successo” è sempre valorizzato con OK000
Nel file degli “errori” contiene il codice dell’errore riscontrato secondo la codifica prevista da RFC
87. Lunghezza 5. valori ammessi: documentati in
http://oscat.rete.toscana.it/docman/view.php/42/1617/RFC85-8687_Specifiche_di_Implementazione_Allegato+Errori_v1.3.doc
Valorizzati solo nel file “successo” per dare evidenza se le variazioni comunicate sono state
acquisite dall’anagrafe.
Il file degli “scarti” è invece composto da 7 campi secondo il formato seguente:
POSIZIONE
Da 1 a 5
NOME
FORMATO
ESEMPIO
Stessi campi forniti in input
6
DATA ELABORAZIONE
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
7
DESCRIZIONE MOTIVO SCARTO
Lunghezza Max 512. Descrizione del motivo dello scarto.
4.2
20140625235732
Tracciato tipo ‘1’ – chiusura medico
Formato del file
POSIZIONE
NOME
RICHIESTO (R)/
OPZIONALE (O)
1
ID UNIVERSALE ASSISTITO
R
2
ID UNIVERSALE MEDICO
R
FORMATO
Lunghezza 24 caratteri
Lunghezza 24 caratteri
Lunghezza 2:
•
01 = MMG
3
TIPOLOGIA DEL MEDICO
R
4
DATA REVOCA
R
•
02 = PLS
Lunghezza 8: AAAAMMGG
5
MOTIVO CHIUSURA
R
Lunghezza 1. Codici ammessi:
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
Pagina 11 di 13
ESEMPIO
REG999999200400013013169
REG999999200400013013169
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
1
2
3
4
5
il medico non vuole più assistere l'assistito
il medico non è più in attività
revoca del pediatra per motivi di età
risoluzione per decisione dell’utente
revoca per decesso dell’assistito
File prodotti a seguito dell’elaborazione
A seguito dell’elaborazione del file sono creati tre tracciati:
• RFC871090NNN000AAAAMMGGHHMISS_successo.txt contenente i record elaborati correttamente.
• RFC871090NNN000AAAAMMGGHHMISS_errori.txt contenente i record inviati al servizio anagrafico ma per i quali la comunicazione non si è conclusa
con successo o che sono stati rifiutati dal servizio anagrafico con un codice di errore.
• RFC871090NNN000AAAAMMGGHHMISS_scarti.txt contenente i record scartati per validazione.
I file “successo” e “errori” per il tracciato di tipo “1” sono composti dai campi documentati in tabella:
POSIZIONE
Da 1 a 5
NOME
ID_SPCOOP
7
DATA INVIO
Da 9 a 13
ESEMPIO
Stessi campi forniti in input
6
8
FORMATO
Id spcoop della comunicazione anagrafica inviata
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
CODICE ESITO
Campi risultanti in anagrafe a
seguito dell’aggiornamento
ASL5Pisa_ASL5PisaSPCoopIT_0004457_201
4-06-17_12:35
20140625235732
Nel file “successo” è sempre valorizzato con OK000
Nel file degli “errori” contiene il codice dell’errore riscontrato secondo la codifica prevista da RFC
87. Lunghezza 5. valori ammessi: documentati in
http://oscat.rete.toscana.it/docman/view.php/42/1617/RFC85-8687_Specifiche_di_Implementazione_Allegato+Errori_v1.3.doc
Valorizzati solo nel file “successo” per dare evidenza se le variazioni comunicate sono state
acquisite dall’anagrafe.
Il file degli “scarti” è invece composto da 7 campi secondo il formato seguente:
POSIZIONE
Da 1 a 5
6
7
NOME
FORMATO
ESEMPIO
Stessi campi forniti in input
DATA ELABORAZIONE
Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS
DESCRIZIONE MOTIVO SCARTO
Lunghezza Max 512. Descrizione del motivo dello scarto.
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
Pagina 12 di 13
20140625235732
Regione Toscana
Sistema Informativo Sanitario e Socio-Sanitario e Sistema Informativo Sociale
Analisi tecnica e formato file
SIS_RT_client_RFC85_86_87_ATE_1.0.doc
Pagina 13 di 13