Certificati Camerali

  • Openapi Erogazione : 4 Ore
  • Openapi a partire da € 11,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.

Esempio Certificati Camerali

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:

  • Certificato di Iscrizione
  • Certificato di Iscrizione con Dichiarazione di non esistenza procedure concorsuali (ex Vigenza)
  • Certificato Artigiano
  • Certificato Storico

È 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

RICHIESTA CERTIFICATI CAMERALI CON API VISURE CAMERALI

Attualmente l'API Visure Camerali consente la richiesta solo dei seguenti certificati e senza opzioni:

  • Certificato Camerale di Iscrizione
  • Certificato Camerale di Vigenza

Il vantaggio di utilizzare l'API Visure Camerali è quello di poter effettuare richieste dirette. Nessun richiesta ulteriore per ottenere hash o parametri.

1) Richiedere certificato POST /certificato-iscrizione

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:

  • Partita IVA / Codice Fiscale dell'Azienda
  • ID azienda

ESEMPIO DI RICHIESTA POST /certificato-iscrizione

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.

ESEMPIO RISPOSTA POST /certificato-iscrizione

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


2) Verificare lo stato della richiesta GET /certificato-iscrizione/{id}

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

ESEMPIO RICHIESTA GET /certificato-iscrizione/{id}

L'id è quello ottenuto e disponibile nella risposta dopo la richiesta all'endpoint POST /certificato-iscrizione 

https://visurecamerali.openapi.it/certificato-iscrizione/5f2829ce065afc21cc60ad0e 


ESEMPIO RISPOSTA GET /certificato-iscrizione/{id}

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
  }
  


3) Scaricare Certificato GET /certificato-iscrizione/{id}/allegati

Una volta che il certificato sarà in stato "evaso" sarà possibile scaricare il documento tramite l'endpoint GET /certificato-iscrizione/{id}/allegati

ESEMPIO RICHIESTA 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/


ESEMPIO RISPOSTA GET /certificato-iscrizione/{id}/allegati

La risposta indicherà nome del file, dimensione e file.

{ "data": 
    {
    "nome": "6564a673ccfa313352066377.zip",
    "dimensione": 1728,
    "file": "UEsDBBQAAAAlNnVTBs6lJ1vIIAJthCQAcABwANjI2OTFjNGY5N2UwOTQ0NzU0MDI3ADU/HOUbc+WLQqnnTtt27Zt27Zt25k7bdu2bdvcadv5fnXOqapz655qt9p93x/vW62tFjHnGmv2HiMiZvQxY7RJIi8sSsNAywxFcnA4uwjFgE+Pb2doCcXNTSdqYe1s4kgnam3gbCJsYmRnbEInbWJr5"
      }

 

RICHIESTA CERTIFICATI CAMERALI CON VISENGINE

Visengine consente di accedere a tutti i Certificati Camerali:

  • Iscrizione
  • Vigenza
  • Storico
  • Artigiano

Inoltre è possibile richiedere anche tutte le opzioni disponibili:

  • Spedizione Certificato in Carta Filigranata
  • In Inglese
  • Urgenza

1) Richiedere Hash Certificati (GET /visure)

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.

2) Verificare dati e costi richiesta Certificati (GET /visure/{hash_visura})

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.

ESEMPIO RICHIESTA GET /visure/{hash_visura}

Per verificare campi e costi per completare la richiesta dovremmo utilizzare l'hash che abbiamo ottenuto nella richiesta precedente.

https://visengine2.altravia.com/visure/fab482bf67a418f00d596b7296750a9a


ESEMPIO RISPOSTA GET /visure/{hash_visura}

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

3) Richiedere certificato POST /richiesta

Nel nostro caso per completare la richiesta del Certificato abbiamo scelto di passare la partita IVA dell'azienda.

ESEMPIO RICHIESTA POST /richiesta

{
    "hash_visura": "fab482bf67a418f00d596b7296750a9a",
    "json_visura": {
      "$1": 12485671007
      }
  }


ESEMPIO RISPOSTA POST /richiesta

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


4) Scaricare certificato GET /documento/{_id}

Una volta che lo stato della richiesta è in stato "evasa" è possibile scaricare il documento tramite metodo GET /documento/{_id}

ESEMPIO RICHIESTA GET /documento/{_id}

Questo è un esempio di richiesta utilizzando l'ID precedentemente ottenuto

https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e


ESEMPIO RISPOSTA GET /documento/{_id}

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.

Le nostre tariffe

Listino prezzi a chiamata

  • Certificati Camerale di Iscrizione € 12,70 + iva
  • Certificati Camerale con Vigenza € 15,70 + iva
  • Certificato Artigiano € 12,70 + iva
  • Certificato Camerale Storico € 19,70 + iva
  • Opzione con Vigenza € 3,00 + iva
  • Opzione Stampa in Carta Filigranata e Spedizione € 7,90 + iva
  • Opzione urgenza € 6,70 + iva
  • Opzione versione Inglese € 3,00 + iva