Anúncio Recusado no ZAP por XML: Causas e Conserto
Equipe Alugo
Especialistas em Contratos e Direito Imobiliário
7 dias grátis. Pede cartão, sem cobrança no período. Cancele quando quiser.
Resposta direta: por que o portal recusa um anúncio por XML
O portal recusa um anúncio por XML porque o dado enviado não cumpre uma regra do formato VRSync (foto de menos, descrição curta, CEP ausente, valor com centavos, código repetido) ou porque o arquivo inteiro nem foi lido (URL bloqueada, certificado inválido, encoding quebrado). Em ambos os casos, o conserto é feito na origem, no sistema que gera o XML. Anúncio criado por XML não pode ser editado no Canal Pro.
Este é o guia de diagnóstico, para quando o anúncio já foi enviado e foi recusado, bloqueado ou sumiu. Para configurar a integração do zero, veja integração XML com ZAP, VivaReal e OLX: passo a passo. Os dados sobre o portal vêm do portal de desenvolvedores do Grupo OLX, conferidos em 16/11/2026. As regras podem mudar, então confirme na documentação oficial se algo divergir.
Primeiro descubra o tamanho do erro: carga ou anúncio
Antes de olhar imóvel por imóvel, separe os dois níveis de erro. Eles têm causas e consertos diferentes, e confundir um com o outro é o que faz a equipe perder horas.
Os dois níveis de erro na integração por XML
| Nível | Sintoma | O que acontece |
|---|---|---|
| Erro de carga | Nenhum anúncio novo ou atualizado aparece. O e-mail fala em formato, download ou carga não processada. | O arquivo inteiro não é processado. Vale para a carteira toda. |
| Erro por anúncio | A maioria dos imóveis está no ar, mas alguns não entram, ou o total com erro no relatório é maior que zero. | O arquivo é lido, e o imóvel com erro não é integrado. Os demais seguem normalmente. |
Arraste para o lado para ver toda a tabela
Se nada mudou na carteira em 24 horas, desconfie de carga. Se só alguns imóveis ficaram de fora, desconfie de erro por anúncio. Há ainda um terceiro grupo, de regras do portal que parecem erro (grade do plano, anúncio manual duplicado), tratado mais abaixo.
Onde ler o erro: e-mail, Relatório de Integração e validador
O portal não deixa o erro escondido, mas ele chega por caminhos diferentes. Quatro fontes valem a consulta:
- E-mail diário de relatório de integração: vai a todo anunciante integrado. Traz o identificador da execução, a data da última execução, a próxima execução, o total de anúncios processados com sucesso, o total de novos e o total com erro. Traz também o uso do plano e a completude da grade.
- Relatório de Integração no Canal Pro: lista os anúncios com erro. O ListingID (código do anúncio) serve para achar o imóvel na aba de relatórios.
- E-mail de erro de carga: vai a quem está com erro há mais de três dias. Informa o motivo de a carga não ter sido processada, o link do validador e orientações.
- Webhook: se o seu software ou CRM estiver configurado para receber, o resultado chega por lá.
O validador de XML do Grupo OLX (em beta, aceita arquivo de até 30 MB e só o formato VRSync) permite testar o arquivo sem esperar a próxima leitura. O fluxo é: validar o arquivo, ajustar na origem, atualizar o link se ele mudou (no Canal Pro, em Configurações da conta e Integração de anúncios; os nomes de menu podem mudar) e conferir o resultado na próxima execução no Relatório de Integração.
O e-mail de relatório chega todo dia e costuma ser ignorado. Defina uma pessoa da equipe para ler o total com erro. Esperar o aviso de três dias é esperar três dias com imóvel vago fora do portal.
Erros de carga: o arquivo inteiro falha
Quando a carga falha, nenhum anúncio é processado, mesmo os que estão perfeitos. A tabela traz o erro, o que o portal exige e o conserto na origem.
Erros de carga: erro, o que o portal exige e como consertar
| Erro | O que o portal exige | Como consertar na origem |
|---|---|---|
| Formato inválido | Só o formato VRSync é aceito. Outros formatos foram aceitos apenas até 30/10/2024. | Peça ao fornecedor do seu sistema que gere o feed em VRSync. A própria documentação orienta consultar o seu software. |
| Erro de download (ex.: HTTP 403) | A sonda do Grupo OLX baixa o XML a cada 12 horas, com o User-Agent VivaRealBot/1.0. | Libere esse User-Agent no servidor ou na hospedagem. Se houver firewall, os IPs de saída do Grupo OLX precisam estar liberados. |
| Tempo esgotado | 60 segundos para estabelecer a conexão e 20 minutos para baixar o arquivo. | Deixe o servidor do feed estável e rápido. Arquivo pesado demais ou servidor lento estoura o limite. |
| Certificado HTTPS inválido | Certificado autoassinado não é aceito. Redirecionamento de HTTP para HTTPS do mesmo domínio é suportado. | Use certificado válido, emitido por autoridade reconhecida. |
| URL do feed fora do padrão | No máximo 255 caracteres, ASCII válido, sem espaços e sem caracteres como | $ # & sem codificação. | Encurte e corrija a URL no sistema e atualize o link no Canal Pro. |
| Acentos quebrados (encoding) | UTF-8 ou ISO8859-1, declarado na primeira linha do XML. A documentação recomenda envolver título e descrição em CDATA. | Corrija a declaração de encoding e o tratamento de CDATA na geração do arquivo. |
| Arquivo grande demais | Até 50 mil anúncios por arquivo. | Só interessa a carteiras muito grandes. Para enviar mais do que isso num arquivo, a documentação manda falar com o suporte do portal. |
Arraste para o lado para ver toda a tabela
Repare que nenhum desses erros se resolve dentro do Canal Pro. Todos dependem do servidor e do gerador do XML, ou seja, do seu sistema. Se o e-mail de erro de carga chegou, abra o link do validador antes de qualquer outra coisa.
Erros por anúncio: só o imóvel com problema fica de fora
Aqui o arquivo foi lido, e o portal informa que imóveis com erros não são integrados. A tabela abaixo organiza por erro, exigência do portal e conserto. Ela é de diagnóstico: o passo a passo de cadastro do link está no guia de configuração da integração.
Erros por anúncio: erro, o que o portal exige e como consertar
| Erro | O que o portal exige | Como consertar na origem |
|---|---|---|
| Código do anúncio repetido | ListingID único, de 1 a 50 caracteres. Com duplicados, só um é processado. | Garanta um código estável e exclusivo por imóvel. Dois imóveis com o mesmo código disputam a vaga. |
| Título fora do padrão | De 10 a 100 caracteres, sem tags HTML. | Ajuste o tamanho do título e remova HTML. |
| Descrição vazia ou curta | Obrigatória, de 50 a 3.000 caracteres, sem tags HTML. Elemento vazio gera erro de importação. | Escreva a descrição no cadastro do imóvel e remova HTML. |
| Preço com formato errado | Aluguel, condomínio e IPTU só com valor inteiro, sem casas decimais, cifrão, ponto ou vírgula. Atributo de moeda BRL obrigatório. | Faça o gerador enviar inteiro e informar a moeda BRL. |
| CEP ou endereço incompleto | CEP obrigatório em todos os anúncios. Endereço mínimo: país, estado, cidade e bairro. A documentação avisa que número e complemento serão obrigatórios para alguns tipos. | Complete o endereço no cadastro, com CEP, e já preencha número e complemento. |
| Tipo de imóvel sem categoria | PropertyType obrigatório. Tipo fora da lista do portal não tem categoria. | Mapeie o tipo do seu cadastro para um tipo aceito pelo portal. |
| Área sem valor | Valor inteiro. A área útil (LivingArea) precisa de valor, senão há erro na importação. | Preencha a área útil, em número inteiro. |
| Quartos ou banheiros ausentes | Obrigatórios para alguns tipos, em geral os residenciais. Banheiro não é obrigatório para lote, terreno, galpão, depósito e armazém. Kitnet vai com 0 quarto. | Preencha os dois campos. Para kitnet, informe 0 em quartos. |
| Fotos insuficientes ou fora do padrão | Mínimo de 5 por anúncio, só JPG, até 7 MB cada, com uma foto de destaque. Imagens fora do padrão não são importadas. | Suba pelo menos 5 fotos em JPG e reduza as que passam de 7 MB. |
| Foto trocada que não atualiza | O link da imagem é o identificador dela. Se a foto muda, o link precisa mudar, senão o portal mantém a antiga. | Faça o sistema gerar um novo endereço de imagem quando a foto for trocada. |
| Vídeo recusado | Vídeo por link só é processado se estiver no YouTube. | Use link do YouTube. |
| Contato do anunciante ausente | Dados mínimos de contato são obrigatórios. Sem eles há erro de importação. | Preencha o contato da imobiliária na configuração do sistema. |
Arraste para o lado para ver toda a tabela
Veja o que ficou de fora antes do portal recusar
O Alugo confere esses campos antes de enviar. O imóvel que o portal recusaria fica fora do link, numa lista "ficou de fora" com o motivo, e você corrige no cadastro.
Ver como a carteira vira anúncioParece erro, mas é regra do portal
Quatro situações fazem a equipe achar que o XML está errado, quando o que há é uma regra do portal.
- Anúncio manual igual ao do XML: o anúncio do XML dá erro de duplicidade e não é processado até você excluir o manual à mão no Canal Pro. A carga não apaga anúncio manual.
- Anúncio do XML que não deixa editar no Canal Pro: é assim mesmo. Anúncio criado por XML não pode ser editado lá. O conserto é na origem.
- Grade contratada estourada: passou da quantidade do plano com o portal, os anúncios excedentes são inativados automaticamente. Vale para manual e XML. O e-mail diário mostra o uso do plano e a completude da grade.
- Ritmo de 12 horas: corrigiu e não apareceu? Espere a próxima leitura antes de procurar defeito.
Ordem de diagnóstico em 7 passos
Leia o e-mail diário de relatório
Veja o total processado com sucesso, o total novo e o total com erro, além da próxima execução. Se a próxima execução ainda não chegou, espere.
Separe carga de anúncio
Se o e-mail fala de formato, download ou carga não processada, é carga. Se o total com erro é pontual, é anúncio.
Se for carga, rode o validador
Valide o arquivo no validador de XML do Grupo OLX (beta, até 30 MB, só VRSync) e confira URL, certificado, User-Agent e encoding.
Se for anúncio, ache o ListingID
No Relatório de Integração do Canal Pro, use o código do anúncio para localizar o imóvel e ler o motivo.
Confira as regras que parecem erro
Veja se há anúncio manual igual no Canal Pro e se a grade do plano estourou.
Corrija na origem
Ajuste o dado no cadastro do imóvel, no seu sistema. Não adianta editar no Canal Pro.
Confira na próxima execução
Depois de até 12 horas, veja no Relatório de Integração se o total com erro caiu. Se persistir, abra chamado no canal de integração do Grupo OLX com o link do feed e o ListingID.
Quem conserta: o seu sistema, não o portal
O portal só lê o que o seu sistema publica. Ele não corrige foto, não completa CEP e não troca o tipo do imóvel. Por isso, antes de pedir ao suporte do portal para "liberar" um anúncio recusado, leia o motivo no relatório: enquanto o dado continuar errado no arquivo, o anúncio volta a ser bloqueado na leitura seguinte.
A conversa certa é com o fornecedor do sistema que gera o XML, levando o ListingID, o motivo do relatório e, se for erro de carga, o resultado do validador. O canal de chamados de integração do Grupo OLX existe para casos em que o feed está correto e o problema persiste. Se você está cansado de repetir esse ciclo com o sistema atual, o guia como migrar de sistema imobiliário mostra como planejar a troca sem perder a carteira.
Como o Alugo ajuda a não chegar ao erro
No Alugo, a tela Portais, dentro do CRM de locação, gera o link do XML (VRSync) da conta da imobiliária. Você cola o link no Canal Pro, e a conta e o plano de anúncios no portal continuam sendo da imobiliária. O Alugo atende ZAP Imóveis, VivaReal e OLX, só para imóveis para alugar. Entram os imóveis vagos marcados como publicados, e o imóvel alugado sai do link sozinho.
O diferencial para este assunto é a checagem antes de enviar. O Alugo segura fora do link o imóvel que o portal recusaria e mostra numa lista "ficou de fora" com o motivo:
- Não publicado
- Tipo não aceito pelos portais
- Sem foto, ou menos de 5 fotos (só JPG conta, PNG e WebP ficam no site mas não vão ao portal)
- Sem valor do aluguel
- Sem área
- Endereço incompleto ou sem CEP
- Sem número de quartos ou de banheiros
- Descrição curta (menos de 50 caracteres)
- Código repetido em outro imóvel (o mais antigo fica com o código, o mais novo espera)
O sistema também já envia valores inteiros, remove HTML da descrição e usa o código de referência do imóvel (ou um código estável gerado) como código do anúncio. Duas ressalvas honestas: o Alugo não lê o relatório do portal nem mostra o erro que o portal devolve, e o anúncio manual duplicado e a grade do plano continuam sendo conferidos por você no Canal Pro. A checagem reduz a chance de recusa, não promete zero erro. Os contatos dos portais chegam ao CRM por e-mail, como explicado no guia da integração.
O recurso de site, portais e CRM está nos planos Empresarial (R$ 199,90 por mês, até 100 imóveis) e Imobiliária (a partir de R$ 349,90 por mês, até 300 imóveis), além de taxas por uso, mostradas no app antes da contratação. O teste é de 7 dias grátis, sem fidelidade. Para ver o que o site da imobiliária precisa ter, veja site para imobiliária: o que precisa ter. Para o conteúdo do anúncio em si, veja como anunciar imóvel para alugar.
Perguntas frequentes
Por que meu anúncio foi recusado no ZAP Imóveis por XML?
Ou o arquivo inteiro falhou (formato fora do VRSync, URL bloqueada, certificado inválido, encoding quebrado), ou o imóvel não cumpriu uma regra: menos de 5 fotos JPG, descrição abaixo de 50 caracteres, CEP ausente, preço com centavos, código repetido. O motivo aparece no Relatório de Integração do Canal Pro e no e-mail diário.
Posso editar no Canal Pro um anúncio que veio do XML?
Não. Anúncio criado por XML não pode ser editado no Canal Pro. A correção é feita no sistema que gera o feed e vale na leitura seguinte do portal.
Corrigi o anúncio e ele não apareceu. O que fazer?
O portal lê o XML a cada 12 horas, duas vezes ao dia. Espere a próxima execução (o e-mail de relatório informa quando será) e confira no Relatório de Integração se o total com erro caiu.
Como achar o anúncio com erro no relatório?
Use o ListingID, o código do anúncio que o seu sistema envia. Ele serve para localizar o imóvel na aba de relatórios do Canal Pro. Por isso o código precisa ser único e estável.
O que é o validador de XML do Grupo OLX?
É uma ferramenta em beta que confere o arquivo no formato VRSync, com até 30 MB. Você valida, ajusta na origem e confere o resultado na próxima execução. O e-mail de erro de carga traz o link dele.
Meus anúncios sumiram depois de dar certo. Pode ser o plano?
Pode. Se a quantidade de anúncios passou da grade contratada com o portal, os excedentes são inativados automaticamente, tanto manuais quanto de XML. O e-mail diário mostra o uso do plano. Os dados são do portal de desenvolvedores do Grupo OLX, conferidos em 16/11/2026, e as regras podem mudar.
Anúncio recusado é sintoma de dado incompleto na origem
Quase todo anúncio recusado nasce de um cadastro incompleto: foto que falta, CEP em branco, descrição de uma linha. Enquanto o dado vive em planilha e em cada portal, o erro só aparece depois do envio. Quando a carteira é a fonte única e o sistema avisa o que falta antes de publicar, o ciclo de recusa, espera de 12 horas e nova tentativa diminui. A página site para imobiliária no Alugo mostra a carteira, o site, os portais e o CRM de locação ligados na mesma base. Para entender o papel do CRM nessa rotina, veja CRM para imobiliária: de venda ou de locação.