Ziel des Beitrags #
Dieser Beitrag zeigt Schritt für Schritt, wie du:
- den OnOffice-API-User korrekt einrichtest
- die notwendigen Rechte für den API-User setzt
- die Suchkriterien-Felder in OnOffice aktivierst
- und dadurch das OnOffice-Suchprofil sauber mit Frymo (z. B. Käuferfinder) verbinden kannst.
Wenn alles korrekt konfiguriert ist, läuft die Schnittstelle stabil und in Frymo erscheinen keine Fehlermeldungen mehr zu fehlenden Suchprofilfeldern.
1. Verbindung in Frymo prüfen #
Pfad in WordPress/Frymo:
Frymo → Einstellungen → Integrationen → OnOffice
Dort findest du:
- OnOffice Token
- OnOffice Secret
- Status
Zielzustand:
- Ein grüner Haken mit Text wie z. B. „OnOffice Setup Looks Good“
Wenn stattdessen Fehlermeldungen erscheinen, etwa:
- „Required Search Field … missing“
- oder Hinweise auf fehlende Suchkriterienfelder
muss die Konfiguration in OnOffice angepasst werden.
2. API-User in OnOffice anlegen und mit Frymo verbinden #
2.1 API-User finden oder anlegen #
In OnOffice:
- Extras → Einstellungen → Benutzer
- Den vorhandenen API-User auswählen oder einen neuen anlegen
- Im API-User kannst du Token und Secret generieren
Wichtig:
- Token und Secret werden von OnOffice nur beim Erstellen/Neugenerieren angezeigt
- Beide Werte direkt kopieren und sicher ablegen
2.2 Token und Secret in Frymo eintragen #
Zurück in Frymo:
- Frymo → Einstellungen → Integrationen → OnOffice
- OnOffice Token einfügen
- OnOffice Secret einfügen
- Speichern
- Seite neu laden
Wenn die Verbindung steht, zeigt Frymo im Status zusätzlich die ID des API-Users an.
3. API-User eindeutig für Frymo kennzeichnen #
Damit Frymo den richtigen API-User sicher erkennt:
- Im OnOffice-API-User den Vornamen auf „Frymo“ setzen
- Änderungen speichern
Anschließend:
- In Frymo die Integrationsseite neu laden
- Prüfen, ob die API-User-ID korrekt angezeigt wird
4. Rechte des OnOffice-API-Users korrekt setzen #
Damit Frymo Suchprofile lesen, schreiben und sauber verarbeiten kann, müssen im API-User die passenden Rechte hinterlegt sein.
4.1 Navigationspfad zu den Rechten #
In OnOffice:
- Extras → Einstellungen → Benutzer
- API-User auswählen
- Auf den Tab „Rechte“ wechseln
4.2 Rechte für Suchkriterien #
Im Bereich Suchkriterien:
- Suchkriterien lesen → auf „Alle“ setzen
- Suchkriterien schreiben → auf „Alle“ setzen
- Suchkriterien löschen → auf „Alle“ setzen
- Haken setzen bei:
- „Erstellung neuer Suchtilen ohne Schreibrecht auf Adresse“
Diese Einstellungen stellen sicher, dass Frymo:
- bestehende Suchprofile vollständig lesen kann
- neue Suchprofile sauber anlegen kann
- und bei Bedarf Suchprofil-Daten anpassen oder löschen darf
4.3 Rechte in der Adressverwaltung #
Im Bereich Adressverwaltung die folgenden Optionen aktivieren:
- „Kundennummer editieren“
- „Neuberechnung der Formel für alle beschreibbaren Felder“
- „Logindaten für internen Bereich verwalten“
- „Fremde Interessenten beim Objekt darstellen“
- „Aktivitäten der eigenen Datensätze sind sichtbar“
Diese Rechte sorgen dafür, dass:
- verknüpfte Adress- und Interessenten-Datensätze korrekt verarbeitet werden
- Formeln und automatisierte Berechnungen aktualisiert werden können
- Login-Daten und interne Zugänge bei Bedarf administriert werden können
- Aktivitäten und Interessenten kontextbezogen sichtbar sind
5. Erforderliche Suchprofil-Felder in OnOffice aktivieren #
Selbst wenn die Rechte stimmen, kann Frymo nur mit den Feldern arbeiten, die als Suchkriterien in OnOffice freigegeben sind.
Benötigte Felder für das Suchprofil
- Warmmiete
- Wohnfläche
- Anzahl der Zimmer
- Kaufpreis
- Objekttyp
- Objektart
- Vermarktungsart
5.1 Suchkriterien-Verwaltung öffnen #
In OnOffice:
- Extras → Einstellungen → Administration
- Tab „Suchkriterien“ öffnen
- Es erscheint eine lange Liste mit möglichen Suchkriterien
5.2 Benötigte Felder aktivieren #
Beispiel: Warmmiete
- Entweder durch die Liste scrollen oder Strg + F und „warmmiete“ suchen
- Wenn das Suchkriterium auf „deaktiviert“ steht → aktivieren
- Beim Speichern erscheint die Frage, ob das Feld ein KO-Kriterium sein soll
- „Ja“ auswählen und speichern
Diesen Schritt für alle oben genannten Felder wiederholen:
- Wohnfläche
- Zimmer
- Kaufpreis
- Objekttyp
- Objektart
- Vermarktungsart
Speichern nicht vergessen.
6. Funktion in Frymo testen #
Nach der Konfiguration in OnOffice:
- Zur Frymo-Integrationsseite zurückkehren
- Seite neu laden
- Prüfen, ob keine Fehlermeldung mehr erscheint, insbesondere keine Meldung vom Typ:
- „required search profile fields missing …“
Wenn alles korrekt eingerichtet ist:
- zeigt Frymo den grünen Status („OnOffice Setup Looks Good“)
- Suchprofile können vollständig genutzt werden
- Funktionen wie der Käuferfinder laufen ohne Fehlermeldungen
7. Typische Fehlerbilder und Ursachen #
- Fehlermeldung zu „required search field missing …“ → Ein oder mehrere Suchkriterien (z. B. Warmmiete, Wohnfläche, Kaufpreis) sind in OnOffice unter Suchkriterien nicht aktiviert.
- Frymo findet den API-User nicht oder zeigt keine ID an → Im API-User ist der Vorname nicht auf „Frymo“ gesetzt oder Token/Secret sind falsch übertragen.
- Suchprofile werden nur teilweise gezogen → Rechte für Suchkriterien (lesen/schreiben/löschen) nicht auf „Alle“ gesetzt oder bestimmte Felder nicht als Suchkriterium freigegeben.