Perguntas frequentes sobre a referência do imóvel
A referência é o código que a sua imobiliária usa para identificar o imóvel no dia a dia: na placa, no anúncio, na conversa com o cliente e com os programas de fora. Ela pode ser digitada no cadastro ou numerada pelo próprio sistema, num padrão como AP-0042. Esta página reúne as dúvidas mais comuns sobre preencher, numerar e buscar a referência e sobre como ela aparece nos portais.
O passo a passo completo da numeração automática por tipo de imóvel está em Como cadastrar referências automáticas para os códigos dos imóveis.
Navegação no Módulo

Rotina: Configurações > Imóveis > aba Referências
O campo Referência de cada imóvel fica na ficha do imóvel, na aba Imóvel, ao lado do Título do Imóvel.
O que é a referência
➜ Qual a diferença entre o Código e a Referência do imóvel? O Código é o número que o sistema dá sozinho a cada imóvel, em sequência. Ele aparece ao lado de "Editando Imóvel", no topo da ficha, e na coluna Código da listagem, e não pode ser alterado. A Referência é o código da sua imobiliária: você digita o que quiser ou deixa o sistema numerar no padrão que você configurar.
➜ Onde preencho a referência? Abra a ficha do imóvel e, na aba Imóvel, preencha o campo Referência. Depois clique em Gravar.

➜ A referência é obrigatória? Não. O imóvel pode ficar sem referência e continua identificado pelo Código.
➜ Qual o tamanho máximo? 60 caracteres. Acima disso aparece "A referência do imóvel deve ter no máximo 60 caracteres."
➜ Não consigo alterar a referência. A sua imobiliária pode ter restringido quem altera esse campo em Configurações > Imóveis > aba Campos e Permissões. Peça a mudança a quem tem essa permissão ou ao responsável pelo seu acesso. Veja Como delimitar campos obrigatórios e permissões no cadastro de imóvel.
Referência repetida
➜ Apareceu "O valor ... informado para o campo Referência já foi usado para o registro ...". Cada referência só pode estar em um imóvel da sua imobiliária, mesmo que o outro imóvel esteja inativo. A mensagem traz o título do imóvel que já usa a referência, com um link para abri-lo. Escolha outra referência ou, se a do outro imóvel estiver errada, corrija lá primeiro.
➜ "AP-10" e "ap-10" são referências diferentes? Não. O sistema não diferencia letras maiúsculas de minúsculas nem acentos ao conferir a repetição, então as duas contam como a mesma referência.
Referência automática
➜ Como faço o sistema numerar a referência sozinho?
- Em Configurações > Imóveis, abra a aba Referências.
- Ligue Referência automática para o imóvel?. Logo abaixo aparece o bloco Referência do Imóvel Padrão.
- Preencha o Prefixo (por exemplo, RES-) e o Tamanho do Incremento, que é a quantidade mínima de dígitos do número (com 4, o primeiro sai RES-0001).
- Para dar um prefixo próprio a alguns tipos de imóvel, clique em Adicionar prefixo por Tipo de Imóvel, escolha os tipos, preencha o prefixo e salve a linha no botão verde ao lado dela.
- Clique em Gravar Informações para gravar a opção ligada e o padrão geral.

➜ Quem pode mexer nessa configuração? Quem tem permissão para editar as configurações de imóveis. Se a aba Referências não aparecer para você, peça ao responsável pelo seu acesso.
➜ Liguei a referência automática, mas o imóvel novo ficou sem referência. O tipo do imóvel não está em nenhuma regra por tipo e o Prefixo do bloco Referência do Imóvel Padrão está em branco. Sem uma regra que valha para aquele tipo, o sistema não tem de onde tirar o número. Preencha o padrão geral ou inclua o tipo numa das regras.
➜ Se eu digitar a referência no cadastro, o sistema troca? Não. A numeração automática só entra quando o imóvel novo é gravado com a referência em branco. O que você digitou é mantido.
➜ A numeração começou num número alto ou pulou números. O sistema procura o maior número já usado com aquele prefixo e gera o seguinte. Se alguém digitou à mão uma referência como AP-9000, o próximo imóvel sai AP-9001.
➜ Ligar a referência automática renumera os imóveis que já existem? Não. Ela vale para os imóveis novos e para os imóveis que tiverem o tipo trocado depois disso. Os imóveis já cadastrados ficam com a referência que têm.
➜ Troquei o tipo do imóvel e a referência mudou. Com a referência automática ligada, trocar o tipo gera uma referência nova no padrão do novo tipo, mesmo que a anterior tenha sido digitada à mão. Ela só é mantida quando o novo tipo tem regra própria e a referência atual já segue o padrão dessa regra: um AP-0042 continua AP-0042 se o novo tipo também usa o prefixo AP-. Quando o novo tipo usa o padrão geral, a referência é sempre trocada.
Se a referência do imóvel está em placas, anúncios ou contratos, confira a referência depois de trocar o tipo e, se precisar, devolva a anterior antes de gravar de novo.
➜ Dois corretores cadastrando ao mesmo tempo podem pegar o mesmo número? Não. O sistema reserva o número durante a gravação, e cada cadastro recebe o seu.
➜ Ao salvar uma regra apareceu um aviso. Cada prefixo só pode estar em uma regra, e cada tipo de imóvel também. As mensagens são:
- "Já existe uma regra com este prefixo para este módulo. Cada prefixo deve ser único por empresa e módulo." Escolha outro prefixo ou, para os tipos usarem a mesma numeração, coloque todos na mesma linha.
- "Um ou mais tipos de imóvel já estão associados a outra regra de referência deste módulo." Tire o tipo da outra linha antes de usá-lo nesta.
Duplicar, buscar e importar
➜ Duplicar um imóvel copia a referência? Não. A cópia nasce sem referência. Com a referência automática ligada, ela recebe o próximo número da sequência. Com a opção desligada, preencha a referência da cópia à mão.
➜ Como acho um imóvel pela referência? Na listagem de Imóveis, digite a referência na busca. Para procurar vários imóveis de uma vez, escolha na busca a opção Múltiplas Referências do imóvel e digite as referências separadas por vírgula ou espaço.
➜ Os imóveis importados mantêm a referência? Sim. Na importação, o imóvel chega com a referência que veio no arquivo.
Referência nos portais
➜ Qual código identifica o imóvel no portal? Depende do portal. Em Configurações > Integrações > Exportação, os portais que aceitam essa escolha têm o campo Código do Imóvel, com três opções: Código Único, Código do Imóvel e Referência. Imóvel sem o código escolhido preenchido é enviado com o Código Único.
➜ Posso trocar o código de um portal que já está ativo? Pode, mas o sistema pede confirmação, porque a troca muda a identificação de todos os anúncios naquele portal. O aviso diz: "Trocar o código do imóvel muda a identificação de todos os anúncios neste portal. O portal pode tratar os anúncios como novos e remover os atuais, com perda de histórico e destaques."
Se o portal usa a Referência, trocar a referência de um imóvel também muda a identificação dele naquele portal, e o anúncio pode ser tratado como novo.
Referência da chave
➜ A referência da chave é a mesma do imóvel? Não. A chave tem referência própria, com numeração automática separada, ligada em Referência automática para a chave do imóvel?, na mesma aba Referências. Veja Como cadastrar referências automáticas para chaves de imóveis.