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

draft → active → reserved → sold or rented → archived

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.