Kit Firma Infocert

Openapi è l'unica piattaforma che consente di richiedere tramite API oltre 15 tipologie di firme digitali diverse, tra cui firme che includono dispositivi fisici (es. USB e smart card), firme remote, dispositivi con o senza CNS, e possibilità di identificazione con video riconoscimento.

Openapi inoltre offre la possibilità di scegliere tra diverse Certification Authority come InfoCert o Aruba, senza impegno di acquisto minimo o obblighi verso specifici Brand.

Allo stesso tempo, con l'API Firma Digitale si possono richiedere altre tipologie di firme come la firma elettronica semplice (con OTP) e la firma qualificata.

Kit Firma Digitale InfoCert

Kit Firma Digitale è la soluzione completa di InfoCert, pensata per tutti coloro che utilizzano la firma digitale con pc da una postazione fissa. Include:

Grazie al certificato CNS è possibile accedere a tutti i portali della PA in pochi secondi ed in modalità sicura.

Tramite il Kit Firma Digitale si può sottoscrivere qualsiasi documento informatico: ad esempio bilanci ed atti societari, fatture, notifiche, moduli per iscrizione a pubblici registri, contratti.

Richiesta Elenco Firme e Codici

Come anticipavamo sopra, Openapi offre un'ampia gamma di firme digitali. Per verificare tutti i dispositivi disponibili tramite l'API Firme Digitali, ed i rispettivi prezzi, è necessario effettuare una richiesta API all'endpoint GET /prodotti.

GET https://ws.firmadigitale.com/prodotti

Risposta Elenco Firme e Codici

Nella risposta è incluso l'elenco completo di tutte le firme disponibili con nome, tipo (es. InfoCert o Aruba), codice e prezzo. Questo elenco non contiene firme elettroniche non appartenenti alla tipologia Firme Digitali (ad es. la Firma Elettronica Semplice), per le quali ci sono endpoint dedicati. Per alcuni prodotti sarà indicato anche se si tratta di firma "vergine", in tali casi non è prevista l'emissione dei certificati di firma

Di seguito proponiamo l'elenco (a titolo esemplificativo e non esaustivo) dei prodotti disponibili:

{
  "data": [
    {
      "nome": "Kit Firma Digitale",
      "tipo": "Infocert",
      "codice_prodotto": "KIT",
      "prezzo": 39.7
    },
    {
      "nome": "Kit CNS Infocert",
      "tipo": "Infocert",
      "codice_prodotto": "KITCNS",
      "prezzo": 40.3
    },
    {
      "nome": "Smart Card CNS Con Videoriconoscimento",
      "tipo": "Infocert",
      "codice_prodotto": "SMARTCARDCNS_VIDEO",
      "prezzo": 57.9
    },
    {
      "nome": "Smart Card CNS Vergine",
      "tipo": "Infocert",
      "codice_prodotto": "SMARTCARDCNS_V",
      "prezzo": 25.70,
      "vergine": true
    }
    .....
  ],
  "success": true,
  "message": "",
  "error": null
}

Nel caso del Kit Firma Digitale saranno presenti più codici a seconda della presenza del Certificato CNS.

Il codice consente di effettuare la richiesta del dispositivo.

Richiesta Kit Firma Digitale

POST/richiesta/{codice_prodotto}

Per procedere alla richiesta del kit è necessario effettuare una richiesta all'endpoint POST/richiesta/{codice_prodotto}. In questo caso si tratta del Kit Firma Digitale con CNS ed il codice prodotto è KITCNS.

POST https://ws.firmadigitale.com/richiesta/KITCNS

Nel payload della richiesta bisogna passare una serie di informazioni sul richiedente. Questi dati dipendono dalla tipologia di dispositivo selezionato, nel caso del Kit Firma Digitale (con o senza CNS) sono:

Di seguito un esempio di payload per la richiesta di un Kit Firma Digitale:

{
  "data":{
  "assistenza": true,
  "urgenza": true,
  "spedizione": "veloce",
  "anagrafica": {
    "nome": "alberto",
    "cognome": "neri",
    "email": "[email protected]",
    "cellulare": "349xxxxx18",
    "codice_fiscale": "vnxxxxxxxl1x7d",
    "data_nascita": "28/12/2000",
    "sesso": "M",
    "comune_nascita": "terni",
    "provincia_nascita": "terni",
    "nazione_nascita": "terni",
    "indirizzo_residenza": "via rossi 2",
    "comune_residenza": "terni",
    "provincia_residenza": "terni",
    "cap_residenza": "05100",
    "nazione_residenza": "italia",
    "destinatario": "alberto neri",
    "indirizzo_spedizione": "via rossi 2",
    "comune_spedizione": "terni",
    "provincia_spedizione": "terni",
    "cap_spedizione": "05100",
    "tipo_documento": "patente",
    "numero_documento": "123456",
    "soggetto_emittente": "mctc",
    "data_emissione": "05/11/1990",
    "data_scadenza": "12/12/2020"
  },
  "callback": {
    "url": "https://dev.ws.firmadigitale.com/test.php",
    "method": "JSON",
    "field": "data"
  }
}

Per il Kit Firma Digitale è possibile selezionare anche una o più opzioni:

I tempi di consegna sono:

Le tempistiche si intendono a partire dalla ricezione della documentazione prevista.

Ti suggeriamo di impostare una callback per rimanere costantemente aggiornato/a sul cambio stato della richiesta.

Risposta Kit Firma Digitale

POST/richiesta/{codice_prodotto}

La risposta contiene tutte le informazioni e l'id della richiesta, ad esempio nel nostro caso sarà 5f7ef1e83a716836d3152662. L'id della richiesta è indispensabile perché ci consente di verificare lo stato della richiesta, scaricare ed eventualmente inviare il modulo di registrazione della Firma. Il modulo può essere scaricato tramite l'endpoint GET /richiesta/{id}/modulo

Completamento Richiesta

Per consentire l'emissione dei certificati e l'evasione del dispositivo è necessario che il richiedente completi il processo di identificazione, come prevede la normativa vigente.

Questo può avvenire in varie modalità. Se il richiedente

È possibile verificare lo stato di evasione delle firme in qualsiasi momento tramite l'endpoint GET /richiesta/{id}. Nella risposta, quando lo stato sarà passato ad evaso, sarà possibile accedere al codice tracciamento della spedizione, al numero della busta e al numero identificativo dispositivo. I dati di attivazione della firma (Codice Emergenza, PIN, PUK) saranno, secondo normativa, invece inviati direttamente all'email del richiedente tramite busta virtuale (PDF) dalla Certification Authority InfoCert.

Sempre tramite l'API Firme Digitali si possono inoltre richiedere anche Smart Card "Vergini". È il caso ad esempio di clienti RAO che possono emettere direttamente loro i certificati di firma e hanno necessità di acquistare solo lotti di dispositivi (CNS)

Hai domande sulle tipologie di dispositivi di firma digitale o sulle modalità di richiesta e attivazione? Non esitare a contattarci: un nostro consulente sarà a tua disposizione per fornirti tutte le informazioni e i chiarimenti di cui hai bisogno!