DocuEngine

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.

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.

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.

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
}