Vai al contenuto

Change Log

Per offrire un prodotto sempre al passo con le esigenze dei nostri clienti e garantire la massima sicurezza del sistema, i servizi di Security sono in continua evoluzione. Tuttavia concentriamo i nostri sforzi per garantire, ogni qual volta sia possibile, la completa retrocompatibilità con le versioni precedenti o comunque ridurre al minimo l’impatto degli aggiornamenti sui sistemi esterni che utilizzano i nostri servizi, comunicando tempestivamente e schedulando le eventuali attività che richiedono una particolare attenzione.

Per sfruttare al meglio tutte le funzionalità del sistema Security si consiglia di tenere sempre aggiornati i propri sistemi.

ChangeLog

Aggiornamento manuale Rev. 4.4.1

  • Documentazione relativa alla obbligatorietà del file permesso di soggiorno per soggetti extracomunitari nelle richieste di rating.

Aggiornamento manuale Rev. 4.3.5

  • Aggiunta esempi di JSON INBOX + documentazione api "getstatorichiesta" + download singolo certificato

Aggiornamento manuale Rev. 4.3.4

  • Aggiunta esempi di risposta output richieste report e report automatici

Aggiornamento manuale Rev. 4.3.2

  • Aggiunta documentazione API relative ai report automatici

Aggiornamento manuale Rev. 4.3.1

  • Aggiunta documentazione API di ricompilazione e riallega modulistica

Aggiornamento manuale Rev. 4.0.3 e rilascio Web API V. 4.0.4 (aggiornamento eseguito in data 16 Marzo 2023)

  • Aggiornamento web api per risoluzione bug + inclusione di nuove feature

Aggiornamento manuale Rev. 4.0.2

  • Revisione per cambio denominazione Lending -> INEO.

Aggiornamento manuale Rev. 4.0.0

  • Inclusione link di dettaglio per nuova modalità di autenticazione.

Aggiornamento manuale Rev. 3.9.13

  • Inclusione dettagli per nuovo tipo report “Verifica Identità Plus” (v. anche nuovo JSON in Appendice D).

Aggiornamento manuale Rev. 3.9.13

  • Inclusione dettagli per API POST /v2/Richiesta/AnnullaRichiesta/{idRichiestaAF}

Aggiornamento manuale Rev. 3.9.12

  • Inclusione dettagli per integrazione SIC CTC

Aggiornamento manuale Rev. 3.9.11

  • Inclusione paragrafo “Impersonificazione inserimento richieste”
  • Rimozione chiavi obsolete dalla response di v2/login

Aggiornamento manuale Rev. 3.9.10

  • Inclusione paragrafo “Utilizzo dei Codici Istat”

Aggiornamento manuale Rev. 3.9.9

  • Revisioni minori al testo del manuale (aggiornamento esempi di routes da v1 a v2)

Aggiornamento manuale Rev. 3.9.7 e Rev 3.9.8

  • Revisioni per l’autenticazione oauth2
  • Revisioni per i browser consigliati

Aggiornamento manuale Rev. 3.9.5 e Rev. 3.9.6

  • Revisioni minori al testo del manuale (accorpamenti, eliminazione di parti obsolete, etc)
  • Inserimento della documentazione sul tipo richiesta “Approfondimento documento supplementare” via Web API (ID_TIPO_RICHIESTA = 17): v. campo “ID_RICHIESTA_DI_CARICAMENTO”
    in Appendice C e JSON “Approfondimento documento supplementare” in Appendice D.

Versione 3.9.0.24370

Aggiornamento eseguito in data 29 Luglio 2020

  • Attivazione flussi modulistica firmabile digitalmente in: download modulistica (DownloadModulisticaLS e DownloadModulistica), nuovo precaricamento, completamento e nuova richiesta.
  • Controller Modulistica
  • Genera e scarica modulistica
  • Generazione e download della modulistica precompilata (in formato pdf se standard o zip se digitale) inserendo nel body della richiesta un json contenente i dati anagrafici del soggetto (v. appendice modello standard: /pages/CbNZ03YnJ0LtVSrH4XXp#h.w0qa6eobbezx o digitale /pages/CbNZ03YnJ0LtVSrH4XXp#h.ettr2qmu27lj). N.b.: i nuovi parametri presenti nei json di esempio in appendice, evidenziati di colore giallo, sono necessari per compilare sia la modulistica di tipo standard: /pages/CbNZ03YnJ0LtVSrH4XXp#h.w0qa6eobbezx che quella di tipo digitale /pages/CbNZ03YnJ0LtVSrH4XXp#h.ettr2qmu27lj. Es.: /Modulistica/CreateDownloadModulistica
  • Controller richiesta:
  • Nuova richiesta o completamento precaricata con modulistica digitale
    Es.:

    v2/Richiesta/NuovaRichiesta
    v2/Richiesta/Completamento/{idPrecaricata} * File allegati

    JSON Richiesta*

    <input name="JSONfile" type="file" />
    *Aggiungere al JSON il nuovo campo “IS_DIGITAL”: true per utilizzare la modulistica firmata digitalmente (v. aggiornamenti dei JSON in appendice di tutte le tipologie di richiesta)

    Codice Fiscale e documento d'identità:

    <input name="cfdocFile" 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" />

    Altro file

    <input name="altrofile" 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" />

    Nuova precaricata con modulistica digitale
    Es.:

    v2/Richiesta/NuovoPrecaricamento

    JSON Richiesta*

    <input name="JSONfile" type="file" />
    *Aggiungere al JSON il nuovo campo “IS_DIGITAL”: true per utilizzare la modulistica firmata digitalmente (v. aggiornamenti dei JSON in appendice di tutte le tipologie di richiesta)
    Nel caso la richiesta sia stata precaricata con il nuovo campo “IS_DIGITAL” impostato a true, la chiamata a v1/DownloadModulisticaLS/{idRichiesta} scaricherà un file zip contenenti i singoli file pdf da firmare digitalmente anziché un unico pdf massivo.

Versione 3.9.0

Aggiornamento eseguito in data 11 Giugno 2020

  • Accorpamento flag certificati: campo EC_DOPPIO non più valido, utilizzare solo ALLEGA_EC. N.b. per supporto alla retrocompatibilità il campo ”EC_DOPPIO” se inviato a “true” verrà ignorato e convertito automaticamente in ALLEGA_EC = true.
  • Introduzione campo DICHIARAZ_POSIZIONE_NP (Dichiarazione di posizione non presente) nelle richieste di tipo “Certificato”: impostandolo a true potrebbe comportare un costo aggiuntivo.

Versione 3.4.0

Aggiornamento eseguito in data 10 Ottobre 2019

  • Reso facoltativo l’inserimento del campo CODICE_ICAO nelle richieste di certificato caricate tramite web service.

Versione 3.2.0

  • Aggiunta campo “PROVINCIA_RESIDENZA” in precaricamento richiesta.

Versione 2.1.0

Aggiornamento eseguito in data 21 Giugno 2019

  • Inserimento opzionale dei campi del documento identità e della provincia residenza nelle richieste di certificato (aggiornamento previsto per Giugno 2019). N.b se viene valorizzato almeno un campo del gruppo di informazioni del documento di identità tutti i campi del gruppo diventano obbligatori. Il gruppo dei nuovi campi ammessi è composto dalle seguenti chiavi: "PROVINCIA_RESIDENZA", "ID_DOCUMENTO", "NUM_DOCUMENTO", "RILASCIATO_DA", "COMUNE_RILASCIO", "PROVINCIA_RILASCIO", "DATA_RILASCIO", "DATA_SCADENZA", "CODICE_ICAO", "NUMERO_PROGRESSIVO_POLIGRAFICO", "FORZA_DOCUMENTO".
  • Rinominato UserController in CollaboratoreController
  • Nuovo Login con OAUTH2
  • Inserimento richieste con access token OAUTH2: POST v2/NuovaRichiesta

Versione 1.9.0

  • Migliore stabilità del sistema e fix minori

Versione 1.8.4

  • Nuova tipologia di finanziamento: Cessione del TFS (solo se abilitati): TIPOLOGIA_FINANZIAMENTO = “T”
  • Gestione inserimento richieste di certificato identiche:
  • Non saranno più accettate nuove richieste di certificato identiche, inserite dal medesimo utente, per lo stesso codice fiscale e con gli stessi certificati a richiedere, se ne esiste già un’altra precedente che non sia in uno dei seguenti stati:
    • Evasa (ID_STATO_RICHIESTA = 3)
    • Inevasa (ID_STATO_RICHIESTA = 4)
    • Annullata dal richiedente (ID_STATO_RICHIESTA = 8)
    • Lavorazione respinta (ID_STATO_RICHIESTA = 12)
    • Precaricata (ID_STATO_RICHIESTA = 19)
  • Eliminazione del campo “CONTRIBUZIONE” (non più necessario, se valorizzato verrà ignorato)
  • Accorpamento categorie richiesta (campo “CATEGORIA_RICHIESTA”) in due macro-categorie (restano invariate le condizioni di contorno precedenti):
  • Statale/Pubblica (ex INPDAP), Privata (INPS/ Ex ENPALS) se dipendente o INPS/Ex INPDAP/Ex ENPALS se pensionato saranno accorpati nell’unico valore CATEGORIA_RICHIESTA = “PRI” (verranno convertiti automaticamente a “PRI” eventuali inserimenti con i valori “STA” e “PAP”)
  • oppure
  • Altro (CATEGORIA_RICHIESTA = “ALT”)

Versione 1.7.2

  • GET v1/Richiesta/GetStatoRichiestaById/{idrichiestaAF} restituisce id_stato_richiesta = 6 (in attesa di documentazione) se INVIO_DOCUMENTI_SUCCESSIVO = true e lo stato è “in richiesta”.

Versione 1.7.1

  • NuovaRichiestaDatore API per l’inserimento report Analisi Datore
    v. JSON “Analisi Datore” in Appendice D.
  • GetStatoRichiestaById: campo “DataEvasione” modificato in “DataAggiornamentoStato”; in caso di id_stato_richiesta = 1 (in richiesta) restituisce la data ora inserimento.
  • NuovaRichiesta: inserimento nuovi tipi richiesta “Approfondimento” (ID_TIPO_RICHIESTA = 14) e “Approfondimento documento supplementare”
    (ID_TIPO_RICHIESTA = 17) v. campo “ID_RICHIESTA_DI_CARICAMENTO”
    in Appendice C e JSON “Approfondimento” e “Approfondimento documento supplementare” in Appendice D.
  • /File/DownloadEsitoRichiestaAF/{idRichiestaAF} in caso di richiesta di certificato consente di scaricare un file zip contenente i pdf dei certificati richiesti in fase di inserimento.
  • Fix caching dati imprevisto
  • Bugfix e ottimizzazioni

Versione 1.7

  • Nuova chiave header RealUserMail per inoltro notifiche richieste ad un ulteriore indirizzo email

Versione 1.6.1.0

  • Aggiornamento modelli JSON precaricamento e completamento
  • Bugfix

Versione 1.5.0.6

  • Nuovo Login con OAUTH2:
  • POST v2/Login: inviare nel body il JSON contenente il proprio username e password
  • ClientId di test: clientSecretTest
  • Precaricamento richiesta:
  • POST v1/Richiesta/NuovoPrecaricamento: indicare nel file “jsonfile” i campi obbligatori. Nome, Cognome, Codice Fiscale e, FLAG_COD_FISCALE ed i seguenti campi, opzionali in fase di precaricamento, se disponibili: DATANASCITA, LUOGONASCITA, SESSO, NAZIONALITA, INDIRIZZO_RESIDENZA, NUMERO_CIVICO_RESIDENZA, CAP_RESIDENZA (v. JSONfile “Precaricamento” in Appendice D e paragrafo “Allegati alle richieste Antifrode” in Appendice B). N.b Il NUMERO_CIVICO_RESIDENZA se valorizzato verrà concatenato nell’unico campo INDIRIZZO_RESIDENZA.
  • Completamento richiesta:
  • POST v1/Richiesta/Completamento/{idPrecaricata}: indicare nel file “jsonfile” i campi mancanti della richiesta (v. JSONfile “Completamento” in Appendice D e paragrafo “Allegati alle richieste Antifrode” in Appendice B)
  • Verifica lo stato di una richiesta:
  • GET v1/Richiesta/GetStatoRichiestaById/{idrichiestaAF}: restituisce lo stato corrente di una richiesta e la data di evasione se in stato evasa (v. tabella degli stati in Appendice B)
  • Download nuova modulistica precompilata:
  • GET v1/Modulistica/DownloadModulisticaLS/{idRichiesta}
  • Allega documentazione:
  • POST v1/File/AllegaDocumentazione/{idRichiestaAF}
  • Upload file associati a richiesta Antifrode (v. paragrafo “Allegati alle richieste Antifrode” in Appendice B)
  • Download esito lavorazione richiesta:
  • GET v1/File/DownloadEsitoRichiestaAF/{idRichiestaAF}: effettua il download dell’esito di una lavorazione richiesta

Versioni precedenti:

  • Gestione C.I. cartacea di 8 e 9 caratteri.
  • Gestione allegati case-insensitive.
  • Durante la creazione di una nuova richiesta è possibile includere una chiave opzionale negli headers denominata "RealUserKey" di tipo GUID contenente l’identificativo di un particolare utente (agente, mediatore, filiale) che si vuole impersonare in fase di inserimento. Per ottenere la userkey di un’agenzia è possibile invocare le seguenti API:
  • GET v1/Societa/ElencoAgenzie: restituisce l’elenco delle agenzie di un utente di tipo società
  • GET v1/Agenzia/ElencoAgenzieVisibili: restituisce l’elenco delle agenzie visibili di un utente di tipo agenzia
  • Alla creazione di una nuova richiesta con esito positivo viene restituito, con status code 200, un JSON strutturato come nel seguente esempio:
{
  "Messaggio": "Richiesta inserita con successo.",
  "IdRichiesta": 193411
}

In caso di esito negativo viene viene restituito l’elenco dei campi non validi con i relativi errori di validazione.

  • Modifica JSON di una richiesta Antifrode:
  • Modifica campo "TESS_SANITARIA": vuoto oppure sono ammessi da 3 (ultimi 3 caratteri del numero della tessera) a tutti i caratteri del numero della tessera sanitaria.
  • Aggiunta campo "FLAG_REAL": indica se l’indirizzo di residenza del cliente è difforme da quello indicato sul documento di identità: se viene impostato a TRUE 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).
  • Aggiunta di un array di JSON di documenti extra opzionali in coda al JSON della richiesta Antifrode denominato "ExtraDocs":
"ExtraDocs": [
{
   "ID_DOCUMENTO": 1,
   "NUM_DOCUMENTO": "AX1371063",
   "RILASCIATO_DA": "Comune",
   "COMUNE_RILASCIO": "ROMA",
   "PROVINCIA_RILASCIO": "RM",
   "DATA_RILASCIO": 20150818,
   "DATA_SCADENZA": 20140521,
   "CODICE_ICAO": null,
   "NUMERO_PROGRESSIVO_POLIGRAFICO": null,
   "FORZA_DOCUMENTO": true
   },
   ....
]
  • Aggiunta del controller Validate per l’analisi del JSON di una richiesta Antifrode prima del suo inserimento:
  • POST v1/Validate/Richiesta : (passare il JSON della richiesta nel body della request). Restituisce l’elenco dei codici dei campi non validi con i relativi errori di validazione. Se la validazione non va a buon fine non sarà possibile procedere all’inserimento della richiesta tramite POST a v1/Richiesta/NuovaRichiesta.
  • GET v1/Validate/GetAllValidationErrorCodes: restituisce l’elenco dei codici di errore di validazione disponibili nel sistema di validazione.
  • GET v1/Validate/GetAllFields: restituisce l’elenco dei codici dei campi disponibili nel sistema di validazione.
  • Controller Richiesta:
  • GET v1/Richiesta/CercaATC/{searchString}: restituisce l’elenco delle società ATC disponibili in base al parametro "searchString" (almeno 3 caratteri richiesti).
  • GET v1/Richiesta/GetCompanyEmails: restituisce l’elenco delle email, con i relativi id, disponibili per il proprio account per l’inoltro dell’esito della richiesta. Utilizzare gli id restituiti da questa API per costruire l’array del file JSONemails.
  • POST v1/Richiesta/AddCompanyEmail: aggiunge un indirizzo email all’elenco delle email per l’inoltro dell’esito della richiesta. E’ possibile includere nel body della request un JSON strutturato come nel seguente esempio:
{
   NOMINATIVO: "Nuova Email per Inoltro",
   EMAIL: "[email protected]"
}
  • POST v1/Richiesta/UpdateCompanyEmail/{Id}: aggiorna l’indirizzo email corrispondente all’Id fornito come parametro nell’URI dell’elenco delle email per l’inoltro dell’esito della richiesta.
  • GET v1/Richiesta/GetTipiDocumento: restituisce l’elenco delle tipologie di documenti disponibili
  • GET v1/GetEntiRilascioByDocId/{idDocumento}: restituisce l’elenco degli enti di rilascio disponibili in base all’id del documento fornito
  • Controller "ProcreditoUser" rinominato in "User".
  • Controller Agenzia:
  • GET v1/Agenzia/ElencoAgenzieVisibili: restituisce l’elenco delle agenzie visibili di un’agenzia
  • Controller Societa:
  • GET v1/Societa/ElencoAgenzie: restituisce l’elenco delle agenzie di una società