€9.30 + MwSt
Zugriff über API auf den amtlichen Kartenauszug eines beliebigen Gemeindegebiets auf italienischem Staatsgebiet
Openapi ermöglicht es, über die API den offiziellen Katasterkarten-Auszug einer bestimmten Gemeindezone anzufordern.
Der Katasterkarten-Auszug ist ein Dokument, ausgestellt von der Agenzia delle Entrate, und stellt den maßstabsgetreuen Kartenausschnitt des Gebiets dar, in dem die Umrisse von Grundstücken und Gebäuden einer bestimmten Gemeindezone zusammen mit den zugehörigen Katasterdaten (Parzellen/Flurstücke) abgebildet sind.
In den Kartenauszügen sind grafisch verschiedene Elemente dargestellt, die das Lesen der Karte erleichtern, indem sie materielle Objekte kennzeichnen, die sich vor Ort befinden, wie zum Beispiel:
Der Kartenauszug ist ein öffentliches Dokument und kann von jedermann angefordert werden.
Der Kartenauszug ermöglicht es, die Grenzen von Grundstücksparzellen und Gebäuden zu überprüfen und gegebenenfalls durch weitere Katasterrecherchen die eingetragene Person eines bestimmten Grundstücks oder Gebäudes zu ermitteln.
GET /documents
Um den Kartenauszug mit Docuengine anzufordern, müssen zunächst 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 benötigt und die vollständige Liste der über Docuengine anforderbaren Dokumente und Vorgänge zurückgibt.
GET /documents
Die Antwort zeigt nicht nur die Liste, sondern auch alle notwendigen Informationen, um die Anforderung der Dokumente sowie die entsprechenden Kosten, die über die Docuengine-API verfügbar sind, abzuschließen. In unserem Fall interessieren uns nur die Daten für den Katasterkarten-Auszug:
{
"data": [
{
"requestStructure": {
"fields": {
"field0": {
"name": "province",
"nameIT": "provincia immobile",
"type": "cadastralProvince",
"required": true,
"options": null,
"help": "Inserire la provincia dove e' presente l'immobile"
},
"field1": {
"name": "municipality",
"nameIT": "comune immobile",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il comune dove e' presente l'immobile"
},
"field2": {
"name": "section",
"nameIT": "sezione amministrativa",
"type": "string",
"required": false,
"options": null,
"help": "Inserire la sezione amministrativa"
},
"field3": {
"name": "cadastralSheet",
"nameIT": "foglio catastale",
"type": "cadastralSheet",
"required": true,
"options": null,
"help": "Inserire il foglio catastale dell'immobile"
},
"field4": {
"name": "cadastralParcel",
"nameIT": "particella catastale",
"type": "cadastralParcel",
"required": true,
"options": null,
"help": "Inserire la particella catastale dell'immobile"
},
"field5": {
"name": "entireSheet",
"nameIT": "intero foglio",
"type": "optionCode",
"required": false,
"options": [
{
"code": "S",
"description": "Si"
},
{
"code": "N",
"description": "No"
}
],
"help": "Selezionare se si desidera estrapolare l'intero foglio catastale"
},
"field6": {
"name": "size",
"nameIT": "formato",
"type": "optionCode",
"required": false,
"options": [
{
"code": "A3",
"description": "Formato A3"
},
{
"code": "A4",
"description": "Formato A4"
}
],
"help": "Selezionare come si desidera il formato"
}
},
"validation": "(field0 && field1 && field2 && field3 && field4 && field5 && field6) || (field0 && field1 && field3 && field4 && field5 && field6) || (field0 && field1 && field2 && field3 && field4 && field6) || (field0 && field1 && field2 && field3 && field4 && field5) || (field0 && field1 && field2 && field3 && field4) || (field0 && field1 && field3 && field4 && field5) || (field0 && field1 && field3 && field4 && field6) || (field0 && field1 && field3 && field4)",
"help": null,
"searchHelp": null
},
"category": "Catastali",
"name": "Estratto Mappa Catastale",
"options": null,
"hasSearch": false,
"isSync": false,
"id": "68adca797a0be68c265a74b3",
"searchPrice": 0,
"documentPrice": 9.3,
"totalPrice": 9.3
}
],
"success": true,
"message": "",
"error": null
}
In der Validierung sind die obligatorischen Daten angegeben, die erforderlich sind, um die Anfrage erfolgreich abzuschließen.
Die für die Anfrage erforderlichen Daten sind:
Um den Kartenauszug anzufordern, muss eine Anfrage an den Endpoint POST /requests gestellt werden, wobei die zuvor genannten Daten angegeben werden müssen: Provinz, Gemeinde, Katasterblatt und Katasterparzelle des Objekts.
POST /requests
{
"documentId": "68adca797a0be68c265a74b3"
"search": {
"field0": "provincia immobile",
"field1": "comune immobile",
"field3": "foglio catastale",
"field4": "particella catastale"
}
}
POST /requests
Die Antwort enthält verschiedene Informationen, darunter den Status, ob das Callback eingestellt wurde, und die Anfragen-ID, die später benötigt wird, um das Dokument herunterzuladen.
{
"documentId": "68adca797a0be68c265a74b3"
"search": {
"field0": "provincia immobile",
"field1": "comune immobile",
"field3": "foglio catastale",
"field4": "particella catastale"
},
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": Estratto Mappa Catastale",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 9.3,
"totalPrice": 9.3,
"documents": null,
"resultId": null,
"results": null,
"id": "68adca957a0be68c265a74b5"
},
"success": true,
"message": "",
"error": null
}
PATCH /requests/{_id}
Standardmäßig wird die Transaktion sofort abgeschlossen, wenn das Feld "STATE" nicht gesetzt ist, und deine Anfrage wird bearbeitet und erledigt. Wenn es jedoch gesetzt ist, wird die Transaktion gestartet, bleibt aber offen, sodass du die Anfrage über den Endpoint PATCH /requests/{_id} aktualisieren kannst.
Wenn die Anfrage den Status "erledigt" hat, kann das Dokument im PDF-Format heruntergeladen werden. Der Endpoint zum Herunterladen der durch die Anfrage generierten Dokumente lautet: GET /documents
Die Antwort gibt den Dateinamen, die Größe und die URL zum Herunterladen der Datei an.
{
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.
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 Kartenauszug (auf Italienisch "estratto mappa catastale" ermöglicht den Zugriff auf den offiziellen Kartenauszug, der in den digitalen Archiven der Agentur italienisch der Einnahmen verfügbar ist, d.h. auf die grafische Darstellung eines Gebiets, in der Regel im Maßstab 1:2000. Er umfasst die Daten eines bestimmten Grundstücks sowie die persönlichen Daten und die Steueridentifikationsnummer der Eigentümer und die Eigentumsanteile.
Der Kartenauszug ist ideal für diejenigen, die die Grenzen und relevanten Bereiche eines bestimmten Grundstücks oder Gebäudes kennen und die entsprechenden Katasterdaten einsehen möchten. Über zusätzliche Dienste können auch Informationen über den Eigentümer des Grundstücks oder Gebäudes erhalten werden.
Im Gegensatz zum Katasterplan kann der Kartenauszug von jedermann angefordert werden, auch wenn er nicht Eigentümer oder bevollmächtigter Vertreter ist.
Der Dienst ermöglicht den Zugriff auf Kartenauszüge für Immobilien im gesamten nationalen Gebiet, mit Ausnahme derjenigen, die sich in den Autonomen Provinzen Trient und Bozen befinden, die ihre eigenen Kataster- und Immobilien-Datenbanken unabhängig verwalten.
Ja, über die APIs von Openapi können Sie auf über 28 Dienste zugreifen, die dem Immobiliensektor gewidmet sind:
Diese Dienste sind über verschiedene APIs verfügbar: Docuengine, Kataster, Immobilien.
Das Dokument wird innerhalb von 2 Arbeitsstunden bereitgestellt.
Die Kosten für den Dienst betragen 9,30 € bei Vorauszahlung.