# Cidades

O módulo de Cidades permite que você cadastre as cidades vinculadas aos estados e países cadastrados no sistema. As cidades compõem o terceiro nível da hierarquia de localização e são obrigatórias para o cadastro de bairros e para o preenchimento completo de endereços em pessoas, imóveis e contratos.

Somente as cidades cadastradas pela sua empresa ficam disponíveis nos formulários de endereço. Para cadastrar uma cidade, o estado correspondente já deve existir no sistema.

**Rotina:** Cadastros > Localização > Cidades

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

![Navegação no módulo de Cidades](https://ajuda.apresenta.me/uploads/images/gallery/2026-04/re800-gif-navegacao.gif)Para acessar o módulo, abra o menu lateral e vá em **Cadastros > Localização > Cidades**. Você verá a listagem com todas as cidades cadastradas pela sua empresa.

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

![Listagem de Cidades](https://ajuda.apresenta.me/uploads/images/gallery/2026-04/yQZ01-listagem.png)A tela principal exibe todas as cidades cadastradas, com as colunas **Nome**, **CEP Principal**, **Estado** e **País**.

Quatro filtros estão disponíveis:

- **Busca Inteligente** , filtra pelo nome da cidade.
- **CEP Principal** , filtra pelo CEP cadastrado na cidade.
- **País** , exibe somente cidades do país selecionado.
- **Estado** , exibe somente cidades do estado selecionado (o filtro de Estado é dinâmico e considera o País escolhido).

Três ações estão disponíveis na barra superior:

- **Buscar** , aplica os filtros e atualiza a listagem.
- **Cadastrar** , abre o formulário para adicionar uma nova cidade.
- **Remover** , exclui as cidades selecionadas. O botão fica ativo ao marcar pelo menos um registro.

<p class="callout warning">Somente as cidades cadastradas pela sua empresa ficam disponíveis nos formulários de endereço. Cidades não cadastradas não aparecem como opção ao preencher um endereço.</p>

#### **3. Cadastrando uma cidade**

![Formulário de cadastro de cidade](https://ajuda.apresenta.me/uploads/images/gallery/2026-04/GE302-form-cadastro.png)Ao clicar em **Cadastrar**, um formulário é aberto com os seguintes campos:

<table id="bkmrk-campodescri%C3%A7%C3%A3oobriga" style="width:100%; table-layout:fixed;"><thead><tr><th style="width:180px; white-space:nowrap;">Campo</th><th>Descrição</th><th style="width:110px; white-space:nowrap; text-align:center;">Obrigatório</th></tr></thead><tbody><tr><td>País</td><td>País ao qual a cidade pertence. Selecione o país para filtrar os estados disponíveis no campo seguinte. Somente países previamente cadastrados em Localização &gt; Países aparecem como opção.</td><td style="text-align:center;">Sim</td></tr><tr><td>Estado</td><td>Estado ao qual a cidade pertence. A lista de estados é filtrada automaticamente pelo país selecionado. Somente estados previamente cadastrados em Localização &gt; Estados aparecem como opção.</td><td style="text-align:center;">Sim</td></tr><tr><td>Nome da Cidade</td><td>Nome completo da cidade como aparecerá nos formulários de endereço do sistema. Exemplo: São Paulo, Curitiba, Belo Horizonte.</td><td style="text-align:center;">Sim</td></tr><tr><td>CEP Principal da Cidade</td><td>CEP de referência da cidade no formato 00000-000. Usado como valor padrão em funcionalidades que dependem de CEP por cidade. Campo opcional.</td><td style="text-align:center;">Não</td></tr></tbody></table>

<p class="callout info">O formulário oferece as opções **Gravar** e **Gravar e Continuar**. Use "Gravar e Continuar" quando precisar cadastrar várias cidades em sequência sem fechar o formulário.</p>

#### **4. Editando uma cidade**

![Listagem com cidades cadastradas](https://ajuda.apresenta.me/uploads/images/gallery/2026-04/4ZG03-listagem-final.png)Para editar uma cidade já cadastrada, clique sobre o nome dela na listagem. O mesmo formulário de cadastro será aberto com os dados preenchidos. Faça as alterações necessárias e salve.

<p class="callout warning">Alterar o nome ou o estado de uma cidade já vinculada a endereços pode impactar a exibição dessas informações em outros módulos. Faça edições com cuidado.</p>

#### **5. Removendo uma cidade**

Para remover uma ou mais cidades, marque as caixas de seleção na listagem e clique em **Remover**. O botão fica habilitado somente quando há pelo menos um item marcado.

<p class="callout danger">Não é possível remover uma cidade que já possui bairros cadastrados. Remova primeiro os bairros vinculados a ela.</p>

#### **6. Onde é usado**

As cidades cadastradas aqui aparecem como opção nos formulários de endereço em todo o sistema, incluindo:

- **Pessoas** , campo Cidade no endereço de pessoas físicas e jurídicas.
- **Imóveis** , cidade do imóvel, também usada em filtros de busca por localização.
- **Contratos** , cidade das partes envolvidas no contrato.

A hierarquia completa de localização segue a ordem: País &gt; Estado &gt; Cidade &gt; Bairro. A cidade deve existir antes de cadastrar bairros vinculados a ela.

#### **7. Permissões necessárias**

Para gerenciar as cidades, o usuário precisa das seguintes permissões:

<table id="bkmrk-permiss%C3%A3oo-que-permi" style="width:100%; table-layout:fixed;"><thead><tr><th style="width:260px; white-space:nowrap;">Permissão</th><th>O que permite</th></tr></thead><tbody><tr><td>Localidade Cidade &gt; Cadastrar</td><td>Criar e editar cidades.</td></tr><tr><td>Localidade Cidade &gt; Excluir</td><td>Remover cidades da listagem.</td></tr></tbody></table>

#### **8. Perguntas frequentes**

**Preciso cadastrar todas as cidades do Brasil?**  
Não. Cadastre apenas as cidades que sua empresa utiliza. Se você opera somente em São Paulo e Campinas, basta cadastrar essas duas.

**Posso cadastrar uma cidade sem selecionar o estado?**  
Não. O campo Estado é obrigatório. Para que o estado apareça na lista, ele deve estar previamente cadastrado em Localização &gt; Estados.

**O que acontece se eu tentar remover uma cidade que tem bairros cadastrados?**  
O sistema não permite a remoção. Você precisa remover primeiro todos os bairros vinculados à cidade antes de excluí-la.

**O campo CEP Principal é usado em alguma funcionalidade específica?**  
Sim. O CEP principal pode ser usado como referência em funcionalidades que dependem de CEP por cidade. Não é obrigatório, mas recomendamos preencher para facilitar o uso do sistema.