Overview

Property Management is the system of record for every listed property. Every listing, every match, and every valuation reads from this data.

Data model

A property combines master data (type, title, address), key figures (areas, rooms, year built), commercial details (purchase price or rent, commission), and energy-certificate figures. Media - photos, floor plans, documents - attach to the property, not to a listing, and are therefore available to every document generated later.

Lifecycle

draftactivereservedsold or rentedarchived

Archived properties remain readable. There's no true deletion, because settlements and disclosures reference them.

Property data feed

POST /import/feed accepts XML or a ZIP. In merge mode, only the properties in the file are created or updated; replace additionally archives anything not in the file. For a nightly sync from an existing agency system, replace is the right mode - but only once the export is verifiably complete.

Common Mistakes

  • Postal code as a number. postal_code is a string; leading zeros are otherwise lost.
  • Energy certificate added later. Optional at creation, but publishing any listing fails without it.
  • Missing cover photo. Without category: "cover_photo", the template falls back to a placeholder graphic.