Lettore Smart Card

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.

Inoltre solo su Openapi è possibile scegliere tra diverse Certification Authority come InfoCert o Aruba, senza impegni d'acquisto di volume o obblighi verso Brand specifici.

L'API Firma Digitale permette anche di richiedere altre tipologie di firme come la firma elettronica semplice (con OTP) e la firma elettronica qualificata.

Lettore Smart Card

Openapi consente di accedere a 7 tipologie di Firme Digitali su Smart Card differenti:

Tutte le tipologie di firme su Smart Card richiedono l'ausilio del lettore smart card per poter firmare, siano esse con o senza CNS, siano esse InfoCert o Aruba. I Kit di firma digitale includono già la soluzione completa con smart card e lettore.

Hai bisogno di richiedere un lettore per una firma su smart card già acquistata o per altre tipologie di card? È disponibile un endpoint dedicato su Openapi!

Il lettore richiedibile tramite Openapi infatti può essere utilizzato non solo per le più diffuse firme digitali su Smart Card in Italia (InfoCert, Aruba, Infocamere), ma anche per CNS (Carta Nazionale dei Servizi), CIE (Carta d'identità elettronica) e CRS (Carta Regionale Servizi).

Il lettore è compatibile con i più diffusi sistemi operativi:

Caratteristiche tecniche del Lettore Smart Card:

Richiesta Elenco Firme e Codici

GET /prodotti

Come indicato precedentemente, Openapi offre un'ampia gamma di firme digitali. Per verificare tutti i dispositivi disponibili tramite l'API Firma 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

GET /prodotti

La risposta conterrà 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 (come ad esempio la Firma Elettronica Semplice) per cui sono previsti 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": "Lettore Smart Card USB",
"tipo": "Infocert",
"codice_prodotto": "LETTORE",
"prezzo": 13,
"vergine": true
},
{
"nome": "Smart Card Aruba CNS",
"tipo": "Aruba",
"codice_prodotto": "SCARUBACNS",
"prezzo": 22.40
},
{
"nome": "Firma Digitale",
"tipo": "Infocert",
"codice_prodotto": "FIR",
"prezzo": 22.70
}
.....
],
"success": true,
"message": "",
"error": null
}

Il codice LETTORE consente di effettuare la richiesta del dispositivo.

Richiesta Lettore Smart Card

POST /richiesta/{codice_prodotto}

Per poter ottenere il lettore o qualsiasi dispositivo di firma è necessario effettuare una richiesta all'endpoint POST /richiesta/{codice_prodotto} . Il codice prodotto è LETTORE.

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

Nel payload della richiesta sarà possibile selezionare l'opzione assistenza, urgenza, spedizione e la callback per rimanere sempre aggiornato/a sul cambio di stato della richiesta.

I tempi di consegna sono:

Risposta Lettore

POST /richiesta/{codice_prodotto}

La risposta includerà tutte le informazioni sulla richiesta.

{
"data":{
 "anagrafica_spedizione":{
  "email": [email protected]
  "cellulare": "349xxxxx18",
  "destinatario": "alberto neri",
  "indirizzo_spedizione": "via rossi 2",
  "comune_spedizione": "terni",
  "provincia_spedizione": "terni",
  "cap_spedizione": "05100",
  "note": ""
 },
"callback": {
    "url": "https://dev.ws.firmadigitale.com/test.php",
    "method": "JSON",
    "field": "data"
    "data": {}
},
"codice_richiesta": "fdd40",
"prodotto": "Lettore Smart Card USB",
"codice_prodotto": "LETTORE",
"tipo": "Infocert",
"stato": "evasa",
"assistenza": true,
"urgenza": false,
"spedizione": ordinaria,
"videoriconoscimento": false,
"timestamp": {
    "acquisto":"1693574555"  
},
"owner": "[email protected]",
"fornitore": {
      "ragione_sociale": "Openapi Srl",
      "sede_legale": "Viale F. Tommaso Marinetti 221 - 00143 Roma (RM)",
      "partita_iva": "07432261001",
      "legale_rappresentante": "",
      "email_assistenza": "",
      "email_contabilita": "",
      "telefono_assistenza": "",
      "sede_riconoscimento": "Piazza San Giovanni Decollato 6 - 05100 Terni (TR)"
    },
    "firma": {
      "codice_spedizione": "",
      "pin": "",
      "puk": "",
      "numero_dispositivo": "",
      "codice_carta": "",
      "numero_busta": "",
      "codice_utente": "",
      "iut": "",
      "alias": "",
      "codice_emergenza": ""
    },
    "id": "5f7ef1e83a716836d3152662",
    "modulo": false,
    "documento": false
  },
  "success": true,
  "message": "",
  "error": null
}

È possibile verificare lo stato di evasione dell'ordine in qualsiasi momento attraverso l'endpoint GET /richiesta/{id} . Nella risposta, quando lo stato sarà passato ad evaso, sarà possibile accedere al codice tracciamento della spedizione.

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!