0,001 € + MwSt
Automatisieren Sie die Anmeldung, Beendigung und Verlängerung des Mietverhältnisses durch unsere Dienste. Das telematische Verfahren hat den gleichen Wert wie das am Schalter der Agenzia delle Entrate durchgeführte und Sie erhalten eine offizielle Quittung.
Openapi ermöglicht den Zugriff über APIs auf alle wesentlichen Dienste im Zusammenhang mit der Mietverwaltung. Insbesondere können die folgenden Vorgänge abgeschlossen werden:
Der Service ermöglicht die Verwaltung der verschiedenen Arten von Mietverträgen:
Der Service wird über APIs direkt von einem autorisierten Fachmann bereitgestellt, und die Zeitrahmen hängen von der Komplexität des Vorgangs ab, da die Arbeiten manuell von Fachleuten durchgeführt werden. Openapi gewährleistet, dass der gesamte Prozess unter vollständiger Einhaltung der geltenden Datenschutzbestimmungen mit Datenminimierung und Verschlüsselung erfolgt.
Als Beispiel zeigen wir, wie man die Registrierung eines Mietvertrages über die API verwaltet.
GET /visure
Um die Registrierung des Mietvertrages über die Visengine API fortzusetzen, ist es zunächst erforderlich, den Hash zu ermitteln, der jedes Dokument oder jede Anfrage eindeutig identifiziert.
https://visengine2.altravia.com/visure/
Dies ist über den Endpunkt GET /visure möglich, der keine Parameter benötigt und die vollständige Liste der Dokumente und Anfragen zurückgibt, die über Visengine und entsprechend dem Hash anforderbar sind.
GET /visure/{hash_visura}
Um die Informationen, die benötigten Dokumente und die Kosten der Mietvertragsregistrierung zu überprüfen, ist es erforderlich, eine Anfrage über den Endpunkt GET /visure/{hash_visura} zu stellen und den zuvor erhaltenen Hash der Mietregistrierung zu übergeben.
GET /visure/{hash_visura}
Um die Felder und Kosten zur Vervollständigung der Anfrage zu überprüfen, sollten wir den Hash verwenden, den wir in der vorherigen Anfrage erhalten haben.
https://visengine2.altravia.com/visure/e9dc845edf4ab2e2a3f06807a578126a
GET /visure/{hash_visura}
Die Antwort enthält alle notwendigen Informationen zur Vervollständigung der Registrierungsanfrage, wie zum Beispiel die Pflichtfelder.
{
"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
}
Bei der Validierung werden die Daten angegeben, die zum erfolgreichen Abschluss der Anfrage erforderlich sind.
POST /richiesta
In der Nutzlast der Anfrage sollten alle oben genannten Informationen und Dokumente enthalten sein.
POST /richiesta
Die Antwort gibt verschiedene Informationen zurück, darunter den Status, ob ein Rückruf eingestellt ist, und die Anforderungs-ID, die wir später zum Herunterladen des Dokuments benötigen.
{ "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"
}
In der Validierung sind die erforderlichen Daten angegeben, um die Anfrage erfolgreich abzuschließen.
POST /richiesta
Im Payload der Anfrage sollten wir alle zuvor angegebenen Informationen und Dokumente übermitteln.
POST /richiesta
Die Antwort enthält verschiedene Informationen, darunter den Status, ob ein Callback eingerichtet ist, und die ID der Anfrage, die wir später benötigen, um das Dokument herunterzuladen.
{ "data":
{
"_id": "5f2829ce065afc21cc60ad0e",
"state": 1,
"hash_visura": "e9dc845edf4ab2e2a3f06807a578126a",
"nome": "Registrierung Mietverträge",
"ricerca": false,
"id_ricerca": null,
"prezzo_visura": 12.7,
"prezzo_ricerca": 0,
"indice_ricerca": null,
"stato_richiesta": "In Bearbeitung",
"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": "Forschung abgeschlossen",
"json_ricerca": "{\"$1\":\"12485671007\"}",
"json_mappato": {
"NRea": "1378273",
"Cciaa": "RM"
},
"json_risultato": null
}
],
"esito": {
"codice": "0",
"info": "OK"
}
GET /documento/{_id}
Sobald der Status der Anfrage auf "abgeschlossen" steht, kann das Dokument über die Methode GET /documento/{_id} heruntergeladen werden.
GET /documento/{_id}
Dies ist ein Beispiel für eine Anfrage unter Verwendung der zuvor erhaltenen ID.
https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e
GET /documento/{_id}
Die Antwort enthält den Namen, die Größe und die Datei.
{
data{
"nome":"5f22f5b5065afc21cc60a27a.zip",
"dimensione": "10206",
"file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
},
"success": true,
"message": "",
"error": null
}
Brauchen Sie Hilfe?
Haben Sie die gewünschte Antwort nicht gefunden?
Füllen Sie alle Details aus, wir werden uns so schnell wie möglich bei Ihnen melden!
Der Dienst Mietvertragsdienste ermöglicht die Verwaltung des Prozesses zur Registrierung, Verlängerung und Kündigung eines Mietvertrags bei der Agentur der Einnahmen, alles über APIs. Am Ende des Verfahrens stellt der Dienst dem Antragsteller die offizielle Quittung der Agentur der Einnahmen zur Verfügung.
Der Dienst unterstützt die Verwaltung aller Arten von Mietverträgen.
Der Dienst Mietvertragsdienste ist ideal für diejenigen, die einen manuellen Prozess automatisieren und die Verwaltung von Mietverträgen optimieren möchten. Er kann in Immobilien- oder Buchhaltungssoftware, CAF- und Patronagesysteme integriert oder in jede Plattform oder jedes Portal eingebunden werden, das die Verwaltung von Mietverträgen erfordert, um deren Verwaltung und Registrierung zu vereinfachen.
Ja, über die APIs von Openapi können Sie auf über 28 Dienste zugreifen, die dem Immobiliensektor gewidmet sind:
Diese Dienste sind über verschiedene APIs verfügbar: Docuengine, Kataster, Immobilien.
Das Dokument wird innerhalb von 24 Arbeitsstunden bereitgestellt.
Die Kosten für den Dienst betragen 13,70 € bei Vorauszahlung.