Smart Card 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.

Su Openapi inoltre è possibile scegliere tra diverse Certification Authority come InfoCert o Aruba, senza impegno di acquisto minimo o obblighi verso specifici Brand.

Con l'API Firma Digitale possono essere richieste anche altre tipologie di firme, come la firma elettronica semplice (con OTP) e la firma qualificata.

Smart Card InfoCert

Smart Card è una tipologia di firma digitale InfoCert dalla forma di una carta di credito, compatibile con i più diffusi lettori di smart card. Esistono due versioni di Smart Card:

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

Smart Card consente di apporre la firma digitale su qualsiasi documento elettronico (come bilanci ed atti societari, fatture, notifiche, moduli per iscrizione a pubblici registri, contratti) con validità legale in tutta Europa ed è la soluzione ideale per chi utilizza il computer da postazione fissa.

Con l’acquisto del dispositivo di firma su Smart Card sono inclusi:

Richiesta Elenco Firme e Codici

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

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

Risposta Elenco Firme e Codici

La risposta offre l'elenco completo di tutte le firme disponibili con nome, tipo (es. InfoCert o Aruba), codice e prezzo. Questo elenco non include 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

L'elenco che segue è solo a titolo di esempio e non esaustivo dei prodotti disponibili:

{
  "data": [
    {
      "nome": "Smart Card",
      "tipo": "Infocert",
      "codice_prodotto": "FIR",
      "prezzo": 22.7
    },
    {
      "nome": "Smart Card CNS",
      "tipo": "Infocert",
      "codice_prodotto": "SMARTCARDCNS",
      "prezzo": 25.7
    },
    {
      "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 della firma digitale Smart Card saranno presenti più codici a seconda della presenza del Certificato CNS e dell'opzione Videoriconoscimento.

Il codice consente di effettuare la richiesta del dispositivo.

Richiesta Smart Card InfoCert

Per procedere alla richiesta del dispositivo è necessario effettuare una richiesta all'endpoint POST/richiesta/{codice_prodotto}. In questo caso il dispositivo è la Smart Card con CNS ed il codice prodotto è SMARTCARDCNS.

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

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

Di seguito un esempio di payload per la richiesta di una Smart Card

{
  "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 prodotto Smart Card con video riconoscimento è sufficiente passare un dataset di informazioni più limitato:

Per le Smart Card (senza video riconoscimento) è possibile selezionare anche una o più opzioni come l'assistenza, l'urgenza e la tipologia di spedizione (ordinaria, prioritaria, veloce).

I tempi di spedizione sono:

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

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

Risposta Smart Card

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

L'opzione video riconoscimento semplifica questo processo automatizzando l'intero processo di identificazione tramite una semplice chiamata con un operatore, effettuabile da qualsiasi dispositivo.

È 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.

Inoltre, sempre tramite l'API Firma Digitale si possono 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).

Il servizio Smart Card CNS via API è ideale per aziende e organizzazioni che desiderano offrire ai propri clienti una firma sicura e certificata, utilizzabile dalla singola persona con proprie credenziali sia per poter sottoscrivere qualsiasi documento digitale sia per poter accedere ai servizi della Pubblica Amministrazione nel caso in cui si scelga l’opzione CNS (Carta Nazionale dei Servizi).

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!