# Fehlercodes von App und MCP: was jeder Code bedeutet

Adresse: https://docs.athaus.ai/api/fehlercodes

> Jeder Code, den die App und die MCP-Server nach außen geben, mit seiner Bedeutung. Erzeugt aus dem Verzeichnis, gegen das sie getippt sind.

Typ: Referenz
Zuletzt aktualisiert: 2026-11-16

Hier stehen die Codes der App und der MCP-Server, nicht die von `/v1`. Die Wege der App antworten schlicht mit `{ "error": "rate_limited" }`, die MCP-Server bei einer Drossel mit `data.error` im JSON-RPC-Fehler. Hier steht das Verzeichnis dieser Codes. Der Code ist eine Kennung für eine Verzweigung, kein Satz für Menschen; es gibt genau einen je Bedeutung. Verzweige auf den Code, nie auf den Status allein. Die REST-API unter `/v1` hat eigene englische Codes und eine eigene Seite: [Fehlercodes der API](/api/errors). Hat ein Code hier eine Entsprechung bei `/v1`, steht sie am Ende seiner Zeile. Das Format der Fehler von `/v1` steht unter [Fehler](/api/v1/fehler).

## Anmeldung und Konto [#anmeldung-und-konto]

| Code                                                          | Bedeutung                                                                                      |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `account_exists`             | Zu dieser Adresse gibt es schon ein Konto.                                                     |
| `no_account`                     | Zu dieser Adresse gibt es kein Konto.                                                          |
| `passwort_anmeldung`     | Diese Adresse meldet sich mit einem Passwort an; ein Code wird nicht verschickt.               |
| `konto_pruefung_fehlt` | Die Kontoprüfung war nicht erreichbar.                                                         |
| `wegwerf_adresse`           | Eine Wegwerfadresse. An sie kommt keine Antwort an.                                            |
| `adresse_unzustellbar` | Die Domain der Adresse nimmt keine Post an: es gibt sie nicht, oder sie hat keinen Mailserver. |
| `invalid_code`                 | Der eingegebene Code stimmt nicht.                                                             |

## Zwei-Faktor-Anmeldung [#zwei-faktor-anmeldung]

| Code                                                                                  | Bedeutung                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zweiter_faktor_code_falsch`             | Der Code der Zwei-Faktor-Anmeldung stimmt nicht: weder der Code der Authenticator-App noch ein unbenutzter Sicherungscode.                                                                                                                                                |
| `zweiter_faktor_nicht_aktiv`             | Für dieses Konto ist die Zwei-Faktor-Anmeldung nicht eingeschaltet.                                                                                                                                                                                                       |
| `zweiter_faktor_gesperrt`                   | Zu viele falsche Codes der Zwei-Faktor-Anmeldung hintereinander; das Konto nimmt für eine Viertelstunde keine weiteren an.                                                                                                                                                |
| `zweiter_faktor_mailcode_falsch`     | Der per Mail geschickte Code für das Einschalten stimmt nicht oder ist abgelaufen.                                                                                                                                                                                        |
| `zweiter_faktor_mailcode_unnoetig` | Dieses Konto hat ein Passwort und weist sich damit beim Einschalten aus; ein Mailcode wird nur ohne Passwort verlangt.                                                                                                                                                    |
| `unauthorized`                                         | Keine gültige Sitzung.                                                                                                                                                                                                                                                    |
| `forbidden`                                               | Angemeldet, aber nicht berechtigt.                                                                                                                                                                                                                                        |
| `passwort_nicht_offen`                         | Zu diesem Konto steht kein Passwort zum Festlegen aus: es wurde schon festgelegt, ist zu alt, oder das Konto hat nie eines gebraucht.                                                                                                                                     |
| `herkunft_unzulaessig`                         | Eine Anfrage mit Sitzungscookie kommt von einer Seite, die nicht zu Athaus gehört.                                                                                                                                                                                        |
| `schluessel_recht_fehlt`                     | Dem API-Schlüssel fehlt das Recht für diesen Weg: außerhalb des MCP-Servers schreibt nur ein Schlüssel mit dem Recht freigeben, und an /v1 entscheidet das Recht je Ressource mit. Bei `/v1` heißt er [`insufficient_permissions`](/api/errors#insufficient_permissions). |
| `schluessel_nur_v1`                               | Der API-Key ist je Ressource enger gefasst und gilt nur an /v1: am MCP-Server und an den Wegen der App gibt es diese Begrenzung nicht, und sie soll dort nicht still entfallen.                                                                                           |
| `verbindung_ungueltig`                         | Die Zustimmung zu einer Verbindung ist abgelaufen, verändert, gehört zu keinem bekannten Client oder mischt die Rechte beider Seiten.                                                                                                                                     |
| `seite_fehlt`                                           | Diesem Konto fehlt das Produkt, das dieser Weg oder diese Verbindung verlangt: die Suche, oder die Anbieterseite mit aktiver Mitgliedschaft im Büro.                                                                                                                      |
| `contact_missing`                                   | Zur Sitzung gibt es keinen Kontakt.                                                                                                                                                                                                                                       |
| `confirmation_mismatch`                       | Die Bestätigung stimmt nicht mit der Vorgabe überein.                                                                                                                                                                                                                     |

## Freigabeliste (Panel) [#freigabeliste-panel]

| Code                                                      | Bedeutung                                                                                 |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `freigabe_vorhanden` | Für diese Adresse oder Domain gilt schon eine Freigabe.                                   |
| `domain_zu_breit`       | Eine Domain eines Mailanbieters lässt sich nicht freigeben, nur einzelne Adressen darauf. |

## Team (Panel) [#team-panel]

| Code                                                                | Bedeutung                                                                                          |
| ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `admin_vorhanden`                 | Diese Adresse hat diese Rolle schon oder steht schon im Team.                                      |
| `admin_aus_konfiguration` | Diese Adresse ist Inhaber über ADMIN\_EMAILS; im Panel lässt sie sich weder ändern noch entfernen. |
| `letzter_inhaber`                 | Das ist der letzte Inhaber; ohne ihn könnte niemand mehr das Team verwalten.                       |
| `eigene_rolle`                       | Die eigene Rolle lässt sich nicht anheben.                                                         |

## Support-Ansicht (Panel und App) [#support-ansicht-panel-und-app]

| Code                                                                        | Bedeutung                                                                                                                                          |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uebernahme_grund_fehlt`           | Der Grund der Support-Ansicht fehlt oder ist kürzer als zehn Zeichen.                                                                              |
| `uebernahme_ziel_gesperrt`       | Diese Person lässt sich nicht ansehen: ein Admin, die eigene Adresse oder ein Konto ohne Anmeldung.                                                |
| `uebernahme_nur_lesen`               | Dieser Weg ist in der Support-Ansicht nicht erlaubt: sie liest nur, und was schreibt, versendet, zahlt, löscht oder Zugänge vergibt, ist gesperrt. |
| `uebernahme_abgelaufen`             | Die Support-Ansicht ist abgelaufen, beendet oder widerrufen.                                                                                       |
| `uebernahme_ticket_ungueltig` | Das Ticket der Support-Ansicht ist abgelaufen, schon eingelöst oder gehört zu einer anderen Sitzung des Panels.                                    |

## Form der Anfrage [#form-der-anfrage]

| Code                                                                            | Bedeutung                                                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid_body`                                   | Der Rumpf passt nicht zum Schema.                                                                                                                                                                                                                                                                       |
| `invalid_field`                                 | Ein Feld im Rumpf wurde abgelehnt; `field` nennt seinen Pfad in den englischen Namen des Schemas.                                                                                                                                                                                                       |
| `invalid_query`                                 | Die Abfrageparameter passen nicht zum Schema.                                                                                                                                                                                                                                                           |
| `invalid_id`                                       | Die Kennung ist keine gültige Kennung.                                                                                                                                                                                                                                                                  |
| `invalid_input`                                 | Die Eingabe passt nicht.                                                                                                                                                                                                                                                                                |
| `query_required`                               | Es fehlt die Suchabfrage.                                                                                                                                                                                                                                                                               |
| `no_fields`                                         | Es wurde kein einziges Feld geschickt.                                                                                                                                                                                                                                                                  |
| `unknown_key`                                     | Der Schlüssel ist unbekannt.                                                                                                                                                                                                                                                                            |
| `missing_property_id`                     | Es fehlt die Kennung der Immobilie.                                                                                                                                                                                                                                                                     |
| `payload_too_large`                         | Der Rumpf oder die Datei ist größer als erlaubt.                                                                                                                                                                                                                                                        |
| `not_found`                                         | Es gibt nichts unter dieser Kennung.                                                                                                                                                                                                                                                                    |
| `fassung_unbekannt`                         | Die angefragte Fassung der öffentlichen API (Kopf Athaus-Version) gibt es nicht. Bei `/v1` heißt er [`api_version_unsupported`](/api/errors#api_version_unsupported).                                                                                                                                   |
| `method_not_allowed`                       | Dieser Pfad der öffentlichen API kennt die Methode nicht.                                                                                                                                                                                                                                               |
| `referenz_vergeben`                         | Die Referenznummer gehört in diesem Büro schon einer anderen Immobilie. Bei `/v1` heißt er [`reference_already_exists`](/api/errors#reference_already_exists).                                                                                                                                          |
| `idempotenz_rumpf_abweichend`     | Der Idempotenzschlüssel der öffentlichen API wurde schon mit einem anderen Rumpf benutzt. Bei `/v1` heißt er [`idempotency_key_reused`](/api/errors#idempotency_key_reused).                                                                                                                            |
| `idempotenz_schluessel_fehlt`     | Die Operation geht über das Büro hinaus und verlangt den Kopf Idempotency-Key; er fehlt. Bei `/v1` heißt er [`idempotency_key_missing`](/api/errors#idempotency_key_missing).                                                                                                                           |
| `idempotenz_laeuft`                         | Zu diesem Idempotenzschlüssel läuft noch die erste Anfrage; nach ihrem Ende liefert derselbe Schlüssel ihre Antwort. Bei `/v1` heißt er [`idempotency_key_in_use`](/api/errors#idempotency_key_in_use).                                                                                                 |
| `idempotenz_ausgang_unklar`         | Die erste Anfrage zu diesem Idempotenzschlüssel endete ohne gespeicherte Antwort; ob sie schrieb, ist offen. Nachsehen, dann mit einem neuen Schlüssel wiederholen. Bei `/v1` heißt er [`idempotency_outcome_unknown`](/api/errors#idempotency_outcome_unknown).                                        |
| `bedingung_nicht_erfuellt`           | Die Bedingung der Anfrage (If-Match oder If-None-Match) trifft auf den heutigen Stand der Ressource nicht zu; geschrieben wurde nichts. Neu lesen, die Änderung auf den neuen Stand legen, mit dem neuen ETag wiederholen. Bei `/v1` heißt er [`precondition_failed`](/api/errors#precondition_failed). |
| `termine_offen`                                 | Die Immobilie hat noch bevorstehende Termine; ein Löschen sagte sie den Gästen ab. Die Termine erst absagen. Bei `/v1` heißt er [`upcoming_viewings_exist`](/api/errors#upcoming_viewings_exist).                                                                                                       |
| `webhook_limit_erreicht`               | Das Büro hat schon so viele Webhook-Endpunkte, wie die öffentliche API erlaubt. Einen löschen, dann anlegen. Bei `/v1` heißt er [`webhook_endpoint_limit_exceeded`](/api/errors#webhook_endpoint_limit_exceeded).                                                                                       |
| `webhook_url_kein_https`               | Die Adresse des Webhook-Endpunkts beginnt nicht mit https.                                                                                                                                                                                                                                              |
| `webhook_url_anmeldedaten`           | Die Adresse des Webhook-Endpunkts enthält einen Benutzernamen oder ein Passwort.                                                                                                                                                                                                                        |
| `webhook_url_nicht_oeffentlich` | Die Adresse des Webhook-Endpunkts zeigt auf einen Rechner, der nicht öffentlich erreichbar ist.                                                                                                                                                                                                         |
| `webhook_url_unaufloesbar`           | Der Rechnername in der Adresse des Webhook-Endpunkts lässt sich nicht auflösen.                                                                                                                                                                                                                         |
| `webhook_url_ungueltig`                 | Die Adresse des Webhook-Endpunkts ist keine gültige Adresse.                                                                                                                                                                                                                                            |
| `testbuero_voll`                               | Das Testbüro ist voll (Immobilien, Kontakte oder Dateien); etwas löschen oder das Testbüro zurücksetzen. Bei `/v1` heißt er [`test_office_full`](/api/errors#test_office_full).                                                                                                                         |
| `test_key_limit_erreicht`             | Das Büro hat schon so viele gültige Test-Keys, wie erlaubt sind (10). Einen widerrufen, dann einen neuen anlegen.                                                                                                                                                                                       |
| `testbuero_beschaeftigt`               | Das Testbüro wird gerade aufgebaut oder zurückgesetzt; in einigen Sekunden noch einmal versuchen. Bei `/v1` heißt er [`test_office_busy`](/api/errors#test_office_busy).                                                                                                                                |

## Drossel [#drossel]

| Code                                                                | Bedeutung                                                                                               |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `rate_limited`                       | Zu viele Anfragen in zu kurzer Zeit.                                                                    |
| `tageslimit_erreicht`         | Das Tageslimit des Chats ist erreicht; es gilt bis zum Ende des Tages, Warten von Sekunden hilft nicht. |
| `measurement_daily_limit` | Für heute sind alle Messungen von Hand verbraucht; ab morgen geht es wieder.                            |

## Dateien [#dateien]

| Code                                                                | Bedeutung                                                                                                       |
| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `datei_fehlt`                         | Es war keine Datei dabei.                                                                                       |
| `invalid_attachment`           | Der Anhang ist nicht erlaubt.                                                                                   |
| `typ_nicht_erlaubt`             | Dieser Dateityp ist nicht erlaubt.                                                                              |
| `typ_stimmt_nicht`               | Der Inhalt der Datei passt nicht zu ihrem Typ.                                                                  |
| `zu_viele`                               | Mehr Dateien, als erlaubt sind.                                                                                 |
| `upload_unvollstaendig`     | Der Upload in Teilen ist nicht vollständig: es fehlen Teile, oder die Datei ist nicht so gross wie angekündigt. |
| `zu_gross_gesamt`                 | Die Dateien zusammen sind größer als erlaubt.                                                                   |
| `kein_xml`                               | Die Datei ist kein XML.                                                                                         |
| `kein_openimmo`                     | Das XML ist kein OpenImmo.                                                                                      |
| `kaputt`                                   | Die Datei ließ sich nicht lesen.                                                                                |
| `leer`                                       | Die Datei oder der Wurf enthält nichts.                                                                         |
| `unbekanntes_fach`               | Dieses Fach der Ablage gibt es nicht.                                                                           |
| `datei_nicht_abrufbar`       | Die Datei ließ sich unter der genannten Adresse nicht abrufen.                                                  |
| `website_fehlt`                     | Im Profil steht keine Website.                                                                                  |
| `messung_laeuft`                   | Für dieses Büro läuft schon eine Messung der KI-Sichtbarkeit.                                                   |
| `nicht_messbar`                     | Dem Büro fehlt der Ort, ohne den sich keine Fragen der KI-Sichtbarkeit bauen lassen.                            |
| `aktion_angenommen`             | Zu dieser Aktion der KI-Sichtbarkeit gibt es schon eine offene Aufgabe.                                         |
| `kuerzel_fehlt`                     | Das Büro hat noch kein Kürzel, ohne das es keine öffentliche Adresse gibt.                                      |
| `profil_ohne_daten`             | Das Büro hat weder Objekte noch Inserate, aus denen ein Profil entstehen könnte.                                |
| `kein_entwurf`                       | Zu dieser Aktion gibt es noch keinen Entwurf, den man freigeben könnte.                                         |
| `zu_wenig_belege`                 | Die Daten des Büros tragen keine Antwort auf diese Frage.                                                       |
| `antwort_unbelegt`               | Der Entwurf der Antwort stimmt nicht mit den Daten des Büros überein.                                           |
| `optimierung_laeuft`           | Für dieses Objekt läuft schon eine Optimierung.                                                                 |
| `objekt_gesperrt`                 | Das Objekt lässt sich gerade nicht ändern, etwa weil sein Inserat gesperrt ist.                                 |
| `visibility_credits_leer` | Die Visibility-Credits sind aufgebraucht; eine Messung von Hand braucht einen je Markt.                         |
| `einrichtung_fehlt`             | Die KI-Sichtbarkeit des Büros ist noch nicht eingerichtet: erst die Einrichtung abschliessen, dann messen.      |
| `logo_nicht_gefunden`         | Die Website nennt kein Zeichen, das sich als Bild laden lässt.                                                  |

## Tarif und Bezahlung [#tarif-und-bezahlung]

| Code                                                                        | Bedeutung                                                                                                                                                 |
| --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payment_required`                       | Ohne Bezahlung geht es hier nicht weiter.                                                                                                                 |
| `plan_required`                             | Der Tarif enthält diese Leistung nicht.                                                                                                                   |
| `tarif_zu_klein`                           | Der Tarif enthält diese Leistung nicht (Anbieterseite). Bei `/v1` heißt er [`plan_required`](/api/errors#plan_required).                                  |
| `profile_unsupported`                 | Für dieses Land gibt es kein Länderprofil.                                                                                                                |
| `listing_blocked`                         | Athaus hat das Inserat gesperrt.                                                                                                                          |
| `listing_closed`                           | Das Objekt ist verkauft oder vermietet und geht nicht wieder online.                                                                                      |
| `listing_incomplete`                   | Dem Inserat fehlen Angaben für die Veröffentlichung.                                                                                                      |
| `listing_not_online`                   | Das Inserat läuft gerade nicht.                                                                                                                           |
| `listing_reserved`                       | Das Objekt ist reserviert.                                                                                                                                |
| `listing_not_unit`                       | Das Inserat gehört zu keinem Neubauprojekt.                                                                                                               |
| `project_not_empty`                     | Das Projekt hat noch Einheiten.                                                                                                                           |
| `project_unit_limit_exceeded` | Das Projekt hat schon so viele Einheiten, wie eines haben kann.                                                                                           |
| `unit_already_exists`                 | Diese Einheitsnummer gibt es im Projekt schon.                                                                                                            |
| `unit_status_invalid`                 | Dieser Stand passt nicht zur Vermarktungsart des Projekts.                                                                                                |
| `quota_exceeded`                           | Die Grenze des Tarifs ist erreicht (Suchende, nur bei Kaufobjekten).                                                                                      |
| `mandate_limit`                             | Mehr Suchaufträge, als der Tarif erlaubt.                                                                                                                 |
| `nur_kauf`                                       | Gibt es nur bei Kaufsuchen; bei Mietsuchen für kein Konto.                                                                                                |
| `abo_vorhanden`                             | Es läuft schon ein Abo.                                                                                                                                   |
| `zustimmung_fehlt`                       | Es fehlt eine Erklärung, die der Kauf braucht: die Zustimmung zu AGB und AV-Vertrag in ihrer aktuellen Fassung oder das Verlangen nach sofortigem Beginn. |
| `kein_wechsel`                               | Ein Wechsel auf denselben Tarif ist keiner.                                                                                                               |
| `no_customer`                                 | Zu diesem Konto gibt es keinen Kunden bei Stripe.                                                                                                         |
| `plan_not_configured`                 | Zu diesem Tarif ist kein Preis hinterlegt.                                                                                                                |
| `billing_not_configured`           | Die Bezahlung ist nicht eingerichtet.                                                                                                                     |
| `billing_unavailable`                 | Der Bezahldienst antwortet nicht.                                                                                                                         |
| `print_unavailable`                     | Der Druck des PDF antwortet gerade nicht oder zu langsam.                                                                                                 |
| `verkauf_pausiert`                       | Der Verkauf ist vom Betrieb pausiert.                                                                                                                     |
| `kuendigung_fehlgeschlagen`     | Die Kündigung ging nicht durch.                                                                                                                           |
| `widerruf_fehlgeschlagen`         | Der Widerruf ging nicht durch.                                                                                                                            |
| `kein_abo`                                       | Zu diesem Konto läuft kein Abo.                                                                                                                           |
| `nicht_gekuendigt`                       | Es liegt keine Kündigung vor, die sich zurücknehmen ließe.                                                                                                |
| `maklervertrag_offen`                 | Es läuft noch ein Maklervertrag. Bei `/v1` heißt er [`brokerage_agreement_active`](/api/errors#brokerage_agreement_active).                               |
| `konto_intern`                               | Das Konto ist intern und trägt seinen Plan schon ohne Zahlung.                                                                                            |
| `angebot_unbekannt`                     | Das Angebot gibt es nicht.                                                                                                                                |
| `angebot_bezahlt`                         | Das Angebot ist schon bezahlt oder die Zahlung läuft.                                                                                                     |
| `konto_vorhanden`                         | Zu dieser Adresse gibt es schon ein Konto; ein Angebot für einen Neukunden gibt es nur ohne.                                                              |
| `vorkasse_nur_karte`                   | Die Zahlung zum Start gibt es nur mit Bezahllink, nicht mit Rechnung.                                                                                     |
| `zusatz_nicht_buchbar`               | Dieser Zusatz lässt sich zu diesem Plan nicht buchen (Visibility+ nicht zu Basic).                                                                        |
| `zusatz_takt`                                 | Ein Zusatz gilt nur bei Abrechnung im Monat oder im Jahr, nicht für einen Zeitraum nach Wahl und nicht mit der Zahlung zum Start.                         |
| `kein_empfaenger`                         | Das Büro hat keinen Inhaber mit Adresse, und es wurde keine Adresse angegeben.                                                                            |
| `invitation_in_use`                     | Für diesen Anbieter läuft schon ein Abo, eine Testphase oder ein bezahltes Angebot; die Einladung bleibt.                                                 |
| `invitation_expired`                   | Die Einladung ist abgelaufen. Das Team schickt sie dir gern noch einmal, dann kannst du dich anmelden.                                                    |
| `invitation_offer_open`             | Für diesen Anbieter ist noch ein Angebot offen; erst das Angebot zurücknehmen.                                                                            |
| `invitation_offer_path`             | Dieser Anbieter wurde über ein Angebot angelegt, das noch nicht bezahlt ist; schick das Angebot neu.                                                      |
| `invitation_path_unknown`         | Im Verlauf steht nicht vollständig, wie dieser Anbieter angelegt wurde; die Einladung geht so nicht noch einmal raus.                                     |

## Suchauftrag [#suchauftrag]

| Code                                                      | Bedeutung                                                                          |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| `mandate_conflict`     | Der Suchauftrag widerspricht einem bestehenden.                                    |
| `mandate_incomplete` | Dem Suchauftrag fehlen Pflichtangaben.                                             |
| `no_active_mandate`   | Es gibt keinen laufenden Suchauftrag.                                              |
| `send_failed`               | Die Sendung ging nicht raus.                                                       |
| `claim_not_stored`     | Der Anspruch wurde nicht hinterlegt.                                               |
| `schon_angefragt`       | Zu dieser Immobilie gibt es schon eine Anfrage.                                    |
| `kein_uebergang`         | Der Treffer steht inzwischen anders; die Entscheidung führt von dort nirgends hin. |
| `schon_geteilt`           | Diese Angaben sind an dieser Anfrage schon geteilt.                                |

## Inserat und Objekt [#inserat-und-objekt]

| Code                                                                    | Bedeutung                                                                                                                                                                                               |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `unvollstaendig`                       | Dem Inserat fehlen Pflichtangaben.                                                                                                                                                                      |
| `inserat_abgeschlossen`         | Die Immobilie ist verkauft oder vermietet.                                                                                                                                                              |
| `inserat_reserviert`               | Die Immobilie ist reserviert.                                                                                                                                                                           |
| `inserat_gesperrt`                   | Das Inserat ist gesperrt.                                                                                                                                                                               |
| `kuerzel_vergeben`                   | Das Kürzel hat schon jemand.                                                                                                                                                                            |
| `interessent_doppelt`             | Zu dieser Mailadresse gibt es an diesem Objekt schon einen Interessenten.                                                                                                                               |
| `keine_adresse`                         | Es fehlt die Anschrift. Bei `/v1` heißt er [`address_missing`](/api/errors#address_missing).                                                                                                            |
| `adresse_vergeben`                   | Zu dieser Anschrift gibt es schon eine Immobilie. Bei `/v1` heißt er [`address_already_exists`](/api/errors#address_already_exists).                                                                    |
| `plz_land`                                   | Die Postleitzahl passt nicht zum Land der Anschrift.                                                                                                                                                    |
| `einheit_nr_vergeben`             | Im Projekt gibt es schon eine Einheit mit dieser Nummer.                                                                                                                                                |
| `projekt_nicht_leer`               | Das Projekt hat noch Einheiten und lässt sich nicht entfernen.                                                                                                                                          |
| `status_in_gebrauch`               | Der Projektstatus wird noch von Projekten benutzt und lässt sich nicht entfernen.                                                                                                                       |
| `seite_unvollstaendig`           | Der Seite des Projekts fehlen Angaben; sie lässt sich erst freigeben, wenn sie nachgetragen sind.                                                                                                       |
| `seite_zurueckgezogen`           | Der Makler hat die Seite dieses Projekts vom Netz genommen; sie bleibt weg, bis er sie neu freigibt.                                                                                                    |
| `mail_widerspruch`                   | Der Kontakt hat E-Mails widersprochen oder seine Einwilligung widerrufen; nur eine Antwort auf seine eigene Nachricht darf hinaus. Bei `/v1` heißt er [`email_opted_out`](/api/errors#email_opted_out). |
| `mail_ohne_einwilligung`       | Für diese Werbemail liegt keine Einwilligung des Kontakts in E-Mails vor. Bei `/v1` heißt er [`email_consent_missing`](/api/errors#email_consent_missing).                                              |
| `consent_revoked`                     | Für diesen Weg liegt ein Widerruf vor; eine Einwilligung von Hand hebt ihn nicht auf.                                                                                                                   |
| `eigene_adresse`                       | Die eigene Adresse lässt sich nicht einladen.                                                                                                                                                           |
| `schon_eingeladen`                   | Diese Person ist schon eingeladen.                                                                                                                                                                      |
| `inhaber_nicht_entfernbar`   | Der Inhaber lässt sich nicht aus seiner Organisation entfernen; ohne ihn hätte sie niemanden, der einlädt, abrechnet oder kündigt.                                                                      |
| `inhaber_zuerst_uebergeben` | Der Inhaber muss die Inhaberschaft erst an ein anderes aktives Mitglied geben, bevor er geht.                                                                                                           |
| `eigenes_buero_nicht_leer`   | Das eigene Büro der Person hat noch Bestand, Mitglieder oder ein laufendes Abo und lässt sich für die Einladung nicht stillschweigend aufgeben; die Antwort nennt, was es noch hält.                    |
| `schon_notiert`                         | Dieser Satz steht schon als Notiz am selben Gegenstand.                                                                                                                                                 |
| `entwurf_leer`                           | Der Entwurf kam leer zurück.                                                                                                                                                                            |
| `entwurf_fehlgeschlagen`       | Der Entwurf ließ sich nicht erzeugen.                                                                                                                                                                   |
| `versand_fehlgeschlagen`       | Der Versand ging nicht durch.                                                                                                                                                                           |
| `zu_wenig`                                   | Zu wenig Material für diesen Schritt.                                                                                                                                                                   |
| `seller_disabled`                     | Die Anbieterseite ist abgeschaltet.                                                                                                                                                                     |
| `abruf`                                         | Der Abruf beim fremden System schlug fehl.                                                                                                                                                              |
| `abgeschlossen`                         | Der Vorgang ist abgeschlossen und nicht mehr zu ändern.                                                                                                                                                 |
| `inserat_aktiv`                         | Die Immobilie ist noch inseriert. Bei `/v1` heißt er [`listing_active`](/api/errors#listing_active).                                                                                                    |
| `nicht_online`                           | Das Inserat läuft gerade nicht.                                                                                                                                                                         |
| `beispielobjekt`                       | Die Immobilie ist ein erfundenes Beispielobjekt; an sie geht keine Anfrage.                                                                                                                             |
| `impressum_fehlt`                     | Ein gewerblicher Anbieter braucht ein hinterlegtes Impressum, bevor seine Objekte in ChatGPT und Claude erscheinen.                                                                                     |

## Anfrage ohne Konto [#anfrage-ohne-konto]

| Code                                                      | Bedeutung                                                                                                          |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `einwilligung_fehlt` | Es fehlt die ausdrückliche Einwilligung in die Weitergabe der Anfrage an den Anbieter, in ihrer aktuellen Fassung. |

## Exposé-Zugang [#exposé-zugang]

| Code                                                                        | Bedeutung                                                                                                                                                      |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `expose_gesperrt`                         | Das Exposé wird nicht ausgegeben: die Provision ist so nicht zulässig, oder die Angaben des Maklers fehlen.                                                    |
| `expose_widerrufen`                     | Der Maklervertrag zu diesem Exposé ist widerrufen; der Zugang ist beendet.                                                                                     |
| `expose_unvollstaendig`             | Das Exposé lässt sich noch nicht veröffentlichen; die Antwort nennt in `fehlt`, was fehlt.                                                                     |
| `expose_tor_pflicht`                   | Das Tor lässt sich nicht ausschalten: eine Provision verlangt die Bestätigung der Texte.                                                                       |
| `expose_positionen_ungueltig` | Die Plätze passen nicht: ein Bild oder eine Datei gehört nicht zum Objekt, passt nicht zum Platz, oder ein Platz ist zu oft belegt.                            |
| `expose_nicht_live`                     | Das Exposé ist nicht veröffentlicht; einen Link gibt es erst, wenn es live ist.                                                                                |
| `expose_nur_entwurf`                   | Löschen geht nur bei einem Entwurf oder einem zurückgezogenen Exposé, das keine Person geöffnet oder angefordert hat; ein veröffentlichtes wird zurückgezogen. |
| `expose_bau_laeuft`                     | Das Exposé wird gerade gebaut; ein zweiter Bau beginnt, wenn der erste fertig ist.                                                                             |
| `expose_ohne_adresse`                 | Zu diesem Link gehört keine E-Mail-Adresse; das Exposé muss mit Namen und Adresse angefordert werden.                                                          |
| `branding_keine_website`           | Im Profil des Büros steht keine Website, von der Farbe und Schrift gelesen werden könnten.                                                                     |
| `branding_nicht_gelesen`           | Die Website war nicht erreichbar oder hat keine lesbare Seite.                                                                                                 |
| `provision_widerspruch`             | Die Käuferprovision widerspricht sich: Schalter, Satz und Text der Klausel passen nicht zusammen.                                                              |
| `provision_miete`                         | Beim Mieten schuldet der Mieter keine Provision; es gibt nur provisionsfrei.                                                                                   |

## CRM [#crm]

| Code                                              | Bedeutung                                                                                                                                        |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `email_vergeben` | Zu dieser Mailadresse gibt es in diesem Büro schon einen Kontakt. Bei `/v1` heißt er [`email_already_exists`](/api/errors#email_already_exists). |
| `name_vergeben`   | Eine Liste dieser Art oder ein Projektstatus trägt den Namen schon.                                                                              |

## Anbindungen an fremde Systeme [#anbindungen-an-fremde-systeme]

| Code                                                                          | Bedeutung                                             |
| ----------------------------------------------------------------------------- | ----------------------------------------------------- |
| `geheimnis_nicht_eingerichtet` | Zugangsdaten lassen sich gerade nicht sicher ablegen. |
| `anbindung_nicht_gespeichert`   | Die Anbindung ließ sich nicht speichern.              |

## Portalversand [#portalversand]

| Code                                                                                | Bedeutung                                                                                                                      |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `portal_nicht_verbunden`                   | Das Portal ist für dieses Büro nicht verbunden.                                                                                |
| `portal_unvollstaendig`                     | Dem Objekt fehlt etwas für dieses Portal; die Antwort nennt die Punkte.                                                        |
| `portal_unterwegs`                               | Für dieses Objekt läuft bei diesem Portal schon ein Auftrag.                                                                   |
| `portal_nichts_zu_entfernen`           | Das Objekt steht bei diesem Portal nicht.                                                                                      |
| `portal_anmeldung`                               | Benutzer oder Kennwort hat der Server des Portals nicht angenommen.                                                            |
| `portal_adresse`                                   | Die Adresse des Portal-Servers fehlt oder zeigt in ein privates Netz.                                                          |
| `portal_sftp`                                         | Der Port gehört zu SFTP; Athaus spricht mit den Portalen FTP und FTPS.                                                         |
| `portal_abgewiesen`                             | Der Server des Portals nimmt die Anfrage nicht an, etwa weil der Zugang nichts ablegen darf.                                   |
| `schluessel_falsch`                             | Das fremde System lehnt die Zugangsdaten ab.                                                                                   |
| `keine_berechtigung`                           | Die Zugangsdaten gelten, dürfen aber keine Objekte lesen.                                                                      |
| `nicht_erreichbar`                               | Das fremde System war nicht erreichbar.                                                                                        |
| `quelle_drosselt`                                 | Das fremde System nimmt gerade keine weiteren Anfragen an.                                                                     |
| `quelle_abgewiesen`                             | Das fremde System hat die Anfrage abgewiesen.                                                                                  |
| `quelle_unlesbar`                                 | Das fremde System hat etwas geantwortet, das sich nicht lesen lässt.                                                           |
| `zielfeld_unbekannt`                           | Dieses Zielfeld gibt es nicht.                                                                                                 |
| `lauf_nicht_zuruecknehmbar`             | Dieser Lauf lässt sich nicht zurücknehmen.                                                                                     |
| `lauf_laeuft`                                         | Für diese Anbindung läuft schon ein Lauf.                                                                                      |
| `lauf_beendet`                                       | Dieser Lauf ist schon beendet.                                                                                                 |
| `auswahl_zu_gross`                               | Die Auswahl ist größer, als ein Aufruf auf einmal bearbeitet.                                                                  |
| `auswahl_geaendert`                             | Der Bestand hat sich seit der Ansicht geändert; es wurde nichts entfernt.                                                      |
| `bestaetigung_falsch`                         | Die Bestätigung passt nicht zum Namen.                                                                                         |
| `schon_angemeldet`                               | Zu dieser Einladung gibt es inzwischen ein Konto; sie ist keine offene Einladung mehr.                                         |
| `zusammenfuehrung_gleiche_quelle` | Beide Kontakte führen einen Datensatz derselben Quelle; die Quelle hält sie getrennt, also bleiben sie zwei.                   |
| `dublette_entschieden`                       | Dieser Vorschlag ist schon entschieden.                                                                                        |
| `zusammenfuehrung_nicht_trennbar` | Die Zusammenführung ist schon getrennt, die Frist ist um, oder einer der beiden Kontakte wurde seither selbst zusammengeführt. |
| `entitaet_nicht_schreibbar`             | Diese Anbindung kann diesen Bereich nicht zurückschreiben.                                                                     |

## Der Agent im Hintergrund [#der-agent-im-hintergrund]

| Code                                                                | Bedeutung                                                                                                                                                                 |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `nicht_sammelbar`                 | Diesen Vorschlag nimmt man nur einzeln an, nicht gesammelt mit anderen.                                                                                                   |
| `vorschlag_entschieden`     | Über diesen Vorschlag ist schon entschieden: angenommen, verworfen oder verfallen. Bei `/v1` heißt er [`proposal_already_decided`](/api/errors#proposal_already_decided). |
| `bestaetigung_noetig`         | Diese Handlung führt erst der Klick eines Menschen aus, in der Karte des Assistenten oder in der App.                                                                     |
| `bestaetigung_abgelaufen` | Die Bestätigung ist abgelaufen; die Handlung muss neu vorbereitet werden.                                                                                                 |
| `approval_running`               | The approved change is still running; its result follows.                                                                                                                 |
| `stufe_aus`                             | Das Büro hat diese Art von Handlung in der Automatik abgeschaltet; nichts wird vorbereitet. Bei `/v1` heißt er [`automation_disabled`](/api/errors#automation_disabled).  |
| `wert_geaendert`                   | Der Wert wurde seit der Änderung des Agenten wieder geändert; zurücksetzen ginge über diese hinweg.                                                                       |
| `schon_rueckgaengig`           | Diese Änderung des Agenten ist schon zurückgenommen.                                                                                                                      |

## Besichtigung [#besichtigung]

| Code                                                                        | Bedeutung                                                   |
| --------------------------------------------------------------------------- | ----------------------------------------------------------- |
| `voll`                                               | Der Termin ist belegt.                                      |
| `vorbei`                                           | Der Zeitpunkt liegt in der Vergangenheit.                   |
| `schon_gebucht`                             | Es gibt schon eine Buchung dieser Person.                   |
| `kalender_belegt`                         | Der Anbieter hat zu dieser Zeit schon einen anderen Termin. |
| `kalender_nicht_eingerichtet` | Dieser Kalender-Anbieter ist bei uns nicht eingerichtet.    |

## Postfach [#postfach]

| Code                                                                                      | Bedeutung                                                                                                                                                                          |
| ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `postfach_nicht_eingerichtet`               | Das Gmail-Postfach ist bei uns nicht eingerichtet: es fehlt der Google-Client.                                                                                                     |
| `postfach_getrennt`                                   | Das Postfach ist abgelaufen oder gestört und sendet nicht; neu verbinden.                                                                                                          |
| `kein_postfach`                                           | Es ist kein Postfach verbunden; eine Antwort auf diese Anfrage geht nur aus dem eigenen Postfach. Bei `/v1` heißt er [`mailbox_not_connected`](/api/errors#mailbox_not_connected). |
| `postfach_imap_anmeldung`                       | Der IMAP-Server hat Benutzer oder Passwort abgelehnt (bei vielen Anbietern ist ein App-Passwort erforderlich).                                                                     |
| `postfach_smtp_anmeldung`                       | Der SMTP-Server hat Benutzer oder Passwort abgelehnt.                                                                                                                              |
| `postfach_imap_unerreichbar`                 | Der IMAP-Server ist unter Host und Port nicht erreichbar (unbekannter Host, Verbindung abgelehnt oder Zeitlimit).                                                                  |
| `postfach_smtp_unerreichbar`                 | Der SMTP-Server ist unter Host und Port nicht erreichbar (unbekannter Host, Verbindung abgelehnt oder Zeitlimit).                                                                  |
| `postfach_imap_tls`                                   | Die TLS-Verbindung zum IMAP-Server kam nicht zustande (Zertifikat abgelaufen oder falsch, TLS-Einstellung passt nicht zum Port, kein STARTTLS).                                    |
| `postfach_smtp_tls`                                   | Die TLS-Verbindung zum SMTP-Server kam nicht zustande (Zertifikat abgelaufen oder falsch, TLS-Einstellung passt nicht zum Port, kein STARTTLS).                                    |
| `postfach_imap_fehlgeschlagen`             | Der IMAP-Server hat die Anmeldung aus einem anderen Grund nicht angenommen oder antwortete unerwartet.                                                                             |
| `postfach_smtp_fehlgeschlagen`             | Der SMTP-Server hat die Anmeldung aus einem anderen Grund nicht angenommen oder antwortete unerwartet.                                                                             |
| `postfach_adresse_andere_verbindung` | Diese Adresse ist schon über Gmail oder Outlook verbunden; erst diese Verbindung trennen, dann per IMAP verbinden.                                                                 |
| `postfach_host_gesperrt`                         | Der Host zeigt auf eine Adresse im eigenen oder privaten Netz; dorthin verbindet Athaus nicht.                                                                                     |
| `keine_eingehende_mail`                           | Der Faden hat keine eingehende Mail, an die sich eine Antwort richten ließe.                                                                                                       |
| `mail_senden_fehlgeschlagen`                 | Gmail hat die Mail nicht angenommen oder war nicht erreichbar; nichts wurde gesendet.                                                                                              |
| `mail_senden_unklar`                                 | Die Verbindung riss nach dem Absenden: ob die Mail hinausging, ist offen; im Postfach nachsehen, bevor sie noch einmal gesendet wird.                                              |
| `objekt_fehlt`                                             | Zu dieser Anfrage per Mail fehlt das Objekt; wähle eines.                                                                                                                          |
| `textbausteine_voll`                                 | Die Person hat so viele Textbausteine, wie erlaubt sind; erst einen löschen.                                                                                                       |
| `mitglied_unbekannt`                                 | Die Person gehört nicht zum Büro und kann keinen Faden zugewiesen bekommen.                                                                                                        |
| `keine_abmeldung`                                       | Die Mail nennt keinen Weg zum Abmelden (kein List-Unsubscribe mit mailto oder https).                                                                                              |

## Serienmail und Newsletter [#serienmail-und-newsletter]

| Code                                                                        | Bedeutung                                                                                    |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `serie_nicht_aenderbar`             | Die Serie läuft schon oder ist beendet und lässt sich nicht mehr ändern.                     |
| `serie_unvollstaendig`               | Der Serie fehlt Betreff, Text, ein verbundenes Postfach oder das Objekt, das der Text nennt. |
| `serie_platzhalter_unbekannt` | Der Text nennt einen Platzhalter, den es nicht gibt.                                         |
| `serie_buero_angaben_fehlen`   | Dem Büro fehlen Name und Anschrift für den Fuss jeder Mail.                                  |
| `serie_keine_empfaenger`           | Auf die Auswahl trifft kein Kontakt zu, der die Serie bekommen darf.                         |

## Google Drive [#google-drive]

| Code                                                                  | Bedeutung                                                                                                          |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `drive_nicht_eingerichtet` | Google Drive ist bei uns nicht eingerichtet: es fehlt der Google-Client oder der Schlüssel für das Auswahlfenster. |
| `drive_nicht_verbunden`       | Google Drive ist nicht verbunden oder der Zugang wurde bei Google entzogen; neu verbinden.                         |

## Bewertung [#bewertung]

| Code                                                              | Bedeutung                                                                                               |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `bewertung_fertig`             | Die Bewertung ist fertig; eine Annahme ändert man in einer neuen Bewertung.                             |
| `unbekannte_annahme`         | Eine Annahme mit diesem Schlüssel gibt es nicht.                                                        |
| `bewertung_nicht_fertig` | Die Bewertung ist noch ein Entwurf; einen Bericht für den Eigentümer gibt es erst, wenn sie fertig ist. |
| `bewertung_ohne_spanne`   | Die Bewertung hat keine Spanne; ohne Wert gibt es keinen Bericht für den Eigentümer.                    |
| `annahme_von_hand`             | Ein Mensch hat diese Annahme gesetzt; ein ausgelesener Wert ersetzt sie nicht.                          |
| `incomplete`                         | Für eine Bewertung fehlen Angaben.                                                                      |
| `ambiguous`                           | Die Angabe ist nicht eindeutig.                                                                         |

## Zustellwege fremder Systeme [#zustellwege-fremder-systeme]

| Code                                                              | Bedeutung                                                                           |
| ----------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `missing_signature`           | Es fehlt die Signatur.                                                              |
| `bad_payload`                       | Der Rumpf des Zustellwegs passt nicht.                                              |
| `bad_signature`                   | Die Signatur des Zustellwegs stimmt nicht.                                          |
| `retry_later`                       | Später noch einmal versuchen.                                                       |
| `automation_aus`                 | Die Automation hinter diesem Webhook ist ausgeschaltet; der Aufruf löst nichts aus. |
| `webhook_not_configured` | Der Zustellweg ist nicht eingerichtet; ohne Geheimnis nimmt er nichts an.           |

## Datenexport [#datenexport]

| Code                                                              | Bedeutung                                                                                                        |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `datenexport_abgelaufen` | Der Link zu diesem Datenexport ist abgelaufen; in den Einstellungen lässt sich ein Export noch einmal anfordern. |

## Der Rest [#der-rest]

| Code                                                                      | Bedeutung                                                                                         |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `offer_state`                               | Das Angebot steht in einem Zustand, in dem das nicht geht.                                        |
| `discount_invalid`                     | Der Rabatt passt nicht zu Preis, Takt oder Plan.                                                  |
| `start_invalid`                           | Der Starttermin liegt außerhalb dessen, was möglich ist.                                          |
| `prepayment_card_only`             | Die Vorauszahlung der ersten Periode gibt es nur mit Karte.                                       |
| `prepayment_invalid`                 | Die Vorauszahlung passt nicht zu Rabatt oder Preis.                                               |
| `payment_method_not_offered` | Diese Zahlungsart ist in diesem Angebot nicht vorgesehen.                                         |
| `legal_changed`                           | Die Bedingungen haben sich seit der Anzeige geändert; die Seite muss neu geladen werden.          |
| `offer_preview`                           | Das ist die Vorschau des Teams; annehmen, ablehnen und bezahlen geht nur mit dem Link des Kunden. |
| `prospect_exists`                       | Zu dieser Adresse gibt es schon einen Interessenten.                                              |
| `tool_failed`                               | Das Werkzeug des Agenten schlug fehl.                                                             |
| `internal_error`                         | Ein Fehler, für den es keinen eigenen Code gibt.                                                  |
