Quando o XML imobiliário não funciona, os erros mais frequentes são: XML malformado por caractere especial não escapado (o mais silencioso porque o portal confirma recebimento mas não processa), URL do feed bloqueada ou inacessível externamente, campos obrigatórios ausentes que o portal rejeita silenciosamente, IDs de imóvel duplicados ou alterados que geram duplicatas no portal, e URLs de fotos inacessíveis que o portal não consegue buscar. O diagnóstico correto começa pelo sintoma: imóvel não aparece, imóvel aparece com dados errados, imóvel não atualiza ou imóvel some do portal. Cada sintoma aponta para um conjunto diferente de causas. O Website Imobiliário gera e valida o XML automaticamente com todas as especificações dos portais integrados, eliminando os erros de geração manual, mas os conceitos de diagnóstico neste artigo se aplicam a qualquer sistema que gere feed XML imobiliário.
XML imobiliário com erro de integração com portais é um dos problemas técnicos mais frustrantes para imobiliárias e desenvolvedores de sistemas: o feed é gerado, o portal confirma o recebimento, e os imóveis simplesmente não aparecem, ou aparecem com dados incorretos, ou param de atualizar sem aviso. O XML imobiliário é o formato de troca de dados entre sistemas de gestão de imobiliárias e portais como ZAP Imóveis, VivaReal, OLX Imóveis, Chaves na Mão e outros. É um arquivo XML com estrutura específica que o portal importa periodicamente para criar e atualizar as listagens da imobiliária. Quando esse fluxo falha, os imóveis deixam de aparecer nos portais e os leads param de chegar, sem que a imobiliária receba qualquer notificação clara sobre o que aconteceu.
O XML imobiliário tem uma característica técnica que dificulta o diagnóstico: os erros raramente geram mensagens de erro claras para o anunciante. O portal pode confirmar que recebeu o feed com sucesso e ainda assim não publicar nenhum imóvel porque algum campo obrigatório está ausente ou porque o encoding do arquivo está incorreto. O imóvel pode aparecer no portal com preço errado porque o campo de preço tem formatação incorreta (com vírgula como separador decimal em vez de ponto, ou com o símbolo R$ incluído no valor numérico). A integração pode funcionar por semanas e parar abruptamente porque um imóvel com ID duplicado entrou no feed e corrompeu a importação inteira.
Este artigo apresenta o diagnóstico sistemático de falhas no XML imobiliário por sintoma: o que observar na listagem do portal, que categoria de erro cada sintoma indica e como verificar e corrigir. Para o contexto de como configurar a integração corretamente, o artigo sobre integração de portais imobiliários cobre o processo de publicação do início ao fim. E para a configuração do site imobiliário com integração nativa aos portais, o artigo sobre site para imobiliárias com integração aos portais: guia prático explica a configuração passo a passo.
Neste artigo:
- XML imobiliário com erro de integração: como identificar em qual parte do fluxo o problema está
- Quais são os quatro sintomas que identificam categorias diferentes de erro no XML?
- Por que o XML malformado é o erro mais silencioso na integração com portais?
- Como verificar se a URL do feed XML está acessível pelo servidor do portal?
- Quais campos obrigatórios o ZAP e o VivaReal exigem no XML que causam rejeição silenciosa?
- Como erros de encoding e caracteres especiais quebram a integração XML imobiliário?
- Por que IDs duplicados e URLs de fotos inacessíveis causam sumida de imóveis?
- Por que o XML foi alterado mas o portal não atualizou o imóvel?
- Ponto de vista: o que aprendi em 20 anos de integrações XML com portais imobiliários
- Tabela de diagnóstico: sintoma, causa provável e solução
- Perguntas frequentes
- Fontes e referências
XML imobiliário com erro de integração: como identificar em qual parte do fluxo o problema está
O fluxo de integração XML imobiliário tem quatro etapas que podem falhar independentemente: geração do arquivo XML pelo sistema, acessibilidade da URL do feed pelo servidor do portal, parsing do XML pelo portal e publicação do imóvel na listagem. Identificar em qual etapa o problema está reduz o diagnóstico de horas para minutos.
Antes de analisar campos específicos do XML ou contatar o suporte do portal, o primeiro passo no diagnóstico de uma integração XML imobiliário que não funciona é identificar em qual das quatro etapas do fluxo o problema está ocorrendo. Cada etapa falha de forma diferente e tem solução diferente.
A primeira etapa é a geração do XML pelo sistema imobiliário: o arquivo é criado com todos os dados dos imóveis no formato esperado pelo portal? A segunda é a acessibilidade da URL: o servidor do portal consegue fazer uma requisição HTTP para a URL do feed e receber o arquivo? A terceira é o parsing: o portal consegue ler e interpretar o XML recebido sem erros? A quarta é a publicação: o XML foi lido corretamente mas algum campo invalida o imóvel e ele é rejeitado da listagem?
O diagnóstico correto começa pela etapa mais básica e avança progressivamente. Verificar se a URL do feed é acessível de fora da sua rede antes de analisar o conteúdo do XML. Validar o XML antes de verificar campos obrigatórios específicos. Isso evita passar horas corrigindo campos obrigatórios em um XML que o portal nem consegue acessar.
Quais são os quatro sintomas que identificam categorias diferentes de erro no XML?
Quatro sintomas indicam categorias diferentes de erro: imóvel não aparece no portal (problema de geração, acesso ou parsing), imóvel aparece com dado incorreto (problema de campo específico), imóvel parou de atualizar (problema de cache ou frequência de importação) e imóvel sumiu do portal depois de aparecer (problema de ID ou remoção incorreta).
Sintoma 1: Imóvel não aparece no portal após o envio do XML. Esse é o sintoma mais abrangente e pode ter causas em qualquer das quatro etapas do fluxo. Pode ser URL inacessível, XML malformado, campo obrigatório ausente ou encoding incorreto. O diagnóstico começa verificando se o portal consegue acessar a URL do feed.
Sintoma 2: Imóvel aparece no portal mas com dados incorretos, como preço errado, descrição cortada, endereço faltando ou fotos ausentes. Esse sintoma indica que o XML chegou e foi lido pelo portal, mas um campo específico está com formato incorreto ou valor inválido. O problema está na geração do XML, não na acessibilidade ou no parsing geral.
Sintoma 3: Imóvel foi atualizado no sistema mas o portal continua mostrando a versão antiga. Esse sintoma indica que o XML foi gerado corretamente e o portal o leu antes, mas não está importando a nova versão. A causa mais comum é o intervalo de atualização do portal (a maioria importa a cada 24 horas) ou um erro na nova versão do XML que causou rejeição silenciosa da atualização.
Sintoma 4: Imóvel estava aparecendo e sumiu do portal sem ação da imobiliária. Esse sintoma indica que o imóvel foi removido do feed XML (vendido ou captação encerrada sem remoção adequada do XML), que o ID do imóvel foi alterado no sistema, ou que um erro no XML mais recente causou a remoção automática do imóvel pelo portal.
Por que o XML malformado é o erro mais silencioso na integração com portais?
Um XML malformado é aquele com erro de estrutura que impede o parsing correto, como tag não fechada, caractere especial não escapado ou encoding incorreto. O portal pode confirmar o recebimento do arquivo mas não conseguir processar nenhum imóvel sem informar exatamente qual foi o erro.
O XML malformado é o tipo de erro mais difícil de diagnosticar porque o comportamento do portal não é transparente: muitos portais confirmam que receberam o feed mas não relatam erros de parsing de forma detalhada ao anunciante. O painel do portal pode mostrar "feed importado com sucesso" enquanto nenhum imóvel aparece, porque a confirmação se refere ao recebimento do arquivo, não ao processamento do conteúdo.
Os erros mais frequentes de malformação no XML imobiliário são:
- Caracteres especiais não escapados no conteúdo de campos: ampersand (&) escrito como & em vez de & quebra o parsing em qualquer parser XML estrito. Menos-que (<) e maior-que (>) têm o mesmo problema. Esses caracteres aparecem com frequência em descrições de imóveis que usam expressões como "3 quartos & 2 suítes" ou em textos copiados de outras fontes.
- Tags não fechadas: uma tag aberta sem o fechamento correspondente (<descricao>Texto sem fechar) invalida o XML inteiro a partir daquele ponto.
- BOM (Byte Order Mark) indesejado no início do arquivo: alguns editores de texto e geradores de arquivo adicionam uma marca BOM no início do UTF-8 que alguns parsers XML rejeitam, causando falha no parsing do arquivo inteiro.
- Caracteres de controle no conteúdo de campos: caracteres invisíveis como tabulação, quebra de linha no meio de um campo ou outros caracteres de controle copiados de planilhas ou PDFs.
Para validar se o XML está bem formado, a ferramenta mais rápida é o validador online do W3C (validator.w3.org): cole a URL do feed ou o conteúdo do XML e o validador aponta a linha exata de qualquer erro de estrutura. Essa verificação leva menos de 2 minutos e elimina toda a categoria de erros de malformação do diagnóstico.
Como verificar se a URL do feed XML está acessível pelo servidor do portal?
A URL do feed XML precisa estar acessível por qualquer servidor na internet, sem autenticação e sem restrição de IP. Um feed que funciona localmente mas não é acessível externamente nunca vai ser importado pelo portal, independentemente da qualidade do XML gerado.
O erro mais básico e mais comum em integrações XML imobiliário é a URL do feed ser acessível apenas dentro da rede local da imobiliária ou do servidor de desenvolvimento, mas não pelos servidores do portal. Isso acontece quando o sistema imobiliário está em servidor local sem IP público, quando o firewall bloqueia requisições externas para a porta do servidor, quando a URL exige autenticação HTTP que o portal não passa, ou quando o certificado SSL do domínio tem problema que causa rejeição pela maioria dos clientes HTTP modernos.
Para verificar se a URL do feed é acessível externamente, três testes são suficientes. O primeiro é tentar acessar a URL de um dispositivo em uma rede diferente da imobiliária: celular com dados móveis ou computador em outra rede wifi. Se não carregar, o problema está na acessibilidade da URL. O segundo é usar uma ferramenta de verificação de URL online como reqbin.com ou urlvoid.com, que fazem a requisição de servidores externos e mostram o código HTTP de resposta. Código 200 indica sucesso; 401 ou 403 indicam problema de autenticação; 404 indica URL incorreta; 500 indica erro no servidor. O terceiro é verificar se o SSL do domínio está válido em ssllabs.com/ssltest, porque portais modernos rejeitam conexões com certificados inválidos ou expirados.
Quais campos obrigatórios o ZAP e o VivaReal exigem no XML que causam rejeição silenciosa?
ZAP Imóveis e VivaReal (GroupZAP) exigem campos mínimos para publicação: identificador único do imóvel, tipo do imóvel, finalidade (venda ou aluguel), preço, cidade, estado e pelo menos uma foto. A ausência de qualquer campo obrigatório causa rejeição silenciosa do imóvel específico, sem afetar os outros imóveis do feed.
Uma característica importante da importação XML pelos portais é que um campo obrigatório ausente em um imóvel específico causa a rejeição daquele imóvel, não do feed inteiro. Isso significa que um feed com 50 imóveis pode ter 30 publicados e 20 rejeitados silenciosamente, cada um por um campo diferente que está ausente ou com valor inválido. A imobiliária vê 30 imóveis no portal e não sabe por que os outros 20 não aparecem.
Os campos que mais frequentemente causam rejeição silenciosa nos portais brasileiros são:
- ID único do imóvel: cada imóvel precisa de um identificador único e estável. IDs que mudam a cada atualização do sistema causam o portal a criar duplicatas ou perder a referência do imóvel existente.
- Tipo do imóvel com valor aceito pelo portal: o portal tem uma lista de tipos aceitos (Apartamento, Casa, Terreno, Comercial, etc.) e valores que não estão nessa lista causam rejeição. "AP" pode funcionar em um portal e falhar em outro que espera "Apartamento" por extenso.
- Preço como valor numérico sem formatação: o campo de preço deve conter apenas o valor numérico (ex: 450000) sem símbolo de moeda, sem pontos de milhar e sem vírgula decimal. "R$ 450.000,00" causa rejeição na maioria dos portais que esperam "450000".
- CEP no formato correto: alguns sistemas geram o CEP sem o hífen quando o portal espera com hífen, ou vice-versa. O CEP inválido faz o portal rejeitar o endereço do imóvel.
- Pelo menos uma foto com URL acessível: imóveis sem foto são rejeitados pela maioria dos portais premium ou são publicados sem visibilidade adequada.
A documentação oficial dos campos obrigatórios por portal é a referência correta para verificar o que está faltando. O GroupZAP (ZAP + VivaReal) publica a especificação do XML no portal de desenvolvedores. A integração de portais imobiliários do Website Imobiliário gera o XML já validado para cada portal específico, mapeando os campos do sistema para o formato exato de cada plataforma, eliminando esse tipo de erro de campo na geração automática.
Como erros de encoding e caracteres especiais quebram a integração XML imobiliário?
O XML imobiliário deve ser gerado em UTF-8 sem BOM. Arquivos em ISO-8859-1 (Latin-1) que não declaram o encoding correto no cabeçalho XML causam falha de parsing com caracteres acentuados. Textos copiados do Word ou de PDFs frequentemente carregam caracteres invisíveis que corrompem o XML.
O encoding é a especificação de como os caracteres são representados em bytes no arquivo. XML padrão usa UTF-8, que suporta todos os caracteres do português (ã, ç, é, ó, etc.) sem necessidade de escape. O problema ocorre quando o sistema gera o arquivo em encoding diferente (ISO-8859-1, Windows-1252, ou outro) mas o cabeçalho do XML declara UTF-8, ou vice-versa. O parser do portal tenta ler o arquivo com o encoding declarado e encontra bytes que não correspondem àquele encoding, causando falha no parsing ou publicação de caracteres incorretos.
Um sinal visível de erro de encoding no portal é o imóvel aparecer com caracteres estranhos na descrição: "Apartamento bem localizado em São Paulo" aparece como "Apartamento bem localizado em S�o Paulo" ou "Apartamento bem localizado em São Paulo" com caracteres deformados. Isso indica que o arquivo foi gerado com um encoding e lido com outro.
O problema de caracteres especiais não escapados é diferente do encoding, mas tem sintoma similar. Em XML, cinco caracteres têm significado especial na estrutura da linguagem e precisam ser substituídos por entidades quando aparecem em conteúdo de campos: & vira &, < vira <, > vira >, " vira " e ' vira '. Textos copiados de qualquer fonte que contenha & (comum em endereços como "Rua A & B" ou em características como "piscina & churrasqueira") vão quebrar o XML se não forem escapados antes de entrar no feed.
Por que IDs duplicados e URLs de fotos inacessíveis causam sumida de imóveis?
IDs de imóvel que mudam entre atualizações fazem o portal criar um novo anúncio em vez de atualizar o existente, gerando duplicatas. IDs duplicados em imóveis diferentes fazem o portal sobrescrever um imóvel com os dados de outro. URLs de fotos inacessíveis resultam em imóveis sem imagem que portais premium ocultam da busca.
O identificador único do imóvel (id ou CodigoImovel dependendo do portal) é o campo mais crítico para a estabilidade da integração. Esse ID é o que o portal usa para identificar se um imóvel já existe e deve ser atualizado, ou se é novo e deve ser criado. Quando um sistema imobiliário gera IDs que mudam a cada atualização do feed (como IDs baseados em timestamp ou em sequência que se reinicia), o portal não consegue associar o imóvel novo ao imóvel existente e cria um novo anúncio a cada importação. O resultado é que o mesmo imóvel aparece duplicado no portal, frequentemente com datas diferentes de publicação, o que pode violar as políticas de uso do portal e causar suspensão da conta da imobiliária.
IDs duplicados dentro do mesmo feed (dois imóveis diferentes com o mesmo ID) causam comportamento imprevisível: o portal pode publicar apenas o último imóvel com aquele ID, sobrescrevendo o anterior, ou pode rejeitar ambos. O diagnóstico de IDs duplicados em um feed grande é simples: ordenar o arquivo XML por ID e verificar se algum valor se repete.
As URLs de fotos inacessíveis têm um impacto específico em portais premium: o ZAP Imóveis e o VivaReal requerem ao menos uma foto válida e acessível para publicar o imóvel com visibilidade normal. Um imóvel cuja URL de foto retorna 404 (imagem deletada do servidor) ou 403 (imagem com restrição de acesso) não vai ter as fotos exibidas no portal, e muitos portais reduzem a visibilidade ou ocultam completamente imóveis sem foto. Para verificar se as URLs de foto estão acessíveis, o mesmo teste de URL externa descrito na seção de feed se aplica: testar uma URL de foto de fora da rede da imobiliária para confirmar que o servidor externo do portal consegue acessá-la.
Por que o XML foi alterado mas o portal não atualizou o imóvel?
Portais importam o feed XML em intervalos programados, tipicamente a cada 24 horas. Uma alteração feita no sistema imobiliário aparece no portal somente após a próxima importação agendada, não imediatamente. Se a importação falhou silenciosamente, a atualização não acontece mesmo após o intervalo.
O modelo de integração XML imobiliário é por polling: o portal acessa periodicamente a URL do feed da imobiliária e importa os dados. Não é push (a imobiliária avisa o portal quando algo muda) nem tempo real. Isso significa que qualquer alteração feita no sistema imobiliário, seja mudança de preço, atualização de descrição ou adição de foto, vai aparecer no portal apenas após a próxima importação agendada.
A maioria dos portais importa os feeds a cada 24 horas, com horários que variam por portal e às vezes por conta. ZAP e VivaReal têm ciclos de importação que podem ser de 24 a 48 horas dependendo do plano contratado. Isso significa que uma alteração urgente de preço feita agora pode demorar até dois dias para aparecer no portal. Esse comportamento não é um erro: é o funcionamento normal do sistema. O erro ocorre quando a importação falha silenciosamente e o imóvel não é atualizado mesmo após vários ciclos.
Uma atualização que não se reflete no portal após 48 horas indica que a importação mais recente falhou. As causas mais comuns para falha de uma importação que antes funcionava são: a URL do feed mudou (domínio ou path alterado), o certificado SSL expirou, uma alteração no sistema gerou XML malformado apenas no feed mais recente, ou um imóvel novo adicionado tem um campo inválido que interrompeu o parsing do feed inteiro antes de processar os imóveis que precisam de atualização.
Para forçar uma reimportação antes do ciclo agendado, a maioria dos portais tem um botão de "reimportar feed" ou "sincronizar agora" no painel do anunciante. Isso é útil para confirmar se o feed atual está sendo importado corretamente após uma correção.
Ponto de vista: o que aprendi em 20 anos de integrações XML com portais imobiliários
Por Alessandro Oliveira — fundador do Website Imobiliário, doutor em Engenharia de Sistemas Eletrônicos (Poli-USP), desenvolvedor de plataformas para o mercado imobiliário brasileiro desde 2005.
Desenvolvi integrações XML para portais imobiliários desde que essa forma de integração surgiu no mercado brasileiro, e ao longo desse tempo cometi ou diagnostiquei praticamente todos os erros descritos neste artigo. O que me levou a desenvolver a integração do Website Imobiliário com geração automática e validada de XML foi exatamente a observação de que a maioria dos problemas de integração que imobiliárias relatavam eram recorrentes e completamente previsíveis: o caractere especial não escapado na descrição de um imóvel, o preço copiado de uma planilha com formatação incorreta, o ID que mudou porque o sistema foi reiniciado.
Há um padrão nos erros de XML imobiliário que identifiquei ao longo dos anos: os erros de conteúdo (campo com valor incorreto) são mais fáceis de diagnosticar porque o imóvel aparece com dado errado, sinalizando onde está o problema. Os erros de estrutura (XML malformado, encoding incorreto) são mais difíceis porque o sintoma é o imóvel simplesmente não aparecer, sem nenhuma pista sobre a causa. E os erros de acessibilidade (URL inacessível, SSL expirado) são os mais frustrantes porque o sistema gera o XML corretamente, a imobiliária abre o feed no navegador e vê tudo certo, mas o portal nunca consegue acessar o arquivo porque o teste foi feito de dentro da rede local.
Por isso o Website Imobiliário foi desenvolvido com integração aos portais como funcionalidade nativa, não como exportação manual de XML. A plataforma gera o feed XML de acordo com a especificação de cada portal, valida automaticamente os campos obrigatórios antes de publicar, mantém os IDs de imóveis estáveis independentemente de outras alterações no cadastro e verifica acessibilidade das URLs de foto antes de incluí-las no feed. As imobiliárias que usam o sistema não precisam se preocupar com esses detalhes técnicos: o XML correto é gerado automaticamente. Para conhecer como funciona a divulgação de imóveis com integração automática a mais de 20 portais, a demonstração mostra o processo completo sem necessidade de configuração manual de XML.
Tabela de diagnóstico: sintoma, causa provável e solução
| Sintoma observado | Causa provável | Como verificar | Solução |
|---|---|---|---|
| Nenhum imóvel aparece no portal, portal confirma feed recebido | XML malformado (caractere especial, tag não fechada) ou encoding incorreto | Validar o XML no validator.w3.org | Escapar caracteres especiais (& < >), fechar todas as tags, verificar declaração de encoding UTF-8 |
| Nenhum imóvel aparece, portal não confirma recebimento do feed | URL do feed inacessível externamente: problema de rede, firewall, SSL ou autenticação | Acessar a URL do feed de rede externa (dados móveis) ou via reqbin.com | Liberar acesso externo ao servidor, verificar SSL em ssllabs.com, remover autenticação ou informar credenciais ao portal |
| Apenas alguns imóveis aparecem, outros não | Campos obrigatórios ausentes ou com valor inválido nos imóveis que não aparecem | Comparar o XML de um imóvel que aparece com um que não aparece, verificando todos os campos obrigatórios | Preencher campos obrigatórios ausentes, corrigir formato de preço (sem R$ e sem formatação), verificar tipo do imóvel aceito pelo portal |
| Imóvel aparece com descrição com caracteres estranhos (? ou símbolos) | Erro de encoding: arquivo em ISO-8859-1 declarado como UTF-8, ou vice-versa | Abrir o arquivo XML em editor de texto hexadecimal para verificar o encoding real versus o declarado | Converter o arquivo para UTF-8 sem BOM e declarar corretamente no cabeçalho: <?xml version="1.0" encoding="UTF-8"?> |
| Imóvel aparece com preço incorreto | Campo de preço com formato não numérico (R$, pontos, vírgulas) ou valor de campo errado mapeado para o preço | Ver o valor do campo de preço no XML bruto para aquele imóvel | Garantir que o campo preço contenha apenas o valor numérico inteiro (ex: 450000 e não R$ 450.000,00) |
| Imóvel aparece duplicado no portal | ID do imóvel mudou entre duas atualizações do feed, fazendo o portal criar novo anúncio | Comparar o ID do imóvel no feed atual com o ID no feed anterior da mesma propriedade | Usar IDs estáveis baseados no código interno permanente do imóvel, nunca em sequência reiniciável ou timestamp |
| Imóvel sem fotos no portal | URLs de fotos inacessíveis externamente (404, 403) ou URLs não incluídas no feed | Acessar a URL de uma foto do feed de rede externa para verificar acessibilidade | Mover fotos para servidor de hospedagem com URL pública e permanente, remover restrição de acesso |
| Imóvel foi atualizado no sistema mas o portal mostra a versão antiga | Importação do portal ainda no ciclo de 24h, ou falha silenciosa na importação mais recente | Verificar se o feed atual (URL do XML) já contém a alteração e usar botão de reimportação no painel do portal | Aguardar o ciclo de importação (24 a 48h) ou acionar reimportação manual. Se não atualizar após 48h, verificar se o feed mais recente está acessível e válido |
| Imóvel sumiu do portal sem ação da imobiliária | Imóvel foi removido do feed XML (vendido ou inativo) sem processo de remoção adequado, ou ID foi alterado | Verificar se o imóvel ainda está no feed XML atual pelo seu ID | Para remover imóvel do portal, mantê-lo no feed com status "inativo" ou "vendido" por ao menos uma importação antes de remover completamente, para sinalizar remoção intencional ao portal |
Perguntas frequentes sobre erros no XML imobiliário
O portal confirmou que recebeu o XML mas meus imóveis não aparecem. O que fazer?
A confirmação de recebimento do feed pelo portal indica que o arquivo foi baixado com sucesso, mas não necessariamente que o conteúdo foi processado. O próximo passo é validar o XML em um validador online como o do W3C (validator.w3.org) para verificar se está bem formado. Se o XML for válido, verificar se todos os campos obrigatórios do portal estão presentes e com formato correto nos imóveis. Um campo obrigatório ausente causa rejeição silenciosa do imóvel sem mensagem de erro visível no painel.
Como saber qual é o formato de XML aceito pelo ZAP Imóveis e pelo VivaReal?
O GroupZAP (que opera ZAP Imóveis e VivaReal) publica a especificação do formato XML no portal de desenvolvedores da plataforma. A documentação lista os campos obrigatórios, os campos opcionais, os valores aceitos para campos de lista (como tipo de imóvel e finalidade) e o formato de cada campo. Antes de configurar qualquer integração com ZAP ou VivaReal, a leitura da documentação oficial é o passo correto para garantir aderência ao formato esperado.
Por que meu feed XML funciona no computador mas o portal diz que não consegue acessar?
Esse é o sintoma clássico de URL acessível apenas dentro da rede local. Se o sistema imobiliário está em servidor local (na imobiliária) ou em servidor sem IP público, o feed é acessível dentro da rede mas não pelo servidor do portal. A solução é hospedar o sistema em servidor com IP público e domínio próprio, ou mover a geração do feed para um servidor com acesso externo. Verificar sempre se a URL é acessível de uma rede externa (celular com dados móveis ou computador em outra rede) antes de cadastrar o feed no portal.
Com que frequência os portais atualizam os dados do feed XML?
A frequência de importação varia por portal e por plano. ZAP e VivaReal importam feeds tipicamente a cada 24 a 48 horas para planos padrão. Alguns portais oferecem frequência maior (12 horas ou menos) em planos premium. Isso significa que qualquer alteração feita no sistema imobiliário pode demorar até dois dias para aparecer no portal. Para alterações urgentes (como redução de preço ou marcação de vendido), a maioria dos portais tem botão de reimportação manual no painel do anunciante que força a busca do feed antes do próximo ciclo agendado.
Como o Website Imobiliário evita os erros de XML na integração com portais?
O Website Imobiliário gera o feed XML de forma automática para cada portal integrado, mapeando os campos do cadastro do imóvel para o formato exato esperado por cada plataforma: ZAP Imóveis, VivaReal, OLX Imóveis, Chaves na Mão, ImovelWeb e outros. O sistema valida os campos obrigatórios antes da publicação, escapa automaticamente caracteres especiais em campos de texto, gera o arquivo em UTF-8 sem BOM, mantém IDs de imóvel estáveis e verifica que as URLs de foto estão incluídas corretamente. As imobiliárias que usam o Website Imobiliário não precisam configurar ou manter o XML manualmente. Para conhecer como funciona na prática, agende uma demonstração gratuita.
Fontes e referências
- W3C — Especificação XML 1.0 e validador oficial
Sustenta as afirmações sobre as regras de XML bem formado: caracteres que devem ser escapados (&, <, >, ", '), requisito de codificação de encoding no cabeçalho e regras de tags bem fechadas. O validador W3C é a ferramenta de referência para verificar conformidade de XML com a especificação.
validator.w3.org - W3C — Especificação de encoding XML e Unicode
Sustenta as afirmações sobre encoding UTF-8 como padrão para XML, o problema do BOM (Byte Order Mark) em arquivos UTF-8 e como declarar corretamente o encoding no cabeçalho XML para evitar erros de parsing com caracteres especiais do português.
w3.org/TR/xml — Character Encoding - SSL Labs — Ferramenta de teste de certificado SSL/TLS
Sustenta a recomendação de verificar a validade do certificado SSL da URL do feed como etapa do diagnóstico de inacessibilidade, especialmente porque portais e clients HTTP modernos rejeitam conexões com certificados inválidos ou expirados.
ssllabs.com/ssltest
