# Como incluir um novo estado no sistema?

O módulo de Estados permite que você cadastre os estados (ou províncias, regiões e unidades federativas) vinculados aos países cadastrados no sistema. Os estados compõem o segundo nível da hierarquia de localização e são obrigatórios para o cadastro de cidades.

Assim como os países, somente os estados cadastrados pela sua empresa ficam disponíveis nos formulários de endereço. Para imobiliárias que operam exclusivamente no Brasil, basta cadastrar os estados brasileiros que você efetivamente utiliza.

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

![entradaestado.gif](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/entradaestado.gif)**Rotina:**<span style="white-space: pre-wrap;"> Cadastros &gt; Localização &gt; Estados</span>

---

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

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/scaled-1680-/nj2image.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/nj2image.png)  
<span style="white-space: pre-wrap;">A tela principal exibe a lista de estados cadastrados, com as colunas </span>**UF**<span style="white-space: pre-wrap;"> (sigla do estado), </span>**Estado**<span style="white-space: pre-wrap;"> (nome completo) e </span>**País**<span style="white-space: pre-wrap;"> (país ao qual o estado pertence). A busca inteligente permite filtrar por sigla ou nome. O filtro </span>**País**<span style="white-space: pre-wrap;"> permite listar somente os estados de um país específico.</span>

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

- **Buscar**<span style="white-space: pre-wrap;"> , filtra a listagem pelo texto digitado ou pelo país selecionado.</span>
- **Cadastrar**<span style="white-space: pre-wrap;"> , abre o formulário para adicionar um novo estado.</span>
- **Remover**<span style="white-space: pre-wrap;"> , exclui o(s) estado(s) selecionado(s). O botão fica ativo ao marcar pelo menos um registro.</span>

<p class="callout warning">Somente os estados cadastrados pela sua empresa são exibidos nos formulários de endereço. Estados não cadastrados não aparecem como opção ao preencher um endereço.</p>

#### **3. Cadastrando um estado**

![Formulário de cadastro de estado](https://ajuda.apresenta.me/uploads/images/gallery/2026-04/duR02-form-cadastro.png)<span style="white-space: pre-wrap;">Ao clicar em </span>**Cadastrar**, um formulário é aberto com os seguintes campos:

<table id="bkmrk-campodescri%C3%A7%C3%A3oobriga" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col><col style="width: 142px;"></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>Nome do País

</td><td>País ao qual o estado pertence. Busque pelo nome do país no campo de pesquisa. Somente países previamente cadastrados em Localização &gt; Países aparecem como opção.

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

</td></tr><tr><td>Sigla do Estado

</td><td>Abreviação do estado com até 3 caracteres (ex: SP, RJ, MG para estados brasileiros). Usada na exibição compacta de endereços no sistema.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Nome do Estado

</td><td>Nome completo do estado como aparecerá nos formulários de endereço. Exemplo: São Paulo, Rio de Janeiro, Minas Gerais.

</td><td class="align-center" style="text-align: center;">Sim

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

<p class="callout info"><span style="white-space: pre-wrap;">O formulário oferece as opções </span>**Gravar**<span style="white-space: pre-wrap;"> e </span>**Gravar e Continuar**. Use "Gravar e Continuar" quando precisar cadastrar vários estados em sequência sem fechar o formulário.</p>

---

#### **4. Editando um estado**

![Listagem com estados cadastrados](https://ajuda.apresenta.me/uploads/images/gallery/2026-04/s0D03-listagem-final.png)Para editar um estado já cadastrado, clique sobre o nome dele 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 a sigla ou o nome de um estado já vinculado a cidades ou endereços pode impactar a exibição dessas informações em outros módulos. Faça edições com cuidado.</p>

---

#### **5. Removendo um estado**

<span style="white-space: pre-wrap;">Para remover um ou mais estados, marque as caixas de seleção na listagem e clique em </span>**Remover**. O botão fica habilitado somente quando há pelo menos um item marcado.

<p class="callout danger">Não é possível remover um estado que já possui cidades cadastradas. Remova primeiro as cidades vinculadas a ele.</p>

---

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

Os estados cadastrados aqui aparecem como opção nos formulários de endereço em todo o sistema, incluindo:

- **Pessoas**<span style="white-space: pre-wrap;"> , campo Estado no endereço de pessoas físicas e jurídicas.</span>
- **Imóveis**<span style="white-space: pre-wrap;"> , endereço do imóvel.</span>
- **Contratos**<span style="white-space: pre-wrap;"> , endereço das partes envolvidas.</span>

A hierarquia completa de localização segue a ordem: País &gt; Estado &gt; Cidade &gt; Bairro. O estado deve existir antes de cadastrar cidades vinculadas a ele.

---

#### **7. Perguntas frequentes**

**Preciso cadastrar todos os estados do Brasil?**  
Não. Cadastre apenas os estados que sua empresa utiliza nos endereços do sistema. Se você opera somente em São Paulo, basta cadastrar SP.

**Posso cadastrar um estado sem vincular a um país?**  
Sim. O campo País não é obrigatório no formulário. Porém, para que o endereço completo funcione corretamente na hierarquia País &gt; Estado &gt; Cidade, recomendamos sempre vincular o estado ao país correspondente.

**O que acontece se eu tentar remover um estado que tem cidades cadastradas?**  
O sistema não permite a remoção. Você precisa remover primeiro todas as cidades vinculadas ao estado antes de excluí-lo.

**A sigla do estado tem limite de caracteres?**  
Sim. A sigla aceita no máximo 3 caracteres. Para os estados brasileiros, use sempre a sigla oficial de 2 letras (ex: SP, RJ, MG).