---
title: "Vom Objekt zum Exposé"
description: "Der komplette Weg: Objekt anlegen, Medien ergänzen, Exposé generieren, PDF abholen, veröffentlichen."
url: "https://maklerportal.apim.eu/leitfaeden/expose-workflow"
image: "https://maklerportal.apim.eu/_og/d/c_Ocean.takumi,title_~Vm9tIE9iamVrdCB6dW0gRXhwb3PDqQ,description_~RGVyIGtvbXBsZXR0ZSBXZWc6IE9iamVrdCBhbmxlZ2VuLCBNZWRpZW4gZXJnw6RuemVuLCBFeHBvc8OpIGdlbmVyaWVyZW4sIFBERiBhYmhvbGVuLCB2ZXLDtmZmZW50bGljaGVuLg,props_eyJ0aGVtZSI6eyJtb2RlIjoiZGFyayIsImNvbG9ycyI6eyJwcmltYXJ5IjoiI0Q0QTI0QyJ9fX0,p_Ii9sZWl0ZmFlZGVuL2V4cG9zZS13b3JrZmxvdyI,s_1zHWmKmVBeGU8D24.png"
---

## Vom Objekt zum Exposé

Fünf Schritte, die sich vollständig automatisieren lassen – vom leeren Datensatz bis zum veröffentlichten Dokument.

GEG Pflichtdaten Objektdaten

## [Schritt 1: Objekt anlegen](#schritt-1-objekt-anlegen)

Ein Exposé entsteht nie aus dem Nichts – es referenziert immer ein Objekt. Legen Sie es zuerst über die **Objektverwaltung** an.

```bash
curl -X POST https://api.maklerportal.example/v1/objekte \
  -H "apikey: $MAKLERPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "typ": "wohnung",
        "titel": "3-Zimmer-Altbau am Falkenried",
        "adresse": { "strasse": "Falkenried 42", "plz": "20251", "ort": "Hamburg" },
        "wohnflaeche_qm": 86.5,
        "zimmer": 3,
        "baujahr": 1908,
        "kaufpreis_eur": 645000,
        "provision": { "kaeufer_prozent": 3.57, "hinweis": "inkl. gesetzlicher USt." },
        "energieausweis": {
          "art": "verbrauchsausweis",
          "endenergiebedarf_kwh": 118.4,
          "energietraeger": "fernwaerme",
          "effizienzklasse": "D",
          "gueltig_bis": "2031-04-30"
        }
      }'
```

Der Block `energieausweis` ist beim Anlegen optional, für die spätere Veröffentlichung aber verpflichtend. Siehe [Pflichtangaben](https://maklerportal.apim.eu/leitfaeden/pflichtangaben).

## [Schritt 2: Medien hochladen](#schritt-2-medien-hochladen)

Bilder und Grundrisse werden dem Objekt zugeordnet, nicht dem Exposé. So stehen sie allen späteren Exposés und Vorlagen zur Verfügung.

```bash
curl -X POST https://api.maklerportal.example/v1/objekte/obj_8f2c1a/medien \
  -H "apikey: $MAKLERPORTAL_API_KEY" \
  -F "datei=@wohnzimmer.jpg" \
  -F "kategorie=innenansicht" \
  -F "reihenfolge=1"
```

Empfohlen sind mindestens ein Titelbild (`kategorie=titelbild`) und ein Grundriss (`kategorie=grundriss`). Fehlt das Titelbild, greift die Vorlage auf eine neutrale Platzhaltergrafik zurück.

## [Schritt 3: Exposé generieren](#schritt-3-exposé-generieren)

Wer den Ablauf zuerst ohne Code sehen möchte: Der [Exposé-Generator](https://maklerportal.apim.eu/expose-generator) nimmt dieselben Objektdaten über ein Formular entgegen und erzeugt daraus per Sprachmodell einen fertigen Exposé-Text – der Aufruf läuft über das Kong AI Gateway.

```bash
curl -X POST https://api.maklerportal.example/v1/exposes \
  -H "apikey: $MAKLERPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "objekt_id": "obj_8f2c1a",
        "vorlage_id": "vrl_klassik",
        "sprache": "de",
        "abschnitte": ["lage", "ausstattung", "energie", "grundriss", "provision"]
      }'
```

```json
{
  "id": "exp_4d9b2e",
  "objekt_id": "obj_8f2c1a",
  "vorlage_id": "vrl_klassik",
  "status": "in_arbeit",
  "erstellt_am": "2026-08-20T09:41:12Z"
}
```

Die Generierung ist asynchron, weil Bilder skaliert und das PDF gesetzt werden muss. Üblich sind zwei bis zehn Sekunden.

## [Schritt 4: Ergebnis abholen](#schritt-4-ergebnis-abholen)

Zwei Wege führen zum fertigen Dokument:

**Ereignisgesteuert (empfohlen).** Abonnieren Sie `expose.fertiggestellt`; der Webhook trägt die Exposé-ID und den Download-Link. Siehe [Webhooks](https://maklerportal.apim.eu/leitfaeden/webhooks).

**Abfragend.** Fragen Sie `GET /exposes/{id}` mit ansteigendem Abstand ab (1 s, 2 s, 4 s, 8 s), bis `status` auf `fertig` steht:

```bash
curl https://api.maklerportal.example/v1/exposes/exp_4d9b2e/pdf \
  -H "apikey: $MAKLERPORTAL_API_KEY" \
  -o expose-falkenried.pdf
```

Der Link aus `pdf_url` ist 24 Stunden gültig. Speichern Sie das Dokument, statt den Link weiterzugeben.

## [Schritt 5: Veröffentlichen](#schritt-5-veröffentlichen)

```bash
curl -X POST https://api.maklerportal.example/v1/exposes/exp_4d9b2e/veroeffentlichen \
  -H "apikey: $MAKLERPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kanaele": ["portal", "website", "newsletter"] }'
```

Vor der Veröffentlichung prüft die API die Pflichtangaben. Fehlt etwas, kommt `422`:

```json
{
  "code": "pflichtangabe_fehlt",
  "nachricht": "Für die Veröffentlichung fehlen Pflichtangaben aus dem Energieausweis.",
  "details": [
    { "feld": "energieausweis.endenergiebedarf", "grund": "fehlt" }
  ]
}
```

Ergänzen Sie die Angabe am **Objekt**, generieren Sie das Exposé neu und veröffentlichen Sie erneut. Ein bereits erzeugtes Exposé wird nicht nachträglich verändert – das hält die Historie nachvollziehbar.

## [Typische Stolpersteine](#typische-stolpersteine)

-   **Exposé ohne Objektbezug.** `objekt_id` ist Pflicht; freie Exposés gibt es bewusst nicht.
-   **Vorlage aus einer anderen Mandanteneinheit.** `vorlage_id` muss zu Ihrem Mandanten gehören, sonst `404`.
-   **PDF zu früh abgeholt.** Vor `status: "fertig"` liefert `/pdf` ein `409`.
-   **Preisänderung ohne Neugenerierung.** Ein geändertes Objekt aktualisiert bestehende Exposés nicht automatisch.