stema di Accesso Interscambio Anagrafico Pag. 1 di 29 Allegato Tecnico 4 - Struttura Dati Risposta AP5 1/29
stema di Accesso Interscambio Anagrafico Pag. 2 di 29 Versioni del documento versione data Modifiche principali Autore/i 3.00 Prima Stesura. 2/29
stema di Accesso Interscambio Anagrafico Pag. 3 di 29 Introduzione... 4 1 Struttura dati per le risposte a richieste contenenti comunicazioni anagrafiche. 6 1.1 Documento Accettato... 7 1.2 Documento n Accettato... 8 2 Struttura dati per le risposte a richieste di stato delle code... 9 2.1 Riferimenti... 10 2.2 Stato Documento... 11 2.3 Messaggio... 12 3 Struttura dati per le risposte a richieste di presa in carico... 13 3.1 Riferimenti... 15 3.2 Esito... 16 3.3 Esito AE... 17 3.4 Messaggio... 18 4 Struttura dati per le risposte alle consultazioni... 19 4.1 Riferimenti per le consultazioni di INA... 20 4.2 Riferimenti per le consultazioni di Agenzia delle Entrate... 20 5 Struttura dati per le risposte con errore... 21 5.1 Errore... 21 A1 Struttura dei dati base... 22 A1.1 Causale... 23 A1.2 Codice Fiscale... 23 A1.3 Comune... 24 A1.4 Ente... 24 A1.5 Generalita... 25 A1.6 Località... 25 A1.7 Luogo... 26 A1.8 Messaggio... 27 A2 Tabelle di decodifica... 28 A2.1 Tabella Causali... 28 A3 Messaggi di SAIA... 29 3/29
stema di Accesso Interscambio Anagrafico Pag. 4 di 29 INTRODUZIONE In questo allegato si descrive la struttura dati di risposta per il flusso di comunicazione tra Anagrafe Comunale e CNSD mediante il software XML-SAIA v.2. Tale struttura contiene le informazioni utilizzate per gestire le risposte alle richieste di variazioni anagrafiche, stato code, presa in carico e consultazione. Tale struttura, essendo in formato XML, è descritta in maniera esaustiva sulla base degli xsd disponibili sul sito del CNSD. Di seguito è riportata la struttura di base dell xsd di risposta. A seguire si riporta una spiegazione di dettaglio delle informazioni contenute nella struttura. Le informazioni contenute nella struttura sono tutte quelle notificate dagli Enti Centrali coinvolti nel progetto nelle modalità esposte nell Allegato Tecnico 1 - Considerazioni Architetturali. Una risposta inviata dal SAIA al comune può essere di tre tipi, in base alla richiesta ricevuta: 4/29
stema di Accesso Interscambio Anagrafico Pag. 5 di 29 Risposta a una richiesta contenente comunicazioni anagrafiche Risposta a una richiesta di stato delle code Risposta a una richiesta di presa in carico Ognuna delle risposte sopraelencate è composta da macrodati. Ogni macrodato è ulteriormente dettagliato in più livelli, in modo da avere sempre una struttura chiara e non ambigua. Nei paragrafi che seguono si descrive la struttura dei macrodati e dei campi che li compongono, oltre che la struttura dei dati da inserire come intestazione per ogni richiesta. In appendice si descrive la struttura dei dati su cui si basano le risposte. La struttura dei dati sarà descritta nel modo seguente: Il nome del paragrafo indica il tipo di risposta a cui ci si riferisce Ogni paragrafo inizia con una descrizione generale del tipo di risposta Il nome del sottoparagrafo indica il macrodato a cui ci si riferisce Ogni sottoparagrafo inizia con una descrizione generale del macrodato In seguito alla descrizione vi è una tabella contenente le seguenti informazioni: - Dato: contiene il nome del dato in questione. - me del dato in AP5: contiene il nome con cui è definito nell AP5 il dato in questione. - Formato: il formato da rispettare nel popolare l informazione in questione. - te: ulteriori informazioni sul formato dell informazione o sull informazione in generale. - Descrizione: breve descrizione del contenuto del dato. - Obbligatorio: indica se il dato in questione è obbligatorio per ogni comunicazione anagrafica che si invia al SAIA. L ordine seguito nella presentazione dei macrodati coincide con l ordine in cui sono inseriti tali macrodati nelle risposte. 5/29
stema di Accesso Interscambio Anagrafico Pag. 6 di 29 1 STRUTTURA DATI PER LE RISPOSTE A RICHIESTE CONTENENTI COMUNICAZIONI ANAGRAFICHE Descrizione Tale struttura contiene i dati che il SAIA invia a un comune in seguito a una richiesta di invio di una comunicazione anagrafica. La struttura è composta dall insieme di risposte alle comunicazioni anagrafiche ricevute, ognuna delle quali può contenere un documento accettato o un documento non accettato dal SAIA. Nei seguenti sottoparagrafi si descrivono i macrodati di cui sono costituiti i documenti accettati e i documenti non accettati. 6/29
stema di Accesso Interscambio Anagrafico Pag. 7 di 29 1.1 Documento Accettato Descrizione - Contiene informazioni relative alla risposta ad una comunicazione anagrafica accettata dal SAIA. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Data e Ora di Accettazione dataoraaccettazione DateTime YYYY-MM- DDThh:mm:ss La data e l ora in cui il SAIA ha accettato la comunicazione anagrafica La causale della Causale causale Causale Vedi Appendice A1.1 comunicazione anagrafica Protocollo Anagrafe protocolloanagrafe Char (20) Il protocollo assegnato dall anagrafe comunale alla comunicazione anagrafica Protocollo della Comunicazione Anagrafica Generalità del cittadino protocollocomunicazioneanagrafica Char (20) generalitacittadino Destinatario destinatario Char (Max 4) Generalita (Vedi Appendice A1.5) Può essere presente più di un destinatario Messaggio messaggio Messaggio (Vedi Appendice A1.8 e Appendice A3). Popolato con un messaggio avente codice: MSG_AP_002. Nel caso di ripetizione di invio per la quale non sono ancora stati presi in carico gli esiti viene restituito un messaggio avente codice MSG_AP_001. Il protocollo assegnato dal SAIA alla comunicazione anagrafica Le generalità del cittadino soggetto della comunicazione anagrafica L ente o il comune destinatario della comunicazione anagrafica Messaggio allegato dal SAIA all accettazione della comunicazione anagrafica 7/29
stema di Accesso Interscambio Anagrafico Pag. 8 di 29 1.2 Documento n Accettato Descrizione - Contiene informazioni relative alla risposta ad una comunicazione anagrafica non accettata dal SAIA. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Data e Ora di Accettazione dataoraaccettazione DateTime YYYY-MM- DDThh:mm:ss La data e l ora in cui il SAIA ha ricevuto la comunicazione anagrafica La causale della Causale causale Causale Vedi Appendice A1.1 comunicazione anagrafica Protocollo Anagrafe protocolloanagrafe Char (20) Il protocollo assegnato dall anagrafe comunale alla comunicazione anagrafica Protocollo della Comunicazione Anagrafica Generalità del cittadino protocollocomunicazioneanagrafica Char (20) generalitacittadino Generalita (Vedi Appendice A1.5) Messaggio messaggio Messaggio (Vedi Appendice A1.8 e Appendice A3). Popolato con un messaggio avente codice: MSG_VE_XXX oppure MSG_AP_001 oppure MSG_AP_003 Il protocollo assegnato dal SAIA alla comunicazione anagrafica Le generalità del cittadino soggetto della comunicazione anagrafica Messaggio allegato dal SAIA alla non accettazione della comunicazione anagarfica, contenente il motivo per cui la comunicazione anagrafica non è stata accettata 8/29
stema di Accesso Interscambio Anagrafico Pag. 9 di 29 2 STRUTTURA DATI PER LE RISPOSTE A RICHIESTE DI STATO DELLE CODE Descrizione Tale struttura contiene i dati che il SAIA invia a un comune in seguito a una richiesta di stato delle code. La struttura è composta dall insieme di documenti presenti in coda, ovvero l insieme dei documenti che il SAIA sta elaborando. Nei seguenti sottoparagrafi si descrivono i macrodati di cui un documento presente nelle code è costituito. 9/29
stema di Accesso Interscambio Anagrafico Pag. 10 di 29 2.1 Riferimenti Descrizione - Contiene informazioni relative alla comunicazione anagrafica di cui il documento in questione costituisce la risposta. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Protocollo Anagrafe protocolloanagrafe Char (20) Il protocollo assegnato dall anagrafe comunale alla comunicazione anagrafica Protocolo della Comunicazione Anagrafica Data di Accettazione Data di Decorrenza della Comunicazione protocollocomunicazioneanagrafica Char (20) Il protocollo assegnato dal SAIA alla comunicazione anagrafica in fase di accettazione della stessa dataaccettazione Date YYYY-MM- DD datadecorrenzacomunicazione Date YYYY-MM- DD Causale Causale Causale (Vedi Appendice A1.1) Generalità del Cittadino generalitacittadino Generalita (Vedi Appendice A1.5) La data in cui è stata accettata la comunicazione anagrafica La data a partire dalla quale ha decorrenza la comunicazione anagrafica a cui il documento in questione si riferisce La causale della comunicazione anagrafica a cui il documento in questione si riferisce Le generalità del cittadino soggetto della comunicazione anagrafica a cui il documento in questione si riferisce 10/29
stema di Accesso Interscambio Anagrafico Pag. 11 di 29 2.2 Stato Documento Descrizione - Contiene informazioni relative allo stato del documento. Un documento può trovarsi in più stati, ognuno relativo ad una coda differente. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Codice istat del comune destinatario Codice dell Ente destinatario Tipo Documento codiceistatcomunedestinatario Char (6) codiceentedestinatario Char (Max 4) Almeno uno tra codiceistatcomunedestinatario e codiceentedestinatario è presente. Almeno uno tra codiceistatcomunedestinatario e codiceentedestinatario è presente. tipodocumento Char (4) Può assumere il seguente valore: ENTE Stato stato Char (1) Può assumere uno dei seguenti valori: A: documento accettato I : Documento inoltrato C: Documento completato R: Documento con risposta Il codice istat del comune destinatario. Popolato quando il destinatario della comunicazione anagrafica è un altro comune Il codice dell ente destinatario. Popolato quando il destinatario della comunicazione anagrafica è un ente Il tipo di documento presente in coda Lo stato in cui si trova il documento Data di Inoltro datainoltro Date YYYY-MM-DD La data in cui il documento è stato inoltrato all ente Protocollo di Inoltro Data di Accettazione della Risposta protocolloinoltro Char (20) Il protocollo assegnato al documento quando è stato inoltrato all ente dataaccettazionerisposta Date YYYY-MM-DD La data in cui il comune ha preso in carico il documento Messaggio messaggio Messaggio Vedi Appendice A1.8 Messaggio allegato alla risposta 11/29
stema di Accesso Interscambio Anagrafico Pag. 12 di 29 2.3 Messaggio Descrizione Messaggio allegato dal SAIA alle informazioni sullo stato del documento. Dato me del dato in AP5 Messaggio messaggio Messaggio Vedi Appendice A1.8 Formato te Descrizione Obbligatorio Messaggio che il SAIA ha ricevuto dall ente destinatario del documento, contenente ulteriori informazioni sullo stato del documento. 12/29
stema di Accesso Interscambio Anagrafico Pag. 13 di 29 3 STRUTTURA DATI PER LE RISPOSTE A RICHIESTE DI PRESA IN CARICO Descrizione Tale struttura contiene i dati che il SAIA invia a un comune in seguito a una richiesta di presa in carico. La struttura è composta dall insieme di documenti che è possibile prendere in carico, ovvero l insieme dei documenti per cui il SAIA ha ottenuto una risposta da almeno uno degli enti interessati. Nei seguenti sottoparagrafi si descrivono i macrodati di cui un documento da prendere in carico è costituito. 13/29
stema di Accesso Interscambio Anagrafico Pag. 14 di 29 Figura 2.3-1 - Presa in Carico 14/29
stema di Accesso Interscambio Anagrafico Pag. 15 di 29 3.1 Riferimenti Descrizione - Contiene informazioni relative alla comunicazione anagrafica di cui il documento in questione costituisce la risposta. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Protocollo Anagrafe protocolloanagrafe Char (20) Il protocollo assegnato dall anagrafe comunale alla comunicazione anagrafica Protocolo della Comunicazione Anagrafica Data di Accettazione Data di Decorrenza della Comunicazione protocollocomunicazioneanagrafica Char (20) Il protocollo assegnato dal SAIA alla comunicazione anagrafica in fase di accettazione della stessa dataaccettazione Date YYYY-MM- DD datadecorrenzacomunicazione Date YYYY-MM- DD Causale Causale Causale (Vedi Appendice A1.1) Generalità del Cittadino generalitacittadino Generalita (Vedi Appendice A1.5) La data in cui è stata accettata la comunicazione anagrafica La data a partire dalla quale ha decorrenza la comunicazione anagrafica a cui il documento in questione si riferisce La causale della comunicazione anagrafica a cui il documento in questione si riferisce Le generalità del cittadino soggetto della comunicazione anagrafica a cui il documento in questione si riferisce 15/29
stema di Accesso Interscambio Anagrafico Pag. 16 di 29 3.2 Esito Descrizione - Contiene informazioni relative all esito ottenuto da un ente destinatario della comunicazione anagrafica a cui il documento si riferisce. In questo macrodato non sono compresi gli esiti ottenuti dall Agenzia delle Entrate (AE). Per un documento è possibile avere più esiti, ognuno ottenuto da un diverso ente. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Codice istat del comune destinatario Codice dell Ente destinatario codiceistatcomunedestinatario Char (6) codiceentedestinatario Char (Max 4) Almeno uno tra codiceistatcomunedestinatario e codiceentedestinatario è presente. Almeno uno tra codiceistatcomunedestinatario e codiceentedestinatario è presente. Il codice istat del comune destinatario. Popolato quando il destinatario della comunicazione anagrafica è un altro comune Il codice dell ente destinatario. Popolato quando il destinatario della comunicazione anagrafica è un ente Data di inoltro datainoltro Date YYYY-MM-DD La data in cui il documento è stato inoltrato all ente Data e ora di presa visione dell esito dataorapresavisioneesito DateTime YYYY-MM-DDThh:mm:ss La data e l ora in cui il comune prende in carico il documento Messaggio messaggio Messaggio Vedi Appendice A1.8 Messaggio allegato all esito te note Char È possibile ottenere più di una te allegate (Max 1024) nota all esito Protocollo della risposta protocollorisposta Char (20) Protocollo assegnato al documento di risposta. 16/29
stema di Accesso Interscambio Anagrafico Pag. 17 di 29 3.3 Esito AE Descrizione - Contiene informazioni relative all esito ottenuto dall Agenzia delle Entrate per la comunicazione anagrafica a cui il documento si riferisce. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Codice istat del comune destinatario Codice dell Ente destinatario Data di inoltro Data e ora di presa visione dell esito Codice Fiscale Attribuito codiceistatcomunedestinatario Char (6) codiceentedestinatario Char (Max 4) Almeno uno tra codiceistatcomunedestinatario e codiceentedestinatario è presente. Almeno uno tra codiceistatcomunedestinatario e codiceentedestinatario è presente. Il codice istat del comune destinatario. Popolato quando il destinatario della comunicazione anagrafica è un altro comune Il codice dell ente destinatario. Popolato quando il destinatario della comunicazione anagrafica è un ente datainoltro Date YYYY-MM-DD La data in cui il documento è stato inoltrato all ente dataorapresavisioneesito DateTime YYYY-MM-DDThh:mm:ss La data e l ora in cui il comune prende in carico il documento codicefiscaleattribuito CodiceFiscale Vedi Appendice Il codice fiscale attribuito dall Agenzia delle Entrate al cittadino soggetto della comunicazione anagrafia Messaggio messaggio Messaggio Vedi Appendice A1.8 Messaggio allegato dall ente all esito te note Char È possibile ottenere più di una te allegate (Max 1024) nota all esito Protocollo della risposta protocollorisposta Char (20) Protocollo assegnato al documento di risposta. 17/29
stema di Accesso Interscambio Anagrafico Pag. 18 di 29 3.4 Messaggio Descrizione Messaggio allegato dal SAIA quando il comune prende in carico il documento. Dato me del dato in AP5 Messaggio messaggio Messaggio Vedi Appendice A1.8 Formato te Descrizione Obbligatorio Messaggio che il SAIA ha ricevuto dall ente destinatario del documento 18/29
stema di Accesso Interscambio Anagrafico Pag. 19 di 29 4 STRUTTURA DATI PER LE RISPOSTE ALLE CONSULTAZIONI Descrizione Tale struttura contiene i dati che il SAIA invia a un comune in seguito a una consultazione. La struttura è composta dalle informazioni comuni alla ricerca in INA e Agenzia delle Entrate e a due sottopatri specifiche dei due tipi di consultazione. Nei seguenti sottoparagrafi si descrivono i macrodati di cui il documento è costituito. 19/29
stema di Accesso Interscambio Anagrafico Pag. 20 di 29 4.1 Riferimenti per le consultazioni di INA Descrizione - Contiene informazioni relative alla comunicazione anagrafica di cui il documento in questione costituisce la risposta. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Generalità del Cittadino generalitacittadino Generalita (Vedi Appendice A1.5) Le generalità del cittadino soggetto della comunicazione anagrafica a cui il documento in questione si riferisce Data caricamento datacaricamento Date YYYY-MM-DD La data in cui è stata inserita la persona in INA Data ultimo dataultimoaggiornamento Date YYYY-MM-DD La data di ultima modifica aggiornamento dei dati in INA Comune residenza comuneresidenza Comune (Vedi Appendice Dati del comune di A1.3) residenza Data decesso datadecesso Date YYYY-MM-DD La data di decesso della persona In esame inesame Char(1) Validati dati anagrafici Validato Codice fiscale validatidatianagrafici Char(1) validatocf Char(1) 4.2 Riferimenti per le consultazioni di Agenzia delle Entrate Descrizione - Contiene informazioni relative alla comunicazione anagrafica di cui il documento in questione costituisce la risposta. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Generalità del Cittadino generalitacittadino Generalita (Vedi Appendic e A1.5) Le generalità del cittadino soggetto della comunicazione anagrafica a cui il documento in questione si riferisce Decesso decesso Decesso I dati del decesso (data e comune) Ufficio competente ufficiocompetente Ufficio Assegnazione Codice Fiscale assegnazionecodicefiscale AssegnazioneCodiceFiscale Contiene l ufficio, il comune e la data di Conferma dati anagrafci assegnazione confermadatianagrafici ConfermaDatiAnagrafici Contiene l ufficio, il comune e la data di conferma dei dati. Tessera sanitaria tesserasanitaria TesseraSanitaria Contiene i dati della tessera Storico residenze Storico residenze estere Elenco codici fiscali Elenco sinonimi persone fisiche storicoresidenze StoricoResidenze Lista di residenze storicoresidenzeestere StoricoResidenze Lista di residenze elencocodicifiscali CodiceFiscale Lista di codici fiscali elencononimipersonefisi che TipoSN Char(1) 20/29
stema di Accesso Interscambio Anagrafico Pag. 21 di 29 5 STRUTTURA DATI PER LE RISPOSTE CON ERRORE Descrizione Tale struttura contiene i dati che il SAIA invia a un comune quando si verifica un errore. 5.1 Errore Figura 4.2-1 Errore Dato me del dato in AP5 Tipo di errore tipo Char (Max 20) Codice di errore codice Char (Max 10) Testo messaggio Char (Max 1024) Formato te Descrizione Obbligatorio Vedi appendice A3. Può essere popolato con uno dei seguenti valori: 1. PARSING 2. COMMUNICATION 3. VALIDATION Vedi appendice A3. Può essere popolato con uno dei seguenti valori: 1. MSG_PE_XXX 2. MSG_CE_XXX 3. MSG_VE_XXX Vedi appendice A3. Tipo di errore Codice di errore Testo del messaggio di errore. Data e Ora dataora DateTime YYYY-MM-DDThh:mm:ss Data e Ora in cui si è verificato l errore 21/29
stema di Accesso Interscambio Anagrafico Pag. 22 di 29 A1 STRUTTURA DEI DATI BASE La struttura dei dati basilari sarà descritta nel modo seguente: Il nome della sezione indica il dato base a cui ci si riferisce. In ogni sezione vi è una tabella contenente le seguenti informazioni: - Dato: contiene il nome con cui è definito nell AP5 il dato in questione. - Dettaglio: contiene il nome con cui sono definiti nell AP5 i campi dai quali il dato è formato. - Ulteriore Dettaglio: contiene il nome con cui sono definiti nell AP5 i sottocampi per ogni campo. - Dettagli: contiene i dettagli dei sottocampi. - Formato: il formato da rispettare nel popolare l innformazione in questione. - te: ulteriori informazioni sul formato dell informazione o sull informazione in generale. - Descrizione: breve descrizione del contenuto del dato. - Obbligatorio: indica se il dato in questione è obbligatorio per ogni comunicazione anagrafica che si invia al SAIA. Per i dati più dettagliati, in seguito alla tabella si può trovare un immagine che contribuisce a chiarire la struttura del dato. L immagine ha una struttura detta ad albero ed è stata costruita seguendo le seguenti convenzioni: - Alla radice dell albero (estrema sinistra dell immagine) si trova il dato principale. - Procedendo verso destra si entra più in dettaglio nel dato. - Alle foglie dell albero (estrema destra dell immagine) si trova il maggiore dettaglio del dato. - Gli elementi che hanno il bordo costituito da una linea continua sono obbligatori per ogni comunicazione anagrafica inoltrata al SAIA. - Gli elementi che hanno il bordo costituito da una linea tratteggiata sono facoltativi. - Con il simbolo seguente si indica che i dati che seguono devono essere ordinati esattamente come indicato nella sequenza. Figura 5.1-1 - Sequenza Ordinata - Con il simbolo seguente si indica che occorre inserire obbligatoriamente solo uno tra gli elementi che seguono. Figura 5.1-2 - Scelta di uno tra più elementi L ordine seguito nella presentazione dei tipi base dell AP5 è quello alfabetico. 22/29
stema di Accesso Interscambio Anagrafico Pag. 23 di 29 A1.1 Causale Descrizione - Contiene informazioni relative alla causale della comunicazione anagrafica. È obbligatorio per ogni comunicazione anagrafica inoltrata al SAIA. Dato me del dato in AP5 Formato te Descrizione Obbligatorio Tipo Comunicazione tipocomunicazione Motivo Comunicazione motivocomunicazione Char (Max 15) Char (Max 2) Può assumere solo i seguenti valori: variazione, annullamento Vedi tabella Causali (Appendice A2.1) Enti Destinatari entidestinatari Ente Può essere presente più di un ente. È obbligatorio inserire almeno un ente, se è presente l elemento Enti Destinatari. (Vedi Appendice A1.4) Protocollo Comunicazione Anagrafica Esempio: protocollocomunicazioneanagrafica Char(20) Da popolare solo in caso di annullamento Definisce se si tratta di una comunicazione di variazione o di un annullamento di una precedente comunicazione anagrafica Il motivo della comunicazione anagrafica (Nascita, Cambio Abitazione, ecc.) Gli enti a cui inviare la comunicazione anagrafica. Fanno parte di questo elenco solo gli enti facoltativi di destinazione. n fanno parte di questo elenco gli enti a cui la comunicazione è inviata da SAIA in ogni caso (es. non occorre specificare che una comunicazione di nascita ha come ente destinatario l agenzia delle entrate) Il protocollo assegnato da SAIA alla comunicazione anagrafica che si sta cercando di annullare. <causale> <tipocomunicazione>variazione</tipocomunicazione> <motivocomunicazione>1</motivocomunicazione> <entidestinatari> <ente>nomeente</ente> </entidestinatari> </causale> A1.2 Codice Fiscale Dato Dettaglio Ulteriore Dettaglio Dettagli Formato te Descrizione Obbligatorio codicefiscale Char (16) Sono ammessi solo i caratteri alfabetici in maiuscolo (A-Z) e i caratteri numerici (0-9) Il codice fiscale del cittadino 23/29
stema di Accesso Interscambio Anagrafico Pag. 24 di 29 A1.3 Comune Dato Dettaglio Ulteriore Dettaglio comune Dettagli Formato te Descrizione Obbligatorio Contiene le informazioni che occorrono per individuare un comune. nomecomune Char (max 80) Il nome del comune codicecomuneistat Char (6) Sono ammessi solo i caratteri numerici (0-9) Il codice ISTAT del comune siglaprovinciaistat Char (2) La sigla della provincia in cui si trova il comune Esempio: <comune> <nomecomune>roma</nomecomune> <codicecomuneistat>091091</codicecomuneistat> <siglaprovinciaistat>rm</siglaprovinciaistat> </comune> A1.4 Ente Dato Dettaglio Ulteriore Dettaglio ente Dettagli Formato te Descrizione Obbligatorio Char (Max 10) Contiene l identificativo di un ente. 24/29
stema di Accesso Interscambio Anagrafico Pag. 25 di 29 A1.5 Generalita Dato Dettaglio Ulteriore Dettaglio codicefiscale Dettagli Formato te Descrizione Obbligatorio Codice Fiscale Vedi Appendice A1.2 cognome Char (Max 80) nome Char (Max 80) luogonascita Luogo Vedi Appendice 1.7 Il codice fiscale del cittadino Il cognome del cittadino Il nome del cittadino Il luogo di nascita del cittadino La data di nascita del cittadino datanascita Date YYYY-MM- DD sesso Char (1) M F m f Il sesso del cittadino A1.6 Località Dato Dettaglio Ulteriore Dettaglio localita descrizionelocalita descrizionestato Dettagli Formato te Descrizione Obbligatorio Char (Max 80) Char (Max 80) codicestato Char (3) ISO3 166 code3 Contiene le informazioni relative ad una località non italiana. Descrizione della località Descrizione dello Stato a cui la località appartiene Il Codice dello Stato a cui la località appartiene 25/29
stema di Accesso Interscambio Anagrafico Pag. 26 di 29 A1.7 Luogo Dato Dettaglio Ulteriore Dettaglio luogo luogoeccezionale Dettagli Formato te Descrizione Obbligatorio Char (Max 120) comune Comune Uno tra i campi Comune e Località è obbligatorio e non si possono popolare entrambi i campi. Vedi Appendice A1.3 localita Località Vedi Appendice A1.6 Contiene le informazioni relative a un luogo Indica se si tratta di un luogo eccezionale, non identificabile solo con un comune o una località (es: su una nave, in aereo, ecc.) Il comune italiano a cui il luogo si riferisce. La località non italiana a cui il luogo si riferisce Figura 5.1-3 Luogo 26/29
stema di Accesso Interscambio Anagrafico Pag. 27 di 29 A1.8 Messaggio Dato Dettaglio Ulteriore Dettaglio Dettagli Formato te Descrizione Obbligatorio tipo Char Tipo di codice (Max 20) messaggio Char Codice del testo (Max 10) messaggio Char Testo del messaggio. 27/29
stema di Accesso Interscambio Anagrafico Pag. 28 di 29 A2 TABELLE DI DECODIFICA In questa appendice si presentano delle tabelle da utilizzare per popolare alcuni campi descritti precedentemente. A2.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 28/29
stema di Accesso Interscambio Anagrafico Pag. 29 di 29 A3 MESSAGGI DI SAIA In questa appendice si descrivono i messaggi inviati da SAIA. TIPO CODICE TESTO NOTE DESCRIZIONE VALIDATION MSG_VE_001 Errore di validazione xml Al testo viene concatenata la causa che ha generato l errore di validazione xml APPLICATION MSG_AP_001 Documento già inserito nel sistema Tale messaggio può essere restituito sia per una risposta di accettazione che per il rifiuto di una comunicazione, in entrambi i casi viene restituito il protocollo e la data della comunicazione precedentemente avvenuta. L esito sarà legato ad una accettazione se le risposte da parte degli enti non sono ancora state restituite al comune, viceversa il sistema restituirà una risposta di tipo Documento non Accettato Errore durante la validazione del file xml di input. Viene generato quando, nel popolare il file xml di input, non si segue la struttura dei dati di richiesta descritta nell Allegato Tecnico 2 o non si rispettano le regole di validazione applicativa descritte nell Allegato Tecnico 3. Errore applicativo generato quando si cerca di effettuare una comunicazione anagrafica già inviata in precedenza al SAIA. APPLICATION MSG_AP_002 Documento accettato Messaggio applicativo generato quando una comunicazione anagrafica viene accettata dal SAIA APPLICATION MSG_AP_003 Errore durante l'elaborazione del Messaggio applicativo documento generato quando si ha un errore durante l elaborazione di un documento PARSING MSG_PE_001 Errore durante il parsing del file xml di richiesta Errore durante la lettura del file xml di input: il file non è coerente con la struttura dati descritta nell Allegato Tecnico 2. PARSING MSG_PE_002 Il file di input non contiene richieste COMMUNICATION MSG_CE_001 Nessuna risposta è stata ricevuta dal server SAIA Errore durante la lettura del file xml di input: si sta cercando di inviare un file che non contiene richieste. Errore durante la comunicazione client-server: l applicazione comunale non riceve alcuna risposta dal server SAIA. COMMUNICATION MSG_CE_002 Errore di comunicazione Errore durante la comunicazione client-server: l applicazione comunale non riesce a comunicare con il server SAIA 29/29