Struttura Dati Popolamento INA Documento: INA-SAIA_Struttura_Dati_e_Validazione_Popolamento_INA_v3.02 Versione: v3.02 Stato: Emesso Data: 22/03/2012 Deliverable di riferimento:
Cronologia Versioni Versione Data Cambiamenti rispetto alla versione precedente Autore 3.00 30/09/2011 Prima Stesura Modifiche legate all'emanazione del nuovo regolamento dell'ina, il quale prevede l'aggiunta dei campi INDIRIZZO, CITTADINANZA e FAMIGLIA ANAGRAFICA alle informazioni contenute nell'indice. Inserite le regole di controllo applicativo. Aggiunto "codice Istat della sezione di censimento" e corrispettive obbligatorietà (codiceistatsezionecensimento). 3.01 04/11/2011 Aggiunta obbligatorietà del campo famigliaanagrafica/dataoriginefamiglia sul Popolamento Residenti 3.02 22/03/12 Aggiunte le relazioni di parentela della convivenza in A1.3 Modificata Fig.3 eliminando Inizio Nuovo File in Generalità INA: un nuovo file è generato ad ogni Richiesta Saia e contiene tutte le comunicazioni di popolamento in essa contenute. Modificata Fig.8 inserendo nella risposta gli id del file e della persona. Eliminati 7.1, 7.4, 7.3, 7.4, ridondati dal rif.2 3.03 12/12/2012 Aggiunta di una nota nel paragrafo 3 che descrive il nuovo processo di elaborazione delle variazioni di popolamento (causali 22 23 24). Ancitel Ancitel Ancitel Ancitel Documenti di Riferimento Documento Rif. 1: INA-SAIA_Allegato_tecnico_2_Struttura_Dati_AP5_v.3.01.doc Rif. 2. INA-SAIA_Allegato_tecnico_3_Schema_di_validazione_applicativa_v.3.02.doc Ambito di riferimento Acronimi e Definizioni Def/Acronimo AE INA XML SAIA Descrizione Agenzia delle Entrate Indice Nazionale delle Anagrafi extensible Markup Language Sistema di Accesso ed Interscambio Anagrafico
Indice 1. Scopo del documento... 5 2. Introduzione... 5 3. Struttura delle richieste e delle risposte... 5 4. Struttura dati Popolamento INA... 10 4.1. Struttura dati invio Popolamento INA... 11 4.2. Struttura dati risposta... 14 5. Struttura dati Stato Code... 16 5.1. Struttura dati richiesta Stato Code... 16 5.2. Struttura dati risposta Stato Code... 17 6. Struttura dati Presa in Carico... 18 6.1. Struttura dati richiesta Presa in Carico... 18 6.2. Struttura dati risposta Presa in Carico... 19 7. Validazione Applicativa... 20 A1. Tabelle di decodifica... 21 A1.1. Tabella Causali... 21 A1.2. Tabella Stato Civile... 22 A1.3. Tabella Codici Relazione Parentela... 22 Indice delle figure Figura 1 Richieste SAIA... 8 Figura 2 Risposte del SAIA... 9 Figura 3 Richiesta di Popolamento INA... 12 Figura 4 Dati per la richiesta di Popolamento INA (Soggetti Residenti)... 13 Figura 5 Dati per la richiesta di Popolamento INA (Soggetti Emigrati all Estero)... 13 Figura 6 Dati per la richiesta di Popolamento INA (Soggetti Deceduti)... 13 Figura 7 Risposta del SAIA per la richiesta di Popolamento INA... 14 Figura 8 Dati della risposta del SAIA alla richiesta di Popolamento INA... 15 Figura 9 Richiesta di stato code per i popolamenti INA... 16 Figura 10 Risposta del SAIA alla richiesta di Stato Code... 17 Figura 11 Richiesta di presa in carico dei popolamenti INA... 18 Figura 12 Risposta del SAIA per la richiesta di presa in carico del Popolamento INA... 19 Figura 13 Classi di validazione applicativa specifiche utilizzate per il Popolamento INA... 20 Indice delle tabelle Tabella 1 Spazio dei nomi utilizzato per le comunicazioni di popolamento INA... 5
1. Scopo del documento Il documento introduce la struttura dei dati scambiati tra i comuni e il SAIA per il popolamento della base dati INA. Nei paragrafi seguenti sono descritti i messaggi e la loro struttura definiti all interno di file schema XML. Gli elementi sono descritti nei documenti di specifica dei suddetti schema XML indicati nel seguito. 2. Introduzione Il servizio di popolamento INA prevede lo scambio dei seguenti messaggi tra il comune che deve effettuare il popolamento e il SAIA che deve ricevere le comunicazioni e inoltrarle all INA: Richiesta di popolamento, dal comune al SAIA Presa in Carico delle risposte, dal SAIA al comune Stato delle code, dal comune al SAIA Tutti i messaggi prevedono una richiesta e una risposta sincrona via HTTP tra il comune che utilizza il client XML-SAIA e il server. I messaggi sono serializzatati in formato XML e rispettano una grammatica formalizzata utilizzando il linguaggio XML Schema. I messaggi sono composti utilizzando i vocaboli definiti per le comunicazioni basate sul modello AP5 Namespace URI Prefisso Riferimento http://saia.ancitel.it/xmlmanager/ap5 ap5 Rif. 1 Tabella 1 Spazio dei nomi utilizzato per le comunicazioni di popolamento INA 3. Struttura delle richieste e delle risposte I comuni utilizzano il servizio di Popolamento INA per allineare i dati delle proprie anagrafi con quelli presenti nella base dati INA. Quest ultima gestisce alcune informazioni riguardanti i cittadini, italiani e stranieri, che hanno o hanno avuto la residenza in Italia. Un cittadino può essere residente nel comune, emigrato o deceduto. I dati dei cittadini gestiti dall INA, che devono essere forniti dai comuni per il popolamento, sono i seguenti: Codice fiscale Nome Cognome Sesso Data di nascita Comune o stato estero di nascita Provincia di nascita
Per i cittadini residenti devono essere forniti, oltre ai precedenti, anche i seguenti dati: Indirizzo di Residenza Data di decorrenza dell indirizzo di residenza Famiglia Anagrafica Per i cittadini emigrati all estero devono essere forniti, in aggiunta ai dati comuni a tutti i cittadini, anche i seguenti: Stato estero di emigrazione Data di decorrenza dell emigrazione Infine per i cittadini deceduti deve essere fornito il seguente dato: Data di decesso Il comune che effettua il popolamento può utilizzare i messaggi del SAIA per inviare i dati all INA e in seguito per ottenere informazioni sullo stato della richiesta e sull esito dei popolamenti. Una richiesta di popolamento è formata da un numero di comunicazioni pari al numero dei cittadini per i quali si deve effettuare l aggiornamento dei dati in INA. Un comune può effettuare il popolamento dei cittadini residenti o dei cittadini emigrati all estero o infine dei cittadini deceduti. Ogni comunicazione contiene i dati per il popolamento della base dati INA con i dati di un cittadino del comune mittente. Il comune invia la richiesta di popolamento al SAIA che gestisce le operazioni di aggiornamento/inserimento in INA. Il SAIA, a fronte dell acquisizione di una richiesta di popolamento, restituisce una risposta sincrona contenente informazioni di riepilogo sulla richiesta e il risultato della validazione delle comunicazioni contenute nella richiesta.il comune può ottenere lo stato dei popolamenti con una richiesta di stato code. Per ciascun popolamento dei dati di un cittadino il SAIA può restituire uno dei seguenti valori dello stato: Accettato Completato Preso in carico Si precisa che le richieste di popolamento per le quali è stata restituita una risposta del tipo "documento accettato", saranno processate in modo asincrono dal sistema pertanto, qualora venga eseguita una richiesta di stato code subito dopo l invio, è possibile che non vi sia alcuna evidenza della comunicazione inviata. Si raccomanda di non risottomettere le comunicazioni che hanno ricevuto il messaggio documento accettato anche se non presenti temporaneamente nello stato code. Il primo è assegnato dal SAIA al momento della ricezione dei dati per il popolamento dell'ina. Il secondo è assegnato al termine delle operazioni di popolamento INA sia in caso di inserimento dei dati sia in caso di anomalie. Il terzo stato è assegnato all'invio
dell'esito del popolamento al comune in seguito alla richiesta di presa in carico. Il comune può ottenere gli esiti dei popolamenti attraverso una richiesta di presa in carico. Nelle figure seguenti sono riportate le strutture dei messaggi di richiesta di popolamento e di risposta nonché dei messaggi di richiesta di stato code e presa in carico.
Figura 1 Richieste SAIA
Figura 2 Risposte del SAIA
4. Struttura dati Popolamento INA Di seguito sono rappresentati i tipi di dati delle richieste di popolamento e delle risposte del SAIA. Ogni richiesta può contenere una o più comunicazioni contenente ciascuna i dati per il popolamento di un cittadino nella base dati INA. La richiesta ha un attributo versione che identifica la versione della busta del messaggio. Il server SAIA, in seguito alla ricezione di una richiesta di popolamento, restituisce una risposta sincrona al client contenente informazioni di riepilogo sulle comunicazioni contenute nella richiesta e sull esito della validazione di ciascuna. Per ciascuna comunicazione accettata come valida dal SAIA la risposta contiene il numero di protocollo da utilizzare successivamente per ottenere lo stato del popolamento ed effettuare la presa in carico.
4.1. Struttura dati invio Popolamento INA La richiesta di popolamento contiene, all interno di ciascuna comunicazione, i dati del cittadino da utilizzare per il popolamento.
Figura 3 Richiesta di Popolamento INA
Figura 4 Dati per la richiesta di Popolamento INA (Soggetti Residenti) Figura 5 Dati per la richiesta di Popolamento INA (Soggetti Emigrati all Estero) Figura 6 Dati per la richiesta di Popolamento INA (Soggetti Deceduti)
4.2. Struttura dati risposta Il SAIA risponde ad una richiesta di popolamento restituendo l esito delle verifiche effettuate su ciascuna comunicazione contenuta nella richiesta. Per le comunicazioni accettate il SAIA restituisce, oltre ad alcune informazioni di riepilogo, un numero di protocollo da utilizzare successivamente per il recupero degli esiti dei popolamenti nella base dati INA. Figura 7 Risposta del SAIA per la richiesta di Popolamento INA
Figura 8 Dati della risposta del SAIA alla richiesta di Popolamento INA
5. Struttura dati Stato Code Lo stato delle code, permette agli utenti del sistema SAIA di verificare lo stato delle loro richieste. 5.1. Struttura dati richiesta Stato Code La richiesta di stato code permette al comune di prelevare lo stato dei popolamenti inviati al SAIA. Figura 9 Richiesta di stato code per i popolamenti INA
5.2. Struttura dati risposta Stato Code Lo risposta del SAIA alla richiesta di stato code contiene lo stato delle singole comunicazioni inviate per il popolamento dei cittadini. Gli stati previsti per ciascuna comunicazione possono essere: accettata, completata e presa in carico. Una comunicazione risulta completata al termine dell operazione di popolamento nella base dati INA. Figura 10 Risposta del SAIA alla richiesta di Stato Code
6. Struttura dati Presa in Carico La presa in carico delle comunicazioni deve essere effettuata dal responsabile dei servizi anagrafici di un comune per acquisire gli esiti dei popolamenti. 6.1. Struttura dati richiesta Presa in Carico La richiesta di presa in carico permette al comune di prelevare gli esiti dei popolamenti effettuati nella base dati INA. Figura 11 Richiesta di presa in carico dei popolamenti INA
6.2. Struttura dati risposta Presa in Carico La risposta del SAIA alla richiesta di presa in carico restituisce gli esiti dei popolamenti completati. Figura 12 Risposta del SAIA per la richiesta di presa in carico del Popolamento INA
7. Validazione Applicativa I messaggi da comune a SAIA devono poter essere convalidati oltre che da un punto di vista grammaticale, attraverso gli schema XML, anche da un punto di vista applicativo. Per tutti i controlli applicativi di una generica comunicazione, nello specifico di popolamento, si fa riferimento al documento [Rif. 2]. Nella tabella seguente sono riportate le classi di validazione specifiche per il solo popolamento con la descrizione del tipo di validazione implementata. Classe Descrizione ValidazioneIdFileIdPersona Verifica che l IDFilePopolamento e l IDPersonaPopolamento siano congruenti. Figura 13 Classi di validazione applicativa specifiche utilizzate per il Popolamento INA
A1. Tabelle di decodifica In questo paragrafo si presentano delle tabelle da utilizzare per popolare alcuni campi dell AP5 descritti precedentemente. A1.1. Tabella Causali Descrizione Tabella che associa un codice identificativo alla Variazione Anagrafica. Tale codice si utilizza per popolare il campo MotivoComunicazione del macrodato Causale dell AP5. CODICE DESCRIZIONE 1 Nascita 2 Immigrazione da altro comune 3 Immigrazione dall estero 4 Iscrizione da mancata iscrizione in alcun comune italiano 5 Morte 6 Emigrazione in altro comune 7 Emigrazione all estero 8 Cancellazione per irreperibilità (anagrafica / al censimento) 9 Cancellazione per omessa dichiarazione di dimora abituale 10 Cambio di abitazione 11 Matrimonio 12 Vedovanza 13 Divorzio (cessazione / scioglimento effetti civili) 14 Annullamento matrimonio 15 Variazione di cognome e nome 16 Variazione di sesso 17 Variazione di cittadinanza 18 Variazione del permesso di soggiorno 19 Variazione di paternità / maternità 21 Rettifica 22 Popolamento residenti 23 Popolamento deceduti 24 Popolamento emigrati 25 Carta d identità 26 Variazione famiglia anagrafica 28 Stato di Senza Fissa Dimora
A1.2. Tabella Stato Civile Descrizione Tabella che associa un codice per identificare lo stato civile del cittadino. Tale codice si utilizza per popolare il campo Stato Civile del macrodato Generalità dell AP5. CODICE DESCRIZIONE 1 Celibe / Nubile 2 Coniugato / Coniugata 3 Vedovo / Vedova 4 Già coniugato / Già coniugata 5 Non conosciuto A1.3. Tabella Codici Relazione Parentela Descrizione Tabella che associa un codice alla relazione di parentela di un cittadino rispetto all intestatario della famiglia anagrafica in cui è iscritto. Tale codice si utilizza per popolare il campo Codice relazione parentela del macrodato Famiglia Anagrafica dell AP5. CODICE DESCRIZIONE 1 Intestatario Scheda 2 Marito / Moglie 3 Figlio / Figlia 4 Nipote (discendente) 5 Pronipote (discendente) 6 Padre / Madre 7 Nonno / Nonna 8 Bisnonno / Bisnonna 9 Fratello / Sorella 10 Nipote (collaterale) 11 Zio / Zia (Collaterale) 12 Cugino / Cugina 13 Altro Parente 14 Figliastro / Figliastra 15 Patrigno / Matrigna 16 Genero / Nuora 17 Suocero / Suocera 18 Cognato / Cognata 19 Fratellastro / Sorellastra 20 Nipote (Affine) 21 Zio / Zia (Affine) 22 Altro Affine 23 Convivente 24 Responsabile della convivenza non affettiva 25 Convivenza non affettiva