---
title: "Überblick"
description: "Die Objektverwaltung ist das führende System für alle vermarkteten Immobilien. Jedes Exposé, jedes Matching und jede Bewertung greift auf diese Daten zu."
url: "https://maklerportal.apim.eu/apis/objektverwaltung/docs/uebersicht"
image: "https://maklerportal.apim.eu/_og/d/c_Ocean.takumi,title_~w5xiZXJibGljaw,description_~RGllIE9iamVrdHZlcndhbHR1bmcgaXN0IGRhcyBmw7xocmVuZGUgU3lzdGVtIGbDvHIgYWxsZSB2ZXJtYXJrdGV0ZW4gSW1tb2JpbGllbi4gSmVkZXMgRXhwb3PDqSwgamVkZXMgTWF0Y2hpbmcgdW5kIGplZGUgQmV3ZXJ0dW5nIGdyZWlmdCBhdWYgZGllc2UgRGF0ZW4genUu,props_eyJ0aGVtZSI6eyJtb2RlIjoiZGFyayIsImNvbG9ycyI6eyJwcmltYXJ5IjoiI0Q0QTI0QyJ9fX0,p_Ii9hcGlzL29iamVrdHZlcndhbHR1bmcvZG9jcy91ZWJlcnNpY2h0Ig,s_AVyunvqDuH5styvI.png"
---

# Überblick

Die Objektverwaltung ist das führende System für alle vermarkteten Immobilien. Jedes Exposé, jedes Matching und jede Bewertung greift auf diese Daten zu.

## [Datenmodell](#datenmodell)

Ein Objekt vereint Stammdaten (Typ, Titel, Adresse), Kennzahlen (Flächen, Zimmer, Baujahr), kommerzielle Angaben (Kaufpreis oder Miete, Provision) und die Kennwerte des Energieausweises. Medien – Bilder, Grundrisse, Dokumente – hängen am Objekt, nicht am Exposé, und stehen dadurch allen späteren Dokumenten zur Verfügung.

## [Lebenszyklus](#lebenszyklus)

`entwurf` → `aktiv` → `reserviert` → `verkauft` bzw. `vermietet` → `archiviert`

Archivierte Objekte bleiben lesbar. Ein echtes Löschen gibt es nicht, weil Abrechnungen und Nachweise darauf verweisen.

## [OpenImmo](#openimmo)

`POST /import/openimmo` nimmt XML oder ZIP entgegen. Im Modus `ergaenzen` werden nur enthaltene Objekte angelegt oder aktualisiert; `ersetzen` archiviert zusätzlich alles, was nicht in der Datei steht. Für den nächtlichen Abgleich aus einer bestehenden Maklersoftware ist `ersetzen` der richtige Modus – aber erst, wenn der Export nachweislich vollständig ist.

## [Häufige Fehler](#häufige-fehler)

-   **Postleitzahl als Zahl.** `plz` ist eine Zeichenkette; führende Nullen gehen sonst verloren.
-   **Energieausweis erst später.** Beim Anlegen optional, aber ohne ihn scheitert die Veröffentlichung jedes Exposés.
-   **Titelbild fehlt.** Ohne `kategorie: "titelbild"` greift die Vorlage auf eine Platzhaltergrafik zurück.