Con il service Visure Camerali è possibile ottenere la visura ordinaria o storica di un’impresa individuale, una società di capitale o una società di persone. È l'unico che consente di ricercare Gratuitamente l’azienda di proprio interesse e verificare le visure disponibili, prima di effettuare la richiesta della visura.
Il ws è strutturato come segue:
Ricerca (GET /impresa)
Come indicato sopra, questa chiamata è gratuita e dà la possibilità di trovare un’impresa attraverso parametri come denominazione, provincia, codice ATECO, numero di dipendenti (min. e max), fatturato (min. e max.) e coordinate geografiche.
In questa fase è possibile sapere immediatamente la natura giuridica dell'impresa e quali sono le visure richiedibili per quell'azienda.
{
"data": [
{
"id": "61f2d9978e5bb376ab1c85d6",
"denominazione": "OPENAPI S.R.L.",
"comune": "ROMA",
"codice_natura_giuridica": "SR",
"chiamate_disponibili": [
"visurecamerali.openapi.it/ordinaria-societa-capitale",
"visurecamerali.openapi.it/storica-societa-capitale"
]
}
],
"success": true,
"message": "",
"error": null;
}
Genera Richiesta (GET /ordinaria-societa-capitale)
Una volta effettuata la ricerca gratuita, si può proseguire con il generare la richiesta per la tipologia di visura di proprio interesse.
Le visure camerali disponibili tramite web service sono le seguenti:
- Visura ordinaria imprese individuali
- Visura ordinaria società di capitali
- Visura ordinaria società di persone
- Visura storica imprese individuali
- Visura storica società di capitali
- Visura storica società di persone
I dati da inserire per la richiesta sono: Codice Fiscale / Partita Iva / ID Azienda (l'ID Azienda è quello ottenuto in fase di Ricerca).
{
"data": {
"cf_piva_id": "12485671007",
"tipo": "ordinaria-societa-capitale",
"stato_richiesta": "In erogazione",
"timestamp_creation": 1649683350,
"timestamp_last_update": 1649683350,
"allegati": [],
"callback": false,
"owner": "[email protected]",
"id": "625fec9313ddfc09f11c47e2"
},
"message": "",
"success": true,
"error": null
}
Specifica Richiesta (GET /ordinaria-societa-capitale/{id})
Con questo metodo è possibile visualizzare la richiesta identificata dall'id creato con il metodo “Genera richiesta”.
La chiamata permette poi di vedere tutto l'oggetto della richiesta tra cui lo stato, il timestamp, la presenza dell'allegato etc.
Di seguito lo snippet di codice della richiesta di una visura camerale ordinaria per società di capitale. Questo è solo un esempio, è possibile ottenere anche gli altri tipi di visura.
{
"data": {
"cf_piva_id": "12485671007",
"tipo": "ordinaria-societa-capitale",
"stato_richiesta": "Dati disponibili",
"timestamp_creation": 1649683350,
"timestamp_last_update": 1649688928,
"allegati": [
"625fec93fb8ca84347057795.pdf"
],
"callback": false,
"owner": "[email protected]",
"id": "625fec9313ddfc09f11c47e2"
},
"success": true,
"message": "",
"error": null
}
Scarica il documento (GET /ordinaria-societa-capitale/{id}/allegati)
La visura ufficiale della Camera di Commercio ottenuta tramite la richiesta effettuata nello step precedente può essere poi scaricata come zip, contenente al suo interno un pdf.
{
"data": {
"nome": "625fec93fb8ca84347057795.zip",
"dimensione": 586660,
"file": "UEsDBBQAAAAIABFOllTBs6lJ1vIIAJthCQAcABwANjI1ZmVjOTNmYjhjYTg0MzQ3MDU3Nzk1LnBkZlVUCQAD8nliYvJ5YmJ1eAsAAQQhAAAABCEAAACMvFO0ME0PNfgc27Zt27Zt27Zt27Zt27Zt+5x5v39mruZm7tLpZNfu6qyqpFZ3SOSFRWkYaNkgScau4w/HOUbc+WLQqnnTtt27Zt27Zt25k7bdu2bdvcadv5fnXOqapz655qt9p93x/vW62tFjHnGmv2HiMiZvQxY7RJIi8sSsNAywxFcnA4uwjFgE+Pb2doCcXNTSdqYe1s4kgnam3gbCJsYmRnbEInbWJr5"
},
"success": true,
"message": "",
"error": null
}
Verifica Richieste (GET /ordinaria-societa-capitale)
Infine è consentito effettuare una verifica delle richieste completate precedentemente, con i dettagli delle stesse.
{
"data": [
{
"cf_piva_id": "12485671007",
"tipo": "ordinaria-societa-capitale",
"stato_richiesta": "In erogazione",
"timestamp_last_update": 1650550461,
"owner": "[email protected]",
"id": "626166bd20a96b3711585590"
},
{
"cf_piva_id": "12485671007",
"tipo": "ordinaria-societa-capitale",
"stato_richiesta": "Dati disponibili",
"timestamp_last_update": 1650454028,
"owner": "[email protected]",
"id": "625fec9313ddfc09f11c47e2"
}
],
"success": true,
"message": "",
"error": null
}
È inoltre possibile richiedere anche la Visura Camerale in Inglese però tramite le API Visengine.
