Quase todo erro de integração XML nasce no cadastro do imóvel, não no portal. O feed só repassa o que está no sistema: se faltam fotos, o endereço está incompleto ou o código se repete, o portal recusa ou publica errado. A saída é conferir o cadastro antes do envio e olhar o relatório de erros toda semana.
Este artigo complementa o guia sobre como funciona a integração com portais por XML. Aqui o foco é prático: os erros que mais aparecem, de onde vêm e o que fazer para que não voltem.
O que é o feed XML e por que ele falha
O feed XML é um arquivo, gerado pelo seu sistema, que lista os imóveis em um formato que o portal consegue ler. O portal visita o endereço do arquivo de tempos em tempos, compara com o que já publicou e cria, atualiza ou remove anúncios.
Isso significa que o portal não conversa com você: ele só lê. Quando um imóvel não aparece ou aparece errado, a causa é uma entre três. O dado estava ruim no cadastro, o portal não aceitou o dado, ou o arquivo não chegou a ser lido. Saber em qual dessas três você está economiza horas de tentativa e erro.
Erros de cadastro que viram recusa
São os mais frequentes e os mais fáceis de evitar, porque dependem só de disciplina na hora de cadastrar.
- Fotos insuficientes ou com problema: cada portal define um mínimo de fotos e um tamanho mínimo de imagem. Foto vertical cortada, imagem muito pequena ou link de foto que não abre também derrubam o anúncio.
- Endereço incompleto: sem cidade, bairro ou CEP coerentes, o portal não consegue posicionar o imóvel no mapa e pode recusar ou exibir em local errado.
- Tipo de imóvel e finalidade trocados: cadastrar uma cobertura como apartamento comum, ou uma locação como venda, muda a categoria do anúncio e gera reclamação do cliente.
- Valor zerado ou em formato errado: preço vazio, com texto ou com separador de milhar fora do padrão costuma gerar recusa imediata.
- Código de referência repetido: o código é a identidade do imóvel no portal. Dois imóveis com o mesmo código se sobrescrevem, e um deles some.
- Descrição copiada ou com dados de contato: muitos portais proíbem telefone e e-mail no texto do anúncio. Descrição idêntica em vários imóveis também prejudica o desempenho.
Erros de configuração entre sistema e portal
Mesmo com cadastro perfeito, a ligação pode estar mal feita.
- Código da imobiliária errado: o portal precisa reconhecer quem está enviando. Um código digitado com erro faz o feed ser ignorado sem aviso claro.
- URL do feed desatualizada: se o endereço do arquivo mudou e o portal continua olhando o antigo, nada é atualizado. Depois de qualquer mudança de domínio, reenvie a URL.
- Portal errado para o formato certo: cada portal ou grupo de portais lê um formato próprio. Mandar o arquivo de um para outro gera erro de leitura.
- Cota de anúncios estourada: o plano contratado no portal limita quantos imóveis ficam publicados. Quando o feed traz mais do que a cota, parte da carteira fica de fora. Vale conferir qual imóvel o portal escolheu manter.
- Imóvel inativo continuando no feed: vendido ou alugado e ainda publicado é o erro que mais gera cliente irritado. O imóvel precisa sair do feed no mesmo dia em que muda de situação.
Erros de rotina
O terceiro grupo não é técnico, é de processo.
Descobrir o problema só quando o cliente reclama
Se o gestor só olha o portal quando alguém liga reclamando de anúncio errado, o erro já ficou semanas no ar. Reserve um momento fixo, por exemplo toda segunda-feira, para olhar o relatório de erros do feed e a lista de imóveis recusados.
Editar direto no portal
Corrigir o anúncio dentro do painel do portal parece rápido, mas na próxima leitura do feed o dado do sistema sobrescreve a correção. A regra é simples: a fonte de verdade é o cadastro do sistema. Corrigiu lá, o portal acompanha.
Ninguém é dono do assunto
Quando todos cadastram e ninguém confere, o erro se repete. Defina uma pessoa responsável por revisar os recusados e, se possível, um campo obrigatório de fotos e endereço no cadastro para que o imóvel nem seja marcado como ativo incompleto.
Rotina semanal de conferência em quatro passos
- Abra a lista de imóveis com erro de envio e corrija cada motivo no cadastro.
- Compare a quantidade de imóveis ativos no sistema com a de anúncios publicados no portal. A diferença precisa ter explicação.
- Abra três anúncios ao acaso no portal e confira foto de capa, preço e endereço.
- Confirme que os imóveis vendidos ou alugados na semana já saíram do ar.
Essa conferência leva poucos minutos quando feita toda semana e muitas horas quando acumulada por meses.
Como o Larvon ajuda nessa rotina
No Larvon, o feed de cada portal é gerado a partir do cadastro de imóveis, e o sistema aponta o que falta em cada imóvel para aquele portal, como fotos ou campos obrigatórios, além de manter um histórico de envios. Os leads que chegam dos portais integrados voltam para o funil já com origem e corretor definido, o que se conecta com a roleta de leads. O passo a passo de ativação está na central de ajuda.
Para checar a qualidade do texto antes de publicar, use também o verificador de anúncio.
Perguntas frequentes
Por que meu imóvel não aparece no portal depois de cadastrado?
As causas mais comuns são cadastro incompleto para aquele portal, imóvel fora da cota contratada ou feed ainda não lido. Confira primeiro o relatório de erros do sistema e depois o painel do portal.
Quanto tempo o portal leva para refletir uma alteração?
Depende do portal e da frequência com que ele lê o feed. Não existe prazo único, então evite corrigir várias vezes seguidas esperando efeito imediato.
Posso corrigir o anúncio direto no painel do portal?
Até pode, mas a correção costuma ser sobrescrita na próxima leitura do feed. O correto é corrigir no cadastro do sistema.
Um erro em um imóvel derruba o feed inteiro?
Em geral não. O portal recusa o item com problema e processa os demais, mas isso varia conforme o portal e o tipo de erro.