Fehlercodes von App und MCP: was jeder Code bedeutet
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.
Zuletzt aktualisiert:
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. Hat ein Code hier eine Entsprechung bei /v1, steht sie am Ende seiner Zeile. Das Format der Fehler von /v1 steht unter Fehler.
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
| 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. |
| 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. |
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)
| 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)
| 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)
| 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
| 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. |
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. |
idempotenz_rumpf_abweichend | Der Idempotenzschlüssel der öffentlichen API wurde schon mit einem anderen Rumpf benutzt. Bei /v1 heißt er 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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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
| 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
| 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. |
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. |
| Der Bezahldienst antwortet nicht. | |
| 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. |
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
| 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
| 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. |
adresse_vergeben | Zu dieser Anschrift gibt es schon eine Immobilie. Bei /v1 heißt er 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. |
mail_ohne_einwilligung | Für diese Werbemail liegt keine Einwilligung des Kontakts in E-Mails vor. Bei /v1 heißt er 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. |
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
| Code | Bedeutung |
|---|---|
einwilligung_fehlt | Es fehlt die ausdrückliche Einwilligung in die Weitergabe der Anfrage an den Anbieter, in ihrer aktuellen Fassung. |
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
| Code | Bedeutung |
|---|---|
email_vergeben | Zu dieser Mailadresse gibt es in diesem Büro schon einen Kontakt. Bei /v1 heißt er email_already_exists. |
name_vergeben | Eine Liste dieser Art oder ein Projektstatus trägt den Namen schon. |
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
| 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
| 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. |
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. |
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
| 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
| 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. |
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
| 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
| 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
| 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
| 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
| Code | Bedeutung |
|---|---|
datenexport_abgelaufen | Der Link zu diesem Datenexport ist abgelaufen; in den Einstellungen lässt sich ein Export noch einmal anfordern. |
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. |
Weiter lesen
Fehlercodes der API: was jeder Code bedeutet
Jeder Code, den die REST-API im Mitglied code eines Problems liefert, mit HTTP-Status und Bedeutung. Aus dem Vertrag erzeugt.
REST-API: Fehler als Problem Details
Jeder Fehler von /v1 ist ein Problem nach RFC 9457 mit echtem HTTP-Status, einem Code zum Verzweigen und einer Request-Id für den Support.
Fehlerbehebung für die häufigsten Probleme
Anmeldung, Anfragen, Antworten, Inserate, MCP und Funktionen, die im Plan fehlen: Ursache und nächster Schritt bei jedem Problem.