Imóvel não aparece no ZAP ou na OLX? Os erros de XML mais comuns e como resolver

Você cadastrou, conferiu as fotos, esperou um dia inteiro e o imóvel não aparece no ZAP. Ou aparece na OLX com o preço errado, sem foto, ou duas vezes. O cliente liga perguntando de um anúncio que você nem sabia que estava no ar. Na maioria dos casos, o problema não é o portal: é algum dado do imóvel que o arquivo XML levou faltando ou errado.

Este artigo mostra as causas mais comuns, o que a documentação pública do Grupo OLX (ZAP Imóveis, VivaReal e OLX) pede em cada campo e um checklist para descobrir o motivo em poucos minutos. No fim, mostramos como a Viniun cuida disso pelo sistema.

Por que o imóvel não aparece no ZAP ou na OLX?

Quase sempre porque o anúncio chegou ao portal incompleto, repetido ou fora da cota contratada. O portal lê o seu arquivo XML (o "feed") de tempos em tempos e descarta, sem avisar no seu CRM, o que não passa nas regras dele.

As causas que mais aparecem no dia a dia da imobiliária:

• Campo obrigatório vazio: CEP, bairro, cidade, estado, tipo do imóvel ou área.
• Endereço ou CEP errado: CEP com dígito trocado, cidade escrita de outro jeito, estado vazio.
• Foto que não serve: poucas fotos, arquivo pesado demais, formato que o portal não importa ou link quebrado.
• Código repetido: dois imóveis com o mesmo código de referência no arquivo.
• Tipo e finalidade que não combinam: imóvel marcado como venda e locação, mas só com o valor de venda preenchido.
• Preço zerado ou "sob consulta" num portal que exige valor.
• Cota do plano do portal estourada: o contrato permite 200 anúncios e o arquivo leva 260.
• Feed parado: o arquivo não foi gerado de novo depois da mudança, e o portal continua lendo a versão antiga.
• Imóvel duplicado: o mesmo apartamento cadastrado duas vezes, com códigos diferentes.

Quais campos o ZAP exige no arquivo XML?

O ZAP, o VivaReal e a OLX leem o padrão VRSync, e a documentação pública dele lista as regras. Se um campo obrigatório falta, o anúncio não é processado.

Os pontos que mais derrubam anúncio, segundo a documentação do VRSync (elemento Listing) e a documentação dos detalhes do imóvel:

A documentação também diz que os destaques precisam respeitar a "grade contratada", ou seja, o que o seu plano no portal permite.

Por que a foto do imóvel não sobe no portal?

Porque o portal baixa cada foto pelo link que está no XML, e descarta a que não abre, está pesada ou fora do formato. Em muitos casos, o portal recusa o anúncio inteiro quando faltam fotos válidas.

Confira três coisas: se o imóvel tem pelo menos 5 fotos, se o link de cada foto abre no navegador (sistema antigo desligado é a causa mais comum de link quebrado) e se a capa é uma foto boa, de frente. Foto de decoração virtual deve vir indicada como imagem ilustrativa e nunca como capa.

Por que o anúncio aparece duplicado ou com o preço errado?

Duplicado é quase sempre o mesmo imóvel cadastrado duas vezes, ou o código de referência que muda a cada exportação. Preço errado é, na maior parte das vezes, o valor indo no campo errado do arquivo.

• Mesmo imóvel, dois cadastros: um corretor cadastrou para venda, outro para locação. O portal vê dois anúncios do mesmo endereço. O certo é um cadastro só, com os dois valores.
• Código que muda: se o sistema gera o código de novo a cada envio, o portal entende como anúncio novo e mantém o antigo no ar por um tempo.
• Valor no campo errado: ao migrar de sistema, é comum o arquivo antigo levar a entrada ou a parcela na tag do preço de venda. O imóvel de R$ 600 mil aparece por R$ 60 mil.
• Preço zerado: "sob consulta" vira zero em alguns sistemas, e o portal recusa ou mostra o anúncio sem valor.

O anúncio pode sumir por causa do plano do portal?

Pode. Se o seu contrato tem cota de anúncios e o arquivo leva mais imóveis do que a cota, o portal publica até o limite e o resto fica de fora, sem critério que você controle.

Por isso, informe a cota no sistema e escolha quais imóveis entram: os destaques primeiro, depois o resto. Assim você decide o que fica fora, e não o portal.

Checklist: como descobrir por que o imóvel não aparece no ZAP: como funciona?

Siga na ordem. Em geral, o motivo aparece até o passo 5.

1. O imóvel está publicado e ativo? Vendido, alugado ou inativo não deve ir para portal nenhum.
2. Ele foi escolhido para aquele portal? Muitos sistemas pedem que você marque imóvel por imóvel.
3. Quantos imóveis você escolheu e quantos saíram no arquivo? Se escolheu 26 e saíram 22, quatro ficaram fora por algum dado.
4. Quando o arquivo foi gerado pela última vez? Mudança feita depois disso ainda não chegou.
5. Abra a prévia do anúncio no formato do portal e confira CEP, bairro, cidade, estado, tipo, finalidade, preço e área.
6. Conte as fotos e abra o link de duas ou três.
7. Procure o código do imóvel no arquivo inteiro: ele aparece uma vez só?
8. Compare com a cota do contrato: o arquivo leva mais anúncios do que o plano permite?
9. Veja o relatório de integração no painel do portal (no Grupo OLX, pelo Canal Pro). Ele costuma dizer o campo recusado.
10. Persistiu? Abra chamado no portal com o código do imóvel, a URL do feed e o print do erro.

Como a Viniun resolve isso?

Na Viniun você cadastra o imóvel uma vez e ele vai para o site e para o feed de cada portal que você ativou: VRSync (ZAP, VivaReal e OLX), ImovelWeb, Chaves na Mão, Portal CRECI-SP e outros formatos. As regras que evitam a maior parte dos erros acima ficam no próprio gerador do arquivo.

• Fotos em JPG, no tamanho que o portal aceita: o feed envia cada foto em JPG com até 1.600 px e abaixo de 7 MB, mesmo que no site ela apareça em formato mais leve.
• Imóvel sem foto não vai para portal nenhum, e foto com link quebrado fica fora do arquivo para não derrubar o anúncio.
• Vendido, alugado ou inativo sai do feed na próxima geração.
• O código do anúncio é sempre o código do imóvel, o mesmo em toda geração. O portal não vê anúncio "novo" a cada envio.
• Estado deduzido pela cidade ou CEP quando o cadastro não tem UF, sem chutar.
• Descrição cortada no limite do portal e decoração virtual sempre por último, com a legenda de imagem ilustrativa.
• Feed regerado sozinho: quem muda imóvel, anúncio ou foto marca o portal como pendente, e o arquivo é refeito na rodada seguinte, a cada 30 minutos. Também dá para clicar em "Gerar agora".
• Cota respeitada: você informa o limite do contrato e os destaques entram primeiro.

1. Imóveis, No feed e Gerado — 26 escolhidos e 22 no arquivo: a diferença é o sinal para conferir os 4 que ficaram fora. "Gerado" diz quando o portal recebeu a última versão.
2. URL do feed — o endereço que você cola no cadastro de integração do portal.
3. Falta informar — o dado que o portal exige e ainda não foi preenchido (aqui, o Código Central de Vendas da ImovelWeb). Sem ele, o feed não é gerado.

1. Prévia — aberta pelo ícone de olho, na lista de imóveis do portal.
2. O XML do anúncio — confira código, finalidade, preço, fotos (a principal vem marcada) e descrição sem precisar abrir o arquivo inteiro.

1. URL do feed — completa, com o formato e o nome do arquivo.
2. Limite de anúncios no feed — a cota do seu plano no portal. Em branco, vão todos os escolhidos.
3. Destaques entram primeiro — se a cota apertar, o que fica fora é o que você não destacou.

1. Gerações — o histórico do arquivo deste portal.
2. Feed gerado com N anúncio(s) — se o número cair de repente (ou zerar), algo mudou nos imóveis escolhidos e vale conferir antes de o portal tirar os anúncios do ar.

Duas proteções ficam antes do feed. A primeira é o imóvel único: se a mesma empresa cadastra de novo um endereço que já existe, o sistema salva, marca como duplicado e avisa; cadastro só de venda e outro só de locação no mesmo endereço aparecem como "repetidos por finalidade", com a opção de juntar num só. A segunda é a importação com de-para por tag: ao trazer o estoque do sistema antigo pelo XML, você vê cada tag do arquivo com um exemplo do valor e escolhe para qual campo ela vai. É assim que se evita a entrada indo parar no preço de venda.

E, para colocar muitos imóveis no ar de uma vez, a lista de imóveis tem a seleção em lote com "Publicar no site". O passo a passo de ativar cada portal está no tutorial de publicar imóveis nos portais, e o panorama dos portais e formatos está no guia de integração com portais imobiliários. Para trazer o estoque de outro sistema, veja importar imóveis e leads por planilha; para caprichar no texto que vai ao portal, descrição de imóveis para venda.

A conferência final continua sendo do portal: o relatório de integração do Canal Pro (ou do portal que você usa) é quem diz se ele aceitou cada anúncio. As telas acima são da conta de demonstração da Viniun, com dados fictícios.

Quer parar de caçar erro de XML?

Cadastre uma vez, escolha os imóveis de cada portal e acompanhe o que saiu no feed numa tela só. Crie sua conta e teste grátis. Os planos estão em planos e preços.