Ir para o conteúdo principal

Como importar imóveis via XML

Quando a imobiliária já anuncia seus imóveis em um portal, todos aqueles cadastros podem vir para o sistema sem digitação. Os portais disponibilizam um arquivo XML com a carteira completa, e a importação lê esse arquivo e cria os imóveis automaticamente. É o caminho usado tanto na migração inicial quanto para manter a carteira atualizada. A seguir, veja o passo a passo.


Navegação no Módulo

importacaoviaxml.gif

Rotina: Imóveis > Importações > Importação via XML


Escolher a origem do arquivo

image.png

Campo

Descrição

Origem do Arquivo da Importação

Selecione o modelo correspondente ao arquivo que você tem em mãos:

Modelo Vivareal

ou

Modelo Zap

. O preenchimento é obrigatório.

Cada portal organiza as informações de um jeito. Escolher o modelo errado faz o sistema não encontrar os imóveis dentro do arquivo.


Enviar o arquivo

image.png

Campo

Descrição

Selecione o arquivo XML para importar os imóveis

Envie o arquivo obtido no portal. O envio é obrigatório, o formato precisa ser XML e o arquivo pode ter até

30 MB

.

Se a carteira gerar um arquivo maior que 30 MB, será necessário dividi-lo em partes e importar uma de cada vez. Reenviar arquivos não duplica imóveis, conforme explicado no item 6.


Pré-visualizar antes de importar

Clique em Pré-visualizar. O sistema lê o arquivo. Se o arquivo traz informações que o sistema não lê sozinho, aparece antes o quadro Campos extras do XML, explicado na seção “Levar os campos extras do arquivo para o imóvel”, mais abaixo. Depois de escolher o destino delas, clique em Pré-visualizar de novo. Se o arquivo não traz informações extras, o painel de Pré-visualização abre direto.

Informação

Descrição

Total de imóveis

Informa quantos imóveis foram encontrados dentro do arquivo XML.

Cards dos imóveis

Apresentam uma prévia de cada imóvel encontrado, incluindo foto, título, endereço, finalidades, valores, dormitórios, vagas, quartos, banheiros, área útil e área total. Quando você leva campos extras para Responsável ou Captador, os usuários encontrados também aparecem no cartão.

Avisos

Faixas amarelas acima dos cartões. Dizem o que o sistema não conseguiu aceitar nos campos extras e, por isso, não será importado, com a quantidade de ocorrências.

Esta etapa é a conferência: é o momento de verificar se os imóveis são os esperados e se as informações vieram corretamente.

Se o sistema não conseguir ler o arquivo, ele mostra um aviso explicando o motivo e não segue para a pré-visualização. Os avisos mais comuns estão na tabela abaixo.

AvisoO que fazer

“O arquivo enviado está vazio.”

O arquivo não tem nenhum conteúdo. Gere o arquivo de novo no portal e envie outra vez.

“Este arquivo está no Modelo Zap. Selecione esse modelo em ‘Origem do Arquivo da Importação’.” (ou “Modelo Vivareal”)

A origem escolhida não é a do arquivo. Troque a origem pelo modelo que o aviso indica e clique em Pré-visualizar de novo.

“Não foi possível buscar os imóveis no arquivo, verifique o modelo de XML selecionado!”

O sistema não achou imóveis no arquivo. Confira se o arquivo tem imóveis e se é de um dos dois modelos, Vivareal ou Zap. Se for, tente trocar a origem.

Levar os campos extras do arquivo para o imóvel

Alguns arquivos trazem informações que o sistema não lê sozinho, como o nome do corretor responsável pelo imóvel ou um dado que a sua imobiliária guarda em um campo personalizado. Quando isso acontece, depois do primeiro clique em Pré-visualizar, aparece o quadro Campos extras do XML.

Janela Importação de Imóveis com o aviso de arquivo grande e o quadro Campos extras do XML: cada informação do arquivo aparece com um exemplo de valor e uma lista para escolher o destino. Exemplo com dados fictícios.

Se o arquivo tem mais de 100 imóveis, o quadro vem com o aviso “Este arquivo tem 101 imóveis. A pré-visualização e a importação podem demorar alguns minutos. Mantenha esta janela aberta até o fim.” (o número muda conforme o arquivo). Espere o processamento terminar sem fechar a janela.

Cada informação extra aparece com o nome que ela tem no arquivo e um exemplo do valor. Em cada uma, escolha para onde ela vai:

DestinoO que acontece

Ignorar

É o que vem marcado. A informação não é importada. Os campos sem destino são ignorados.

Responsável e Captador

O valor do arquivo precisa ser o nome completo ou o e-mail de um usuário ativo. Para vários usuários, separe por vírgula ou ponto e vírgula.

Campo personalizado

A lista traz os campos personalizados de imóvel da sua imobiliária, no formato “Campo personalizado › Nome do campo (Tipo)”. Servem os tipos Texto, Caixa de Texto, Número, Link, Verdadeiro/Falso e Lista de Seleção.

O que o arquivo precisa trazer depende do tipo do campo personalizado:

Tipo do campoValor aceito no arquivo

Texto e Caixa de Texto

Qualquer texto. Ele é gravado exatamente como veio.

Número

Um número.

Link

Um endereço de internet completo, como https://www.exemplo.com.br.

Verdadeiro/Falso

Sim, Não, Verdadeiro, Falso, 1 ou 0. Qualquer outro valor não é importado.

Lista de Seleção

Um valor igual a uma das opções do campo.

O que o destino não aceitar não é importado e aparece como aviso na pré-visualização. Se a informação estiver vazia no arquivo, o que já está cadastrado no imóvel não é alterado. Os destinos valem para o arquivo enviado: ao trocar o arquivo ou a origem, o quadro aparece de novo.

Cada campo personalizado recebe só uma informação do arquivo. Se você escolher o mesmo campo para duas informações, o sistema avisa “Duas tags do XML não podem ser importadas para o mesmo campo personalizado.” e não abre a pré-visualização. Escolha outro destino para uma delas.

Com os destinos escolhidos, clique em Pré-visualizar. Acima dos cartões, as faixas amarelas mostram o que não foi aceito, como “Nenhum usuário encontrado para ‘Fulano’. O vínculo não será importado. (2 ocorrências).” ou “Mais de um usuário encontrado para ‘Fulano’. O vínculo não será importado.”.

Pré-visualização da importação com uma faixa amarela de aviso sobre usuário não encontrado e cartões de imóveis com Responsável e Captador. Exemplo com dados fictícios.


Iniciar a importação

Conferida a prévia, clique em Iniciar Importação. O sistema processa imóvel por imóvel.

Enquanto processa, a tela mostra o andamento, como “Importando imóveis: 12 de 150”, e a janela fica travada: não dá para fechá-la nem cancelar. Mantenha a janela aberta até o fim. Em arquivos com mais de 100 imóveis, o processo pode levar alguns minutos, e o sistema avisa isso antes, com a faixa “Este arquivo tem N imóveis. A importação pode demorar alguns minutos. Mantenha esta janela aberta até o fim.”

Ao final do processo, é exibido um resumo:

Informação

Descrição

Total de Imóveis importados com sucesso

Informa quantos imóveis foram processados e importados corretamente.

Total de Imóveis com erro

Informa quantos imóveis não puderam ser importados e apresenta o identificador de cada um deles.

Os imóveis com erro não impedem a importação dos demais — o processo segue até o fim e apresenta o resumo.

Para cada imóvel com erro, o resumo mostra o código dele e o motivo, no formato “O imóvel XML_123 contém um erro: …”.


Reenviar o arquivo não duplica imóveis

Cada imóvel importado guarda a referência do portal de origem. Ao enviar um novo arquivo com os mesmos imóveis, o sistema reconhece essa referência e atualiza os cadastros existentes, em vez de criar cópias.

Isso torna a importação por XML também um caminho de atualização periódica: basta gerar um arquivo novo no portal e reenviá-lo.


Perguntas frequentes

➜ Onde consigo o arquivo XML? No painel do portal em que a imobiliária anuncia. Cada portal disponibiliza a carteira em um endereço ou arquivo próprio.

➜ Importar duas vezes cria imóveis repetidos? Não. Os imóveis são identificados pela referência do portal e, se já existirem, são atualizados.

➜ O que fazer com os imóveis que deram erro? O resumo final lista o identificador de cada um. Verifique esses imóveis no portal de origem — normalmente falta alguma informação obrigatória — e reenvie o arquivo depois de corrigir.

➜ A pré-visualização já importa alguma coisa? Não. Ela apenas lê o arquivo e mostra o que será criado. Nada é gravado até o clique em Iniciar Importação.

➜ Posso usar um arquivo de outro portal, fora Vivareal e Zap? A importação trabalha com esses dois modelos. Arquivos de outros portais precisam estar em um desses padrões para serem lidos.

➜ A importação atualiza os imóveis sozinha depois? Não. A importação por XML é manual: sempre que quiser atualizar, envie um arquivo novo. As importações que se atualizam sozinhas são as das plataformas integradas.

➜ Preciso escolher o destino dos campos extras toda vez que importo? Sim. Os destinos valem para o arquivo enviado. Ao enviar outro arquivo ou trocar a origem, o quadro Campos extras do XML aparece de novo.

➜ O Responsável ou o Captador não foi importado. Por quê? O valor do arquivo precisa ser o nome completo ou o e-mail de um usuário ativo. Se nenhum usuário for encontrado, ou se o mesmo nome servir para mais de um usuário, o sistema avisa na pré-visualização e não faz o vínculo.

➜ Importar de novo com o campo extra vazio apaga o que já está no imóvel? Não. Se a informação vier vazia no arquivo, o que já está cadastrado no imóvel não é alterado.

➜ Posso fechar a janela enquanto os imóveis estão sendo importados? Não. A janela fica travada até o fim para que nenhum imóvel fique sem importar. Mantenha-a aberta e espere o resumo.