Todos os assuntos

Importar imóveis por planilha (CSV)

O formato exato da planilha, o que cada coluna aceita e por que algumas linhas entram como pendentes.

8 min de leituraPara gestores

Ao final, a sua carteira inteira está dentro do BFlow — a maior parte já validada e pronta para o Theo oferecer.

#Antes de começar

Baixe o modelo pronto: em Imóveis → Importar, clique em Baixar template (.csv). Ele já vem com o cabeçalho certo e duas linhas de exemplo. Preencher por cima do modelo evita 90 % dos problemas.

Limite por importação: 5.000 imóveis. Carteira maior, divida em dois arquivos.

#As colunas

O arquivo é um CSV separado por vírgula, com a primeira linha de cabeçalho. Os nomes das colunas precisam ser exatamente estes (em inglês, minúsculo):

Coluna	O que é	Exemplo
`reference_code`	seu código interno do imóvel	`AP-1001`
`transaction_type`	`venda`, `locacao` ou `ambos`	`venda`
`property_type`	`apartamento`, `casa`, `terreno`, `comercial` ou `outro`	`apartamento`
`title`	título do anúncio (até 500 caracteres)	`Apartamento 2 dormitórios no Centro`
`description`	descrição — mire em 100+ caracteres	`Apartamento reformado, 1 vaga…`
`price`	valor de venda, em reais	`450000`
`rent`	valor do aluguel mensal, em reais	`3200`
`condo`	condomínio mensal	`600`
`iptu`	IPTU	`180`
`bedrooms`	dormitórios	`2`
`suites`	suítes	`1`
`bathrooms`	banheiros	`2`
`parking_spots`	vagas	`1`
`area_useful`	área útil em m²	`62`
`area_total`	área total em m²	`68`
`cep`	CEP	`01310-100`
`street`	logradouro e número	`Avenida Paulista 1000`
`neighborhood`	bairro	`Bela Vista`
`city`	cidade	`São Paulo`
`state`	UF, 2 letras	`SP`
`region`	região/zona, como você chama	`Zona Central`
`source_url`	link do anúncio de origem, se houver
`image_urls`	URLs das fotos separadas por barra vertical `\|`	`https://…/1.jpg\|https://…/2.jpg`

#Regras que economizam retrabalho

image_urls usa |, não vírgula. Vírgula quebraria o CSV. As fotos são baixadas e passam a viver no BFlow — o link de origem pode sair do ar depois.
Valores aceitam pontuação brasileira. 450.000,00, R$ 450000 e 450000 são lidos igual.
transaction_type inválido vira venda silenciosamente. Confira antes.
property_type inválido vira outro — e outro bloqueia a publicação. Se muita coisa entrar como pendente, comece conferindo esta coluna.
Campo com vírgula dentro (descrição, endereço) precisa estar entre aspas duplas — o modelo já mostra como.

#Passo a passo

Abra Imóveis → Importar.
Em Subir planilha, clique em Selecione sua planilha e escolha o arquivo .csv.
Clique em Importar planilha.
Aguarde. A tela volta com a contagem: "N imóveis importados".

#Como saber que deu certo

O bloco Acervo atual mostra três números: importados, validados · prontos e a revisar.

A linha entra como validada automaticamente quando traz, ao mesmo tempo: preço (venda ou aluguel), cidade, estado, tipo de imóvel e ao menos uma foto. Faltando qualquer um, ela entra como pendente — existe no portal, mas o Theo não a oferece até você completar.

As pendentes aparecem na Fila de validação, com um botão Revisar em cada uma.

#Se der errado

"A planilha está vazia." O arquivo não tem linhas além do cabeçalho, ou foi salvo em outro formato. No Excel, use Salvar como → CSV UTF-8.

"Selecione um arquivo CSV." O arquivo escolhido não é .csv — planilha .xlsx precisa ser exportada antes.

"Falha ao gravar alguns imóveis." Alguma linha tem formato inesperado. Divida o arquivo ao meio e importe as partes para isolar o trecho problemático.

Os acentos vieram errados. A planilha foi salva em outra codificação. Salve como CSV UTF-8.

As fotos não apareceram. Confira se as URLs abrem sozinhas no navegador (sem login) e se estão separadas por |. Fotos hospedadas em Drive/Dropbox com link de compartilhamento normalmente não funcionam — precisa ser link direto para o arquivo de imagem.

#Importar de novo

Pode importar quantas vezes quiser. Use reference_code consistente para reconhecer os imóveis que já existem e evitar duplicar a carteira.