# Objekte aus onOffice synchronisieren

<Lead>
Der Objekt-Abgleich holt deine Immobilien aus onOffice in die zentrale
Objekt-Datenbank der Plattform. Einmal eingerichtet, läuft er täglich
automatisch. Alle Tools arbeiten danach mit demselben Objektbestand.
</Lead>

Diesen Bereich findest du unter **Einstellungen → Integrationen → onOffice**, im
Frame **„Objekte aus onOffice“**. Voraussetzung ist eine bestehende Verbindung.
Wie du sie herstellst, steht in der <DocLink href="/help/integrations/onoffice/verbindung">Verbindungs-Anleitung</DocLink>.

## Was der Abgleich macht

<Steps>
<Step title="Objekte lesen">
Die Plattform liest deine Objekte seitenweise aus onOffice (100 Objekte pro
Seite). Auch große Bestände werden vollständig verarbeitet: Der erste Lauf holt
so viele Seiten wie möglich sofort, der Rest läuft im Hintergrund weiter.
</Step>
<Step title="Felder zuordnen">
Jedes onOffice-Feld wird gemäß deiner Feldzuordnung in das passende
Plattform-Feld übernommen (Titel, Objektart, Preis, Fläche und so weiter). Der
Status wird automatisch erkannt (siehe unten).
</Step>
<Step title="Eigentümer verknüpfen">
Die Eigentümer-Zuordnung (Objekt zu Adresse) wird mitgelesen. So gehören Objekt
und Eigentümer-Kontakt zusammen, ohne dass du etwas doppelt pflegst.
</Step>
<Step title="Anlegen oder aktualisieren">
Neue Objekte werden angelegt, bereits übernommene aktualisiert. Der Abgleich ist
wiederholbar: Er legt nichts doppelt an und aktualisiert bestehende Objekte bei
jedem Lauf (Statuswechsel wie „verkauft“ fließen weiter ein).
</Step>
</Steps>

<Info title="Der gesamte Bestand kommt mit">
Es werden **alle** Objekte übernommen, nicht nur aktive. Verkaufte und
reservierte Objekte kommen mit ihrem korrekten Status mit. In der
Objekt-Galerie filterst du dann nach Status, statt dass dir Objekte fehlen.
</Info>

## Voraussetzung: Objektrechte des API-Benutzers

Damit wirklich alle Objekte ankommen, muss der onOffice-API-Benutzer die
Objekte **lesen** dürfen, und zwar auch die nicht veröffentlichten:

<Checklist>
<ChecklistItem>Objekte lesen (alle) ist aktiviert.</ChecklistItem>
<ChecklistItem>Der Haken „Kann nur Objekte lesen, die auf der Internetseite veröffentlicht sind“ ist **deaktiviert**.</ChecklistItem>
</Checklist>

<Warning title="Häufigste Ursache für fehlende Objekte">
Ist der Haken „nur veröffentlichte Objekte“ noch aktiv, liefert onOffice nur
einen Teil deiner Objekte. Deaktiviere ihn in onOffice unter
**Extras → Einstellungen → Benutzer → dein API-Benutzer → Rechte**.
</Warning>

## Der Status wird automatisch erkannt

Das ist der wichtigste Teil. Du musst den Status **nicht** von Hand zuordnen:
Die Plattform leitet ihn aus den zuverlässigen onOffice-Standardfeldern ab.

<DefinitionList>
<DefItem term="verkauft = ja">Objekt-Status wird **Verkauft**.</DefItem>
<DefItem term="reserviert = ja">Objekt-Status wird **Reserviert**.</DefItem>
<DefItem term="onOffice-Feld „status“ = aktiv">Objekt-Status wird **Aktiv**.</DefItem>
<DefItem term="onOffice-Feld „status“ = inaktiv">Objekt-Status wird **Entwurf**.</DefItem>
</DefinitionList>

Reihenfolge: „verkauft“ schlägt „reserviert“ schlägt den Aktiv-Status. Ein
verkauftes Objekt ist also immer **Verkauft**, egal was sonst gesetzt ist.

Wenn dein onOffice eine **eigene Status-Werteliste** nutzt (oft ein Feld namens
`Status2` mit Werten wie „Aktive Vermarktung“, „Reserviert“, „Verkauft, allein
verkauft"), kannst du diese zusätzlich zuordnen. Dann hat deine Zuordnung
Vorrang, sobald sie einen Wert auflöst. Wie das geht, steht in der
<DocLink href="/help/integrations/onoffice/status">Status-Anleitung</DocLink>.

## Fotos werden automatisch übernommen

Nach dem Abgleich der Objektdaten holt die Plattform die **Objektfotos** aus
onOffice und legt sie in der Plattform ab. Danach zeigen Galerie und
Objekt-Detail echte Bilder statt des Farbverlauf-Platzhalters.

<DefinitionList>
<DefItem term="Reihenfolge">Das Titelbild aus onOffice wird auch in der Plattform das Titelbild (erste Position).</DefItem>
<DefItem term="Qualität">Das Titelbild wird in guter Qualität gespeichert, die restlichen Fotos web-optimiert (schont den Speicher). Die Originale bleiben in onOffice und werden bei Bedarf in voller Auflösung nachgeladen.</DefItem>
<DefItem term="Namen">Die Bezeichnung, die du in onOffice am Bild gepflegt hast, kommt mit ("Wohnzimmer", "Blick nach Süden"). Ist nichts hinterlegt, greift die Bildunterschrift oder der Name der hochgeladenen Datei. Bleibt auch das leer, heißen die Fotos "Titelbild", "Foto 2", "Foto 3" und sind damit auseinanderzuhalten. Fotos, die schon vor dieser Änderung geladen wurden, benennt ein Nachlauf im Hintergrund nach; selbst vergebene Namen bleiben dabei unangetastet.</DefItem>
<DefItem term="Wann">Der Foto-Import startet automatisch, sobald der Objekt-Abgleich fertig ist, und läuft im Hintergrund weiter.</DefItem>
<DefItem term="Schonend">Bereits vorhandene oder selbst hochgeladene Bilder werden nie überschrieben. Objekte ohne Foto in onOffice behalten den Platzhalter. Ein Objekt wird beim Abgleich reserviert, bevor das erste Foto geladen wird, damit ein unterbrochener Lauf keine zweite Kopie anlegt.</DefItem>
<DefItem term="Speicherlimit">Ist der Plan-Speicher voll, stoppt der Foto-Import und du bekommst eine Benachrichtigung. Nach einem Upgrade oder Aufräumen werden die restlichen Fotos beim nächsten Abgleich nachgeladen.</DefItem>
</DefinitionList>

### Bilder in voller Qualität nachladen

Die kleinen Vorschau-Bilder reichen zum Durchsehen, nicht zum Arbeiten. Sobald
du ein Foto für ein Exposé, fürs Homestaging oder für deine Website brauchst,
öffne das Objekt und klicke über der Galerie auf **In voller Qualität laden**.
Die Plattform holt dann die Originale dieses Objekts aus onOffice und ersetzt
damit die Vorschauen.

Daneben steht, wie viel Speicher das ungefähr belegt. Der Knopf gilt bewusst
immer nur für ein Objekt: in voller Auflösung braucht ein Objekt schnell einige
Dutzend Megabyte, und bei mehreren hundert Objekten wäre das mehr Speicher, als
dein Plan vorsieht.

<Note title="Der Foto-Import braucht kurz">
Bei vielen Objekten werden die Fotos nach und nach nachgeladen (jedes Objekt hat
mehrere Bilder). Es kann also einige Minuten dauern, bis alle Titelbilder
erscheinen. Ein erneuter Abgleich holt Fotos nach, die beim ersten Lauf noch
gefehlt haben.
</Note>

## Feldzuordnung

Sinnvolle Standard-Zuordnungen (Titel, Objektart, Vermarktungsart, Adresse,
Flächen, Zimmer, Preise, Energie) sind ab Werk gesetzt. Du prüfst und ergänzt
sie im aufklappbaren Bereich **„Feldzuordnung“**. Nach dem Speichern klappt der
Bereich automatisch wieder ein, damit die Seite ruhig bleibt; über **„Anzeigen“**
öffnest du ihn erneut.

Details, eigene Felder und die Wert-Übersetzung erklärt die
<DocLink href="/help/integrations/onoffice/feldzuordnung">Feldzuordnungs-Anleitung</DocLink>.

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

## Ersten Abgleich starten

<Steps>
<Step title="Feldzuordnung prüfen">
Öffne den Bereich „Feldzuordnung“, prüfe die Vorbelegung und speichere. (Für den
Standard-Fall musst du nichts ändern.)
</Step>
<Step title="Jetzt synchronisieren">
Klicke **„Jetzt synchronisieren“**. Der erste Lauf holt deinen Bestand; das
Ergebnis kommt als Benachrichtigung („X neu, Y aktualisiert“).
</Step>
<Step title="Ergebnis ansehen">
Öffne **Objekte** in der Plattform. Dort siehst du deine Immobilien mit
korrektem Status und filterst nach Bedarf.
</Step>
</Steps>

Danach läuft der Abgleich **täglich automatisch**. Du musst nichts weiter tun;
Statuswechsel und neue Objekte fließen von selbst nach.

## Zwei häufige Symptome und ihre Ursache

<Faq>
<FaqItem q="Es werden immer nur ~100 Objekte importiert, der Rest bleibt 'übersprungen'.">
Das war ein Fehler im Erstimport-Filter (nur „aktive“ Objekte wurden angelegt).
Er ist behoben: Jetzt wird der gesamte Bestand übernommen. Falls die Meldung
weiter erscheint, starte den Abgleich einmal neu und prüfe die Objektrechte
(Haken „nur veröffentlichte Objekte“ deaktivieren).
</FaqItem>
<FaqItem q="Alle Objekte stehen auf 'aktiv', obwohl viele verkauft oder reserviert sind.">
Ursache war, dass der Status beim Anlegen fälschlich auf „aktiv“ gesetzt wurde,
wenn keine Status-Zuordnung auflöste. Jetzt wird der Status aus verkauft /
reserviert / dem Aktiv-Flag abgeleitet. Beim nächsten Abgleich korrigieren sich
bereits übernommene Objekte automatisch. Mehr dazu in der
<DocLink href="/help/integrations/onoffice/status">Status-Anleitung</DocLink>.
</FaqItem>
</Faq>

## Weiter

<CardGrid>
<Card href="/help/integrations/onoffice/status" title="Status richtig erkennen" eyebrow="Vertiefung">
Wie der Objekt-Status bestimmt wird und wie du eine eigene Status-Werteliste
zuordnest.
</Card>
<Card href="/help/integrations/onoffice/feldzuordnung" title="Feldzuordnung" eyebrow="Vertiefung">
Standardfelder, eigene Felder, Wert-Übersetzung und wie unbekannte Felder
behandelt werden.
</Card>
<Card href="/help/integrations/onoffice/problembehebung" title="Problembehebung" eyebrow="Hilfe">
Lösungen für die häufigsten Fehlerbilder beim Abgleich.
</Card>
</CardGrid>