HL7 Batch Client - RFC 85, 86, 87

Transcript

1 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

2 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: REG MARIO ROSSI M VIA G.VERDI, 139 int VIA V.ALFIERI, 83R I campi vuoti sono corrispondenti agli opzionali. SIS_RT_client_RFC85_86_87_ATE_1.0.doc Pagina 2 di 13

3 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 REG 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 Lunghezza 10: AAAAMMGG Se il campo non è valorizzato si assume che la data non sia disponibile. 6 DATA MORTE O Il valore 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 STP TESSERA TEAM O 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.

4 12 COMUNE NASCITA R Lunghezza 6. Valori ammessi: codice ISTAT dei comuni per i nati all estero 13 STATO NASCITA R Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = IND. RESIDENZA O Lunghezza Max COMUNE RESIDENZA R Lunghezza 6. Valori ammessi: codice ISTAT dei comuni per i residenti all estero. 16 STATO RESIDENZA R Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = IND. DOMICILIO O Lunghezza Max COMUNE DOMICILIO O Lunghezza 6. Valori ammessi: codice ISTAT dei comuni 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_ _ _12:35 21 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 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 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

5 forniti in input 20 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

6 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 REG 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 Lunghezza 10: AAAAMMGG 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 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 Lunghezza 1. Valori ammessi: S CELIBE/NUBILE 9 STATO_CIVILE O M CONIUGATO/A

7 L SEPARATO/A D DIVORZIATO/A W VEDOVO/A 10 CITTADINANZA O Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = COMUNE NASCITA R Lunghezza 6. Valori ammessi: codice ISTAT dei comuni per i nati all estero 12 STATO NASCITA R Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = IND. RESIDENZA R Lunghezza Max COMUNE RESIDENZA R Lunghezza 6. Valori ammessi: codice ISTAT dei comuni per i residenti all estero. 15 STATO RESIDENZA R Lunghezza 3. Valori ammessi: codice ISTAT degli stati. Per Italia = IND. DOMICILIO O Lunghezza Max COMUNE DOMICILIO R Lunghezza 6. Valori ammessi: codice ISTAT dei comuni 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_ _201 SIS_RT_client_RFC85_86_87_ATE_1.0.doc Pagina 7 di 13

8 _12:35 24 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 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 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 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 REG se Lunghezza 10: AAAAMMGG 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

9 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_ _ _12:35 8 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 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 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 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

10 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 REG ID UNIVERSALE MEDICO R Lunghezza 24 caratteri REG 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

11 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_ _ _12:35 7 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 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 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 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 REG ID UNIVERSALE MEDICO R Lunghezza 24 caratteri REG 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

12 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_ _ _12:35 7 DATA INVIO Lunghezza 14. Timestamp del messaggio in formato AAAAMMGGHHMISS 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 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 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

13 SIS_RT_client_RFC85_86_87_ATE_1.0.doc Pagina 13 di 13