€0.001 + VAT
Automate the registration, termination and extension of tenancy through our services. The telematic procedure has the same value as that carried out at the Agenzia delle Entrate counter and you will receive an official receipt.
Openapi allows access via API to all major services related to leasing, specifically it is possible to complete the following procedures:
The service allows managing different types of Lease Contracts:
The service is provided via API directly by an authorized professional, and the timelines, being manual processes carried out by operators, depend on the complexity of the case. Openapi ensures that the entire process is carried out in full compliance with current privacy regulations, with data minimization and encryption practices.
As an example, we will see how to manage the registration of a lease contract via API.
GET /visure
To proceed with the registration of the lease contract via the Visengine API, it is first necessary to identify the hash that uniquely identifies each document or case.
https://visengine2.altravia.com/visure/
This is possible through the endpoint GET /visure, which does not require parameters and will return the complete list of documents and cases available through Visengine and their respective hashes.
To verify the information, necessary documents, and costs of the Lease Contract Registration, it is necessary to make a request via the endpoint GET /visure/{hash_visura} and provide the hash of the lease registration previously obtained.
GET /visure/{hash_visura}
To check fields and costs for completing the request, we should use the hash obtained in the previous request.
https://visengine2.altravia.com/visure/e9dc845edf4ab2e2a3f06807a578126a
GET /visure/{hash_visura}
The response will indicate all the necessary information to complete the registration request, such as required fields.
{
"data": {
"hash_visura": "e9dc845edf4ab2e2a3f06807a578126a",
"json_struttura": {
"campi": {
"$0": {
"nome": "Codice fiscale Privato richiedente (da compilare se Privato)",
"tipo": "codice_fiscale_persona_fisica",
"ordine": "18",
"null": "1"
},
"$1": {
"nome": "Ufficio Territoriale presso cui registrare il contratto e competente per i successivi adempimenti",
"tipo": "ufficio_territoriale",
"ordine": "4"
},
"$2": {
"nome": "Tipologia contratto di locazione",
"tipo": "radio",
"opzioni": {
"L1": "L1-Locazione di immobile ad uso abitativo",
"L2": "L2-Locazione agevolata di immobile ad uso abitativo",
"L3": "L3-Locazione di immobile ad uso abitativo (contratto assoggettato ad IVA)",
"L4": "L4-Locazione finanziaria di immobile ad uso abitativo",
"S1": "S1-Locazione di immobile ad uso diverso dall`abitativo",
"S2": "S2-Locazione di immobile strumentale con locatore soggetto ad IVA",
"S3": "S3-Locazione Finanziaria di immobile ad uso diverso dall`abitativo",
"T1": "T1-Affitto di fondo rustico",
"T2": "T2-Affitto di fondo rustico agevolato",
"T3": "T3-Affitto di terreni ed aree non edificabili, cave e torbiere",
"T4": "T4-Affitto di terreni edificabili o non edificabili destinati a parcheggio (contratto assoggettato ad IVA)"
},
"ordine": "0"
},
"$3": {
"nome": "Decorrenza del contratto da",
"tipo": "data_iso8601",
"opzioni": {
"min": "1800-01-01",
"max": "2100-12-31"
},
"ordine": "2"
},
"$4": {
"nome": "al",
"tipo": "data_iso8601",
"opzioni": {
"min": "1800-01-01",
"max": "2100-12-31"
},
"ordine": "3"
},
"$5": {
"nome": "Numero pagine contratto",
"tipo": "intero",
"opzioni": {
"min": "1"
},
"ordine": "5"
},
"$6": {
"nome": "Numero copie del contratto di locazione (min. 1)",
"tipo": "intero",
"opzioni": {
"min": "1"
},
"ordine": "6"
},
"$7": {
"nome": "Importo canone annuo (es. 100.50) o, in caso di contratti di durata inferiore a un anno, l’importo relativo all`intera durata",
"tipo": "decimale",
"opzioni": {
"min": "0,00"
},
"ordine": "7"
},
"$8": {
"nome": "Data di stipula del contratto",
"tipo": "data_iso8601",
"ordine": "1"
},
"$9": {
"nome": "Allega Contratto di Locazione (grandezza max file da caricare 5 MB)",
"tipo": "file",
"ordine": "36"
},
"$10": {
"nome": "IBAN per assolvere l’imposta di registro e quella di bollo (non necessario se contratto in regime di cedolare secca)",
"tipo": "testo",
"null": "1",
"ordine": "21"
},
"$11": {
"nome": "Contatto Telefonico Richiedente in caso di richiesta informazioni aggiuntive",
"tipo": "denominazione",
"null": "0",
"ordine": "34"
},
"$12": {
"nome": "Contatto Email Richiedente in caso di richiesta informazioni aggiuntive",
"tipo": "email",
"null": false,
"ordine": "35"
},
"$13": {
"nome": "Provincia dove è presente l`immobile",
"tipo": "cod_provincia",
"null": false,
"ordine": "8"
},
"$14": {
"nome": "Comune dove è presente l`immobile",
"tipo": "cod_comune",
"null": false,
"ordine": "9"
},
"$15": {
"nome": "Indirizzo dell`immobile",
"tipo": "testo",
"null": false,
"istruzioni": "Inserire Indirizzo e numero numero civico",
"ordine": "10"
},
"$16": {
"nome": "Foglio Catastale",
"tipo": "catastale_foglio",
"null": false,
"ordine": "11"
},
"$17": {
"nome": "Particella",
"tipo": "catastale_particella",
"null": false,
"ordine": "12"
},
"$18": {
"nome": "Subalterno",
"tipo": "catastale_sub",
"null": false,
"ordine": "13"
},
"$19": {
"nome": "Rendita Catastale",
"tipo": "decimale",
"null": false,
"ordine": "14"
},
"$20": {
"nome": "Categoria Catastale",
"tipo": "radio",
"null": false,
"opzioni": {
"A": "Selezionare la categoria catastale",
"A1": "A/1 Abitazioni di tipo signorile",
"A2": "A/2 Abitazioni di tipo civile",
"A3": "A/3 Abitazioni di tipo economico",
"A4": "A/4 Abitazioni di tipo popolare",
"A5": "A/5 Abitazioni di tipo ultrapopolare",
"A6": "A/6-Abitazioni di tipo rurale",
"A7": "A/7 Abitazioni in villini",
"A8": "A/8 Abitazioni in ville",
"A9": "A/9 Castelli, palazzi di eminenti pregi artistici o storici",
"A10": "A/10 Uffici e studi privati",
"A11": "A/11 Abitazioni ed alloggi tipici dei luoghi",
"B1": "B/1 Collegi e convitti, educandati; ricoveri; orfanotrofi; ospizi; conventi; seminari; caserme",
"B2": "B/2 Case di cura ed ospedali [senza fine di lucro]",
"B3": "B/3 Prigioni e riformatori",
"B4": "B/4 Uffici pubblici",
"B5": "B/5 Scuole e laboratori scientifici",
"B6": "B/6 Biblioteche, pinacoteche, musei, gallerie, accademie che non hanno sede in edifici della categoria A/9",
"B7": "B/7 Cappelle ed oratori non destinati all’esercizio pubblico del culto",
"B8": "B/8 Magazzini sotterranei per depositi di derrate",
"C1": "C/1 Negozi e botteghe",
"C2": "C/2 Magazzini e locali di deposito",
"C3": "C/3 Laboratori per arti e mestieri",
"C4": "C/4 Fabbricati e locali per esercizi sportivi",
"C5": "C/5 Stabilimenti balneari e di acque curative",
"C6": "C/6 Stalle, scuderie, rimesse, autorimesse",
"C7": "C/7 Tettoie chiuse od aperte",
"D1": "D/1 Opifici",
"D2": "D/2 Alberghi e pensioni [con fini di lucro]",
"D3": "D/3 Teatri, cinematografi, sale per concerti e spettacoli e simili [con fine di lucro]",
"D4": "D/4 Case di cura ed ospedali [con fine di lucro]",
"D5": "D/5 Istituto di credito, cambio e assicurazione [con fine di lucro]",
"D6": "D/6 Fabbricati e locali per esercizi sportivi [con fine di lucro]",
"D7": "D/7 Fabbricati costruiti o adattati per le speciali esigenze di un`attività industriale e non suscettibili di destinazione diversa senza radicali trasformazioni.",
"D8": "D/8 Fabbricati costruiti o adattati per le speciali esigenze di un`attività commerciale e non suscettibili di destinazione diversa senza radicali trasformazioni.",
"D9": "D/9 Edifici galleggianti o sospesi assicurati a punti fissi del suolo, ponti privati soggetti a pedaggio",
"D10": "D/10 Fabbricati per funzioni produttive connesse alle attività agricole",
"E1": "E/1 Stazioni per servizi di trasporto, terrestri, marittimi ed aerei",
"E2": "E/2 Ponti comunali e provinciali soggetti a pedaggio",
"E3": "E/3 Costruzioni e fabbricati per speciali esigenze pubbliche",
"E4": "E/4 Recinti chiusi per speciali esigenze pubbliche",
"E5": "E/5 Fabbricati costituenti fortificazioni e loro dipendenze",
"E6": "E/6 Fari, semafori, torri per rendere d’uso pubblico l’orologio comunale",
"E7": "E/7 Fabbricati destinati all’esercizio pubblico dei culti",
"E8": "E/8 Fabbricati e costruzioni nei cimiteri, esclusi i colombari, i sepolcri e le tombe di famiglia",
"E9": "E/9 Edifici a destinazione particolare non compresi nelle categorie precedenti del gruppo E.",
"F1": "F/1 Aree urbane",
"F2": "F/2 Unita` collabenti",
"F3": "F/3 Unita` in corso di costruzione",
"F4": "F/4 Unita` in corso di definizione",
"F5": "F/5 Lastrici solari"
},
"ordine": "15"
},
"$21": {
"nome": "Regime Fiscale",
"tipo": "radio",
"null": "0",
"opzioni": {
"A": "Selezionare il Regime Fiscale",
"B": "Regime Ordinario IRPEF",
"C": "Regime a Cedolare Secca"
},
"ordine": "19"
},
"$22": {
"nome": "Codice Fiscale Persona Giuridica richiedente (da compilare se Persona Giuridica, ad esempio azienda)",
"tipo": "codice_fiscale_persona_giuridica",
"null": "1",
"ordine": "17"
},
"$23": {
"nome": "Nome Intestatario Conto associato all`IBAN (non necessario se contratto in regime di cedolare secca)",
"tipo": "denominazione",
"null": "1",
"ordine": "20"
},
"$24": {
"nome": "Nome e Cognome Richiedente",
"tipo": "denominazione",
"null": false,
"ordine": "16"
},
"$25": {
"nome": "Nome e Cognome Locatore",
"tipo": "denominazione",
"null": "0",
"ordine": "22"
},
"$26": {
"nome": "Codice Fiscale Locatore",
"tipo": "codice_fiscale",
"null": "0",
"ordine": "23"
},
"$27": {
"nome": "Nome e Cognome Altro Locatore (Da compilare solo se presente)",
"tipo": "denominazione",
"null": "1",
"ordine": "24",
"istruzioni": "Completare il campo solo se presente secondo locatario"
},
"$28": {
"nome": "Codice Fiscale Altro Locatore (Da compilare solo se presente)",
"tipo": "codice_fiscale",
"null": "1",
"ordine": "25",
"istruzioni": "Completare il campo solo se presente secondo locatario"
},
"$29": {
"nome": "Nome e Cognome Altro Locatore (Da compilare solo se presente)",
"tipo": "denominazione",
"null": "1",
"ordine": "26"
},
"$30": {
"nome": "Codice Fiscale Altro Locatore (Da compilare solo se presente)",
"tipo": "codice_fiscale",
"null": "1",
"ordine": "27"
},
"$31": {
"nome": "Nome e Cognome Conduttore",
"tipo": "denominazione",
"null": "0",
"ordine": "28"
},
"$32": {
"nome": "Codice Fiscale Conduttore",
"tipo": "codice_fiscale",
"null": "0",
"ordine": "29"
},
"$33": {
"nome": "Nome e Cognome Altro Conduttore (Da compilare solo se presente)",
"tipo": "denominazione",
"null": "1",
"ordine": "30"
},
"$34": {
"nome": "Codice Fiscale Altro Conduttore (Da compilare solo se presente)",
"tipo": "codice_fiscale",
"null": "1",
"ordine": "31"
},
"$35": {
"nome": "Nome e Cognome Altro Conduttore (Da compilare solo se presente)",
"tipo": "denominazione",
"null": "1",
"ordine": "32"
},
"$36": {
"nome": "Codice Fiscale Altro Conduttore (Da compilare solo se presente)",
"tipo": "codice_fiscale",
"null": "1",
"ordine": "33"
}
},
"validazione": "($1 && $2 && $3 && $4 && $5 && $6 && $7 && $8 && $9 && $11 && $12 && $13 && $14 && $15 && $16 && $17 && $18 && $19 && $20 && $21&& $24) && (($0 && $10 && $23) || ($0) ||($10 && $23 && $22) || ($22)) && (($25 && $26 && $31 && $32) || ($25 && $26 && $27 && $28 && $31 && $32) ||($25 && $26 && $27 && $28 && $29 && $30 && $31 && $32)||($25 && $26 && $27 && $28 && $29 && $30 && $31 && $32 && $33 && $34) ||($25 && $26 && $27 && $28 && $29 && $30 && $31 && $32 && $33 && $34 && $35 && $36) || ($25 && $26 && $31 && $32 && $33 && $34) || ($25 && $26 && $31 && $32 && $33 && $34 && $35 && $36) || ($25 && $26 && $27 && $28 && $31 && $32 && $33 && $34) || ($25 && $26 && $27 && $28 && $31 && $32 && $33 && $34 && $35 && $36))",
"istruzioni": "PHA+Q29tcGxldGFyZSBjb3JyZXR0YW1lbnRlIGlsIGZvcm0uIFR1dHRpIGkgZGF0aSBzb25vIG9iYmxpZ2F0b3JpIGVjY2V0dG8gbCYjMzk7SUJBTiBlIE5vbWUgSW50ZXN0YXRyaW8gQ29udG8gKG9iYmxpZ2F0b3JpIHNvbG8gcGVyIHJlZ2ltZSBmaXNjYWxlIG9yZGluYXJpbykuIENvbXBpbGFyZSBzb2xvIGlsIGNhbXBvIGNvZGljZSBmaXNjYWxlIGNvcnJpc3BvbmRlbnRlIGFsbGEgdGlwb2xvZ2lhIGRpIHBlcnNvbmEmbmJzcDsocHJpdmF0byBvIGdpdXJpZGljYSkmbmJzcDs8L3A+DQo=",
"istruzioni_ricerca": ""
},
"nome_categoria": "Catastali",
"nome_visura": "Registrazione Contratti Affitto",
"opzioni": null,
"prezzo_ricerca": 0,
"prezzo_visura": 13.7,
"ricerca": false,
"sincrona": false,
},
"success": true,
"message": "",
"error": null
}
Validation indicates the mandatory data required to successfully complete the request.
POST /richiesta
In the request payload, we need to pass all the previously indicated information and documents.
POST /richiesta
The response returns various pieces of information including the status, whether the callback is set, and the request ID that will be needed later to download the document.
{ "data":
{
"_id": "5f2829ce065afc21cc60ad0e",
"state": 1,
"hash_visura": "e9dc845edf4ab2e2a3f06807a578126a",
"name": "Registrazione Contratti Affitto",
"search": false,
"search_id": null,
"survey_price": 12.7,
"search_price": 0,
"search_index": null,
"request_status": "In processing",
"target_email": null,
"attachments": [],
"timestamp_creation": 1596467662,
"timestamp_last_update": 1596467663,
"timestamp_status": {
"in_search": 1596467663,
"in_processing": 1596467663
},
"callback_data": false,
"options": null,
"owner": "[email protected]",
"synchronous": false,
"searches": [
{
"search_id": "5f2829ce065afc21cc60ad0e_0",
"search_status": "Search completed",
"search_json": "{\"$1\":\"12485671007\"}",
"mapped_json": {
"NRea": "1378273",
"Cciaa": "RM"
},
"result_json": null
}
],
"outcome": {
"code": "0",
"info": "OK"
}
Once the request status is "completed", it is possible to download the document via the GET /document/{_id} method
GET /documento/{_id}
This is an example of a request using the previously obtained ID
https://visengine2.altravia.com/visure/document/5f2829ce065afc21cc60ad0e
GET /document/{_id}
The response will include the name, size, and file.
{
data{
"name":"5f22f5b5065afc21cc60a27a.zip",
"size":"10206",
"file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
},
"success": true,
"message": "",
"error": null
}
Do you need help?
Haven't found the answer you're looking for?
Fill in all the details, we will get back to you as soon as possible!
The Rental Contract Services allow you to manage the process of registering, renewing, and terminating a rental contract with the Revenue Agency, all through APIs. At the end of the procedure, the service provides the requester with the official receipt from the Revenue Agency.
The service supports the management of any type of rental contract
The Rental Contract Services are ideal for those who need to automate a manual process and optimize the management time of rental contracts. It can be integrated into real estate or accounting software, CAF and Patronage management systems, or any platform or portal that requires the management of rental contracts to simplify their management and registration.
Yes, through Openapi’s APIs, you can access over 28 services dedicated to the real estate sector:
These services are available through different APIs: Docuengine, Cadastre, Real Estate.
The document is made available within 24 working hours.
The cost of the service is €13.70 with prepaid charge.