€12.90 + TVA
Automatisez l'enregistrement des contrats de location 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
Notre service d'enregistrement des contrats de location via API est conçu pour simplifier et accélérer l'ensemble du processus, garantissant la conformité réglementaire et la validité légale des documents.
Le service permet de gérer les Contrats de Location pour tout régime fiscal et type de bien immobilier :
Le service est fourni via API directement par un professionnel habilité et les délais, étant donné que les opérations sont effectuées manuellement par des opérateurs, dépendent de la complexité du dossier. Openapi garantit que l'ensemble du processus respecte pleinement la réglementation en vigueur en matière de protection des données, avec des logiques de minimisation et de chiffrement des données.
Le service d'enregistrement des contrats de location permet non seulement d'enregistrer plus de 11 types de contrats de location, mais couvre aussi des biens de toute catégorie cadastrale et jusqu'à 3 bailleurs et locataires.
GET /documents
Pour demander l'Enregistrement du Contrat de Location avec Docuengine, il est d'abord nécessaire de vérifier tous les paramètres afin de compléter correctement la demande.
https://docuengine.openapi.com/documents
Cela est possible via l'endpoint GET /documents qui ne nécessite aucun paramètre et renverra la liste complète des documents et dossiers demandables via Docuengine ainsi que leurs paramètres et coûts respectifs.
GET /documents
La réponse indiquera toutes les informations nécessaires pour compléter la demande des documents disponibles via l'API Docuengine. Dans notre cas, nous nous intéresserons uniquement aux données pour l'Enregistrement du Contrat de Location.
{
"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
}
Les données nécessaires pour la demande sont :
Les documents supplémentaires requis seront demandés par le centre fiscal ou l'agence qui gèrera le dossier en conformité avec la réglementation sur la protection des données.
POST /requests
POST /requests
Les champs sont donnés à titre d'exemple
{
"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"
}
}
POST /requests
La réponse renvoie plusieurs informations, y compris l'état, si le callback est défini, ainsi que l'ID de la demande, qui sera nécessaire par la suite pour télécharger le 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}
Par défaut, si le champ "STATE" n'est pas renseigné, la transaction est immédiatement considérée comme clôturée, et votre demande sera traitée et exécutée. En revanche, si ce champ est défini, la transaction est initiée mais reste ouverte, ce qui vous permet de mettre à jour la demande via l'endpoint PATCH /requests/{_id}.
PATCH /requests/{_id}
Cet endpoint permet de mettre à jour certains champs de la demande et d'en finaliser le processus : en la clôturant si son état est "NEW", ou en sélectionnant un résultat généré par la recherche, dans le cas où le document a le paramètre 'hasSearch' défini sur 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
}
Lorsque la demande est en état "traitée", vous pouvez télécharger votre reçu d'enregistrement officiel délivré par l'Agence des Impôts au format PDF. L'endpoint permettant de télécharger les documents générés par la demande est : GET/requests/{id}/documents
La réponse indiquera le nom du fichier, sa taille et l'URL pour le téléchargement du fichier.
{
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
}
Le fichier PDF est fourni au format encodé base64.
En intégrant les API d'Openapi, les entreprises peuvent offrir à leurs clients un service efficace et conforme pour la demande d'Enregistrement de Contrat de Location et d'autres services liés à la location.
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!
Le service d’Enregistrement des Contrats de Location des Biens Immobiliers permet d'enregistrer un contrat de location pour toute entité (particulier ou entreprise), tout type de bien immobilier et tout régime (classique ou à taux forfaitaire) auprès de l’Agence des Revenus, le tout via API. À la fin de la procédure, le service mettra à disposition du 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 36 heures ouvrables.
Le coût du service est de 12,90 € avec un paiement prépayé.