Digital Signature Kit InfoCert

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.

Additionally, Openapi offers the possibility to choose from various Certification Authorities such as InfoCert or Aruba, without any minimum purchase commitment or obligations towards specific brands.

At the same time, with the API Digital Signature you can request other types of signatures such as simple electronic signatures (with OTP) and qualified signatures.

InfoCert Digital Signature Kit

The Digital Signature Kit is InfoCert's complete solution, designed for everyone who uses the digital signature with a PC from a fixed workstation. It includes:

Thanks to the CNS certificate, it is possible to access all public administration portals in seconds and securely.

With the Digital Signature Kit, you can sign any electronic document: for example, financial statements and corporate acts, invoices, notifications, forms for registration in public records, contracts.

Request Signature List and Codes

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

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

Response Signature List and Codes

GET /prodotti

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

Below we propose the list (as an example and not exhaustive) of the available products:

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

In the case of the Digital Signature Kit, multiple codes will be present depending on the presence of the CNS Certificate.

The code allows you to request the device.

Request Digital Signature Kit

POST/richiesta/{codice_prodotto}

To proceed with the kit request, you need to make a request to the endpoint POST/richiesta/{codice_prodotto}. In this case, it is the Digital Signature Kit with CNS, and the product code is KITCNS.

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

In the request payload, you need to pass a series of information about the applicant. These data depend on the type of device selected; in the case of the Digital Signature Kit (with or without CNS), they are:

Below is an example payload for the request of a Digital Signature Kit:

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

For the Digital Signature Kit, you can also select one or more options:

The delivery times are:

Timeframes are from receipt of the required documentation.

We suggest setting up a callback to stay constantly updated on the status of the request.

Response Digital Signature Kit

POST/richiesta/{codice_prodotto}

The response contains all the information and the request ID, for example, in our case, it will be 5f7ef1e83a716836d3152662. The request ID is essential because it allows us to check the status of the request, download and possibly send the registration form of the Signature.

The form can be downloaded via the endpoint GET/richiesta/{id}/modulo .

Request Completion

In order for the certificates to be issued and the device to be processed, it is necessary for the requester to complete the identification process.

This can be done in various ways. If the applicant:

You can check the status of the signature fulfillment at any time through the endpoint GET/richiesta/{id}.

In the response, when the status has changed to processed, it will be possible to access the tracking code of the shipment, the envelope number and the device identification number. The signature activation data (Emergency Code, PIN, PUK) will instead be, according to regulations, sent directly to the applicant's email via virtual envelope (PDF) by the InfoCert Certification Authority.

Through the API Digital Signature, you can also request "Virgin" Smart Cards. This is the case, for example, of RAO customers who can directly issue signature certificates themselves and need to purchase only batches of devices (CNS).

Do you have questions about the types of digital signature devices or the methods of request and activation? 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!