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
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
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. SIS_RT_client_RFC85_86_87_ATE_1.0.doc Pagina 3 di 13 POSIZIONE NOME RICHIESTO (R)/ OPZIONALE (O) FORMATO ESEMPIO 1 ID UNIVERSALE R Lunghezza 24 caratteri REG999999200400013013169 2 NOME R 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 20050331 Se il campo non è valorizzato si assume che la data non sia disponibile. 6 DATA MORTE O 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"/>). 7 CODICE FISCALE O Il codice fiscale deve essere formalmente valido. Ammessi anche codici fiscali temporanei a 11 cifre. 8 CODICE STP O Formato STP + 11 cifre STP1100000242132 9 TESSERA TEAM O 80380000900048371882 O Lunghezza 1. Valori ammessi: S CELIBE/NUBILE 10 STATO CIVILE M CONIUGATO/A L SEPARATO/A D DIVORZIATO/A W VEDOVO/A 11 CITTADINANZA O Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100.
12 COMUNE NASCITA R Lunghezza 6. Valori ammessi: codice ISTAT dei comuni. 999999 per i nati all estero 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: Da 1 a 19 Campi corrispondenti a quelli forniti in input 20 ID_SPCOOP Id spcoop della comunicazione anagrafica inviata ASL5Pisa_ASL5PisaSPCoopIT_0004457_201 4-06-17_12:35 21 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 22 CODICE ESITO Da 23 a 41 Campi risultanti in anagrafe a seguito dell aggiornamento Il file degli scarti è invece composto da 21 campi secondo il formato seguente: 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-86- 87_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. Da 1 a 19 Campi corrispondenti a quelli SIS_RT_client_RFC85_86_87_ATE_1.0.doc Pagina 4 di 13
forniti in input 20 DATA ELABORAZIONE Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 21 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
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: o 0 per variazioni anagrafiche e di asssitenza o 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. 3.1 Tracciato tipo 0 - variazioni anagrafiche e di assistenza Formato del file POSIZIONE NOME RICHIESTO (R)/ OPZIONALE (O) FORMATO SIS_RT_client_RFC85_86_87_ATE_1.0.doc Pagina 6 di 13 ESEMPIO 1 ID UNIVERSALE R Lunghezza 24 caratteri REG999999200400013013169 2 NOME R 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 20050331 6 DATA MORTE O 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"/>). 7 CODICE FISCALE R Il codice fiscale deve essere formalmente valido. Ammessi anche codici fiscali temporanei a 11 cifre. 8 TESSERA TEAM O 80380000900048371882 Lunghezza 1. Valori ammessi: S CELIBE/NUBILE 9 STATO_CIVILE O M CONIUGATO/A
L SEPARATO/A D DIVORZIATO/A W VEDOVO/A 10 CITTADINANZA O 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 R Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = 100. DATA INIZIO Lunghezza 8: AAAAMMGG 19 ASSISTENZA R 20 DATA FINE ASSISTENZA R Lunghezza 8: AAAAMMGG DATA FINE ASSISTENZA Lunghezza 8: AAAAMMGG 21 SSN 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 22 TIPOLOGIA ASSISTENZA R 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: Da 1 a 22 Stessi campi forniti in input 23 ID_SPCOOP Id spcoop della comunicazione anagrafica inviata ASL5Pisa_ASL5PisaSPCoopIT_0004457_201 SIS_RT_client_RFC85_86_87_ATE_1.0.doc Pagina 7 di 13
4-06-17_12:35 24 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 25 CODICE ESITO Da 26 a 44 Campi risultanti in anagrafe a seguito dell aggiornamento Il file degli scarti è invece composto da 24 campi secondo il formato seguente: 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-86- 87_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. Da 1 a 22 Stessi campi forniti in input 23 DATA ELABORAZIONE Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 24 DESCRIZIONE MOTIVO SCARTO Lunghezza Max 512. Descrizione del motivo dello scarto. 3.2 Tracciato tipo 1 - chiusure di assistenza Formato del file POSIZIONE NOME RICHIESTO (R)/ OPZIONALE (O) FORMATO 1 ID UNIVERSALE R Lunghezza 24 caratteri REG999999200400013013169 se Lunghezza 10: AAAAMMGG 20050331 2 DATA MORTE TIPOLOGIA_ASSISTENZA=4 allora R, altrimenti O. DATA INIZIO Lunghezza 8: AAAAMMGG 3 ASSISTENZA R 4 DATA FINE ASSISTENZA R Lunghezza 8: AAAAMMGG DATA FINE ASSISTENZA Lunghezza 8: AAAAMMGG 5 SSN R Lunghezza 1. Valori ammessi: 4 = deceduto 6 TIPOLOGIA ASSISTENZA R 5 = irreperibile o emigrato File prodotti a seguito dell elaborazione SIS_RT_client_RFC85_86_87_ATE_1.0.doc Pagina 8 di 13 ESEMPIO
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: Da 1 a 6 Stessi campi forniti in input 7 ID_SPCOOP Id spcoop della comunicazione anagrafica inviata ASL5Pisa_ASL5PisaSPCoopIT_0004457_201 4-06-17_12:35 8 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 9 CODICE ESITO Da 10 a 15 Campi risultanti in anagrafe a seguito dell aggiornamento Il file degli scarti è invece composto da 8 campi secondo il formato seguente: 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-86- 87_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. Da 1 a 6 Stessi campi forniti in input 7 DATA ELABORAZIONE Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 8 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
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 o 0 per assegnazione medico o 1 per chiusura medico NNN = Codice ASL a 3 cifre AAAAMMGGHHMISS = data di produzione del tracciato. 4.1 Tracciato tipo 0 assegnazione medico Formato del file POSIZIONE NOME RICHIESTO (R)/ OPZIONALE (O) FORMATO ESEMPIO 1 ID UNIVERSALE ASSISTITO R Lunghezza 24 caratteri REG999999200400013013169 2 ID UNIVERSALE MEDICO R Lunghezza 24 caratteri REG999999200400013013169 Lunghezza 2: 01 = MMG 3 TIPOLOGIA DEL MEDICO R 02 = PLS 4 DATA SCELTA R 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
I file successo e errori per il tracciato di tipo 0 sono composti dai campi documentati in tabella: Da 1 a 5 Stessi campi forniti in input 6 ID_SPCOOP Id spcoop della comunicazione anagrafica inviata ASL5Pisa_ASL5PisaSPCoopIT_0004457_201 4-06-17_12:35 7 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 8 CODICE ESITO Da 9 a 13 Campi risultanti in anagrafe a seguito dell aggiornamento Il file degli scarti è invece composto da 7 campi secondo il formato seguente: 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-86- 87_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. Da 1 a 5 Stessi campi forniti in input 6 DATA ELABORAZIONE Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 7 DESCRIZIONE MOTIVO SCARTO Lunghezza Max 512. Descrizione del motivo dello scarto. 4.2 Tracciato tipo 1 chiusura medico Formato del file POSIZIONE NOME RICHIESTO (R)/ OPZIONALE (O) FORMATO ESEMPIO 1 ID UNIVERSALE ASSISTITO R Lunghezza 24 caratteri REG999999200400013013169 2 ID UNIVERSALE MEDICO R Lunghezza 24 caratteri REG999999200400013013169 Lunghezza 2: 01 = MMG 3 TIPOLOGIA DEL MEDICO R 02 = PLS 4 DATA REVOCA R 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
1 il medico non vuole più assistere l'assistito 2 il medico non è più in attività 3 revoca del pediatra per motivi di età 4 risoluzione per decisione dell utente 5 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: Da 1 a 5 Stessi campi forniti in input 6 ID_SPCOOP Id spcoop della comunicazione anagrafica inviata ASL5Pisa_ASL5PisaSPCoopIT_0004457_201 4-06-17_12:35 7 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 8 CODICE ESITO Da 9 a 13 Campi risultanti in anagrafe a seguito dell aggiornamento Il file degli scarti è invece composto da 7 campi secondo il formato seguente: 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-86- 87_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. Da 1 a 5 Stessi campi forniti in input 6 DATA ELABORAZIONE Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 20140625235732 7 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
SIS_RT_client_RFC85_86_87_ATE_1.0.doc Pagina 13 di 13