# Como importar as unidades de um empreendimento por planilha

> Na configuração de unidades do empreendimento, clique em Importar arquivo, baixe o modelo, preencha uma linha por unidade e envie em Excel ou CSV. A IDX mostra uma prévia antes de aplicar. Para atualizar unidades que já existem, use Exportar Excel e Importar arquivo na tela Editar unidades.

Publicado em 29 de outubro de 2026. Endereço: https://idxbr.com/blog/importar-unidades-por-planilha

## Pontos principais

- Criar unidades e atualizar unidades são duas importações diferentes, em telas diferentes
- Para criar, use o modelo da IDX, em que só a coluna Unidade é obrigatória
- Para atualizar, exporte a planilha da própria tela, edite e importe o mesmo arquivo
- Você confere tudo numa prévia antes de aplicar, e nada é lido por IA
- Aceita .xlsx, .xls e .csv, com até 10MB

## Quando usar a importação por planilha

A importação existe para empreendimentos com muitas unidades, quando cadastrar uma por uma não faz sentido. Ela funciona em dois lugares, com objetivos diferentes:

| Onde                                                      | O que faz                        | Qual planilha                          |
| --------------------------------------------------------- | -------------------------------- | -------------------------------------- |
| Configuração de unidades (cadastro ou **Criar unidades**) | Cria unidades novas              | O modelo, do botão **Baixar modelo**   |
| Tela **Editar unidades**                                  | Atualiza unidades já cadastradas | A planilha do botão **Exportar Excel** |

Nos dois casos, a leitura acontece no seu navegador, por coluna, sem IA. Você vê uma prévia e só depois aplica. Os formatos aceitos são .xlsx, .xls e .csv, com até 10MB. Arquivo vazio ou maior que isso é recusado antes da leitura.

A importação está em todos os planos da IDX, porque faz parte do cadastro de imóveis. Criar unidades pede permissão de criar imóveis no cargo, e atualizar pede permissão de editar.

## Como o modelo é organizado

O modelo é um arquivo `modelo-unidades.xlsx` com duas abas. A aba **Unidades** vem só com o cabeçalho, sem linha de exemplo, para que nada seja importado por engano. A aba **Instruções** explica cada coluna e traz exemplos.

Preencha a aba Unidades a partir da linha 2, uma unidade por linha, e não renomeie as colunas. Em loteamento (empreendimento horizontal), o modelo sai sem a coluna Pavimento.

| Coluna    | Obrigatória                               | Como a IDX lê                                                                   | Exemplo                      |
| --------- | ----------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------- |
| Unidade   | Sim                                       | Sigla (só letras) e número (até 99.999). Sem sigla, usa AP, ou LT no loteamento | AP 101, LT 005, Casa-12, 101 |
| Estrutura | Quando houver mais de uma torre ou quadra | Nome da torre, bloco ou quadra, como no passo anterior                          | Torre A, Quadra 2            |
| Pavimento | Não                                       | Primeiro número da célula. Em branco, o andar sai do número da unidade          | Pavimento 3 ou 3             |
| Valor     | Não                                       | Preço em reais, no formato brasileiro ou como número                            | 450000 ou R$ 450.000,00      |
| Área      | Não                                       | Metros quadrados, com vírgula ou ponto decimal                                  | 72,5 ou 72.5                 |
| Quartos   | Não                                       | Número inteiro                                                                  | 2                            |
| Banheiros | Não                                       | Número inteiro                                                                  | 1                            |

### Como a IDX encontra as colunas

A IDX lê a aba chamada Unidades. Se ela não existir, lê a primeira aba. O cabeçalho pode estar em qualquer uma das dez primeiras linhas, desde que tenha a coluna Unidade. Isso permite um título acima da tabela.

Os nomes das colunas são comparados sem diferenciar maiúsculas, acentos e espaços: "AREA" e "Área" valem igual. Colunas que o modelo não usa, como IDX e Status, são ignoradas. Por isso a planilha do **Exportar Excel** também é aceita na criação.

Em arquivos .csv, a IDX detecta sozinha o separador (vírgula ou ponto e vírgula) e a codificação. O CSV salvo pelo Excel em português costuma vir numa codificação que estraga os acentos em outros sistemas, e a IDX trata isso.

### Como cada valor é interpretado

Números seguem o formato brasileiro, e a IDX entende as variações mais comuns.

| Na planilha   | A IDX entende                       |
| ------------- | ----------------------------------- |
| R$ 1.234,56   | 1234,56                             |
| 450.000       | 450000 (ponto como milhar)          |
| 72,50 ou 72.5 | 72,5                                |
| AP 101        | Sigla AP, número 101                |
| LT 005        | Sigla LT, número 5                  |
| 101           | Sigla padrão, número 101            |
| 101A ou TOTAL | Não reconhecido: a linha vira aviso |

### Como o andar é deduzido

Com a coluna Pavimento em branco, o andar sai do número da unidade, pela numeração brasileira:

- Números a partir de 100: o andar é o número sem os dois últimos dígitos. 101 vai para o 1º andar, 1203 para o 12º
- Números de 10 a 99: o andar é o primeiro dígito. 21 vai para o 2º andar
- Números de 1 a 9: 1º andar

> [!ATENCAO]
> Se o prédio numera as unidades em sequência (de 1 a 40, por exemplo), preencha a coluna Pavimento. Senão, as unidades caem no andar errado. Todo andar deduzido aparece com o selo **deduzido** na prévia, para você conferir.

### Como a torre é encontrada

A IDX compara o nome da coluna Estrutura com as torres já criadas. Ela ignora acentos, maiúsculas, zeros à esquerda e as palavras torre, bloco, quadra, qd, bl, tr e edifício. Assim, "Torre A", "TORRE a" e "A" são a mesma torre.

| Situação                                     | O que acontece                                                  |
| -------------------------------------------- | --------------------------------------------------------------- |
| O nome casa com uma torre existente          | A unidade vai para ela                                          |
| O nome não casa com nenhuma                  | A torre é marcada como **nova** e pode ser criada na importação |
| Coluna em branco e uma torre configurada     | Tudo vai para essa torre                                        |
| Coluna em branco e nenhuma torre configurada | A IDX cria a "Torre 1" (ou "Quadra 1")                          |
| Coluna em branco e mais de uma torre         | A linha é descartada, com o motivo na prévia                    |

### Faixas aceitas

Valores fora da faixa são esvaziados, e a unidade continua na importação com um aviso.

| Campo               | Faixa aceita                          |
| ------------------- | ------------------------------------- |
| Valor               | Maior que zero e até R$ 1.000.000.000 |
| Área                | Maior que zero e até 10.000 m²        |
| Quartos e Banheiros | De 0 a 20                             |

## Como criar unidades a partir da planilha

A importação para criar fica no passo **Configuração de unidades**. Você chega a ele no cadastro do empreendimento (contas de construtora) ou pelo botão **Criar unidades**, no mapa de unidades.

1. Na **Configuração de unidades**, clique em **Importar arquivo**.
2. Clique em **Baixar modelo** e preencha a planilha.
3. Clique em **Clique para selecionar o arquivo** e escolha a planilha.
4. Confira a prévia: quantas unidades, torres e andares entram.
5. Marque ou desmarque as opções que aparecerem.
6. Clique em **Aplicar importação**.
7. Revise as unidades por andar e clique em **Próximo passo** para gravar.

[Vídeo: Como criar unidades a partir da planilha](https://idxbr.com/videos/blog/importar-unidades-por-planilha.mp4)

![Configuração de unidades com abas por torre e os botões Importar arquivo, Adicionar unidade e Adicionar vários unidades](https://idx-main-prod-files.s3.us-east-1.amazonaws.com/docs/lp-blog-importar-unidades-por-planilha-configuracao-de-unidades.jpg 'O botão Importar arquivo fica ao lado dos cadastros manuais, em cada torre')

**Aplicar importação** só leva as unidades para a tela. Nada é gravado até o **Próximo passo**. Se você fechar o assistente antes, a importação se perde.

## O que a prévia mostra antes de aplicar

A prévia mostra o que vai acontecer com cada linha, antes de qualquer gravação. No topo, três cartões resumem quantas unidades, torres e andares serão importados. No loteamento, o cartão de andares não aparece.

### As opções da prévia

As opções só aparecem quando a planilha cria a situação. Cada uma vem com um padrão.

| Opção                                | Quando aparece                                     | Padrão     | Se você desmarcar                               |
| ------------------------------------ | -------------------------------------------------- | ---------- | ----------------------------------------------- |
| Criar N torres que não existem       | A planilha cita torres que ainda não foram criadas | Marcada    | As unidades dessas torres ficam de fora         |
| **Expandir a quantidade de andares** | Há unidades acima do último andar da torre         | Marcada    | As unidades acima do último andar ficam de fora |
| Incluir N unidades duplicados        | Há unidades repetidas no arquivo ou já cadastradas | Desmarcada | Elas continuam de fora                          |

A opção de andares mostra a mudança de cada torre, como "Torre A: 10 → 12".

Uma unidade é duplicada quando repete torre, andar e número de outra. A sigla não entra nessa conta: AP 101 e CASA 101 no mesmo andar da mesma torre são a mesma unidade para a IDX.

### Os selos e avisos

A tabela da prévia mostra as primeiras 100 unidades, com as colunas Unidade, Torre, Andar, Valor, Área, Quartos e Banheiros. Abaixo dela, a IDX informa quantas unidades a mais serão importadas.

- **nova**: a torre não existe e será criada
- **deduzido**: o andar saiu do número da unidade, não da coluna Pavimento
- Linhas descartadas: aparecem com a contagem e o motivo, como "Número da unidade inválido."
- Valores fora da faixa: "N unidades com valores fora da faixa esperada", com os campos esvaziados
- Avisos de leitura: até dez aparecem por extenso, com o número da linha na planilha. Os demais viram uma contagem

Se as opções escolhidas não deixarem nada para importar, a IDX avisa: "As opções selecionadas não deixaram nada para importar." Depois de aplicar, a mensagem confirma o total, como "Importação concluída: 96 unidades."

## O que cada unidade criada recebe

As unidades importadas são gravadas do mesmo jeito que as cadastradas à mão. Cada uma recebe da planilha a sigla, o número, a torre, o andar, o valor, a área, os quartos e os banheiros.

Do empreendimento, ela herda a categoria, o título, a descrição, as comodidades, a capa, as galerias, o estágio comercial e as vagas. Quando a planilha deixa valor, área, quartos ou banheiros em branco, a unidade usa o do empreendimento, se houver.

Toda unidade criada nasce com status **Desativado**. Para colocá-la à venda, mude o status para Disponível depois de gravar.

## Como atualizar unidades que já existem

Para mudar valor, status ou medidas de unidades já cadastradas, use a tela **Editar unidades**. Ela fica no mapa de unidades do empreendimento.

1. Abra o empreendimento e clique em **Editar unidades**.
2. Clique em **Exportar Excel**.
3. Edite os valores na planilha, sem mexer na coluna IDX.
4. Volte à tela e clique em **Importar arquivo**.
5. Envie o mesmo arquivo e confira a prévia, com o valor atual e o novo de cada campo.
6. Clique em **Aplicar alterações** (o botão mostra o número, como Aplicar 12 alterações) para levar as mudanças à tabela.
7. Revise as células destacadas e clique em **Salvar alterações**, que também mostra o número de mudanças, para gravar.

![Tela Editar unidades com os botões Exportar Excel e Importar arquivo e a tabela de unidades](https://idx-main-prod-files.s3.us-east-1.amazonaws.com/docs/lp-blog-importar-unidades-por-planilha-editar-unidades.png 'A coluna IDX identifica cada unidade; é por ela que a planilha casa as linhas')

### As colunas da planilha exportada

O **Exportar Excel** gera um arquivo com o nome do empreendimento e duas abas: Unidades e **Referência**, que lista os valores válidos de Status e Posição do sol. A IDX lê a primeira aba.

| Coluna                          | Na importação                | Como preencher                                                            |
| ------------------------------- | ---------------------------- | ------------------------------------------------------------------------- |
| IDX                             | Liga a linha à unidade       | Não altere                                                                |
| Unidade, Estrutura, Pavimento   | Ignoradas                    | Para mudar torre ou andar, use **Alterar em lote**                        |
| Título                          | Atualiza                     | Texto livre                                                               |
| Valor                           | Atualiza quando é número     | Use número, como sai na exportação. Texto como "R$ 450.000,00" é ignorado |
| Status                          | Atualiza                     | Ativo, Desativado, Reservado ou Vendido. Outro texto é ignorado           |
| Posição do sol                  | Atualiza                     | Um dos valores da aba Referência, como Nascente ou Norte/Poente           |
| Área, Quartos, Banheiros, Vagas | Atualizam quando são números | Em branco, ficam como estão                                               |
| Memorial Descritivo             | Aparece na prévia            | Veja o aviso abaixo                                                       |

Na planilha, o status Disponível aparece como **Ativo**.

A coluna IDX é o que liga cada linha à unidade certa. Sem ela, a IDX recusa o arquivo: "Esta planilha não tem a coluna IDX. Use "Exportar Excel", edite os valores e importe o mesmo arquivo." Linhas com IDX desconhecido são ignoradas, e a prévia conta quantas foram.

A prévia mostra só as colunas que mudaram, com dois cartões: unidades a atualizar e campos alterados. Se nada mudou, o botão fica como **Nada a aplicar**.

Para o memorial descritivo, selecione as unidades e use o botão **Memorial Descritivo**. Ele grava o mesmo texto técnico em todas as unidades selecionadas.

### Outras edições em massa na mesma tela

A tela **Editar unidades** tem mais duas ferramentas para várias unidades de uma vez. Selecione as unidades pela caixa de cada linha.

- **Alterar em Lote**: muda Status, Posição do sol, Estrutura, Pavimento, Área (m²), Quartos, Banheiros, Vagas e valor. Campos vazios são ignorados
- **Reajustar valores**: aplica um reajuste em **Percentual** ou em **Valor fixo** ao valor das unidades selecionadas. O percentual aceita até -100%

## Como a importação de unidades se conecta com o resto da IDX

A planilha só alimenta o cadastro. Tudo o que depende de unidades passa a enxergar as importadas assim que você grava:

- **Mapa de unidades e métricas**: as unidades entram no mapa e nas contagens de disponíveis, reservadas, vendidas e desativadas
- **Condições comerciais**: a planilha não traz condições. As unidades seguem as condições gerais do empreendimento e as da torre delas, cadastradas na aba **Condições comerciais**. Uma torre criada pela importação ainda não tem condições próprias
- **Propostas e reservas**: unidades importadas podem ser reservadas e usadas em propostas como qualquer outra, depois de ativadas. Propostas são do plano Profissional
- **Tabela de vendas pública**: as unidades com status Disponível aparecem na tabela `/tabela/...` no próximo acesso
- **Canal de vendas**: unidades novas não entram sozinhas no site. Você precisa marcá-las em **Canal de vendas** e salvar
- **CRM, roleta e Marketing**: não usam a planilha diretamente, mas passam a reconhecer a unidade quando um lead é vinculado a ela
- **Membros**: criar unidades pede permissão de criar imóveis no cargo, e atualizar pede permissão de editar

O que não se conecta: a importação não traz fotos, status nem posição do sol na criação, não lê PDF nem tabela em espelho e não envia aviso para a equipe.

## Perguntas frequentes

### Posso enviar a tabela de vendas que a construtora já usa, em PDF ou em espelho?

Não. A IDX lê só planilhas no formato do modelo, uma linha por unidade. Tabelas em PDF ou em formato de espelho precisam ser passadas para o modelo antes.

### A importação apaga unidades que não estão na planilha?

Não. Na criação, a planilha só acrescenta unidades. Na tela Editar unidades, a planilha só atualiza as unidades que já existem; nenhuma é criada ou excluída.

### Por que a coluna Vagas não está no modelo?

Na criação, cada unidade herda as vagas do empreendimento. Para mudar as vagas de unidades já cadastradas, use a tela Editar unidades, que tem a coluna Vagas na planilha exportada.

### As unidades importadas já ficam à venda?

Não. Toda unidade criada nasce com status Desativado. Depois de gravar, mude o status para Disponível na tela Editar unidades, em Alterar em lote ou no mapa de unidades.