# 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](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/importacaoviaxml.gif)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/importacaoviaxml.gif)

**Rotina:**<span style="white-space: pre-wrap;"> Imóveis &gt; Importações &gt; </span>**Importação via XML**

---

##### **Escolher a origem do arquivo**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/k3Zimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/k3Zimage.png)

<table id="bkmrk-campodescri%C3%A7%C3%A3oorigem"><colgroup><col></col><col style="width: 598px;"></col></colgroup><tbody><tr><th>Campo

</th><th>Descrição

</th></tr><tr><td>**Origem do Arquivo da Importação**

</td><td><span style="white-space: pre-wrap;">Selecione o modelo correspondente ao arquivo que você tem em mãos: </span>

**Modelo Vivareal**

<span style="white-space: pre-wrap;"> ou </span>

**Modelo Zap**

. O preenchimento é obrigatório.

</td></tr></tbody></table>

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](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/OVTimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/OVTimage.png)

<table id="bkmrk-campodescri%C3%A7%C3%A3oseleci"><colgroup><col></col><col></col></colgroup><tbody><tr><th>Campo

</th><th>Descrição

</th></tr><tr><td>**Selecione o arquivo XML para importar os imóveis**

</td><td><span style="white-space: pre-wrap;">Envie o arquivo obtido no portal. O envio é obrigatório, o formato precisa ser XML e o arquivo pode ter até </span>

**30 MB**

.

</td></tr></tbody></table>

<p class="callout info">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.</p>

---

##### **Pré-visualizar antes de importar**

<span style="white-space: pre-wrap;">Clique em </span>**Pré-visualizar**<span style="white-space: pre-wrap;">. O sistema lê o arquivo e exibe o painel de </span>**Pré-visualização**.

<table id="bkmrk-informa%C3%A7%C3%A3odescri%C3%A7%C3%A3ot"><colgroup><col></col><col style="width: 737px;"></col></colgroup><tbody><tr><th>Informação

</th><th>Descrição

</th></tr><tr><td>**Total de imóveis**

</td><td>Informa quantos imóveis foram encontrados dentro do arquivo XML.

</td></tr><tr><td>**Cards dos imóveis**

</td><td>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.

</td></tr></tbody></table>

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

<p class="callout info">Se aparecer o aviso de que não foi possível buscar as informações no arquivo, o modelo selecionado não corresponde ao arquivo enviado. Volte ao campo de origem, troque entre Vivareal e Zap e pré-visualize novamente.</p>

---

##### **Iniciar a importação**

<span style="white-space: pre-wrap;">Conferida a prévia, clique em </span>**Iniciar Importação**. O sistema processa imóvel por imóvel.

Ao final do processo, é exibido um resumo:

<table id="bkmrk-informa%C3%A7%C3%A3odescri%C3%A7%C3%A3ot-1"><colgroup><col></col><col></col></colgroup><tbody><tr><th>Informação

</th><th>Descrição

</th></tr><tr><td>**Total de Imóveis importados com sucesso**

</td><td>Informa quantos imóveis foram processados e importados corretamente.

</td></tr><tr><td>**Total de Imóveis com erro**

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

</td></tr></tbody></table>

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

---

##### **Reenviar o arquivo não duplica imóveis**

<span style="white-space: pre-wrap;">Cada imóvel importado guarda a </span>**referência do portal**<span style="white-space: pre-wrap;"> de origem. Ao enviar um novo arquivo com os mesmos imóveis, o sistema reconhece essa referência e </span>**atualiza**<span style="white-space: pre-wrap;"> os cadastros existentes, em vez de criar cópias.</span>

<span style="white-space: pre-wrap;">Isso torna a importação por XML também um caminho de </span>**atualização periódica**: basta gerar um arquivo novo no portal e reenviá-lo.

---

#### **Perguntas frequentes**

<span style="white-space: pre-wrap;">➜ </span>**Onde consigo o arquivo XML?**<span style="white-space: pre-wrap;"> No painel do portal em que a imobiliária anuncia. Cada portal disponibiliza a carteira em um endereço ou arquivo próprio.</span>

<span style="white-space: pre-wrap;">➜ </span>**Importar duas vezes cria imóveis repetidos?**<span style="white-space: pre-wrap;"> Não. Os imóveis são identificados pela referência do portal e, se já existirem, são atualizados.</span>

<span style="white-space: pre-wrap;">➜ </span>**O que fazer com os imóveis que deram erro?**<span style="white-space: pre-wrap;"> 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.</span>

<span style="white-space: pre-wrap;">➜ </span>**A pré-visualização já importa alguma coisa?**<span style="white-space: pre-wrap;"> Não. Ela apenas lê o arquivo e mostra o que será criado. Nada é gravado até o clique em </span>**Iniciar Importação**.

<span style="white-space: pre-wrap;">➜ </span>**Posso usar um arquivo de outro portal, fora Vivareal e Zap?**<span style="white-space: pre-wrap;"> A importação trabalha com esses dois modelos. Arquivos de outros portais precisam estar em um desses padrões para serem lidos.</span>

<span style="white-space: pre-wrap;">➜ </span>**A importação atualiza os imóveis sozinha depois?**<span style="white-space: pre-wrap;"> 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.</span>