12,90 € + MwSt
Automatisieren Sie die Registrierung vorläufiger Kaufverträge für jede Art von Immobilie mit unserer API und machen Sie Ihre Arbeit einfacher!
Unser API-Dienst zur Vorläufigen Registrierung von Kaufverträgen ermöglicht eine schnelle und effiziente Registrierung von vorläufigen Immobilienkaufverträgen. Der Dienst automatisiert den Registrierungsprozess, reduziert Fehler und gewährleistet die Einhaltung gesetzlicher Vorschriften.
Der Dienst wird über eine API direkt von einem zugelassenen Fachmann bereitgestellt. Da die Bearbeitung manuell durch Betreiber erfolgt, hängt die Bearbeitungszeit von der Komplexität des Vorgangs ab. Openapi stellt sicher, dass der gesamte Prozess unter strikter Einhaltung der geltenden Datenschutzbestimmungen mit Prinzipien der Datenminimierung und Verschlüsselung durchgeführt wird.
Der Dienst zur Vorläufigen Registrierung von Kaufverträgen ermöglicht die Registrierung von Kaufverpflichtungen für Immobilien jeder Katasterkategorie, mit bis zu drei Verkäufern und Käufern sowie der Festlegung der vorgeschriebenen Zahlungsmodalitäten.
GET /documents
Um die Vorläufige Registrierung des Kaufvertrags mit Docuengine anzufordern, müssen zuerst alle Parameter überprüft werden, um die Anfrage korrekt abzuschließen.
https://docuengine.openapi.com/documents
Dies ist über den Endpoint GET /documents möglich, der keine Parameter erfordert und eine komplette Liste der über Docuengine anforderbaren Dokumente und Vorgänge sowie die jeweiligen Parameter und Kosten zurückgibt.
GET /documents
Die Antwort enthält alle notwendigen Informationen, um die Dokumentenanfrage über die Docuengine-API abzuschließen. In unserem Fall sind nur die Daten zur Vorläufigen Registrierung des Kaufvertrags relevant.
{
"data": [
{
"requestStructure": {
"fields": {
"field0": {
"name": "contractFile",
"nameIT": "file contratto",
"type": "file",
"required": true,
"options": null,
"help": "Allegare copia del contratto preliminare firmato"
},
"field1": {
"name": "deposit",
"nameIT": "caparra",
"type": "float",
"required": true,
"options": null,
"help": "Inserire l'importo della caparra"
},
"field2": {
"name": "downPayment",
"nameIT": "acconto",
"type": "float",
"required": true,
"options": null,
"help": "Inserire l'importo dell'acconto"
},
"field3": {
"name": "sellerDocument",
"nameIT": "documento venditore",
"type": "file",
"required": true,
"options": null,
"help": "Allegare un documento del venditore"
},
"field4": {
"name": "secondSellerDocument",
"nameIT": "documento secondo venditore",
"type": "file",
"required": true,
"options": null,
"help": "Allegare un documento del secondo venditore (solo se presente)"
},
"field5": {
"name": "thirdSellerDocument",
"nameIT": "documento terzo venditore",
"type": "file",
"required": false,
"options": null
"help": "Allegare un documento del terzo venditore (solo se presente)"
},
"field6": {
"name": "buyerDocument",
"nameIT": "documento acquirente",
"type": "file",
"required": true,
"options": null,
"help": "Allegare un documento dell'acquirente"
},
"field7": {
"name": "secondBuyerDocument",
"nameIT": "documento secondo acquirente",
"type": "file",
"required": false,
"options": null,
"help": "Allegare un documento del secondo acquirente acquirente (solo se presente)"
},
"field8": {
"name": "thirdBuyerDocument",
"nameIT": "documento terzo acquirente",
"type": "file",
"required": false,
"options": null,
"help": "Allegare un documento del terzo acquirente (solo se presente)"
},
"field9": {
"name": "suspensiveConditions",
"nameIT": "condizioni sospensive",
"type": "optionCode",
"required": false,
"options": [],
"help": Presenza di eventuali condizioni sospensive (vanno a vincolare l'esito del contratto); esempio: approvazione del mutuo"
},
"field10": {
"name": "taxPaymentType",
"nameIT": "tipo pagamento imposte",
"type": "optionCode",
"required": false,
"options": [],
"help": Indicare se l'imposta sulla caparra/acconto venga versata in fase di registrazione o successivamente (obbligatorio se esistono condizioni sospensive)"
},
"validation": "()",
"help": null,
"searchHelp": null
},
"category": "Catastali",
"name": "Registrazione Preliminare Compravendita"",
"options": null,
"hasSearch": false,
"isSync": false,
"id": "67e13d862cbb7e30d3d93ea6",
"searchPrice": 0,
"documentPrice": 12.9,
"totalPrice": 12.9
}
],
"success": true,
"message": "",
"error": null
}
Die erforderlichen Daten für die Anfrage sind:
Zusätzliche erforderliche Dokumente werden vom Steuerberatungszentrum oder Rentenamt angefordert, das den Vorgang unter Einhaltung der Datenschutzvorschriften bearbeitet.
POST /requests
POST /requests
Die Anfrage muss die folgenden Daten enthalten
{
"documentId": "67e13d862cbb7e30d3d93ea6"
"search": {
"field0": "File contratto",
"field1": "Caparra",
"field2": "Acconto",
"field3": "Documento venditore",
"field6": "Documento acquirente",
"field9": "Condizioni sospensive",
"field10": "Tipo pagamento imposte"
}
}
Die Felder dienen als Beispiel
POST /requests
Die Antwort enthält verschiedene Informationen, darunter den Status, ob ein Callback gesetzt wurde, und die Antrags-ID, die später zum Herunterladen des Dokuments verwendet wird.
{
"data" {
"documentId": "66ffea9fa2b0bc1d3104fa54"
"search": {
"field0": "File contratto",
"field1": "Caparra",
"field2": "Acconto",
"field3": "Documento venditore",
"field6": "Documento acquirente",
"field9": "Condizioni sospensive",
"field10": "Tipo pagamento imposte"
},
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": "Registrazione Preliminare Compravendita",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 12.9,
"totalPrice": 12.9,
"documents": null,
"resultId": null,
"results": null,
"id": "67e13d862cbb7e30d3d93ea6"
},
"success": true,
"message": "",
"error": null
}
PATCH /requests/{_id}
Standardmäßig wird die Transaktion als sofort abgeschlossen betrachtet, wenn das Feld "STATE" nicht ausgefüllt ist. Falls es jedoch gesetzt wird, bleibt die Transaktion offen und kann über den Endpoint PATCH /requests/{_id} aktualisiert werden.
PATCH /requests/{_id}
Dieser Endpoint ermöglicht das Aktualisieren bestimmter Felder der Anfrage und den Abschluss des Prozesses: Entweder durch Schließen der Anfrage, wenn der Status "NEW" ist, oder durch Auswahl eines generierten Ergebnisses, falls das Dokument den Parameter "hasSearch" auf true gesetzt hat.
{
"data" {
"documentId": "66ffea9fa2b0bc1d3104fa54"
"search": {
"field0": "File contratto",
"field1": "Caparra",
"field2": "Acconto",
"field3": "Documento venditore",
"field6": "Documento acquirente",
"field9": "Condizioni sospensive",
"field10": "Tipo pagamento imposte"
},
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": "Registrazione Preliminare Compravendita",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 12.9,
"totalPrice": 12.9,
"documents": null,
"resultId": null,
"results": null,
"id": "67e13d862cbb67e13d862cbb7e30d3d93ea67e30d3d93ea6"
},
"success": true,
"message": "",
"error": null
}
Wenn der Antrag als "abgeschlossen" markiert ist, kann die offizielle Registrierungsquittung der italienischen Steuerbehörde im PDF-Format heruntergeladen werden. Der Endpoint zum Herunterladen generierter Dokumente lautet: GET/requests/{id}/documents
Die Antwort enthält den Dateinamen, die Größe und die Download-URL 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 zur Anforderung der Vorläufigen Registrierung von Kaufverträgen bieten.
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 ermöglicht eine schnelle und effiziente Registrierung von vorläufigen Immobilienkaufverträgen über eine API, automatisiert den Prozess und reduziert Fehler. Die Registrierung erfolgt in Übereinstimmung mit den geltenden Datenschutzbestimmungen und unter Einbeziehung autorisierter Fachleute.
Zur Vervollständigung des Antrags müssen folgende Daten bereitgestellt werden:
Nach dem Absenden des Antrags per API kann der Status über spezielle Endpunkte überwacht werden. Sobald der Antrag genehmigt wurde, kann das Stornierungsdokument heruntergeladen werden.
Solange der Antrag nicht abgeschlossen ist, kann er bearbeitet werden (er muss den Status "NEW" haben) über den Endpoint PATCH /requests/{_id}. Damit können bestimmte Felder aktualisiert und der Prozess vor der endgültigen Registrierung abgeschlossen werden.
Ja, sobald der Antrag bearbeitet wurde, kann die offizielle Quittung des Finanzamts über den Endpoint GET /requests/{id}/documents heruntergeladen werden. Dieser stellt einen Link zum Herunterladen der PDF-Datei bereit.
Ja, über die Docuengine-API können auch Mietvertragsverlängerung und Mietvertragskündigung angefordert werden.
Die Bearbeitungszeit hängt von der Komplexität des Antrags ab. Openapi garantiert jedoch eine schnelle und effiziente Abwicklung mit einer durchschnittlichen Bearbeitungszeit von 36 Arbeitsstunden.
Die Kosten für die Vorvertrag-Registrierung per API betragen 12,90 €.