# Como cadastrar referências automáticas para chaves de imóveis

Assim como o imóvel, cada chave cadastrada possui um código de identificação próprio, usado para localizar a chave no quadro, registrar retiradas e devoluções e controlar as movimentações. O sistema pode gerar esse código automaticamente, com um padrão definido pela imobiliária e, se desejado, um código diferente para cada tipo de imóvel. A seguir, veja o passo a passo da configuração.

---

##### **Navegação no Módulo**

[![referenciachave.gif](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/referenciachave.gif)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/referenciachave.gif)

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

---

##### **Ativar a referência automática da chave**

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

<span style="white-space: pre-wrap;">No bloco </span>**Valores Padrões**<span style="white-space: pre-wrap;">, ative a opção </span>**Referência automática para a chave do imóvel?**. Enquanto essa opção estiver desligada, os campos de configuração não aparecem na tela.

Essa configuração é independente da referência do imóvel: é possível ativar apenas a da chave, apenas a do imóvel, ou as duas.

<p class="callout info"><span style="white-space: pre-wrap;">Ao ativar, o painel </span>**Referência da Chave do Imóvel Padrão**<span style="white-space: pre-wrap;"> é exibido.</span></p>

---

##### **Definir a regra geral da chave**

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

Essa é a regra aplicada a todas as chaves cujo imóvel não estiver em nenhuma regra específica por tipo.

<span style="white-space: pre-wrap;">➜ </span>**Prefixo:**<span style="white-space: pre-wrap;"> texto fixo exibido antes do número da chave. Exemplo: informando </span>`<span class="editor-theme-code">CH-</span>`<span style="white-space: pre-wrap;">, a referência gerada ficará </span>`<span class="editor-theme-code">CH-1234</span>`. O campo pode ficar em branco quando a imobiliária preferir apenas o número.  
<span style="white-space: pre-wrap;">➜ </span>**Tamanho do Incremento:**<span style="white-space: pre-wrap;"> quantidade mínima de dígitos do número, completada com zeros à esquerda. Informando </span>`<span class="editor-theme-code">3</span>`<span style="white-space: pre-wrap;">, a sequência será </span>`<span class="editor-theme-code">001</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">002</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">010</span>`. Quando a numeração ultrapassar esse limite, ela continua normalmente com mais dígitos.

---

##### **Adicionar uma regra por tipo de imóvel**

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

<span style="white-space: pre-wrap;">Abaixo da regra geral está o item </span>**Referência da Chave por Tipo do Imóvel**<span style="white-space: pre-wrap;">, que permite um código diferente conforme o tipo do imóvel ao qual a chave pertence. Clique em </span>**Adicionar prefixo por Tipo de Imóvel**<span style="white-space: pre-wrap;"> para criar uma nova linha.</span>

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

Em cada linha, preencha:

<span style="white-space: pre-wrap;">➜ </span>**Tipo de Imóvel:**<span style="white-space: pre-wrap;"> selecione a quais tipos de imóvel essa regra se aplica. É possível selecionar mais de um tipo na mesma linha, fazendo com que todos compartilhem o mesmo código e a mesma sequência.</span>  
<span style="white-space: pre-wrap;">➜ </span>**Prefixo:**<span style="white-space: pre-wrap;"> texto fixo que identificará as chaves desses tipos. Exemplo: </span>`<span class="editor-theme-code">CHAP-</span>`<span style="white-space: pre-wrap;"> para chaves de apartamentos.</span>  
<span style="white-space: pre-wrap;">➜ </span>**Tamanho do Incremento:**<span style="white-space: pre-wrap;"> quantidade mínima de dígitos do número gerado para essas chaves.</span>

<p class="callout info">Para remover uma regra criada, utilize o botão vermelho de exclusão no final da linha.</p>

---

##### **Regras que precisam ser respeitadas**

Para que a configuração possa ser gravada, o sistema exige:

<span style="white-space: pre-wrap;">➜ </span>**Cada prefixo deve ser único:**<span style="white-space: pre-wrap;"> dois prefixos iguais em linhas diferentes não são aceitos. Ao tentar gravar, o sistema informa quais prefixos estão duplicados.</span>  
<span style="white-space: pre-wrap;">➜ </span>**Cada tipo de imóvel pode estar em apenas uma regra:**<span style="white-space: pre-wrap;"> não é possível cadastrar o mesmo tipo em duas linhas diferentes.</span>  
<span style="white-space: pre-wrap;">➜ </span>**Toda regra precisa de ao menos um tipo selecionado:**<span style="white-space: pre-wrap;"> linhas com o campo </span>**Tipo de Imóvel**<span style="white-space: pre-wrap;"> vazio impedem a gravação.</span>

<span style="white-space: pre-wrap;">Caso deseje que vários tipos usem o mesmo código de chave, adicione todos eles na </span>**mesma linha**, em vez de criar uma linha para cada um.

---

##### **Como a regra é aplicada no dia a dia**

<span style="white-space: pre-wrap;">➜ </span>**A geração acontece no cadastro da chave:**<span style="white-space: pre-wrap;"> ao cadastrar uma nova chave com o campo de referência em branco, o sistema preenche automaticamente com o próximo número da sequência.</span>  
<span style="white-space: pre-wrap;">➜ </span>**Referência digitada é respeitada:**<span style="white-space: pre-wrap;"> se o usuário informar um código manualmente, o sistema mantém o valor digitado.</span>  
<span style="white-space: pre-wrap;">➜ </span>**A regra por tipo tem prioridade:**<span style="white-space: pre-wrap;"> o sistema verifica o tipo do imóvel ao qual a chave pertence. Havendo uma regra para aquele tipo, o prefixo dela é utilizado. Não havendo, vale a regra geral.</span>  
<span style="white-space: pre-wrap;">➜ </span>**Cada regra tem a sua própria contagem:**<span style="white-space: pre-wrap;"> a numeração de um prefixo é independente da dos demais.</span>  
<span style="white-space: pre-wrap;">➜ </span>**A sequência continua de onde parou:**<span style="white-space: pre-wrap;"> o sistema busca o maior número já utilizado com aquele prefixo e gera o próximo.</span>

---

#### **Perguntas frequentes**

<span style="white-space: pre-wrap;">➜ </span>**A referência da chave precisa ser igual à do imóvel?**<span style="white-space: pre-wrap;"> Não. São numerações totalmente independentes, com prefixos e sequências próprios. O imóvel </span>`<span class="editor-theme-code">RES-010</span>`<span style="white-space: pre-wrap;"> pode ter a chave </span>`<span class="editor-theme-code">CH-047</span>`.

<span style="white-space: pre-wrap;">➜ </span>**Preciso ativar a referência automática do imóvel para usar a da chave?**<span style="white-space: pre-wrap;"> Não. Cada uma tem o seu interruptor e pode ser usada separadamente.</span>

<span style="white-space: pre-wrap;">➜ </span>**Ativar a opção renumera as chaves já cadastradas?**<span style="white-space: pre-wrap;"> Não. As chaves existentes mantêm os códigos atuais. A numeração automática vale para as próximas chaves cadastradas.</span>

<span style="white-space: pre-wrap;">➜ </span>**Onde a referência da chave é utilizada?**<span style="white-space: pre-wrap;"> Na rotina Imóveis &gt; Chaves, no cadastro da chave dentro do imóvel e no controle de retiradas e devoluções, servindo como identificação da chave física.</span>

<span style="white-space: pre-wrap;">➜ </span>**Posso deixar o Prefixo em branco?**<span style="white-space: pre-wrap;"> Sim. Nesse caso a referência será composta apenas pelo número, respeitando o Tamanho do Incremento informado.</span>