Signer Read

API di lettura per Ts Digital Signature per le operazioni riguardanti i firmatari e i certificati. Swagger
Header
Gli header richiesti dalla chiamata sono gli header standard di TSDigital.
Il 
Content-Type deve essere 
application/json
In tutte le chiamate dove è richiesto ServiceName non impostare nulla a meno che si vuole utilizzare le api per il servizio adempimenti. 
 
Descrizione API
SIGNER
Signer search
POST ​/v1​/rest​/signers​/search
Permette di recuperare i firmatari di una data azienda
Query Params
page numero di pagina
itemId  identificativo dell'azienda
size numero di elementi per pagina
fullText permette di fare una ricerca filtrata per alcuni dati dei firmatari
certs permette di filtrare per tipologia di firma, i valori accettati sono FRM, FSM, FEA, FES (firma elettronica automatica, firma elettronica remota, firma elettronica avanzata ,firma elettronica semplice)
strictCerts permette di filtrare solamente le tipologie di firma attive
serviceName controllare le info su questo campo in cima al documento
La ricerca fullText viene fatta su questi dati dei firmatari
firstName  
lastName 
fiscalCode 
ownerTaxId codice fiscale dell'azienda su cui il firmatario e stato assegnato 
ownerVatNumber partita iva dell'azienda su cui il firmatario e stato assegnato 
ownerDescription ragione sociale dell'azienda su cui il firmatario e stato assegnato 
Response
{
   "page":0,
   "itemsNumberPerPage":2,
   "totalItems":2,
   "totalPages":1,
   "signers":[
      {
         "id":219,
         "fiscalCode":"MNNRFL96D21I829W",
         "firstName":"Raffaele",
         "lastName":"Mainini",
         "sex":"M",
         "email":"rmainini@mondora.com",
         "cellNumber":"",
         "ownerDescription":null,
         "enabled":true,
         "certificates":[
            {
               "id":225,
               "type":"FSM",
               "status":"SUBMISSION_SUCCESS"
            },
            {
               "id":226,
               "type":"FRM",
               "certificateSn":"585",
               "certificateId":"10846",
               "enabled":true,
               "status":"FINAL_SUCCESS",
               "createBy":"rmainini@mondora.com"
            },
            {
               "id":60,
               "type":"FES",
               "enabled":true,
               "status":"ACTIVE"
            },
            {
               "id":81,
               "type":"FEA",
               "enabled":false,
               "documentHubId":"5e9847700e20480006394a98",
               "status":"INIT"
            }
         ],
         "_links":{
            "self":{
               "href":"https://ts-signer-read-api-test.agyo.io/api/v1/rest/signers/219"
            }
         }
      },
      {
         "id":247,
         "fiscalCode":"PNNGNN80A01I829P",
         "firstName":"Giovanni",
         "lastName":"Panni",
         "sex":"M",
         "email":"rmainini@mondora.com",
         "cellNumber":"",
         "ownerDescription":null,
         "enabled":true,
         "certificates":[
         ],
         "_links":{
            "self":{
               "href":"https://ts-signer-read-api-test.agyo.io/api/v1/rest/signers/247"
            }
         }
      }
   ]
}
Retrive Signer 
[GET] ​/v1​/rest​/signers​/{id}
Permette di recuperare tutte le info riguardanti uno specifico firmatario
Info
id  identificativo del firmatario
Response
{
   "id":219,
   "fiscalCode":"MNNRFL96D21I829W",
   "firstName":"Raffaele",
   "lastName":"Mainini",
   "fiscalCountry":"IT",
   "sex":"M",
   "birthCity":"Sondrio",
   "birthCountry":"IT",
   "birthDate":"1996-04-21T00:00:00.000+0000",
   "birthDistrict":"SO",
   "city":"Sondrio",
   "country":"IT",
   "district":null,
   "cap":"23010",
   "address":"Via Fasulla",
   "email":"rmainini@mondora.com",
   "cellNumber":"",
   "ownerTaxId":null,
   "ownerVatNumber":null,
   "ownerDescription":null,
   "documentIssuer":"me",
   "documentNumber":"1234",
   "documentEndDate":"2020-04-30T00:00:00.000+0000",
   "documentType":"Carta d'identità",
   "_links":{
      "self":{
         "href":"https://ts-signer-read-api-test.agyo.io/api/v1/rest/signers/219"
      }
   }
}
Retrive If Signer Exist into Item
[GET] ​/v1​/rest​/signers​/searchByFiscalCode
Permette di verificare se un determinato firmatario esiste già per un'azienda
Query Params
itemId  identificativo dell'azienda 
fiscalCode codice fiscale del firmatario che si sta controllando
serviceName controllare le info su questo campo in cima al documento
UTILS
Download Filled/Signed Document
[GET] ​/v1​/rest​/utils​/download​/document
Permette di scaricare il contratto per i certificati FRM/FSM (Firma elettronica qualificata automatica/Firma elettronica qualificata remota) sia solamente pre compilato sia quello pre compilato e firmato
Query Params
signerId  identificativo del firmatario
certType tipologia di certificato FRM o FSM
documentType tipo documento FILLED o SIGNED
Generate and return base64 FEA precompiled module
[GET] ​/v1​/rest​/utils​/generate​/fea​/module
Permette di generare il contratto del modulo di adesione FEA precompilato
Query Params
signerId  identificativo del firmatario
CERTIFICATE
Retrive Slot Usage
[GET] ​/v1​/rest​/certificates​/slotUsage​/{itemId}
Permette di recuperare il conteggio degli slot per i certificati di un'azienda
Query Params
itemId  identificativo dell'azienda 
Response 
{
   "totalFRM":3,
   "freeFRM":2,
   "totalFSM":3,
   "freeFSM":3
}