Servizi Contratti di Locazione
0,001 € + IVA
Automatizza la registrazione, disdetta e proroga locazione tramite i nostri service. La procedura telematica ha lo stesso valore di quella effettuata allo sportello Agenzia delle Entrate e riceverai ricevuta ufficiale.
Openapi consente di accedere tramite API a tutti i principali servizi associati alla locazione, in particolare è possibile completare le seguenti pratiche:
- Registrazione contratti di locazione
- Disdetta contratti di locazione
- Proroga contratti di locazione
Il servizio consente di gestire le diverse tipologie di Contratti di Locazione:
- abitativo a canone libero
- abitativo a canone convenzionato
- abitativo di natura transitoria
- contratto di affitto transitorio per studenti fuori sede
- ad uso diverso da quello abitativo
Il servizio viene erogato tramite API direttamente da un professionista abilitato e le tempistiche, trattandosi di lavorazioni svolte manualmente da operatori, dipendono dalla complessità della pratica. Openapi garantisce che l'intero processo avvenga nel pieno rispetto della normativa vigente in materia di privacy, con logiche di minimizzazione e cifrature dei dati.
Servizi Contratti di Locazione
A titolo di esempio vedremo come gestire tramite API la registrazione di un contratto di locazione.
RICHIESTA REGISTRAZIONE CONTRATTO DI LOCAZIONE
GET /visure
Per procedere alla registrazione del contratto di locazione 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 oltre al rispettivo hash.
VERIFICARE COSTI E DATI
ESEMPIO RICHIESTA
GET /visure/{hash_visura}
Per verificare le informazioni, i documenti necessari ed i costi del documento è necessario effettuare una richiesta tramite l'endpoint GET /visure/{hash_visura} e passare l'hash del documento precedentemente ottenuto.
https://visengine2.altravia.com/visure/38934ffe45179c4d5b88e2a6b849799aESEMPIO RISPOSTA
GET /visure/{hash_visura}
La risposta indicherà tutte le informazioni necessarie per completare la richiesta del documento come ad esempio i campi obbligatori.
{
"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
}In validazione sono indicati il dato o i dati obbligatori per completare la richiesta con successo.
RICHIEDERE LA REGISTRAZIONE
ESEMPIO RICHIESTA
POST /richiesta
Nel payload della richiesta, dobbiamo passare tutte le informazioni e i documenti indicati in precedenza.
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": "e9dc845edf4ab2e2a3f06807a578126a",
"nome": "Registrazione Contratti Affitto",
"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"
}SCARICARE DOCUMENTO
Una volta che lo stato della richiesta è in "evaso" è 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
}Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
I servizi Contratti di locazione consentono di gestire la procedura di registrazione, proroga, disdetta di un contratto di affitto presso l’Agenzia delle Entrate, tutto tramite API. Il servizio a fine procedura metterà a disposizione del richiedente la ricevuta ufficiale dell’Agenzia delle Entrate
Il servizio consente di gestire qualsiasi tipologia di contratto di locazione
Il servizio Contratti di Locazione è ideale per chi necessita di automatizzare un processo manuale e ottimizzare le tempistiche di gestione pratica. Può essere integrato in software immobiliari o di commercialisti, gestionali CAF e Patronato o tutte quelle piattaforme o portali che richiede la gestione dei contratti di affitto al fine di semplificare la gestione e la registrazione dei contratti di locazione
Si tramite le API di Openapi è possibile accedere ad oltre 28 servizi dedicati al mondo immobiliare:
- CAP
- Cerca Comuni
- Comuni Base e Advanced
- Province, Regioni e città metropolitane
- Comuni Soppressi
- Geocoding e reverse geocoding
- Quotazione Immobiliare Start e Advanced (SMQ)
- Compravendite Immobiliari (RMV)
- Elenco Immobili da identificativi catastali e da indirizzo
- Ricerca Persona e Ricerca Nazionale
- Prospetto Catastale
- Visure Catastali
- Ispezione Ipotecaria Nazionale
- Ispezione Ipotecaria per Immobile e Soggetto
- Ispezione Ipotecaria per Singola Nota
- Planimetria Catastale
- Estratto di Mappa
- Elaborato Planimetrico
I servizi sono disponibili tramite differenti API: Docuengine, Catasto, Real Estate
Il documento viene reso disponibili in 24 ore lavorative
Il costo del servizio è 13,70€ con addebito su ricarica
Energia pulita per il nostro cloud 
Low CO2
Openapi SpA Unipersonale - Società sottoposta a direzione e controllo della Open Holding Srl - Viale Filippo Tommaso Marinetti 221 - 00143 Roma - REA 1378273 Cap. Soc. € 50.000,00 i.v. – P.I. IT12485671007 - CODICE DESTINATARIO 'USAL8PV' - PEC: 
Openapi è certificata: Sistema qualità – UNI EN ISO 9001:2015 -Qualità dei Dati ISO 25012:2014 - Gestione della Sicurezza ISO/IEC 27001:2022
Tutti i prezzi sono da considerarsi al netto di eventuale IVA, eventuali imposte di bollo, diritti di segreteria e/o imposte o tasse altrimenti denominate se dovute. Tutti i loghi elencati nel portale sono coperti da copyright e di proprietà dei rispettivi proprietari.
