OpenImmo para TYPO3

Por qué las webs inmobiliarias sin integración OpenImmo generan doble trabajo

Los agentes inmobiliarios gestionan sus propiedades en software de administración como FlowFact, onOffice, ImmoTool o JustImmo. Cada propiedad con fotos, precios, superficies y descripciones de ubicación. Estos datos deben aparecer también en la web, pero sin doble introducción manual. OpenImmo es el estándar XML del sector que tiende exactamente ese puente: el software del agente exporta propiedades como XML, TYPO3 las importa automáticamente y las muestra en la web.

Sin integración OpenImmo, una oficina con 40 propiedades activas mantiene cada exposé por duplicado - una vez en el software de gestión y otra en la web. Con un tiempo medio de 15 minutos por propiedad, eso supone 10 horas al mes solo en mantenimiento de datos que una pipeline automatizada elimina por completo.

Escenarios de uso habituales

Importación automatizada para webs de agencias. Una oficina inmobiliaria con 30 a 100 propiedades activas opera su web en TYPO3. Cada noche, onOffice exporta todas las propiedades como XML OpenImmo a un servidor FTP. Una tarea del Scheduler TYPO3 obtiene el archivo XML, lo parsea y actualiza las propiedades en la base de datos. A la mañana siguiente, la web está automáticamente actualizada.

Portales inmobiliarios con agregación multi-proveedor. Una plataforma inmobiliaria regional agrega propiedades de 10 a 30 agentes. Cada agente entrega sus propiedades en formato OpenImmo. TYPO3 importa todos los feeds, asigna las propiedades a los respectivos proveedores y las muestra en una plataforma común con búsqueda y filtrado unificados.

Webs de promotores con resumen de viviendas. Un promotor vende 50 unidades en un proyecto de obra nueva. Las disponibilidades y precios se gestionan en el software de administración. Mediante importación OpenImmo, la web TYPO3 actualiza automáticamente el estado de cada unidad: disponible, reservada o vendida.

Arquitectura técnica

La integración OpenImmo en TYPO3 consta de cuatro componentes: XML Parser (lee el archivo OpenImmo XML y lo convierte en objetos PHP; el esquema define más de 200 campos por propiedad), Pipeline de importación (tarea del Scheduler o comando CLI que ejecuta la importación periódicamente: descarga de archivo, validación XML, mapeo de propiedades, importación de imágenes, comparación de diferencias), Presentación frontend (plugin Extbase que muestra propiedades como lista con filtrado y como vista de detalle con galería, mapa e información de contacto) y Generación de exposés (opcionalmente las páginas de detalle se descargan como exposé PDF).

Problemas frecuentes y soluciones

La importación falla con errores de parseo XML. El software del agente a veces exporta XML no conforme al esquema. Campos obligatorios ausentes, codificación de caracteres inválida (ISO-8859-1 en lugar de UTF-8) o tags no cerrados causan la interrupción. Solución: implementar un paso de preprocesamiento XML que valide el archivo antes de la importación, corrija problemas de encoding y rellene campos obligatorios ausentes con valores por defecto.

Las imágenes no se importan correctamente. OpenImmo XML referencia imágenes mediante rutas relativas o URLs. Si la carga FTP coloca las imágenes en un directorio distinto al esperado por el XML, las referencias de imagen quedan vacías. Solución: configurar la importación para buscar imágenes relativas al directorio XML e implementar un fallback de coincidencia por nombre de archivo.

Las propiedades eliminadas siguen visibles en la web. OpenImmo conoce dos formas de marcar propiedades como vendidas/eliminadas: mediante campo de estado en el XML o omitiendo la propiedad en la siguiente exportación. No todas las extensiones de importación soportan ambas variantes. Solución: configurar la importación como comparación completa - las propiedades ausentes en la exportación XML actual se marcan automáticamente como “vendidas” o se archivan.

Migración y compatibilidad de versiones

Para OpenImmo en TYPO3 existen varias extensiones. La mayoría están disponibles para TYPO3 v10 y v11. Para TYPO3 v12 y v13, la selección es más limitada ya que algunas extensiones no se mantienen activamente.

El formato OpenImmo es estable. La versión 1.2.7 es desde hace años el estándar de facto. Gosign recomienda, al actualizar TYPO3 de v10/v11 a v12, evaluar la extensión OpenImmo existente. Si el mantenedor ya no está activo, vale la pena cambiar a una pipeline de importación desarrollada a medida con PHP moderno. El esfuerzo inicial es de 5 a 8 días, pero la pipeline es independiente de extensiones de terceros y mantenible a largo plazo.