Erogazione :
4 Ore
a partire da € 13,70 + iva Certificati Camerali ufficiali della CCIAA di tutte le imprese italiane disponibili tramite API.
Il Certificato Camerale è disponibile nella versione digitale o in carta filigranata CCIAA con contromarca oleografica.
Il Certificato Camerale erogato tramite service è il documento ufficiale rilasciato dalla Camera di Commercio e ha valore legale di certificazione.
I Certificati Camerali disponibili sono:
È possibile effettuare la richiesta dei Certificati Camerali solo per Imprese iscritte alla Camera di Commercio Il Certificato infatti attesta l'iscrizione dell'impresa al Registro delle Imprese e al R.E.A. della Camera di Commercio, ha valore di certificazione ed è opponibile a terzi. Ha una validità di 6 mesi.
Al momento è possibile richiedere i Certificati Camerali tramite 2 API differenti:
1) Visure Camerali
2) Visengine
Attualmente l'API Visure Camerali consente la richiesta solo dei seguenti certificati e senza opzioni:
Il vantaggio di utilizzare l'API Visure Camerali è quello di poter effettuare richieste dirette. Nessun richiesta ulteriore per ottenere hash o parametri.
Con un'unica richiesta ad esempio all'endpoint POST /certificato-iscrizione sarà possibile completare la richiesta del certificato. Nel caso si desideri richiedere il certificato di vigenza è necessario utilizzare invece l'endpoint: POST/certificato-iscrizione-vigenza
Per richiedere il Certificato è necessario uno dei seguenti dati:
Nel nostro caso abbiamo scelto di passare nel body della richiesta il codice fiscale
{
"cf_piva_id": "12485671007"
}
L'ID azienda è ottenibile tramite i due servizi di ricerca commerciale a partire dal nome (o da alcuni criteri come codice ateco e fatturato) oppure dalla partita IVA / codice fiscale. Sarà possibile anche impostare una callback per essere aggiornati su quando il documento è disponibile, senza dover chiamare l'endpoint GET /certificato-iscrizione/{id} per verificarne lo stato.
Nella risposta viene restituito lo stato, il timestamp della richiesta, eventuale url callback impostata e l'id della richiesta che sarà necessario per le prossime richieste.
{
"data": {
"cf_piva_id": "12485671007",
"tipo": "certificato-iscrizione",
"stato_richiesta": "In erogazione",
"timestamp_creation": 1651056422,
"timestamp_last_update": 1651056500,
"allegati": [
"65671d1c207bbf56a50aa122.pdf"
],
"callback": {
"url": "https://www.your_url.it/callback",
"method": "POST",
"field": "data",
"data": {}
},
"owner": "[email protected]",
"id": "65671d1ce3f1e6dff80a9265"
},
"success": true,
"message": "",
"error":
}
È possibile verificare lo stato di una richiesta di Certificato tramite l'endpoint GET /certificato-iscrizione/{id}. Come indicato anche precedentemente, suggeriamo di impostare in fase di richiesta la callback per essere aggiornati quando il documento è disponibile e può essere scaricato.
L'id è quello ottenuto e disponibile nella risposta dopo la richiesta all'endpoint POST /certificato-iscrizione
https://visurecamerali.openapi.it/certificato-iscrizione/5f2829ce065afc21cc60ad0e La risposta include il tipo di certificato, il timestamp della richiesta e dell'ultimo aggiornamento, eventuale url di callback e se evasa anche l'allegato
{
"data": {
"cf_piva_id": "12485671007",
"tipo": "certificato-iscrizione",
"stato_richiesta": "Visura evasa",
"timestamp_creation": 1651056422,
"timestamp_last_update": 1651056500,
"allegati": [
"65671d1c207bbf56a50aa122.pdf"
],
"callback": {
"url": "https://www.your_url.it/callback",
"method": "POST",
"field": "data",
"data": {}
},
"owner": "[email protected]",
"id": "65671d1ce3f1e6dff80a9265"
},
"success": true,
"message": "",
"error": null,t
}
Una volta che il certificato sarà in stato "evaso" sarà possibile scaricare il documento tramite l'endpoint GET /certificato-iscrizione/{id}/allegati
La richiesta dovrà essere effettuata con l'id ottentuto nella risposta dell'endpoint POST /certificato-iscrizione.
https://visurecamerali.openapi.it/certificato-iscrizione/5f2829ce065afc21cc60ad0e/allegati/
La risposta indicherà nome del file, dimensione e file.
{ "data":
{
"nome": "6564a673ccfa313352066377.zip",
"dimensione": 1728,
"file": "UEsDBBQAAAAlNnVTBs6lJ1vIIAJthCQAcABwANjI2OTFjNGY5N2UwOTQ0NzU0MDI3ADU/HOUbc+WLQqnnTtt27Zt27Zt25k7bdu2bdvcadv5fnXOqapz655qt9p93x/vW62tFjHnGmv2HiMiZvQxY7RJIi8sSsNAywxFcnA4uwjFgE+Pb2doCcXNTSdqYe1s4kgnam3gbCJsYmRnbEInbWJr5"
}
Visengine consente di accedere a tutti i Certificati Camerali:
Inoltre è possibile richiedere anche tutte le opzioni disponibili:
Per richiedere i Certificati Camerali con Visengine prima di tutto è necessario individuare l'hash che identifica univocamente ogni documento o pratica.
https://visengine2.altravia.com/visure/
Questo è possibile tramite l'endpoint GET /visure che non necessita di parametri e restituirà l'elenco completo dei documenti e pratiche richiedibili tramite Visengine e rispetto hash.
Per verificare le informazioni, i documenti necessari ed i costi del Certificato è necessario effettuare una richiesta tramite l'endpoint GET /visure/{hash_visura} e passare l'hash del certificato precedentemente ottenuto.
Per verificare campi e costi per completare la richiesta dovremmo utilizzare l'hash che abbiamo ottenuto nella richiesta precedente.
https://visengine2.altravia.com/visure/fab482bf67a418f00d596b7296750a9aLa risposta indicherà tutti le informazioni necessarie per completare la richiesta del certificato come ad esempio i campi obbligatori.
{
"data": {
"hash_visura": "fab482bf67a418f00d596b7296750a9a",
"json_struttura": {
"campi": {
"$0": {
"nome": "Codice fiscale o partita IVA",
"tipo": "codice_fiscale",
"null": false,
"istruzioni": "Codice Fiscale o partita iva della società",
"ordine": "1"
},
"$1": {
"nome": "Denominazione sociale",
"tipo": "denominazione",
"null": false,
"istruzioni": "Nome esatto della società (non inserire il tipo di società es. srl, spa etc.)",
"ordine": "0"
},
"$2": {
"nome": "Provincia",
"tipo": "cod_provincia",
"null": false,
"istruzioni": "Provincia della sede legale della società",
"ordine": "2"
},
"$3": {
"nome": "Indirizzo completo di spedizione per la consegna del Certificato in versione cartacea",
"tipo": "testo",
"null": false,
"istruzioni": "Inserire Indirizzo Completo di Spedizione con nome destinatario, via e civico, comune, CAP. La spedizione è inclusa nel prezzo",
"ordine": "4"
},
"$4": {
"nome": "Numero Telefonico per essere ricontattati",
"tipo": "testo",
"null": false,
"istruzioni": "Inserire numero telefonico dove essere ricontattati per problemi o per la consegna del Certificato",
"ordine": "5"
},
"$5": {
"nome": "Destinatario Spedizione",
"tipo": "testo",
"null": false,
"istruzioni": "Nome destinatario spedizione",
"ordine": "3"
}
},
"validazione": "($0 && $3 && $4 && $5) || ($1 && $2 && $3 && $4 && $5) || ($0) || ($1 && $2)",
"istruzioni": "PHA+Q29tcGlsYSBpbCBmb3JtIHBlciBwcm9jZWRlcmUgYWxsYSByaWNoaWVzdGEgZGVsIENlcnRpZmljYXRvLjxiciAvPg0KSW5kaWNhcmUgbGEgc29jaWV0JmFncmF2ZTsgcGVyIGxhIHF1YWxlIHN0YWkgcmljaGllZGVuZG8gaWwgY2VydGlmaWNhdG8gdHJhbWl0ZSA8c3Ryb25nPlAuSXZhLyBDLkYuPC9zdHJvbmc+IG8gPHN0cm9uZz5EZW5vbWluYXppb25lIGUgUHJvdmluY2lhPC9zdHJvbmc+PC9wPg0KDQo8cD4mbmJzcDs8L3A+DQoNCjxwPkFpIGZpbmkgZGkgdW5hIGNvcnJldHRhIGNvbnNlZ25hIGRlbCBjZXJ0aWZpY2F0byBjYXJ0YWNlbyBpbnNlcmlyZSBpbCBkZXN0aW5hdGFyaW8gZSBsJiMzOTtpbmRpcml6em8gY29tcGxldG8mbmJzcDtuZWwgY2FtcG8gaW5kaXJpenpvIGRpIHNwZWRpemlvbmUgY29uIGkgc2VndWVudGkgZGF0aSZuYnNwOzombmJzcDs8L3A+DQoNCjx1bD4NCgk8bGk+dmlhIGUgbnVtZXJvIGNpdmljbzwvbGk+DQoJPGxpPmNvbXVuZTwvbGk+DQoJPGxpPkNBUDwvbGk+DQoJPGxpPmV2ZW50dWFsaSByZWNhcGl0aSB0ZWxlZm9uaWNpIG8gbm90ZSBwZXIgbGEgY29uc2VnbmEmbmJzcDs8L2xpPg0KPC91bD4NCg0KPHA+SW5zZXJpcmUgaW5vbHRyZSBudW1lcm8gZGkgdGVsZWZvbm8gZG92ZSBlc3NlcmUgcmljb250YXR0YXRpIHBlciBwcm9ibGVtaSBvIHBlciBsYSBjb25zZWduYSBkZWwgY2VydGlmaWNhdG88L3A+DQoNCjxwPiZuYnNwOzwvcD4NCg==",
"istruzioni_ricerca": ""
},
"nome_categoria": "Camerali",
"nome_visura": "Certificato di iscrizione",
"opzioni": [
{
"tipo": "urgenza",
"prezzo": 6.7,
"nome": "opzione_0"
},
{
"tipo": "stampa_filigranata/spedizione",
"prezzo": 7.9,
"nome": "opzione_1"
},
{
"tipo": "vigenza",
"prezzo": 3,
"nome": "opzione_2"
},
{
"tipo": "inglese",
"prezzo": 3,
"nome": "opzione_3"
}
],
"prezzo_ricerca": 0,
"prezzo_visura": 12.7,
"ricerca": false,
"sincrona": false,
},
"success": true,
"message": "",
"error": null
}
In validazione sono indicati i dati obbligatori per completare la richiesta con successo. Per il prodotto Certificato Camerale è possibile utilizzare combinazioni di dati diversi.
Nel nostro caso per completare la richiesta del Certificato abbiamo scelto di passare la partita IVA dell'azienda.
{
"hash_visura": "fab482bf67a418f00d596b7296750a9a",
"json_visura": {
"$1": 12485671007
}
}La risposta restituisce diverse informazioni tra cui lo stato, se impostata la callback e l'ID della richiesta che ci servirà successivamente per scaricare il documento.
{ "data":
{
"_id": "5f2829ce065afc21cc60ad0e",
"state": 1,
"hash_visura": "fab482bf67a418f00d596b7296750a9a",
"nome": "Certificato di iscrizione ",
"ricerca": false,
"id_ricerca": null,
"prezzo_visura": 12.7,
"prezzo_ricerca": 0,
"indice_ricerca": null,
"stato_richiesta": "In erogazione",
"email_target": null,
"allegati": [],
"timestamp_creation": 1596467662,
"timestamp_last_update": 1596467663,
"timestamp_stati": {
"in_ricerca": 1596467663,
"in_erogazione": 1596467663
},
"callback_data": false,
"opzioni": null,
"owner": "[email protected]",
"sincrona": false,
"ricerche": [
{
"id_ricerca": "5f2829ce065afc21cc60ad0e_0",
"stato_ricerca": "Ricerca evasa",
"json_ricerca": "{\"$1\":\"12485671007\"}",
"json_mappato": {
"NRea": "1378273",
"Cciaa": "RM"
},
"json_risultato": null
}
],
"esito": {
"codice": "0",
"info": "OK"
}Una volta che lo stato della richiesta è in stato "evasa" è possibile scaricare il documento tramite metodo GET /documento/{_id}
Questo è un esempio di richiesta utilizzando l'ID precedentemente ottenuto
https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e
La risposta conterrà il nome, la dimensione e il file.
{
data{
"nome":"5f22f5b5065afc21cc60a27a.zip",
"dimensione"10206",
"file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
},
"success": true,
"message": "",
"error": null
}Il certificato camerale può essere richiesto da chiunque, anche se non rappresentante legale dell'impresa, senza necessità di presentare alcun tipo di modulo o di delega. Il Certificato Camerale può essere richiesto sia nella versione digitale che in carta filigranata CCIAA con contromarca oleografica.