Visengine

Tutti i documenti ufficiali di Camera di Commercio, INPS e Agenzia delle Entrate.

Ottieni in tempo reale i documenti certificati su aziende, persone, immobili.

Tutte le informazioni di cui hai bisogno

Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.

Utili consigli per iniziare con Visengine

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.

Ottieni l'elenco dei servizi disponibili

Visengine offre molti tipi di servizi, per ottenerne un elenco basta una chiamata a /visure.
Il risultato conterrà un elenco di documenti disponibli identificati da un nome, una categoria e un hash (ovvero un identificativo univoco del tipo di documento)
Effettuando una successiva chiamata allo stesso endpoint ma passando l'hash come parametro "path" es: Visengine offre molti tipi di servizi, per ottenerne un elenco basta una chiamata a /visure/{hash_visura} si otterranno una serie di informazioni relativi al servizio richiesto come prezzo del documento, prezzo della ricerca (se presente), elenco dei campi di input con relativa spiegazione ed istruzioni per la validazione.
Presta attenzione all'elenco dei "campi" in "json_struttura" perchè in base alle regole di validazioni saranno i campi necessari da compilare in fase di richiesta.

Hai scelto quale servizio vuoi interrogare? Effettua la tua prima richiesta!

Ora che conosciamo l'hash del documento che intendiamo richiedere passiamo a preparare la nostra richiesta /richiesta.
I dati minimi necessari sono infatti "hash_visura" di cui abbiamo parlato e "json_visura" che consiste nei dati di input del servizio.
Nel seguente esempio stiamo richiedendo una "Visura Camerale Ordinaria - società di Capitale" indicando che il campo "$1" ovvero "Cciaa" è uguale a "RM" (camera di commercio di Roma) ed il campo "$0" ovvero "NRea" (codice rea) uguale a 1378273. La spiegazione dei campi presenti in ogni visura è ottenibile allo step precedente
{
	"hash_visura": "eccbc87e4b5ce2fe28308fd9f2a7baf3",
	"json_visura": {
		"$1": "RM",
		"$0": "1378273"
	}
}
Si consiglia caldamente di compilare anche la sezione callback_data per ricevere in maniera asincrona gli aggiornamenti di stato della richiesta visto che i tempi di risposta possono variare in base al tipo di documento.
La risposta che si otterrà conterrà un campo "_id" che rappresenta l'identificativo univoco della richiesta oltre ad informazioni sullo stato e (se presenti) eventuali risultati multipli tra i quali scegliere.
Questo scenario è possibile quando a fronte dell'inserimento di una richiesta sono disponibili più documenti come nel caso dei bilanci in cui è possibile selezionare l'anno di riferimento o nel caso di ricerche catastali a partire da un codice fiscale è possible selezionare per quale immobile di proprietà si vuole ottenere la visura. Solo in questo secondo caso sarà necessaria una successiva richiesta in "PUT" /richiesta indicando l'id della richiesta nel "path", l'id della ricerca e l'indice selezionato nel body.

Scarica il documento una volta pronto!

Appena la richiesta raggiunge lo stato di "visura_evasa" diventa disponibile il documento per il download.
Basta una chiamata a /documento.
Il risultato conterrà il nome del file originale (un file .zip contenente uno o più .pdf), la dimensione del file ed il suo contenuto in formato base64.
{
  "data": {
    "nome": "5f22f5b5065afc21cc60a27a.zip",
    "dimensione": 10206,
    "file": "++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjY..."
  },
  "success": true,
  "message": "",
  "error": null
}