OpenImmo para TYPO3

Por que sites de corretores sem integração OpenImmo geram trabalho duplicado

Corretores de imóveis mantêm seus objetos em softwares de gestão como FlowFact, onOffice, ImmoTool ou JustImmo. Cada objeto com fotos, preços, áreas e descrições de localização. Esses dados devem aparecer também no site - mas sem entrada manual duplicada. OpenImmo é o padrão XML alemão que faz exatamente essa ponte: o software imobiliário exporta objetos como XML, TYPO3 importa automaticamente e os exibe no site.

Sem integração OpenImmo, um escritório com 40 objetos ativos mantém cada exposição em duplicidade - uma vez no software de gestão e uma vez no site. Com tempo médio de processamento de 15 minutos por objeto, são 10 horas por mês apenas para manutenção de dados que um pipeline automatizado elimina completamente.

Cenários típicos de uso

Importação automatizada para sites de corretores. Um escritório imobiliário com 30 a 100 objetos ativos opera seu site em TYPO3. Toda noite, onOffice exporta todos os objetos como OpenImmo-XML para um servidor FTP. Uma tarefa scheduler TYPO3 busca o arquivo XML, o parseia e atualiza os objetos no banco de dados - novos objetos são criados, alterados são atualizados, vendidos são arquivados. De manhã, o site está automaticamente atualizado.

Portais imobiliários com agregação multi-fornecedor. Uma plataforma imobiliária regional agrega objetos de 10 a 30 corretores. Cada corretor entrega seus objetos no formato OpenImmo. TYPO3 importa todos os feeds, atribui os objetos aos respectivos fornecedores e os exibe em uma plataforma comum com busca e filtragem unificadas.

Sites de incorporadoras com visão geral de unidades. Uma incorporadora vende 50 unidades em um projeto de construção nova. Disponibilidades e preços são mantidos no software de gestão. Via importação OpenImmo, o site TYPO3 atualiza automaticamente o status de cada unidade: disponível, reservado ou vendido.

Arquitetura técnica

A integração OpenImmo no TYPO3 consiste em quatro componentes: parser XML (lê o arquivo OpenImmo-XML e o converte em objetos PHP - o schema OpenImmo define mais de 200 campos por objeto), pipeline de importação (tarefa scheduler ou comando CLI que executa a importação regularmente), exibição frontend (plugin Extbase que mostra objetos como lista com filtragem e como visualização de detalhe com galeria de imagens e mapa de localização) e geração de exposição (opcionalmente, páginas de detalhe podem ser baixadas como PDF).

Dependências: TYPO3 Core, opcionalmente maps2/geocoordinates para exibição de mapa e busca por raio, opcionalmente web2pdf para PDFs de exposição.

Problemas frequentes e soluções

Importação aborta com erros de parsing XML. Softwares de corretores às vezes exportam XML não conforme ao schema. Campos obrigatórios ausentes, codificação de caracteres inválida (ISO-8859-1 em vez de UTF-8) ou tags não fechadas levam à interrupção. Solução: incluir etapa de pré-processamento XML que valida o arquivo antes da importação e corrige problemas de encoding.

Imagens não são corretamente importadas. OpenImmo-XML referencia imagens via caminhos relativos ou URLs. Se o upload FTP coloca as imagens em diretório diferente do que o XML espera, as referências de imagem ficam vazias. Solução: configurar a importação para buscar imagens relativas ao diretório XML.

Objetos excluídos permanecem visíveis no site. OpenImmo conhece dois caminhos para marcar objetos como vendidos/excluídos: via campo de status no XML ou por omissão do objeto na próxima exportação. Nem todas as extensões de importação suportam ambas as variantes. Solução: configurar a importação para reconciliação completa - objetos ausentes na exportação XML atual são automaticamente marcados como “vendidos” ou arquivados.

Migração e compatibilidade de versões

Para OpenImmo no TYPO3 existem múltiplas extensões. A maioria está disponível para TYPO3 v10 e v11. Para TYPO3 v12 e v13, a seleção é mais limitada.

O formato OpenImmo em si é estável. Versão 1.2.7 é há anos o padrão de fato, e todos os pacotes de software imobiliário relevantes o suportam. A Gosign recomenda em um upgrade TYPO3 de v10/v11 para v12 uma avaliação da extensão OpenImmo existente. Se o mantenedor não está mais ativo, vale migrar para um pipeline de importação desenvolvido sob medida com PHP moderno. O investimento inicial é de 5 a 8 dias, mas o pipeline é independente de extensões de terceiros e sustentável a longo prazo.