# Como incluir um novo País no sistema?

O módulo de Países permite que você cadastre os países que serão utilizados no sistema Apresenta.me. Esses países compõem a base de localização e são vinculados a estados, cidades e bairros, formando a hierarquia completa de endereços usada em pessoas, imóveis e contratos.

Por padrão, o sistema não possui países pré-cadastrados. Cada empresa cadastra os países que utiliza, o que garante que a listagem fique enxuta e relevante para a sua operação. Para a maioria das imobiliárias brasileiras, basta cadastrar o Brasil.

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

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

---

#### **2. Como funciona o módulo**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/scaled-1680-/adZimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/adZimage.png)<span style="white-space: pre-wrap;">A tela principal exibe a lista de países cadastrados pela empresa, com as colunas </span>**ISO**<span style="white-space: pre-wrap;"> (código internacional do país) e </span>**País**<span style="white-space: pre-wrap;"> (nome completo). A busca inteligente permite filtrar por código ISO ou nome.</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 no campo de busca.</span>
- **Cadastrar**<span style="white-space: pre-wrap;"> , abre o formulário para adicionar um novo país.</span>
- **Remover**<span style="white-space: pre-wrap;"> , exclui o(s) país(es) selecionado(s) na listagem. O botão fica ativo ao marcar pelo menos um registro.</span>

<p class="callout warning">Somente os países cadastrados pela sua empresa são exibidos. Países não cadastrados não aparecem como opção em formulários de endereço.</p>

---

#### **3. Cadastrando um país**

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

<span style="white-space: pre-wrap;">Ao clicar em </span>**Cadastrar**, um formulário é aberto para preenchimento. Ambos os campos são obrigatórios:

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

</td><td>Sigla internacional do país, seguindo o padrão ISO 3166-1 alpha-2 (duas letras maiúsculas). Exemplos: BR para Brasil, US para Estados Unidos, PT para Portugal. Esse código é usado internamente pelo sistema para identificar o país.

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

</td></tr><tr><td>Nome do País

</td><td>Nome completo do país em português, da forma como aparecerá nos formulários de endereço do sistema. Exemplo: Brasil, Estados Unidos, Portugal.

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

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

<p class="callout info">Use sempre a sigla ISO padrão de 2 letras, como "BR" para o Brasil. Isso garante compatibilidade com integrações e relatórios do sistema.</p>

---

#### **4. Editando um país**

Para editar um país 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 o código ISO ou o nome de um país já vinculado a estados, 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 país**

<span style="white-space: pre-wrap;">Para remover um ou mais países, 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 país que já possui estados cadastrados. Remova primeiro os estados vinculados a ele.</p>

---

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

Os países 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 de endereço no cadastro de pessoas físicas e jurídicas.</span>
- **Imóveis**<span style="white-space: pre-wrap;"> , endereço do imóvel.</span>
- **Contratos de Locação**<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.

---

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

**Preciso cadastrar todos os países do mundo?**  
Não. Cadastre apenas os países que sua empresa utiliza. Para imobiliárias que operam somente no Brasil, basta cadastrar o Brasil (ISO: BR).

**O sistema já vem com o Brasil cadastrado?**  
Sim. O sistema possui países pré-cadastrados. Mas cada empresa pode cadastrar os países que vai utilizar.

**O que acontece se eu tentar remover um país que tem estados vinculados?**  
O sistema não permite a remoção. Você precisa remover primeiro todos os estados associados ao país antes de excluí-lo.

**Posso cadastrar o mesmo código ISO duas vezes?**  
Não. O código ISO deve ser único por empresa. Tentativas de cadastrar um código já existente serão bloqueadas pelo sistema.