Nutzung über die
API-Schnittstelle

Die Spezifikation der Rest-API finden Sie unter API-Dokumentation.

Dateneingabe

Die Immobiliendaten werden über POST /valuation/asset-value übertragen.

Vereinfachte Implementierung in PHP

$key = "IHR_API_KEY";
$url = "https://api.immonex-qv.de/valuation/asset-value";
$data = [
  "objectType" => "single_family_house",
  "street" => "Musterstraße",
  "zip" => 12345,
  "city" => "Musterstadt",
  "buildingLand" => 750,
  "houseNumber" => "1",
  "furnishings" => "none",
  "location" => "average",
  "degreeOfModernization" => 20,
  "yearOfConstruction" => 1980,
  "buildingType" => 23,
  "partOwnershipNumerator" => 1,
  "partOwnershipDenominator" => 1,
  "livingSpace" => 140,
  "coldRent" => 0,
  "units" => 1,
  "surcharge" => 10000,
  "discount" => 0,
  "standardLandValue" => 0,
  "remainingUsefulLife" => 0,
  "buildingPriceIndex" => 0,
  "propertyRate" => 0,
  "grossLandArea" => 0,
  "propertyValueFactor" => 0,
  "managementCosts" => 0
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Content-Type: application/json",
  "x-api-key: $key"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error    = curl_error($ch);

curl_close($ch);

if ($error) {
  // cURL Fehler behandeln...
} else if ($httpCode === 200) {
  // Bewertung erfolgreich erhalten...
  $json = json_decode($response, true);
  print_r($json);
} else if ($httpCode === 400) {
  // Validierungs-Fehler behandeln...
  $json = json_decode($response, true);
  print_r($json);
} else {
  // Sonstige Fehler behandeln...
}

Verarbeitung

Die Daten werden automatisch verarbeitet und die Bewertung nach dem ImmoWertV-Verfahren erstellt.

Bewertung

Die Bewertung wird per JSON-Response mitgeteilt.

{
  "marketValue": 468000,
  "standardLandValue": 235,
  "landValueSource": "Der Bodenrichtwert zum jüngsten verfügbaren Stichtag ...",
  "landValue": 176250,
  "remainingUsefulLife": 60,
  "grossLandArea": 177,
  "propertyValueFactor": 9,
  "propertyRate": 2.85,
  "buildingPriceIndex": 1.9041,
  "managementCosts": 0,
  "aiMarketValueMin": 445200,
  "aiMarketValueMax": 490800,
  "aiMarketValueAverage": 468000,
  "aiReview": "Die Immobilie in Musterstadt wurde nach dem ImmoWertV-Sachwertverfahren ..."
}

Hinweise

Es handelt sich um ein vereinfachtes Beispiel. In der Praxis sollten Sie die Daten sorgfältig validieren, Fehler behandeln und die Bewertungsergebnisse entsprechend weiterverarbeiten.