Appendice B¶
Insieme dei valori consentiti per i campi "chiusi" di una richiesta
Tipi richiesta ¶
| ID_TIPO_RICHIESTA | Descrizione |
|---|---|
| 1 | Report completo |
| 3 | Report plus |
| 4 | Report Mutuo |
| 5 | Verifica identità |
| 6 | Posizione contributiva |
| 10 | Certificato |
| 14 | Approfondimento |
| ~~18~~ | ~~Analisi Datore~~ |
| 27 | Report TFS |
| 25 | Verifica identità PLUS |
| 20 | Report KYC |
| 24 | Report KYB |
Nazionalità ¶
| ID_NAZIONALITA | Descrizione |
|---|---|
| I | Italiana |
| E | Comunitaria UE |
| S | Extra comunitaria |
Info
Se ID_NAZIONALITA = "E" possono essere compilati i campi facoltativi relativi al permesso di soggiorno oppure possono essere lasciati vuoti impostando il campo booleano FORZA_DOCUMENTO_PERM_SOG a TRUE.
Se ID_NAZIONALITA = "S" i campi relativi al permesso di soggiorno sono obbligatori.
Tipi di Finanziamento ¶
| TIPOLOGIA_FINANZIAMENTO | Descrizione |
|---|---|
| C | Cqs/Deleghe |
| F | Finalizzato |
| P | Prestito Personale |
| M | Mutui |
| T | Cessione del TFS |
Tipi di documento ¶
| ID_DOCUMENTO | Descrizione |
|---|---|
| 1 | Carta d'Identità cartacea |
| 2 | Carta d'Identità elettronica prec. 2016 |
| 3 | Patente cartacea |
| 4 | Patente plastificata |
| 5 | Passaporto |
| 9 | Altro |
| 10 | Carta d'Identità elettronica succ. 2016 |
Info
Certi documenti necessitano di dati specifici e seguono delle regole dettagliate qui sotto.
Indirizzo¶
Se l’indirizzo di residenza del cliente è diverso da quello indicato nel documento di identità va impostato a TRUE il campo booleano FLAG_REAL e vanno compilati obbligatoriamente i campi INDIRIZZO_RESIDENZA_REAL (indirizzo di residenza del cliente), CITTA_RESIDENZA_REAL (città di residenza del cliente) e PROVINCIA_RESIDENZA_REAL (provincia di residenza del cliente).
Numero poligrafico¶
Se l’indirizzo di residenza del cliente è diverso da quello indicato nel documento di identità va impostato a TRUE il campo booleano FLAG_REAL e vanno compilati obbligatoriamente i campi INDIRIZZO_RESIDENZA_REAL (indirizzo di residenza del cliente), CITTA_RESIDENZA_REAL (città di residenza del cliente) e PROVINCIA_RESIDENZA_REAL (provincia di residenza del cliente).

NUMERO_PROGRESSIVO_POLIGRAFICO per ID_DOCUMENTO = 4 (patente plastificata)

NUMERO_PROGRESSIVO_POLIGRAFICO per ID_DOCUMENTO = 3 (patente cartacea)
Codice ICAO¶
Se ID_DOCUMENTO = 2 (carta d'identità elettronica) o ID_DOCUMENTO = 10 (carta d’identità elettronica 2016) va concatenato l’ultimo carattere della prima riga insieme alla seconda riga per intero nel campo CODICE_ICAO come mostrato in figura (nell’esempio "CODICE_ICAO" = "001234567891234ITA"):

Se ID_DOCUMENTO = 5 (passaporto) va indicato opzionalmente il codice ICAO nel campo `CODICE_ICAO` dal 10° al 29° carattere come mostrato in figura:

Numero della tessera sanitaria¶
Il "numero di documento" della TESS_SANITARIA si può inserire in una delle due modalità:
- vuoto
- ultime 3 cifre fino a tutte le cifre del numero della tessera sanitaria

TESS_SANITARIA = vuoto oppure ultime 3 cifre fino a tutte le cifre del numero della tessera sanitaria
Tipi di contratto ¶
| TIPO_CONTRATTO | Descrizione |
|---|---|
| P | Pensionato |
| D | Dipendente |
| S | Senza Reddito |
| A | Lavoratore Autonomo |
| T | Lavoratore Atipico |
| L | Altro |
Le regole da seguire sono le seguenti.
Se TIPO_CONTRATTO è L (altro) oppure A (Lavoratore Autonomo) oppure T (lavoratore atipico): va indicata obbligatoriamente la tipologia di contratto nel campo di testo libero DESCRIZIONE_ALTRO_TIPO_CONTRATTO.
Se TIPO_CONTRATTO = "P" (pensionato):
- Per tutti i pensionati i campi
RAGIONE_SOCIALE_ATC,PROVINCIA_SEDE_ATC,CITTA_SEDE_ATCeINDIRIZZO_SEDE_ATCse inseriti saranno ignorati ovvero non salvati quindi non verificati dagli operatori. - Se viene inserito l’importo della quota cedibile nel campo
QUOTA_CEDIBILE_IMPORTO, va indicato obbligatoriamente il codice progressivo della quota nel campoQUOTA_CEDIBILE_PROGRESSIVOe viceversa, ovvero, se viene indicata laQUOTA_CEDIBILE_PROGRESSIVOoccorre valorizzare anche il campoQUOTA_CEDIBILE_IMPORTO(se una delle due informazioni non viene riportata correttamente il controllo avrà esito negativo). I campi relativi al datore di lavoro (*_ATCeFORZA_SENZA_CODICE_FISCALE_AMM) , anche se valorizzati, saranno ignorati durante i controlli.
Se TIPO_CONTRATTO = "P" (pensionato) e CATEGORIA_RICHIESTA = "ALT" (altro): oltre alle condizioni valide per TIPO_CONTRATTO = "P" va indicata anche la descrizione dell’ente previdenziale nel campo libero PENSIONATO_ALTRO_EP.
Se TIPO_CONTRATTO = "D" (dipendente) vanno indicati obbligatoriamente: la ragione sociale del datore di lavoro nel campo RAGIONE_SOCIALE_ATC, la provincia della sede di lavoro nel campo PROVINCIA_SEDE_ATC, il comune nel campo CITTA_SEDE_ATC, l’indirizzo nel campo INDIRIZZO_SEDE_ATC.
Se TIPO_CONTRATTO = "D" (dipendente) e CATEGORIA_RICHIESTA = "PRI" (privata): va indicato obbligatoriamente il codice fiscale del datore di lavoro nel campo CODICE_FISCALE_ATC o, in alternativa quest’ultimo puo’ essere lasciato vuoto e va inserito TRUE nel campo booleano FORZA_SENZA_CODICE_FISCALE_AMM.
Tipi di persona correlata ¶
| TIPO_PERSONA_CORRELATA | Descrizione |
|---|---|
| T | Tutore |
| A | Altro |
| G | Garante |
Tipi di Permesso di soggiorno ¶
| Tipi di Permesso di soggiorno | Descrizione |
|---|---|
| 6 | Permesso di soggiorno cartaceo |
| 7 | Permesso di soggiorno elettronico |
Enti rilascio documenti ¶
| RILASCIATO_DA | SE `ID_DOCUMENTO` = |
|---|---|
| Comune | 1 |
| Comune | 2 |
| Motorizzazione Civile | 3 |
| Motorizzazione Civile | 4 |
| Questura | 5 |
| Questura | 6 |
| Questura | 7 |
| Prefettura | 3 |
| Comune | 10 |
Enti rilascio del permesso di soggiorno ¶
| ID_ENTE | RILASCIATO_DA_PERM_SOG | SE ID_DOC_PERM_SOG = |
|---|---|---|
| 4 | Questura | 6 |
| 4 | Questura | 7 |
Categorie del tipo rapporto di lavoro ¶
| CATEGORIA_RICHIESTA | Descrizione |
|---|---|
| ~~STA~~ | ~~Statale/Pubblico~~ |
| PRI | Statale/Pubblica (ex INPDAP), Privata (INPS/ Ex ENPALS) se dipendente (TIPO_CONTRATTO = "D") o INPS/Ex INPDAP/Ex ENPALS se pensionato (TIPO_CONTRATTO = "P") |
| ~~PAP~~ | ~~Privata a partecipazione pubblica~~ |
| ALT | Altro |
Stati di una richiesta ¶
| ID_STATO_RICHIESTA | Descrizione |
|---|---|
| 1 | In richiesta |
| 2 | In lavorazione |
| 3 | Evasa |
| 4 | Inevasa |
| 5 | Lavorazione interrotta per servizi esterni indisponibili |
| 6 | In attesa di documentazione corretta |
| 8 | Annullata dal richiedente |
| 12 | Lavorazione respinta |
| 13 | Da evadere |
| 14 | Sospesa per dati errati ed in attesa di correzione |
| 15 | Da approfondire |
| 17 | In attesa di accertamenti supplementari |
| 18 | Presa in carico |
| 19 | Precaricata |
| 20 | Precaricata Inevasa |
| 21 | Assegnata |
| 22 | In assegnazione |
| 23 | Controllo automatico negativo, in attesa di richiesta verifica identità |
| 24 | In fase di inserimento |
| 25 | In attesa di lavorazione |
| 26 | In attesa di INBOX |
| 27 | In attesa di INBOX (procedura avviata) |
| 28 | In attesa di firma |
| 29 | In attesa di documentazione INBOX |
Tipologie di modulistica (ID_TIPO_SELEZ_MODULISTICA) ¶
| ID_TIPO_SELEZ_MODULISTICA | Descrizione |
|---|---|
| 1 | Modulistica precompilata senza firma digitale |
| 2 | Modulistica precompilata con firma digitale |
| 3 | Allegati separati senza firma digitale |
| 4 | Allegato massivo senza firma digitale |
| 5 | Invia successivamente via email |
| 6 | Invia successivamente via email con firma digitale |
| 7 | Nessuna modulistica (INBOX) |
Allegati alle richieste Antifrode ¶
Estensioni consentite: JSON, txt, pdf, doc, jpeg
Input name di ciascun allegato:
| JSON Richiesta | <input name="JSONfile" type="file" /> |
| Codice Fiscale e documento d'identità: | <input name="cfdocFile" type="file" /> |
| Privacy firmata | <input name="privacyFile" type="file" /> |
| Delega LS e mandato del patronato | <input name="mandatopatronatoFile" type="file" /> |
| Altro file | <input name="altrofile" type="file" /> |
| Massivo | <input name="massivofile" type="file" /> |
| Permesso di soggiorno | <input name="permsogfile" type="file" /> |
| Busta paga 1 | <input name="bustapaga1file" type="file" /> |
| Busta paga 2 | <input name="bustapaga2file" type="file" /> |
| Busta paga 3 | <input name="bustapaga3file" type="file" /> |
| Certificato stipendio | <input name="certstipendiofile" type="file" /> |
| Certificato di residenza | <input name="certresidenzafile" type="file" /> |
| Elenco destinatari email | <input name="JSONemails" type="file" /> |
| Privacy con firma digitale | <input name="PrivacyDigiSignFile" type="file" /> |
| Delega con firma digitale | <input name="DelegaDigiSignFile " type="file" /> |
| Primo mandato patronato con firma digitale | <input name="MandatiPat1DigiSignFile " type="file" /> |
| Secondo mandato patronato con firma digitale | <input name="MandatiPat2DigiSignFile" type="file" /> |
Dettaglio allegati obbligatori per tutte le tipologie di richiesta (in aggiunta al JSONfile)¶
File massivo: per tutte le tipologie di richieste è consentito allegare un unico file contenente tutta la documentazione, oppure, in alternativa:
Per Verifica Identità (ID_TIPO_RICHIESTA = 5): a differenza delle altre tipologie di richiesta non necessita obbligatoriamente della Delega LS e dei mandati al patronato.
Per nuova Verifica Identità Plus (ID_TIPO_RICHIESTA = 25): a differenza delle altre tipologie di richiesta non necessita obbligatoriamente della privacy, della delega e dei mandati al patronato.
Per tutte le altre tipologie di richiesta, se non viene inserito un file massivo e la modulistica non è di tipo digitale sono obbligatori:
- Codice Fiscale e documento d'identità (cfdocFile)
- Privacy firmata (privacyFile)
- Delega LS e mandato del patronato (mandatopatronatoFile)
- Se extracomunitario per richieste di tipologia rating: Permesso di soggiorno (permSogFile)
In caso di modulistica con firma digitale:
- Codice Fiscale e documento d'identità (cfdocFile)
- Privacy firmata digitalmente (PrivacyDigiSignFile)
- Delega LS firmata digitalmente (DelegaDigiSignFile)
- Se extracomunitario per richieste di tipologia rating: Permesso di soggiorno (permSogFile)
- Primo mandato al patronato firmato digitalmente (MandatiPat1DigiSignFile)
- Secondo mandato al patronato firmato digitalmente (MandatiPat2DigiSignFile)
Tipologie di file scaricabili nei certificati (idAllegato) ¶
| idAllegato | Descrizione |
|---|---|
| 3 | Estratto contributivo |
| 4 | CU |
| 9 | OBIS M |
| 74 | Certificato digitale XML |
| 79 | Certificato digitale JSON |
| 87 | Elaborazione estratto contributivo |
| 89 | Cedolino pensione |
| 85 | Elaborazione dati (formato JSON) |