Unser Registrierung von Mietverträgen für Immobilien per API wurde entwickelt, um den gesamten Prozess zu vereinfachen und zu beschleunigen, wobei die Einhaltung der gesetzlichen Vorschriften und die rechtliche Gültigkeit der Dokumente gewährleistet werden.
Der Dienst ermöglicht die Verwaltung von Mietverträgen für jedes Steuerregime und jede Art von Immobilie:
- Vermietung einer Wohnimmobilie
- Erleichterte Vermietung einer Wohnimmobilie
- Vermietung einer Wohnimmobilie (vertraglich der Mehrwertsteuer unterworfen)
- Leasing einer Wohnimmobilie
- Vermietung einer Immobilie für nicht wohnwirtschaftliche Zwecke
- Vermietung einer gewerblichen Immobilie mit Mehrwertsteuerpflicht für den Vermieter
- Leasing einer Immobilie für nicht wohnwirtschaftliche Zwecke
- Verpachtung eines landwirtschaftlichen Betriebs
- Erleichterte Verpachtung eines landwirtschaftlichen Betriebs
- Verpachtung von nicht bebaubaren Grundstücken, Steinbrüchen und Torfabbaugebieten
- Verpachtung von bebaubaren oder nicht bebaubaren Grundstücken für Parkzwecke (vertraglich der Mehrwertsteuer unterworfen)
Der Dienst wird per API direkt von einem befugten Fachmann erbracht, und die Bearbeitungszeit hängt von der Komplexität des Vorgangs ab, da die Arbeiten manuell durchgeführt werden. Openapi gewährleistet, dass der gesamte Prozess unter voller Einhaltung der geltenden Datenschutzbestimmungen mit Datenminimierung und Verschlüsselung erfolgt.
DIENSTLEISTUNGEN ZUR MIETVERTRAGSREGISTRIERUNG
Der Mietvertragsregistrierungsdienst ermöglicht nicht nur die Registrierung von mehr als 11 Arten von Mietverträgen, sondern deckt auch Immobilien jeder Katasterkategorie sowie bis zu 3 Vermieter und Mieter ab.
ANFRAGE ZUR REGISTRIERUNG EINES MIETVERTRAGS
GET /documents
Um die Registrierung eines Mietvertrags mit Docuengine anzufordern, müssen zunächst alle Parameter überprüft werden, um die Anfrage korrekt abzuschließen.
BEISPIELANFRAGE
https://docuengine.openapi.com/documents
Dies ist über den Endpunkt GET /documents möglich, der keine Parameter erfordert und eine vollständige Liste der anforderbaren Dokumente und Vorgänge sowie die jeweiligen Parameter und Kosten zurückgeben wird.
BEISPIEL ANTWORT
GET /documents
Die Antwort enthält alle erforderlichen Informationen zur Anforderung der verfügbaren Dokumente über die Docuengine API. In unserem Fall interessieren uns nur die Daten für die Mietvertragsregistrierung.
{
"data": [
{
"requestStructure": {
"fields": {
"field0": {
"name": "territorialOffice",
"nameIT": "ufficio territoriale",
"type": "territorialOffice",
"required": true,
"options": null,
"help": "Ufficio Territoriale presso cui registrare il contratto e competente per i successivi adempimenti"
},
"field1": {
"name": "rentalContractType",
"nameIT": "tipologia contratto locazione",
"type": "optionCode",
"required": true,
"options": [],
"help": "Selezionare la tipologia di contratto di locazione"
},
"field2": {
"name": "contractStartDate",
"nameIT": "data inizio contratto",
"type": "date",
"required": true,
"options": null,
"help": "Inserire la data da cui parte la decorrenza del contratto"
},
"field3": {
"name": "contractEndDate",
"nameIT": "data fine contratto",
"type": "date",
"required": true,
"options": null,
"help": "Inserire la data in cui finisce la decorrenza del contratto"
},
"field4": {
"name": "contractPages",
"nameIT": "numero pagine contratto",
"type": "integer",
"required": true,
"options": {
"min": 1
},
"help": "Inserire il numero di pagine del contratto"
},
"field5": {
"name": "contractCopies",
"nameIT": "copie contratto",
"type": "integer",
"required": true,
"options": {
"min": 1
},
"help": "Inserire il numero di copie del contratto da registrare"
},
"field6": {
"name": "annualFee",
"nameIT": "canone annuo",
"type": "float",
"required": true,
"options": {
"min": 0
},
"help": "Inserire l'importo del canone annuo (es. 100.50) o, in caso di contratti di durata inferiore a un anno, l'importo relativo all'intera durata"
},
"field7": {
"name": "contractDate",
"nameIT": "data contratto",
"type": "date",
"required": true,
"options": null,
"help": "Inserire la data di stipula del contratto"
},
"field8": {
"name": "contractFile",
"nameIT": "file contratto",
"type": "string",
"required": true,
"options": null,
"help": "Allegare contratto di locazione firmato da tutte le parti"
},
"field9": {
"name": "province",
"nameIT": "provincia immobile",
"type": "string",
"required": false,
"options": null,
"help": "Inserire la provincia dove e' presente l'immobile"
},
"field10": {
"name": "town",
"nameIT": "comune immobile",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il comune dove e' presente l'immobile"
},
"field11": {
"name": "address",
"nameIT": "indirizzo immobile",
"type": "string",
"required": true,
"options": null,
"help": "Inserire l'indirizzo (con civico) dell'immobile"
},
"field12": {
"name": "cadastralSheet",
"nameIT": "foglio catastale",
"type": "cadastralSheet",
"required": true,
"options": null,
"help": "Inserire il foglio catastale dell'immobile"
},
"field13": {
"name": "cadastralParcel",
"nameIT": "particella catastale",
"type": "cadastralParcel",
"required": true,
"options": null,
"help": "Inserire la particella catastale dell'immobile"
},
"field14": {
"name": "cadastralSub",
"nameIT": "subalterno catastale",
"type": "cadastralSub",
"required": true,
"options": null,
"help": "Inserire il subalterno catastale dell'immobile"
},
"field15": {
"name": "cadastralIncome",
"nameIT": "rendita catastale",
"type": "float",
"required": true,
"options": null,
"help": "Inserire la rendita catastale dell'immobile"
},
"field16": {
"name": "cadastralCategory",
"nameIT": "categoria catastale",
"type": "optionCode",
"required": true,
"options": [],
"help": "Selezionare la categoria catastale dell'immobile"
},
"field17": {
"name": "taxRegime",
"nameIT": "regime fiscale",
"type": "optionCode",
"required": true,
"options": [],
"help": "Selezionare il regime fiscale"
},
"field18": {
"name": "applicantName",
"nameIT": "nome richiedente",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il nome completo del richiedente"
},
"field19": {
"name": "applicantPhone",
"nameIT": "telefono richiedente",
"type": "string",
"required": true,
"options": null,
"help": "Inserire un contatto telefonico del richiedente in caso di richiesta informazioni aggiuntive"
},
"field20": {
"name": "applicantEmail",
"nameIT": "email richiedente",
"type": "email",
"required": true,
"options": null,
"help": "Inserire un'email del richiedente in caso di richiesta informazioni aggiuntive"
},
"field21": {
"name": "privateApplicantTaxCode",
"nameIT": "codice fiscale richiedente privato",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale del richiedente privato"
},
"field22": {
"name": "legalApplicantTaxCode",
"nameIT": "codice fiscale richiedente giuridico",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale del richiedente giuridico (ad esempio azienda)"
},
"field23": {
"name": "ibanCode",
"nameIT": "codice iban",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il codice IBAN per assolvere l'imposta di registro e quella di bollo (obbligatorio se contratto in regime ordinario)"
},
"field24": {
"name": "accountHolderTaxCode",
"nameIT": "codice fiscale titolare conto",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale del titotale del conto associato all'IBAN (obbligatorio se contratto in regime ordinario"
},
"field25": {
"name": "landlordName",
"nameIT": "nome locatore",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il nome completo del locatore"
},
"field26": {
"name": "landlordTaxCode",
"nameIT": "codice fiscale locatore",
"type": "taxCode",
"required": true,
"options": null,
"help": "Inserire il codice fiscale del locatore"
},
"field27": {
"name": "landlordDocument",
"nameIT": "documento locatore",
"type": "strifileng",
"required": true,
"options": null,
"help": "Allegare un documento del locatore"
},
"field28": {
"name": "landlordPercentage",
"nameIT": "percentuale possesso locatore",
"type": "float",
"required": false,
"options": null,
"help": "Inserire la percentuale di possesso del locatore (obbligatorio se contratto in regime di cedolare secca)"
},
"field29": {
"name": "secondLandlordName",
"nameIT": "nome secondo locatore",
"type": "string",
"required": false,
"options": null,
"help": "Inserire il nome completo del secondo locatore (solo se presente)"
},
"field30": {
"name": "secondLandlordTaxCode",
"nameIT": "codice fiscale secondo locatore",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale del secondo locatore (solo se presente)"
},
"field31": {
"name": "secondLandlordDocument",
"nameIT": "documento secondo locatore",
"type": "strinfileg",
"required": false,
"options": null,
"help": "Allegare un documento del secondo locatore (solo se presente)"
},
"field32": {
"name": "secondLandlordPercentage",
"nameIT": "percentuale possesso secondo locatore",
"type": "float",
"required": false,
"options": null,
"help": "Inserire la percentuale di possesso del secondo locatore (obbligatorio se contratto in regime di cedolare secca e solo se presente)"
},
"field33": {
"name": "thirdLandlordName",
"nameIT": "nome terzo locatore",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il nome completo del terzo locatore (solo se presente)"
},
"field34": {
"name": "thirdLandlordTaxCode",
"nameIT": "codice fiscale terzo locatore",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale del terzo locatore (solo se presente)"
},
"field35": {
"name": "thirdLandlordDocument",
"nameIT": "documento terzo locatore",
"type": "file",
"required": false,
"options": null,
"help": "Allegare un documento del terzo locatore (solo se presente)"
},
"field36": {
"name": "thirdLandlordPercentage",
"nameIT": "percentuale possesso terzo locatore",
"type": "floate",
"required": false,
"options": null,
"help": "Inserire la percentuale di possesso del terzo locatore (obbligatorio se contratto in regime di cedolare secca e solo se presente)"
},
"field37": {
"name": "conductorName",
"nameIT": "nome conduttore",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il nome completo del conduttore"
},
"field38": {
"name": "conductorTaxCode",
"nameIT": "codice fiscale conduttore",
"type": "taxCode",
"required": true,
"options": null,
"help": "Inserire il codice fiscale del conduttore"
},
"field39": {
"name": "secondConductorName",
"nameIT": "nome secondo conduttore",
"type": "string",
"required": false,
"options": null,
"help": "Inserire il nome completo del secondo conduttore (solo se presente)"
},
"field40": {
"name": "secondConductorTaxCode",
"nameIT": "codice fiscale secondo conduttore",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale del secondo conduttore (solo se presente)"
},
"field41": {
"name": "secondConductorDocument",
"nameIT": "documento secondo conduttore",
"type": "file",
"required": false,
"options": null,
"help": "Allegare un documento del secondo conduttore (solo se presente)"
},
"field42": {
"name": "thirdConductorName",
"nameIT": "nome terzo conduttore",
"type": "string",
"required": false,
"options": null,
"help": "Inserire il nome completo del terzo conduttore (solo se presente)"
},
"field43": {
"name": "thirdConductorTaxCode",
"nameIT": "codice fiscale terzo conduttore",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale del terzo conduttore (solo se presente)"
},
"field44": {
"name": "thirdConductorTaxCode",
"nameIT": "codice fiscale terzo conduttore",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale del terzo conduttore (solo se presente)"
},
"field45": {
"name": "thirdConductorDocument",
"nameIT": "documento terzo conduttore",
"type": "file",
"required": false,
"options": null,
"help": "Allegare un documento del terzo conduttore (solo se presente)"
},
"field46": {
"name": "feesPaymentGuarantees",
"nameIT": "garanzie pagamento canoni",
"type": "optionCode",
"required": true,
"options": [],
"help": "Specificare se sono presenti garanzie per il pagamento dei canoni"
},
"field47": {
"name": "guaranteeProviderTaxCode",
"nameIT": "codice fiscale prestatore",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale di chi presta la garanzia"
},
"field48": {
"name": "maximumGuaranteeAmount",
"nameIT": "importo garanzia",
"type": "float",
"required": false,
"options": null,
"help": "Inserire l'importo massimo della garanzia"
},
"field49": {
"name": "penaltyClauses",
"nameIT": "clausole penali",
"type": "optionCode",
"required": true,
"options": [],
"help": "Segnalare eventuali clausole penali"
},
"field50": {
"name": "taxPaymentType",
"nameIT": "tipo pagamento imposte",
"type": "optionCode",
"required": false,
"options": [],
"help": "Indicare se si intende pagare le imposte per l'intero periodo o annualmente (obbligatorio se contratto in regime ordinario)"
}
},
"validation": "()",
"help": null,
"searchHelp": null
},
"category": "Catastali",
"name": "Registrazione Contratti Affitto",
"options": null,
"hasSearch": false,
"isSync": false,
"id": "67e13cfd2cbb7e30d3d93e9d",
"searchPrice": 0,
"documentPrice": 12.9,
"totalPrice": 12.9
}
],
"success": true,
"message": "",
"error": null
}
Die erforderlichen Daten für die Anfrage sind:
- Regionalstelle für die Registrierung
- Art des Mietvertrags
- Vertragsbeginn und -ende
- Seitenanzahl des Vertrags und Kopie
- Jährlicher Mietzins
- Vertragsdatum
- Unterzeichneter Vertrag
- Katasterdaten und Adresse der Immobilie
- Steuerregime
- Name, Nachname, E-Mail, Steuernummer, IBAN und Telefonnummer des Antragstellers
Zusätzliche erforderliche Dokumente werden vom Steuerberatungs- oder Sozialversicherungsdienst (CAF oder Patronat) im Einklang mit den Datenschutzbestimmungen angefordert.
ANFORDERUNG DES DOKUMENTS
POST /requests
BEISPIELANFRAGE
POST /requests
Die Anfrage muss die folgenden Daten enthalten:
{
"documentId": "67e13cfd2cbb7e30d3d93e9d"
"search": {
"field0": "ufficio territoriale",
"field1": "tipologia contratto locazione",
"field2": "data inizio contratto",
"field3": "data fine contratto",
"field4": "numero pagine contratto",
"field5": "copie contratto",
"field6": "canone annuo",
"field7": "data contratto",
"field8": "file contratto",
"field9": "provincia immobile",
"field10": "comune immobile",
"field11": "indirizzo immobile",
"field12": "foglio catastale",
"field13": "particella catastale",
"field14": "subalterno catastale",
"field15": "rendita catastale",
"field16": "categoria catastale",
"field17": "regime fiscale",
"field18": "nome richiedente",
"field19": "telefono richiedente",
"field20": "email richiedente",
"field21": "codice fiscale richiedente privato",
"field23": "codice iban",
"field24": "codice fiscale titolare conto",
"field25": "nome locatore",
"field26": "codice fiscale locatore",
"field27": "documento locatore",
"field28": "percentuale possesso locatore",
"field37": "nome conduttore",
"field38": "codice fiscale conduttore",
"field39": "documento conduttore",
"field46": "garanzie pagamento canoni",
"field49": "clausole penali",
"field50": "tipo pagamento imposte"
}
}
Die Felder sind beispielhaft angegeben.
BEISPIEL ANTWORT
POST /requests
Die Antwort liefert verschiedene Informationen, darunter den Status, ob der Callback gesetzt wurde, und die Anfragen-ID, die später benötigt wird, um das Dokument herunterzuladen.
{
"data" {
"documentId": "66ffea9fa2b0bc1d3104fa54"
"search": {
"field0": "ufficio territoriale",
"field1": "tipologia contratto locazione",
"field2": "data inizio contratto",
"field3": "data fine contratto",
"field4": "numero pagine contratto",
"field5": "copie contratto",
"field6": "canone annuo",
"field7": "data contratto",
"field8": "file contratto",
"field9": "provincia immobile",
"field10": "comune immobile",
"field11": "indirizzo immobile",
"field12": "foglio catastale",
"field13": "particella catastale",
"field14": "subalterno catastale",
"field15": "rendita catastale",
"field16": "categoria catastale",
"field17": "regime fiscale",
"field18": "nome richiedente",
"field19": "telefono richiedente",
"field20": "email richiedente",
"field21": "codice fiscale richiedente privato",
"field23": "codice iban",
"field24": "codice fiscale titolare conto",
"field25": "nome locatore",
"field26": "codice fiscale locatore",
"field27": "documento locatore",
"field28": "percentuale possesso locatore",
"field37": "nome conduttore",
"field38": "codice fiscale conduttore",
"field39": "documento conduttore",
"field46": "garanzie pagamento canoni",
"field49": "clausole penali",
"field50": "tipo pagamento imposte"
},
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": "Registrazione Contratti Affitto",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 12.9,
"totalPrice": 12.9,
"documents": null,
"resultId": null,
"results": null,
"id": "67e13cfd2cbb7e30d3d93e9d"
},
"success": true,
"message": "",
"error": null
}
Anfrage aktualisieren
PATCH /requests/{_id}
Standardmäßig wird die Transaktion als sofort abgeschlossen betrachtet und die Anfrage wird verarbeitet und ausgeführt, wenn das Feld "STATE" nicht ausgefüllt ist. Falls es jedoch gesetzt ist, wird die Transaktion gestartet, bleibt aber offen, sodass du die Anfrage über den Endpoint PATCH /requests/{_id} aktualisieren kannst.
Beispiel für eine Anfrageaktualisierung
PATCH /requests/{_id}
Dieser Endpoint ermöglicht das Aktualisieren bestimmter Felder der Anfrage und den Abschluss des Prozesses: entweder durch Schließen, wenn der Status "NEW" ist, oder durch die Auswahl eines durch die Suche generierten Ergebnisses, falls das Dokument den Parameter 'hasSearch' auf true gesetzt hat.
{
"data" {
"documentId": "66ffea9fa2b0bc1d3104fa54"
"search": {
"field0": "ufficio territoriale",
"field1": "tipologia contratto locazione",
"field2": "data inizio contratto",
"field3": "data fine contratto",
"field4": "numero pagine contratto",
"field5": "copie contratto",
"field6": "canone annuo",
"field7": "data contratto",
"field8": "file contratto",
"field9": "provincia immobile",
"field10": "comune immobile",
"field11": "indirizzo immobile",
"field12": "foglio catastale",
"field13": "particella catastale",
"field14": "subalterno catastale",
"field15": "rendita catastale",
"field16": "categoria catastale",
"field17": "regime fiscale",
"field18": "nome richiedente",
"field19": "telefono richiedente",
"field20": "email richiedente",
"field21": "codice fiscale richiedente privato",
"field23": "codice iban",
"field24": "codice fiscale titolare conto",
"field25": "nome locatore",
"field26": "codice fiscale locatore",
"field27": "documento locatore",
"field28": "percentuale possesso locatore",
"field37": "nome conduttore",
"field38": "codice fiscale conduttore",
"field39": "documento conduttore",
"field46": "garanzie pagamento canoni",
"field49": "clausole penali",
"field50": "tipo pagamento imposte"
},
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": "Registrazione Contratti Affitto",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 12.9,
"totalPrice": 12.9,
"documents": null,
"resultId": null,
"results": null,
"id": "67e13cfd2cbb7e30d3d93e9d"
},
"success": true,
"message": "",
"error": null
}
DOKUMENT HERUNTERLADEN
Wenn die Anfrage den Status "abgeschlossen" hat, kannst du deine offizielle Registrierungsbestätigung im PDF-Format herunterladen, die von der italienischen Finanzbehörde ausgestellt wurde. Der Endpoint zum Herunterladen der durch die Anfrage generierten Dokumente ist: GET/requests/{id}/documents
Die Antwort enthält den Dateinamen, die Größe und die URL zum Herunterladen der Datei.
{
data{
"fileName":"5f22f5b5065afc21cc60a27a_0.pdf",
"mimeType"application/pdf",
"fileSize":"34144",
"md5":"application/pdf",
"urlExpire":"1724505599",
"downloadUrl":"https://storage.googleapis.com/test-docuengine-openapi-com/documents/5f22f5b5065afc21cc60a27a_0.pdf",
},
"success": true,
"message": "",
"error": null
}
Die PDF-Datei wird im Base64-codierten Format bereitgestellt.
Durch die Integration der Openapi-APIs können Unternehmen ihren Kunden einen effizienten und konformen Service für die Beantragung der Mietvertragsregistrierung und anderer mietbezogener Dienstleistungen anbieten.