# Como funciona a referência automática para a chave do imóvel?

A chave do imóvel é um código único que identifica cada imóvel cadastrado na plataforma. A função de referência automática para a chave do imóvel gera esse código de forma automática, sem que o usuário precise digitá-lo manualmente.

No dia a dia, essa configuração evita erros de digitação, duplicidades e inconsistências na identificação dos imóveis. Com ela ativada, o sistema atribui um código sequencial a cada novo imóvel cadastrado, seguindo um padrão definido pela própria imobiliária.

Essa configuração é feita na área de cadastros gerais e afeta todos os imóveis criados a partir do momento em que é ativada.

**Rotina:**<span style="white-space: pre-wrap;"> Configurações &gt; Cadastros Gerais &gt; Imóvel</span>

#### **1. Navegação no módulo**

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

Caminho de acesso até a rotina de configurações de cadastros gerais, onde a chave do imóvel é configurada.

#### **2. Como funciona**

A tela de configurações de cadastros gerais reúne todas as opções relacionadas ao comportamento dos imóveis no sistema. As chaves são uma dessas opções e ficam na seção de controles por chave (as chaves de ativação), junto com outras configurações do imóvel.

Nessa tela, você encontra duas opções relacionadas a referências automáticas: uma para o imóvel e outra especificamente para a chave do imóvel. Cada uma controla um tipo de código diferente.

<p class="callout info">A "Referência automática para o imóvel" e a "Referência automática para a chave do imóvel" são configurações independentes. Você pode ativar uma sem ativar a outra, conforme a necessidade da sua imobiliária.</p>

#### **3. A chave de ativação "Referência automática para a chave do imóvel"**

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

Quando essa opção está ativada, o sistema gera automaticamente o código da chave do imóvel no momento do cadastro. Você não precisa informar esse código manualmente: a plataforma cria um valor único e sequencial para cada imóvel.

Quando a opção está desativada, o campo de código da chave fica disponível para preenchimento manual. Nesse caso, a equipe é responsável por definir e controlar os códigos utilizados.

<p class="callout warning">Atenção: ao ativar a referência automática, o código da chave passa a ser gerado pelo sistema. Se a sua imobiliária já utiliza um padrão próprio de numeração, verifique se o modelo automático atende antes de ativar.</p>

#### **4. Prefixo e tamanho do incremento**

Ao ativar a referência automática para a chave do imóvel, dois campos complementares ficam disponíveis para personalizar o formato do código gerado.

<table id="bkmrk-campo-descri%C3%A7%C3%A3o-obri" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col><col style="width: 110px;"></col></colgroup><tbody><tr><th style="width: 160px; white-space: nowrap;">Campo

</th><th>Descrição

</th><th class="align-center" style="width: 110px; white-space: nowrap; text-align: center;">Obrigatório

</th></tr><tr><td>Prefixo

</td><td>Texto ou sigla adicionado antes do número sequencial da chave. Por exemplo, se você informar "CH", o código gerado será algo como "CH001", "CH002" e assim por diante. Útil para distinguir as chaves dos imóveis de outros códigos do sistema.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Tamanho do Incremento

</td><td>Define quantos dígitos numéricos o código terá. Por exemplo, com tamanho 3, os números serão formatados como "001", "002"... até "999". Com tamanho 4, ficam "0001", "0002" e assim por diante.

</td><td class="align-center" style="text-align: center;">Não

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

<p class="callout info">O prefixo é opcional. Se você deixar esse campo vazio, o código da chave será gerado apenas com os números sequenciais, sem nenhum texto antes.</p>

#### **5. Resultado após salvar**

Após configurar as opções e clicar em "Gravar Informações", as definições passam a valer para todos os novos imóveis cadastrados. Os imóveis já existentes não têm seus códigos alterados retroativamente.

<p class="callout success">Boa prática: defina o prefixo e o tamanho do incremento antes de começar a cadastrar imóveis. Isso garante um padrão visual consistente em toda a base de dados da imobiliária.</p>

#### **6. Perguntas frequentes**

**Como funciona a numeração das chaves no sistema?**  
<span style="white-space: pre-wrap;">A numeração das chaves (campo </span>**Referência**) é gerada de forma sequencial e global, ou seja, ela não é separada por imóvel.

**Exemplo:**

- Chave 1 do imóvel 123 → Referência 1
- Chave 2 do imóvel 123 → Referência 2
- Chave 1 do imóvel 456 → Referência 3

Dessa forma, cada chave possui uma referência única dentro do sistema, facilitando o controle e a identificação das chaves cadastradas.

**O que é a "chave do imóvel" no sistema?**  
É um código único de identificação atribuído a cada imóvel. Ele pode ser usado internamente pela equipe para localizar e referenciar imóveis de forma rápida, sem depender do endereço completo.

**Qual a diferença entre "Referência automática para o imóvel" e "Referência automática para a chave do imóvel"?**  
São dois códigos distintos. A referência do imóvel identifica o imóvel em geral no sistema. A chave do imóvel é um código específico utilizado para controle físico ou operacional das chaves, conforme o processo de cada imobiliária. Cada um pode ter seu próprio prefixo e sequência.

**Os imóveis já cadastrados terão seus códigos de chave alterados ao ativar a referência automática?**  
Não. A geração automática se aplica apenas aos imóveis cadastrados após a ativação da opção. Imóveis existentes mantêm os códigos que já possuíam.

**Posso alterar o prefixo depois que já tenho imóveis cadastrados com referência automática?**  
Sim. Você pode alterar o prefixo a qualquer momento. No entanto, os imóveis já cadastrados continuam com o código anterior. Somente os novos cadastros adotarão o prefixo atualizado.

**Se eu desativar a referência automática depois de um tempo usando, o que acontece?**  
Os imóveis cadastrados com código automático mantêm seus códigos. Para os novos cadastros, o campo de código da chave voltará a ser preenchido manualmente pela equipe.