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
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.
- Na Configuração de unidades, clique em Importar arquivo.
- Clique em Baixar modelo e preencha a planilha.
- Clique em Clique para selecionar o arquivo e escolha a planilha.
- Confira a prévia: quantas unidades, torres e andares entram.
- Marque ou desmarque as opções que aparecerem.
- Clique em Aplicar importação.
- Revise as unidades por andar e clique em Próximo passo para gravar.
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.
- Abra o empreendimento e clique em Editar unidades.
- Clique em Exportar Excel.
- Edite os valores na planilha, sem mexer na coluna IDX.
- Volte à tela e clique em Importar arquivo.
- Envie o mesmo arquivo e confira a prévia, com o valor atual e o novo de cada campo.
- Clique em Aplicar alterações (o botão mostra o número, como Aplicar 12 alterações) para levar as mudanças à tabela.
- Revise as células destacadas e clique em Salvar alterações, que também mostra o número de mudanças, para gravar.
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.
