Quando o portal pede o XML, ele não está pedindo um arquivo por e-mail. Ele está dizendo que um robô vai visitar o seu site duas vezes por dia e copiar a lista inteira de imóveis. A documentação do Grupo OLX é literal: "uma sonda do Grupo OLX baixa o arquivo XML e começa o processo de integração dos anúncios", "a cada 12 horas, totalizando 2 vezes ao dia". Entender essa frase resolve a maioria das dúvidas de quem não é técnico. Fontes consultadas em setembro de 2026.
O que é publicar imóvel por XML, em português claro?
É deixar uma lista pronta num endereço da internet e esperar o portal vir buscar. A documentação do Grupo OLX descreve a integração como voltada "para imobiliárias que, ao invés de atualizar manualmente seus anúncios por meio do Canal Pro, optam por enviar uma carga de ofertas para a atualização em lote". A palavra técnica é polling, e a documentação diz o que ela significa na prática: "de tempos em tempos uma sonda do Grupo OLX baixa o arquivo XML e começa o processo de integração dos anúncios". Quem gera esse arquivo é o seu CRM, não você. O trabalho humano acaba no cadastro do imóvel e no envio das mídias — a partir daí é o sistema que publica. Por isso, na Piperz, a entrega das fotos é pensada como insumo do CRM, e não como anexo que alguém vai subir à mão em cada portal. Fontes consultadas em setembro de 2026.
De quanto em quanto tempo o portal lê o seu arquivo?
A cada doze horas, e o horário não é fixo. O texto do Grupo OLX aparece igual em duas páginas: "O processamento dos arquivos XML é realizado a cada 12 horas, totalizando 2 vezes ao dia. O horário exato pode variar." É a explicação para a queixa mais comum do time de captação: alguém atualizou e o anúncio continua igual. Mudou no CRM, mas a sonda ainda não passou de novo. A documentação acrescenta que "as alterações, inclusões e exclusões serão refletidas no portal ZAP, VivaReal ou OLX, dependendo do plano contratado", ou seja, a mesma carga alimenta o portal que você contratou, não todos automaticamente. Planejar mídia com essa janela em mente evita promessa impossível ao proprietário. A Piperz entrega o ensaio em 1 dia útil justamente para que o material já esteja no CRM antes da carga seguinte. Fontes consultadas em setembro de 2026.
Por que o anúncio cadastrado na mão trava a carga do XML?
Porque o portal enxerga dois anúncios do mesmo imóvel e recusa o segundo. Essa é a regra que mais gera chamado e quase ninguém conhece: "O anúncio que está no XML vai apresentar erro de duplicidade no processamento e não será processado", e a solução indicada é direta — "Para que o anúncio via XML seja processado, é necessário que o anúncio manual seja excluído". A documentação ainda avisa em caixa alta que "os anúncios criados de forma manual não são excluídos automaticamente ao rodar uma carga via XML". Há um efeito colateral no sentido inverso: "o anúncio criado via XML não poderá ser editado manualmente através do Canal Pro". Quem começou pelo cadastro manual e migrou depois convive com os dois mundos até fazer a limpeza. A Piperz não publica anúncio por você, mas entrega mídia organizada o bastante para essa limpeza ser rápida, como descrito em como organizar as fotos no CRM. Fontes consultadas em setembro de 2026.
Quanto o arquivo aguenta e o que derruba a leitura?
Cinquenta mil anúncios por arquivo, e a leitura cai por motivos banais de hospedagem. O limite é declarado: "Atualmente nossa plataforma suporta o processamento de até 50 mil anúncios em um único arquivo XML". O que costuma quebrar antes disso é o acesso. A sonda se identifica com um User-Agent próprio, `VivaRealBot/1.0`, e a documentação alerta que "para que não ocorram erros no download (ex: HTTP 403), é necessário que este User-Agent esteja liberado no seu servidor ou pela sua hospedagem". Somam-se três detalhes que derrubam integração silenciosamente: certificado HTTPS autoassinado não é aceito, a URL do arquivo tem teto de 255 caracteres e há timeout de 60 segundos para abrir a conexão. Nenhum deles é assunto de imobiliária — são assunto do fornecedor do CRM, e saber citá-los encurta o chamado. A Piperz cuida do lado da mídia, com URL estável para cada entrega. Fontes consultadas em setembro de 2026.
Como saber se a carga entrou mesmo no portal?
Pelo relatório de importação, que chega por três caminhos. A documentação afirma que, "ao final do processo, o cliente pode acompanhar o resultado do processamento por meio do relatório de importação, entregue por e-mail, webhook e disponível no Canal Pro". Existe ainda um validador de XML publicado pelo próprio grupo, útil para o fornecedor do seu sistema testar o arquivo antes de apontar a sonda para ele. O ponto de gestão é simples e quase nunca é feito: alguém da imobiliária precisa receber esse e-mail. Sem isso, um anúncio que parou de ser processado só aparece quando o corretor reclama que o imóvel sumiu. Vale lembrar que a quantidade de anúncios ativos segue "a grade contratada pelo anunciante, quando exceder essa grade os anúncios serão inativados automaticamente". A Piperz recomenda tratar esse relatório como o LQS do ZAP: número de rotina, não de emergência. Fontes consultadas em setembro de 2026.
O que muda na rotina de mídia quando a publicação é por XML?
Muda o ponto de entrega: a foto passa a ser um endereço, não um arquivo anexado. Num fluxo por XML, o que vai para o portal é o link da imagem hospedada, lido pela sonda na próxima passagem — e é por isso que reeditar um arquivo mantendo a mesma URL não produz efeito, detalhe explicado em regras de foto do VivaReal. A rotina que funciona é entregar rápido, com endereço novo a cada versão e ordem definida antes da captação. Na linha Foto Pro, o imóvel custa R$ 95 no avulso e R$ 64 por imóvel na assinatura, com edição incluída e entrega em 1 dia útil (D+1) nas oito praças atendidas: São Paulo, Rio de Janeiro, Belo Horizonte, Porto Alegre, Florianópolis e Maceió, com as respectivas regiões metropolitanas, mais Campinas e Jundiaí. O caminho completo, do agendamento ao portal, está em fluxo de mídia da imobiliária.
Perguntas frequentes sobre publicar imóvel por XML
O que é a integração por XML dos portais?
É o envio de uma lista completa de imóveis para atualização em lote, em vez do cadastro manual anúncio por anúncio. A documentação do Grupo OLX descreve uma arquitetura de polling, em que "uma sonda do Grupo OLX baixa o arquivo XML e começa o processo de integração dos anúncios". Quem gera o arquivo é o CRM da imobiliária.
De quanto em quanto tempo o portal lê o arquivo XML?
A cada doze horas. A documentação afirma que "O processamento dos arquivos XML é realizado a cada 12 horas, totalizando 2 vezes ao dia. O horário exato pode variar." É por isso que uma alteração feita no CRM não aparece imediatamente no anúncio publicado.
Por que o anúncio enviado pelo XML não é processado?
Uma causa frequente é existir o mesmo imóvel cadastrado manualmente. Nesse caso, "o anúncio que está no XML vai apresentar erro de duplicidade no processamento e não será processado", e "para que o anúncio via XML seja processado, é necessário que o anúncio manual seja excluído". A exclusão do anúncio manual não é automática.
Qual o número máximo de anúncios num arquivo XML?
Cinquenta mil. A documentação declara que "Atualmente nossa plataforma suporta o processamento de até 50 mil anúncios em um único arquivo XML" e orienta acionar o suporte para volumes acima disso.
Como acompanhar se a carga do XML deu certo?
Pelo relatório de importação. Segundo a documentação, "ao final do processo, o cliente pode acompanhar o resultado do processamento por meio do relatório de importação, entregue por e-mail, webhook e disponível no Canal Pro". Sem alguém recebendo esse relatório, uma falha só aparece quando o imóvel some do portal.
O Robô Passa Duas Vezes por Dia
A integração por XML parece assunto de desenvolvedor até o dia em que um imóvel some do portal e ninguém sabe explicar por quê. As respostas, quase sempre, estão em frases curtas de uma documentação pública: a sonda passa de doze em doze horas, um cadastro manual esquecido bloqueia a carga inteira daquele imóvel, o arquivo tem teto de cinquenta mil anúncios e o relatório de importação diz o que entrou. Nada disso exige saber ler XML — exige saber que existe. Para o time de captação, o efeito prático é de planejamento: a mídia precisa estar pronta antes da próxima passagem, não depois. É o que a Piperz entrega na linha Foto Pro a R$ 95 no avulso e R$ 64 por imóvel na assinatura, em 1 dia útil (D+1), nas 8 praças atendidas.
Equipe Editorial Piperz
Especialistas em Mídia e Tecnologia Imobiliária
Pronto para otimizar suas captações de fotos e vídeos?
Conectar-se com fotógrafos imobiliários profissionais de alto padrão e gerenciar a entrega segura e faturamento de suas mídias nunca foi tão simples. Junte-se a milhares de imobiliárias e corretores que já aceleram suas vendas com a Piperz.
