# Adressen aus onOffice synchronisieren

<Lead>
Der Adress-Abgleich holt dein onOffice-Adressbuch in das zentrale
Plattform-Adressbuch. Alle Tools lesen danach denselben Kontaktstand, und du
pflegst die Zuordnung nur ein einziges Mal.
</Lead>

Diesen Bereich findest du unter **Einstellungen → Integrationen → onOffice**, im
Frame **„Adressen aus onOffice“**. Voraussetzung ist eine bestehende Verbindung
(siehe <DocLink href="/help/integrations/onoffice/verbindung">Verbindungs-Anleitung</DocLink>).

## Ein Adressbuch für alle Tools

<Info title="Nur eine Zuordnung, ein Stand">
Es gibt genau **ein** zentrales Adressbuch. Tools holen ihre Kontakte nicht
mehr einzeln aus onOffice, sondern lesen dieses Buch. Beispiel: DB-Leads
übernimmt seine Leads aus dem zentralen Adressbuch. Das spart doppelte
Pflege und doppelte API-Zugriffe.
</Info>

## Was der Abgleich macht

<Steps>
<Step title="Adressen lesen">
Die Plattform liest dein Adressbuch seitenweise aus onOffice (200 Adressen pro
Seite). Auch ein Adressbuch mit vielen tausend Einträgen wird vollständig
verarbeitet: Der erste Lauf holt so viel wie möglich sofort, der Rest läuft im
Hintergrund weiter.
</Step>
<Step title="Felder zuordnen">
Jedes onOffice-Adressfeld wird gemäß deiner Feldzuordnung in das passende
Plattform-Feld übernommen (Vorname, Name, E-Mail, Telefon, Kundennummer und so
weiter).
</Step>
<Step title="Anlegen oder aktualisieren">
Neue Kontakte werden angelegt, bereits übernommene aktualisiert. Der Abgleich
ist wiederholbar und legt nichts doppelt an (Dedup über die onOffice-Datensatz-Id).
</Step>
<Step title="Gelöschte Kontakte entfernen">
Kontakte, die es in onOffice nicht mehr gibt, verschwinden auch aus dem
Adressbuch, samt allem, was Tools daraus errechnet haben (zum Beispiel
Briefings und Funde in DB-Leads). Das passiert nur am Ende eines vollständigen
Laufs und erst nach einer Nachfrage bei onOffice für jeden einzelnen Kontakt.
</Step>
</Steps>

## Gelöschte Kontakte

Löschst du einen Kontakt in onOffice, räumt der nächste Abgleich ihn auch bei
uns ab. Damit aus einem gestörten Lauf nie eine Massenlöschung wird, gelten
drei Regeln:

- **Nur nach einem vollständigen Lauf.** Ein Abgleich, der abbricht, entfernt
  nichts. Ein Kontakt gilt erst dann als Kandidat, wenn ein Lauf das ganze
  Adressbuch gelesen und ihn dabei nicht gesehen hat.
- **Jeder Kandidat wird einzeln nachgefragt.** Bevor ein Kontakt geht, fragt
  die Plattform onOffice gezielt nach genau diesem Datensatz. Liefert onOffice
  ihn doch, bleibt er. Antwortet onOffice mit einem Fehler, bleibt er ebenfalls
  und der Lauf nennt das im Verlauf.
- **Eine Sicherheitsgrenze.** Fehlen auf einmal mehr als 50 Kontakte oder mehr
  als zehn Prozent des Adressbuchs, löscht der Abgleich nichts. Er stoppt,
  meldet die Zahl an Inhaber:innen und Admins, und der Bereich zeigt einen
  Hinweis mit dem Knopf **„Löschung bestätigen“**. Erst mit dieser Bestätigung
  entfernt der nächste Lauf die Kontakte, wieder nach Nachfrage bei onOffice.

<Warning title="Löschen ist endgültig">
Was der Abgleich entfernt, ist aus dem Adressbuch und aus den Tools weg. Ein
Werbewiderspruch bleibt trotzdem erhalten: Er hängt an der Adresse, nicht am
Kontakt.
</Warning>

## Feldzuordnung

Sinnvolle Standard-Zuordnungen (Vorname, Name, E-Mail, Telefon, Kundennummer)
sind ab Werk gesetzt, weil onOffice-Feldnamen je Makler variieren. Du prüfst und
ergänzt sie im aufklappbaren Bereich **„Feldzuordnung“**. Nach dem Speichern
klappt der Bereich automatisch ein; über **„Anzeigen“** öffnest du ihn erneut.

Die Zuordnung ist bewusst einfach: onOffice-Feld auf Plattform-Feld, **ohne
Richtung**. Der Abgleich **liest nur**. Zurück nach onOffice geschrieben wird
ausschließlich über ausdrückliche Funktionen (zum Beispiel den
Akquise-Write-back von DB-Leads mit eigener Feld-Konfiguration).

<Note title="Keine Daten gehen verloren">
Felder ohne Zuordnung sind nicht verloren: Alle gelesenen Rohdaten liegen
vollständig in den Kontakt-Details. Du kannst eine Zuordnung später ergänzen und
neu synchronisieren.
</Note>

Details zur Zuordnung und wie unbekannte Felder behandelt werden, erklärt die
<DocLink href="/help/integrations/onoffice/feldzuordnung">Feldzuordnungs-Anleitung</DocLink>.

## Ersten Abgleich starten

<Steps>
<Step title="Feldzuordnung prüfen">
Bereich „Feldzuordnung“ öffnen, Vorbelegung prüfen, speichern.
</Step>
<Step title="Jetzt synchronisieren">
**„Jetzt synchronisieren“** klicken. Das Ergebnis kommt als Benachrichtigung
(„X neu, Y aktualisiert“).
</Step>
</Steps>

Danach läuft der Abgleich **täglich automatisch**.

## Problembehebung

<Faq>
<FaqItem q="Ein zugeordnetes Feld (z.B. Mobiltelefon) taucht nicht auf.">
Kann onOffice ein Feld über die API nicht liefern, wird es beim Abgleich
übersprungen. Speichere die Feldzuordnung einmal neu: Das gibt zuvor
übersprungene Felder wieder frei, sodass sie beim nächsten Abgleich erneut
gelesen werden. Prüfe außerdem, ob der API-Benutzer Adressen (alle) lesen darf.
</FaqItem>
<FaqItem q="Der Abgleich ist gestoppt und meldet fehlende Kontakte.">
onOffice führt mehr Kontakte nicht mehr, als die Sicherheitsgrenze zulässt.
Prüfe in onOffice, ob die Löschung gewollt war (zum Beispiel eine Bereinigung
des Adressbuchs) und ob der API-Benutzer weiterhin alle Adressen lesen darf.
Ist die Löschung gewollt, bestätige sie über **„Löschung bestätigen“** im
Bereich „Adressen aus onOffice“. Bis dahin bleibt alles stehen.
</FaqItem>
<FaqItem q="Muss ich den Adress-Sync und den Objekt-Sync getrennt starten?">
Ja, es sind zwei Frames mit je eigenem Button. Beide laufen danach täglich
automatisch.
</FaqItem>
</Faq>

## Weiter

<CardGrid>
<Card href="/help/integrations/onoffice/objekte" title="Objekte-Sync" eyebrow="Grundlagen">
Deine Immobilien aus onOffice übernehmen.
</Card>
<Card href="/help/integrations/onoffice/feldzuordnung" title="Feldzuordnung" eyebrow="Vertiefung">
Felder zuordnen, eigene Felder ergänzen, unbekannte Felder verstehen.
</Card>
<Card href="/help/integrations/onoffice/problembehebung" title="Problembehebung" eyebrow="Hilfe">
Lösungen für die häufigsten Fehlerbilder.
</Card>
</CardGrid>