€12.90 + IVA
Automatizza la registrazione dei contratti locazione tramite i nostri service. La procedura telematica ha lo stesso valore di quella effettuata allo sportello Agenzia delle Entrate e riceverai ricevuta ufficiale.
Il nostro servizio di registrazione contratti di locazione tramite API è progettato per semplificare e velocizzare l'intero processo, garantendo la conformità normativa e la validità legale dei documenti.
Il servizio consente di gestire di Contratti di Locazione per qualsiasi regime fiscale e tipologia di immobile :
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.
Il servizio di registrazione contratti di locazione consente non solo di registrare oltre 11 tipologie di contratti di locazione ma copre immobili di qualsiasi categoria catastale e fino a 3 locatari e conduttori.
GET /documents
Per richiedere la Registrazione Contratto di Locazione con Docuengine prima di tutto è necessario verificare tutti i parametri per completare correttamente la richiesta.
https://docuengine.openapi.com/documents
Questo è possibile tramite l'endpoint GET /documents che non necessita di parametri e restituirà l'elenco completo dei documenti e pratiche richiedibili tramite Docuengine ed i rispettivi parametri e costi.
GET /documents
La risposta indicherà tutti le informazioni necessarie per completare la richiesta dei documenti disponibili tramite l'API Docuengine. Nel nostro caso ci interesserà solo i dati per la Registrazione Contratto di Locazione
{
"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
}
I dati utili per la richiesta sono:
I documenti aggiuntivi necessari saranno richiesti dal CAF o Patronato che gestirà la pratica in conformità con la normativa sulla privacy.
POST /requests
POST /requests
La richiesta dovrà includere i seguenti dati
{
"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"
}
}
I campo sono a titolo di esempio
POST /requests
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" {
"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}
Per impostazione predefinita, se il campo "STATE" non viene valorizzato la transazione viene considerata immediatamente chiusa e la tua richiesta verrà gestita ed evasa. Se invece viene impostato, la transazione viene avviata ma rimane aperta e quindi puoi procedere ad aggiornare la richiesta tramite l'endpoint PATCH /requests/{_id}.
PATCH /requests/{_id}
Questo endpoint permette di aggiornare determinati campi della richiesta e di completarne il processo: chiudendola, se lo stato è "NEW", oppure selezionando un risultato generato dalla ricerca, nel caso in cui il documento abbia il parametro 'hasSearch' impostato su 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
}
Quando la richiesta è in stato "evaso", è possibile scaricare la tua ricevuta di registrazione ufficiale rilasciata dall’Agenzia delle Entrate in formato PDF. L'endpoint che permette di scaricare i documenti generati dalla richiesta è: GET/requests/{id}/documents
La risposta indicherà nome del file, dimensione e l'URL per il download del 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
}
Il file PDF è fornito in formato codificato base64.
Integrando le API di Openapi, le aziende possono offrire ai propri clienti un servizio efficiente e conforme per la richiesta della Registrazione Contratto di Affitto e degli altri servizi legati alla locazione.
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
Il servizio di Registrazione Contratto di Locazione consente si registrare il contratto di affitto di qualsiasi soggetto (privato o giuridico), tipologia di immobile, regime (ordinario e cedolare), 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:
I servizi sono disponibili tramite differenti API: Docuengine, Catasto, Real Estate
Il documento viene reso disponibili in 36 ore lavorative
Il costo del servizio è 12,90€ con addebito su ricarica