Adressdatensatz mit dieser UUID nicht gefunden

Du klickst auf einen propform-Link aus einer onOffice-Mail-Vorlage und bekommst die Fehlermeldung „Adressdatensatz mit dieser UUID nicht gefunden" (oder analog für Immobilien)? Das hat fast immer eine von vier Ursachen.

💡 Bevor du tief gräbst: prüf zuerst, ob die UUID in der URL überhaupt vollständig ist (?address[ID]=... mit großem I und D, ?estate[Id]=... mit großem I, kleinem d). Tippfehler bei der Klammer-Schreibweise sind Ursache #0.

Diagnose-Reihenfolge (4 Ebenen)

Geh die vier Ebenen in dieser Reihenfolge durch — die häufigsten Ursachen zuerst.

1. Datensatz wurde gelöscht

onOffice öffnen → Modul Adressen / Immobilien
Suche nach der UUID (oder dem zugehörigen Datensatz)
Wenn nicht mehr da → Datensatz wurde manuell gelöscht oder über einen Prozessmanager-Auto-Löschjob entfernt
Lösung: Wiederherstellung über onOffice-Administration → Papierkorb (falls aktiviert), oder Datensatz neu anlegen

2. API-Benutzer hat keine Lese-Rechte auf das Modul

onOffice → Extras → Einstellungen → Administration → API-Benutzer → den propform-API-Benutzer auswählen
Reiter „Rechte" → prüfen ob „Adressen" bzw. „Immobilien" mit Lesen-Häkchen versehen ist
Lösung: Häkchen setzen + speichern. Wirkt sofort, kein Cache.

3. Mitarbeiter-/Gruppen-Datensatzrechte zu restriktiv

In onOffice können Datensätze auf bestimmte Mitarbeiter oder Gruppen beschränkt sein (Sharing).

Datensatz in onOffice öffnen → Reiter „Rechte" (oder „Datensatzrechte")
Prüfen, ob der API-Benutzer (bzw. seine Gruppe) Zugriff hat
Lösung: API-Benutzer in die berechtigten Gruppen aufnehmen oder Sharing-Einstellung erweitern

💡 Bei großen onOffice-Versionen mit Gruppen-Modul: API-Benutzer braucht oft die Gruppe „Alle" oder eine spezifische Sharing-Gruppe.

4. Datensatz ist „Privat" markiert + API-Benutzer ist nicht Eigentümer

Datensatz öffnen → Häkchen „Privat" prüfen
Wenn aktiv: Nur der Eigentümer (anlegender Mitarbeiter) sieht den Datensatz, alle anderen — auch API-Benutzer — werden ausgeschlossen
Lösung: Häkchen entfernen, oder Eigentümer auf den API-Benutzer ändern

Hilfreiches Test-Setup

Wenn du den Fehler systematisch reproduzieren willst:

Test-Datensatz in onOffice anlegen
UUID notieren
Test-Formular mit URL ?address[ID]=<UUID> aufrufen
Funktioniert → Datensatz, Rechte und API-Benutzer sind grundsätzlich OK
Funktioniert nicht → eine der vier Ebenen oben prüfen

propform.ioHilfe