0,001 € + TVA
Automatisez l'enregistrement, la résiliation et la prolongation du bail grâce à nos services. La procédure télématique a la même valeur que celle effectuée au guichet de l'Agenzia delle Entrate et vous recevrez un reçu officiel.
Openapi permet d'accéder via API à tous les principaux services associés à la location, en particulier il est possible de compléter les démarches suivantes :
Le service permet de gérer les différents types de Contrats de Location :
Le service est fourni via API directement par un professionnel habilité et les délais, étant donné qu'il s'agit de traitements effectués manuellement par des opérateurs, dépendent de la complexité de la démarche. Openapi garantit que l'ensemble du processus se déroule dans le respect total de la législation en vigueur en matière de confidentialité, avec des logiques de minimisation et de chiffrement des données.
À titre d'exemple, voyons comment gérer via API l'enregistrement d'un contrat de location
GET /visure
Pour procéder à l'enregistrement du contrat de location via l'API Visengine, il est d'abord nécessaire d'identifier le hash qui identifie de manière unique chaque document ou démarche.
https://visengine2.altravia.com/visure/
Cela est possible via l'endpoint GET /visure qui ne nécessite pas de paramètres et renverra la liste complète des documents et démarches demandables via Visengine et leur hash respectif.
GET /visure/{hash_visura}
Pour vérifier les informations, les documents nécessaires et les coûts de l'enregistrement du contrat de location, il est nécessaire de faire une demande via l'endpoint GET /visure/{hash_visura} et de passer le hash de l'enregistrement de location obtenu précédemment.
GET /visure/{hash_visura}
Pour vérifier les champs et les coûts pour compléter la demande, nous devons utiliser le hash que nous avons obtenu dans la demande précédente.
https://visengine2.altravia.com/visure/e9dc845edf4ab2e2a3f06807a578126a
GET /visure/{hash_visura}
La réponse indiquera toutes les informations nécessaires pour compléter la demande d'enregistrement, comme par exemple les champs obligatoires.
{
"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
}
En validation sont indiquées les données obligatoires pour compléter la demande avec succès.
POST /richiesta
Dans le payload de la demande, nous devons passer toutes les informations et les documents indiqués précédemment.
POST /richiesta
La réponse renvoie plusieurs informations, y compris l'état, si le callback est configuré et l'ID de la demande, qui sera nécessaire par la suite pour télécharger le document.
{ "data":
{
"_id": "5f2829ce065afc21cc60ad0e",
"state": 1,
"hash_visura": "e9dc845edf4ab2e2a3f06807a578126a",
"nome": "Enregistrement Contrats de Location ",
"ricerca": false,
"id_ricerca": null,
"prezzo_visura": 12.7,
"prezzo_ricerca": 0,
"indice_ricerca": null,
"stato_richiesta": "En cours de traitement",
"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": "Recherche effectuée",
"json_ricerca": "{\"$1\":\"12485671007\"}",
"json_mappato": {
"NRea": "1378273",
"Cciaa": "RM"
},
"json_risultato": null
}
],
"esito": {
"codice": "0",
"info": "OK"
}
GET /documento/{_id}
Une fois que l'état de la demande est "complété", il est possible de télécharger le document via la méthode GET /documento/{_id}.
GET /documento/{_id}
Ceci est un exemple de demande utilisant l'ID obtenu précédemment
https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e
GET /documento/{_id}
La réponse contiendra le nom, la taille et le fichier.
{
data{
"nome":"5f22f5b5065afc21cc60a27a.zip",
"dimensione"10206",
"file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
},
"success": true,
"message": "",
"error": null
}
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
Les Services Contrats de Location permettent de gérer la procédure d'enregistrement, de prorogation et de résiliation d'un contrat de location auprès de l'Agence des Revenus, tout cela via des API. À la fin de la procédure, le service fournit au demandeur le reçu officiel de l'Agence des Revenus.
Le service permet de gérer tout type de contrat de location.
Le service Contrats de Location est idéal pour ceux qui souhaitent automatiser un processus manuel et optimiser le temps de gestion des contrats de location. Il peut être intégré dans des logiciels immobiliers ou comptables, des systèmes de gestion CAF et Patronage, ou toute plateforme ou portail nécessitant la gestion des contrats de location pour simplifier leur gestion et leur enregistrement.
Oui, via les API d'Openapi, vous pouvez accéder à plus de 28 services dédiés au secteur immobilier :
Ces services sont disponibles via différentes API : Docuengine, Cadastre, Immobilier.
Le document est disponible dans un délai de 24 heures ouvrables.
Le coût du service est de 13,70 € avec un paiement prépayé.