Integração XML ZAP, VivaReal e OLX: Passo a Passo
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: como funciona a integração por XML
A integração por XML liga o seu sistema aos portais do Grupo OLX (ZAP Imóveis, VivaReal e OLX) sem digitar anúncio no Canal Pro. O sistema gera um arquivo XML no formato VRSync, publicado numa URL. Você cola esse link uma vez no Canal Pro, e uma sonda do Grupo OLX baixa o arquivo a cada 12 horas. O que entrou, mudou ou saiu da carteira aparece (ou some) nos portais na leitura seguinte, conforme o plano de anúncios que a imobiliária tem com o portal.
Este é o guia de como a integração funciona. Para ver o site da imobiliária, o CRM e os portais ligados à mesma carteira, veja a página site para imobiliária no Alugo. Os dados técnicos dos portais vêm do portal de desenvolvedores do Grupo OLX, conferido em 12/11/2026.
Como o feed funciona: link, leitura a cada 12 horas e relatório
O Grupo OLX descreve a integração por feed como o caminho de quem, em vez de atualizar anúncio à mão no Canal Pro, envia uma carga de ofertas em lote a partir de um CRM ou software. Na prática, são quatro peças:
- Formato VRSync: é o formato aceito. O portal de desenvolvedores avisa que formatos diferentes de VRSync foram aceitos apenas até 30/10/2024.
- Polling: o portal vai até o seu link, e não o contrário. A sonda baixa o XML duas vezes ao dia, a cada 12 horas, e o horário exato pode variar.
- Inclusão, alteração e exclusão: tudo o que muda no arquivo aparece no ZAP, VivaReal ou OLX na leitura seguinte, dependendo do plano contratado com o portal.
- Relatório de importação: o resultado chega por e-mail (um e-mail diário com o uso do plano e a quantidade de anúncios contratados, enviados e bloqueados por erro), por webhook e no Canal Pro. Quem tem erro há mais de três dias recebe um e-mail de aviso.
Duas consequências práticas: não existe atualização instantânea (o ritmo é o da leitura do portal) e o relatório é onde você descobre por que um anúncio não subiu. Vale ler esse e-mail, e não só deixá-lo cair na caixa de entrada.
O que o portal exige de cada anúncio
Anúncio que não atende às regras do VRSync é bloqueado, e o erro aparece no relatório. Estas são as regras que a documentação do Grupo OLX traz por anúncio:
Regras do VRSync por anúncio
| Campo | O que o portal exige |
|---|---|
| Código do anúncio (ListingID) | Único, de 1 a 50 caracteres. Se houver código duplicado, só um é processado. |
| Título | De 10 a 100 caracteres, sem HTML. |
| Descrição | Obrigatória, de 50 a 3.000 caracteres, sem tags HTML. |
| Valores (aluguel, condomínio, IPTU) | Número inteiro, sem centavos, cifrão, ponto ou vírgula. |
| CEP (PostalCode) | Obrigatório em todos os anúncios. |
| Endereço | No mínimo país, estado, cidade e bairro. Há três formas de exibir: completo, só o logradouro ou só o bairro. A documentação recomenda enviar sempre o endereço completo. |
| Tipo de imóvel | Obrigatório. |
| Imagens | No mínimo 5 por anúncio. Só JPG é importado, com até 7 MB cada, e uma única foto de destaque. Se a imagem muda, o link dela precisa mudar. |
| Vídeo | Só do YouTube, um por imóvel. |
| Anúncios por arquivo | Até 50 mil anúncios por arquivo. |
Arraste para o lado para ver toda a tabela
Se você quer caprichar no conteúdo do anúncio em si (texto, ordem das fotos, o que destacar), o guia como anunciar imóvel para alugar cobre essa parte. Aqui o assunto é a mecânica da integração.
Passo a passo no Canal Pro
O cadastro do link é feito na conta da imobiliária no Canal Pro, o painel de anunciante do Grupo OLX. Os nomes de menu podem mudar com o tempo, então vale conferir na ajuda do Canal Pro. O caminho, conforme a ajuda do ZAP lida em 08/11/2026:
Como cadastrar o link do XML
Gere o link do XML no seu sistema
O sistema de gestão publica o feed VRSync numa URL. Copie esse link: é ele que o portal vai ler a cada 12 horas.
Abra a integração de anúncios
No Canal Pro, vá ao menu lateral, depois Configurações da conta, depois Integração de anúncios.
Escolha o software
No campo Selecione o Software, escolha "Desenvolvedor Próprio".
Cole o link e adicione
Cole o link do XML e clique em Adicionar.
Espere a próxima leitura e confira o relatório
Os anúncios entram na leitura seguinte do portal. Depois, abra o relatório de importação (e-mail ou Canal Pro) para ver o que subiu e o que foi bloqueado.
Trocar de integrador e anúncio manual duplicado
Antes de ligar o feed, quatro regras do portal evitam surpresa na carteira:
- Trocar de integrador apaga os anúncios da integração anterior. Os novos entram na próxima leitura. Se você está migrando de sistema, planeje a virada para os imóveis não ficarem fora dos portais mais tempo do que o necessário (veja também como migrar de sistema imobiliário sem perder histórico).
- Anúncio por XML não se edita à mão no Canal Pro. Anúncio manual e anúncio por XML convivem, mas o criado pelo XML só muda pela fonte, ou seja, pelo seu sistema.
- Anúncio manual igual ao do XML bloqueia o do XML. O anúncio do XML dá erro de duplicidade e não é processado até o manual ser excluído. E a carga não apaga anúncio manual sozinha: a exclusão é manual, no Canal Pro.
- A grade do plano manda. A inativação segue a quantidade contratada com o portal: se o feed manda mais imóveis do que o plano comporta, os anúncios excedentes são inativados automaticamente.
Um cadastro só para a carteira, o site e os portais
Para ligar o anúncio nos portais a partir da carteira, sem manter o mesmo imóvel em três lugares, veja como funciona no Alugo.
Ver o site e os portais no AlugoComo o Alugo monta o link a partir da carteira
No Alugo, a tela Portais fica dentro do CRM de locação. A imobiliária liga o anúncio nos portais e o sistema gera um link de XML (VRSync) da conta, que ela cola no Canal Pro pelos passos acima. A conta no Canal Pro e o plano de anúncios são da imobiliária, contratados direto com o Grupo OLX: o Alugo não vende nem inclui plano de portal.
O que entra e como:
- Só ZAP Imóveis, VivaReal e OLX, e só imóveis para alugar (o feed não manda venda).
- Entram os imóveis vagos que a imobiliária marcou como publicados, a mesma marcação que os coloca no site. Imóvel alugado deixa de ser vago, sai do link sozinho e some dos portais na leitura seguinte deles.
- Até 20 fotos por imóvel vão no link.
- Código do anúncio: o código de referência do imóvel, se a imobiliária tiver; senão, um código estável gerado pelo sistema.
- Opção "Mostrar o número do endereço": desligada, o anúncio mostra só a rua e o bairro.
- Publicação padrão: o destaque não é configurado pelo Alugo.
A tela mostra duas listas: o que está indo para os portais e o que ficou de fora, com o motivo. O Alugo segura o imóvel fora do link em vez de mandar um anúncio que o portal recusaria. Os motivos que aparecem:
Motivos pelos quais um imóvel fica fora do link
- Imóvel não marcado como publicado
- Tipo de imóvel não aceito pelos portais
- Sem foto, ou menos de 5 fotos (só JPG conta)
- Sem valor do aluguel
- Sem área
- Endereço incompleto ou sem CEP
- Sem número de quartos ou de banheiros
- Descrição curta, com menos de 50 caracteres
- Código repetido em outro imóvel
Quem já viveu o anúncio recusado sem saber o motivo sabe o valor dessa lista: o conserto acontece na carteira, no cadastro do imóvel, e o link se atualiza sozinho. Isso vale 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), mais taxas por uso, junto com o site da imobiliária e o CRM de locação. O teste é de 7 dias grátis, sem fidelidade. O checklist de como deve ser o site em si está em site para imobiliária: o que precisa ter.
Como os contatos dos portais chegam
Os contatos de interessados nos portais chegam por e-mail, e é assim que o Alugo os recebe. No Canal Pro, o caminho é Configurações, depois Integrações, depois "Receber leads no e-mail", depois Configurar, e adicionar o endereço de e-mail.
No Alugo, a imobiliária cadastra nesse campo um endereço de e-mail da conta dela no sistema. Cada aviso de contato vira um interessado no CRM, já ligado ao imóvel certo (pelo código do anúncio), com rodízio entre os corretores. O caminho é o e-mail de aviso do portal, lido pelo sistema e transformado em interessado. Para quem quer entender o funil depois disso, a diferença entre CRM de venda e de locação está em CRM para imobiliária: de venda ou de locação, e a divisão de quem atende o quê em quem acessa o quê na equipe da imobiliária.
Por que o anúncio não aparece: erros comuns
- Anúncio manual igual ainda no ar: o do XML recebe erro de duplicidade até você excluir o manual no Canal Pro.
- Menos de 5 fotos, ou fotos que não são JPG: só JPG é importado e o mínimo é de 5 por anúncio.
- Descrição curta: abaixo de 50 caracteres, o anúncio é bloqueado.
- CEP ou endereço incompleto: o CEP é obrigatório, e o endereço precisa ter ao menos país, estado, cidade e bairro.
- Valor com centavos ou símbolos: o VRSync pede número inteiro.
- Código repetido: com ListingID duplicado, só um dos anúncios é processado.
- Plano do portal menor que a carteira: passou da grade contratada, os excedentes são inativados.
- Expectativa de imediatismo: o portal lê o link a cada 12 horas. Alterou e não apareceu? Espere a próxima leitura antes de procurar problema.
- Relatório ignorado: erro há mais de três dias gera e-mail de aviso do portal. Alguém na equipe precisa ler.
Perguntas frequentes
Como integrar imóveis ao ZAP Imóveis e ao VivaReal por XML?
O seu sistema publica um feed XML no formato VRSync numa URL. No Canal Pro, em Configurações da conta, Integração de anúncios, escolha "Desenvolvedor Próprio" em Selecione o Software, cole o link e clique em Adicionar. Os nomes de menu podem mudar, então confira na ajuda do Canal Pro.
Com que frequência os portais leem o XML?
A cada 12 horas, duas vezes ao dia, e o horário exato pode variar. Por isso não existe atualização instantânea: o que muda na carteira aparece nos portais na leitura seguinte, dependendo do plano contratado com o portal.
Posso editar no Canal Pro um anúncio que veio do XML?
Não. O anúncio criado por XML não pode ser editado à mão no Canal Pro. A alteração é feita na fonte, no sistema que gera o feed, e vale na leitura seguinte.
O que acontece com os anúncios ao trocar de integrador?
Os anúncios que vinham da integração anterior são apagados, e os novos entram na próxima leitura do portal. Planeje a troca para a carteira não ficar fora do ar mais do que o necessário.
Por que o anúncio do XML deu erro de duplicidade?
Provavelmente existe um anúncio manual igual no Canal Pro. O anúncio do XML não é processado até o manual ser excluído, e a carga do XML não apaga anúncios manuais sozinha.
O Alugo anuncia em quais portais?
ZAP Imóveis, VivaReal e OLX, só imóveis para alugar, nos planos Empresarial e Imobiliária. O plano de anúncios e a conta no Canal Pro são da imobiliária, contratados direto com o Grupo OLX. O Alugo não promete mais contatos nem posição no portal.
Anunciar da carteira em vez de manter anúncio à mão
A integração por XML resolve um problema de operação: o mesmo imóvel digitado no sistema, no site e em cada portal, com preço e status que divergem. Quando o anúncio nasce da carteira, o imóvel alugado sai sozinho do link, e o que falta no cadastro aparece numa lista com o motivo, antes de o portal recusar. O que continua dependendo de você: o plano com o portal, a qualidade das fotos e da descrição e a leitura do relatório. Para ver essa operação numa tela só, com carteira, site, portais e CRM, a página site para imobiliária no Alugo mostra o fluxo.