.. _C020-acc-residenza-mas:

Servizio di accertamento residenza (C020)
========================================================================================================================

Tracciato di input
------------------------------------------------------------------------------------------------------------------------

Il formato di input è **uguale per tutti i tipi di accertamento**.

.. list-table::
   :widths: 5 25 35 35
   :align: left

   * - 1
     - idANPR
     - Identificativo ANPR del cittadino (se disponibile)
     - Obbligatorio solo se non disponibile il codFiscale
   * - 2
     - codFiscale
     - Codice fiscale del cittadino
     - Obbligatorio solo se non disponibile il idANPR
   * - 3
     - dataRiferimentoRichiesta
     - Data di riferimento della verifica, formato DD/MM/YYYY (in alternativa YYYY/MM/DD, YYYY-MM-DD, DD-MM-YYYY)
     - Obbligatorio

Output
------------------------------------------------------------------------------------------------------------------------

.. list-table::
   :header-rows: 1
   :widths: 5 35 60

   * - No
     - Nome colonna
     - Descrizione
   * - 1
     - nome
     - Nome anagrafico del soggetto.
   * - 2
     - cognome
     - Cognome anagrafico del soggetto.
   * - 3
     - dataNascita
     - Data di nascita del soggetto in formato ISO 8601 formato DD/MM/YYYY (in alternativa YYYY/MM/DD, YYYY-MM-DD, DD-MM-YYYY)
   * - 4
     - dataDecesso
     - Data di decesso del soggetto, se presente formato DD/MM/YYYY (in alternativa YYYY/MM/DD, YYYY-MM-DD, DD-MM-YYYY)
   * - 5
     - capResidenza
     - Codice di Avviamento Postale (CAP) dell'indirizzo di residenza.
   * - 6
     - comuneResidenza
     - Denominazione del comune di residenza.
   * - 7
     - codiceIstatResidenza
     - Codice ISTAT a 6 cifre del comune di residenza.
   * - 8
     - provinciaResidenza
     - Sigla della provincia di residenza (2 caratteri).
   * - 9
     - specie
     - Tipologia di soggetto (es. “FIS” per persona fisica, “GIU” per persona giuridica).
   * - 10
     - denominazioneToponimo
     - Denominazione del toponimo (es. via, viale, piazza, ecc.) dell’indirizzo di residenza.
   * - 11
     - numeroCivico
     - Numero civico dell’indirizzo di residenza.
   * - 12
     - letteraNumeroCivico
     - Lettera associata al numero civico (es. 12A).
   * - 13
     - dataDecorrenzaResidenza
     - Data di decorrenza della residenza formato DD/MM/YYYY (in alternativa YYYY/MM/DD, YYYY-MM-DD, DD-MM-YYYY)

I campi seguenti ci saranno solo il cittadino è un soggetto AIRE

.. list-table::
   :header-rows: 1
   :widths: 5 35 60

   * - No
     - Nome colonna
     - Descrizione
   * - 14
     - soggettoAIRE
     - Flag booleano che indica se il soggetto è iscritto all’AIRE (Anagrafe Italiani Residenti all’Estero).
   * - 15
     - annoEspatrio
     - Anno in cui il soggetto ha effettuato l’espatrio dall’Italia.
   * - 16
     - tipoIndirizzo
     - Tipologia dell’indirizzo estero (es. RESIDENZA, DOMICILIO).
   * - 17
     - descrizioneStatoEstero
     - Denominazione dello stato estero di residenza.
   * - 18
     - codiceStatoEstero
     - Codice ISTAT dello stato estero di residenza.
   * - 19
     - descrizioneLocalitaEstera
     - Nome della località estera (es. città, distretto) di residenza.
   * - 20
     - codiceConsolato
     - Codice identificativo del consolato italiano di riferimento.
   * - 21
     - descrizioneConsolato
     - Denominazione del consolato italiano competente per la località di residenza.

I campi seguenti ci saranno solo il cittadino è un soggetto deceduto

.. list-table::
   :header-rows: 1
   :widths: 5 35 60

   * - No
     - Nome colonna
     - Descrizione
   * - 21
     - dataDecesso
     - Eventuale data di decesso dell'individuo formato DD/MM/YYYY (in alternativa YYYY/MM/DD, YYYY-MM-DD, DD-MM-YYYY)

.. note::

   - I campi relativi al soggetto collegato sono valorizzati solo in caso di esito positivo e disponibilità del dato in ANPR.
   - Durante l’elaborazione massiva restituisce **soltanto la prima cittadinanza** associata a ciascun soggetto. Attenzione: alcuni utenti possono essere titolari di più cittadinanze, ma le eventuali ulteriori non verranno incluse nell’output.

.. warning::

   I file CSV da caricare devono avere la **virgola** come separatore.