OpenImmo für TYPO3

Warum Makler-Websites ohne OpenImmo-Integration doppelte Arbeit verursachen

Immobilienmakler pflegen ihre Objekte in Verwaltungssoftware wie FlowFact, onOffice, ImmoTool oder JustImmo. Jedes Objekt mit Bildern, Preisen, Flächen und Lagebeschreibungen. Diese Daten sollen auch auf der Website erscheinen - aber ohne manuelle Doppeleingabe. OpenImmo ist der deutsche XML-Standard, der genau diese Brücke schlägt: Die Makler-Software exportiert Objekte als XML, TYPO3 importiert sie automatisch und stellt sie auf der Website dar.

Ohne OpenImmo-Integration pflegt ein Büro mit 40 aktiven Objekten jedes Exposé doppelt - einmal in der Verwaltungssoftware und einmal auf der Website. Bei einer durchschnittlichen Bearbeitungszeit von 15 Minuten pro Objekt sind das 10 Stunden pro Monat allein für Datenpflege, die eine automatisierte Pipeline komplett eliminiert.

Typische Einsatzszenarien

Automatisierter Import für Makler-Websites. Ein Immobilienbüro mit 30 bis 100 aktiven Objekten betreibt seine Website auf TYPO3. Jede Nacht exportiert onOffice alle Objekte als OpenImmo-XML auf einen FTP-Server. Ein TYPO3-Scheduler-Task holt die XML-Datei, parst sie und aktualisiert die Objekte in der Datenbank - neue Objekte werden angelegt, geänderte aktualisiert, verkaufte archiviert. Morgens ist die Website automatisch aktuell.

Immobilienportale mit Multi-Anbieter-Aggregation. Eine regionale Immobilien-Plattform aggregiert Objekte von 10 bis 30 Maklern. Jeder Makler liefert seine Objekte im OpenImmo-Format. TYPO3 importiert alle Feeds, ordnet die Objekte den jeweiligen Anbietern zu und zeigt sie auf einer gemeinsamen Plattform mit einheitlicher Suche und Filterung an.

Bauträger-Websites mit Wohnungsübersicht. Ein Bauträger verkauft 50 Wohneinheiten in einem Neubauprojekt. Die Verfügbarkeiten und Preise werden in der Verwaltungssoftware gepflegt. Über OpenImmo-Import aktualisiert die TYPO3-Website den Status jeder Einheit automatisch: verfügbar, reserviert oder verkauft. Interessenten sehen in Echtzeit, welche Wohnungen noch frei sind.

Technische Architektur

Die OpenImmo-Integration in TYPO3 besteht aus vier Komponenten:

• XML-Parser: Liest die OpenImmo-XML-Datei und wandelt sie in PHP-Objekte um. Das OpenImmo-Schema definiert über 200 Felder pro Objekt: Kaufpreis, Kaltmiete, Wohnfläche, Grundstücksfläche, Zimmerzahl, Baujahr, Energieausweis, Lagebeschreibung, bis zu 30 Bilder und Grundrisse. Der Parser muss alle Feldvarianten und Versionen des OpenImmo-Schemas unterstützen (1.2.7 bis 1.2.8).
• Import-Pipeline: Ein Scheduler-Task oder CLI-Command führt den Import regelmässig aus. Die Pipeline verarbeitet: Datei-Download (FTP, SFTP, lokales Verzeichnis), XML-Validierung, Objekt-Mapping (OpenImmo-Felder auf TYPO3-Datenbankfelder), Bild-Import (Bilder werden in das FAL übertragen), Differenz-Abgleich (nur geänderte Objekte werden aktualisiert).
• Frontend-Darstellung: Ein Extbase-Plugin zeigt die Objekte als Liste mit Filterung (Kaufen/Mieten, Preisspanne, Fläche, Zimmerzahl, PLZ-Umkreis) und als Detailansicht mit Bildergalerie, Lagekarte (über maps2 oder leaflet) und Kontaktformular.
• Exposé-Generierung: Optional können Objekt-Detailseiten als PDF-Exposé heruntergeladen werden (über web2pdf oder eine eigene PDF-Template-Engine).

Abhängigkeiten: TYPO3 Core, optional maps2/geocoordinates für Kartenanzeige und Umkreissuche, optional web2pdf für PDF-Exposés. Die Datenmenge pro Import kann erheblich sein: Ein Maklerbüro mit 100 aktiven Objekten und je 20 Bildern erzeugt eine XML-Datei von 5 bis 15 MB und einen Bildordner von 500 MB bis 2 GB. Der Import-Prozess muss diese Datenmengen effizient verarbeiten, um die Server-Ressourcen nicht zu blockieren.

Häufige Probleme und Lösungen

Problem: Import bricht mit XML-Parsing-Fehlern ab. Makler-Software exportiert teilweise nicht schema-konformes XML. Fehlende Pflichtfelder, ungültige Zeichenkodierung (ISO-8859-1 statt UTF-8) oder nicht geschlossene Tags führen zum Abbruch. Die Lösung: Einen XML-Preprocessing-Step einbauen, der die Datei vor dem Import validiert, Encoding-Probleme korrigiert und fehlende Pflichtfelder mit Standardwerten füllt. Gosign implementiert diesen Step als eigenständigen Service, der Fehler loggt und den Makler benachrichtigt.

Problem: Bilder werden nicht korrekt importiert. OpenImmo-XML referenziert Bilder über relative Pfade oder URLs. Wenn der FTP-Upload die Bilder in einem anderen Verzeichnis ablegt als die XML erwartet, bleiben die Bild-Referenzen leer. Die Lösung: Den Import so konfigurieren, dass Bilder relativ zum XML-Verzeichnis gesucht werden, und einen Fallback auf Dateinamen-Matching implementieren, falls die Pfade nicht stimmen.

Problem: Gelöschte Objekte bleiben auf der Website sichtbar. OpenImmo kennt zwei Wege, Objekte als verkauft/gelöscht zu markieren: Über ein Status-Feld im XML oder durch Weglassen des Objekts im nächsten Export. Nicht alle Import-Extensions unterstützen beide Varianten. Die Lösung: Den Import auf Voll-Abgleich konfigurieren - Objekte, die im aktuellen XML-Export fehlen, werden automatisch als “verkauft” markiert oder archiviert.

Migration und Versions-Kompatibilität

Für OpenImmo in TYPO3 existieren mehrere Extensions: openimmo (TER), femanager_openimmo, und diverse proprietäre Lösungen. Die meisten sind für TYPO3 v10 und v11 verfügbar. Für TYPO3 v12 und v13 ist die Auswahl eingeschränkter, da einige Extensions nicht mehr aktiv gepflegt werden.

Das OpenImmo-Format selbst ist stabil. Version 1.2.7 ist seit Jahren der De-facto-Standard, und alle relevanten Makler-Softwarepakete unterstützen es. Ein Wechsel auf die neuere Version 1.2.8 erfordert Anpassungen am Parser, bringt aber zusätzliche Felder (Energieausweis nach GEG 2024, erweiterte Lagebeschreibungen).

Gosign empfiehlt bei einem TYPO3-Upgrade von v10/v11 auf v12 eine Evaluation der bestehenden OpenImmo-Extension. Falls der Maintainer nicht mehr aktiv ist, lohnt sich der Umstieg auf eine eigenentwickelte Import-Pipeline mit modernem PHP (Typed Properties, Enums für Objekttypen, Event-basierte Architektur). Der Initialaufwand beträgt 5 bis 8 Tage, dafür ist die Pipeline unabhängig von Drittanbieter-Extensions und langfristig wartbar. Die Pipeline kann zudem einfach um zusätzliche Datenquellen erweitert werden: IS24-Schnittstelle, Immowelt-API oder proprietäre XML-Formate von Bauträgern lassen sich als weitere Import-Adapter integrieren, ohne die Gesamtarchitektur zu ändern.