€12.90 + VAT
Automate the Registration of Real Estate Lease Contracts through our services. The electronic procedure has the same validity as the one carried out at the Revenue Agency's office, and you will receive an official receipt.
Our registration of real estate lease contracts service via API is designed to simplify and speed up the entire process, ensuring regulatory compliance and the legal validity of documents.
The service allows the management of Lease Contracts for any tax regime and property type:
The service is provided via API directly by a qualified professional, and the processing time, as it involves manual operations by operators, depends on the complexity of the case. Openapi ensures that the entire process is carried out in full compliance with current privacy regulations, using data minimization and encryption principles.
The lease contract registration service not only allows the registration of more than 11 types of lease contracts but also covers properties of any cadastral category and up to 3 landlords and tenants.
GET /documents
To request the registration of real estate lease contracts with Docuengine, first of all, it is necessary to verify all the parameters to correctly complete the request.
https://docuengine.openapi.com/documents
This can be done through the GET /documents endpoint, which does not require parameters and will return the complete list of documents and requests available via Docuengine, along with the respective parameters and costs.
GET /documents
The response will include all the necessary information to complete the request for documents available via the Docuengine API. In our case, we are only interested in the data for Lease Contract Registration.
{
"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
}
The necessary data for the request are:
Any additional documents required will be requested by the CAF or Patronage managing the procedure in compliance with privacy regulations.
POST /requests
POST /requests
The request must include the following data
{
"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"
}
}
The fields are for example purposes only
POST /requests
The response returns various information, including the status, whether the callback is set, and the request ID, which will be needed later to download the document.
{
"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
}
PATCH /requests/{_id}
By default, if the "STATE" field is not set, the transaction is considered immediately closed, and your request will be processed and completed. However, if it is set, the transaction is initiated but remains open, allowing you to update the request using the endpoint PATCH /requests/{_id}.
PATCH /requests/{_id}
This endpoint allows updating specific fields of the request and completing the process: either closing it if the status is "NEW" or selecting a result generated by the search if the document has the 'hasSearch' parameter set to true.
{
"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
}
When the request is in the "processed" state, you can download your official registration receipt issued by the Revenue Agency in PDF format. The endpoint that allows downloading documents generated by the request is: GET/requests/{id}/documents
The response will indicate the file name, size, and the URL to download the file.
{
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
}
The PDF file is provided in base64 encoded format.
By integrating Openapi's APIs, companies can offer their customers an efficient and compliant service for Lease Contract Registration requests and other rental-related services.
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 Registration of Real Estate Lease Contracts service allows you to register a rental contract for any entity (individual or legal entity), any type of property, and any regime (standard or flat-rate tax) with the Revenue Agency, all via API. At the end of the process, the service will provide 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 36 working hours.
The cost of the service is €12.90 with prepaid charge.