CNS Smart Card Reader

Openapi is the only platform that allows more than 15 different types of digital signatures to be requested via API, including signatures with physical devices (e.g. USB and smart cards), qualified electronic signatures, devices with or without CNSs, and video recognition identification possibilities.

On Openapi it is also possible to choose between different Certification Authorities such as InfoCert or Aruba, without minimum purchase commitment or obligations to specific brands.

With the API Digital Signature other types of signatures such as simple electronic signature (with OTP) and qualified signature can be requested.

CNS Smart Card Reader

Openapi provides access to 7 different types of Digital Signatures on Smart Cards:

All types of smart card signatures require a smart card reader in order to sign, whether with or without a CNS, whether InfoCert or Aruba. The digital signature kits already include the complete solution with smart card and reader.

Do you need a reader for a signature on an already purchased smart card or for other types of cards? A dedicated endpoint is available on Openapi!

The reader that can be requested via Openapi can in fact be used not only for the most common digital signatures on smart cards in Italy (InfoCert, Aruba, Infocamere), but also for CNS (National Services Card), CIE (Electronic Identity Card) and CRS (Regional Services Card).

The reader is compatible with the most popular operating systems:

Smart Card Reader Specifications:

Request Signature List and Code

As mentioned above, Openapi offers a wide range of digital signatures. To check all the devices available via the API Digital Signature, and their respective prices, it is necessary to make an API request to the endpoint /prodotti.

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

Response Signature List and Code

The response offers the complete list of all available signatures with name, type (e.g. InfoCert or Aruba), code and price. This list does not include electronic signatures not belonging to the Digital Signature type (e.g. Simple Electronic Signature), for which there are dedicated endpoints. For some products, it will also be indicated whether it is a 'blank' signature, in which case no signature certificates will be issued.

The list below is only an example and not exhaustive of the available products:

{
"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
}

Request CNS Smart Card Reader

To proceed with the device request, a request must be made to the endpoint POST/richiesta/{codice_prodotto}. In this case the device is the Smart Card Reader and the product code is LETTORE.

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

In the payload of the request you will be able to select the service, urgency, dispatch and callback option to stay updated on the change of status of the request.

Shipping times are:

Response CNS Smart Card Reader

The response contains all the information about the request.

{
"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
}

You can check the status of signature processing at any time via the endpoint GET/richiesta/{id}. In the response, when the status has changed to evaded, you will be able to access the tracking code of the shipment.

Do you have questions about the types of digital signature devices or how to apply and activate them? Do not hesitate to contact us: one of our consultants will be at your disposal to provide you with all the information and clarifications you need!