> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/tecnologia/erp/componentes/funcionalidades/pesquisa-avancada/pesquisa-avancada-de-cep.md).

# Pesquisa Avançada de CEP

A Pesquisa Avançada de CEP é uma funcionalidade integrada para a automação e validação de endereçamentos. A ferramenta realiza a identificação de códigos postais, a normalização de caracteres e o preenchimento automático de logradouro, bairro, cidade e estado, assegurando a integridade dos dados cadastrais e a eficiência operacional.

### Funcionalidades e Atalhos

O sistema opera com comandos específicos para agilizar a localização e a gestão de registros.

* **Pesquisa Avançada (**<kbd>**F7**</kbd>**):** Abre a consulta padrão de códigos postais para localizar um endereço por logradouro ou cidade.
* **Manutenção de Cadastros (**<kbd>**F8**</kbd>**):** Quando habilitado, permite acessar diretamente a rotina de gerenciamento de endereços para realizar ajustes ou novos cadastros de CEPs que ainda não constam na base.

### Tratamento Automático de Entrada

Assim que o usuário digita os números, o leitor processa a informação:

1. **Limpeza de Caracteres:** Remove automaticamente pontos, hifens ou espaços, mantendo apenas os números necessários para o processamento.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Inserção de <kbd>01001-000</kbd> resulta no processamento interno de <kbd>01001000</kbd>.</p></div>
2. **Máscara Visual:** Aplica a formatação padrão assim que o campo é preenchido, garantindo a padronização visual (Formato: `00000-000`).

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Digitação de <kbd>80010100</kbd> com conversão automática para <kbd>80010-100</kbd> ao finalizar a inserção.</p></div>
3. **Tratamento para Exterior (**<kbd>**EXT**</kbd>**):** O sistema identifica o termo <kbd>EXT</kbd> para casos de endereçamentos internacionais, isentando a obrigatoriedade dos 8 dígitos.

### Integração e Busca de Endereço

A recuperação de informações ocorre de forma hierárquica para garantir a disponibilidade do dado.

1. **Consulta Externa:** O sistema tenta localizar o endereço em serviços oficiais de busca de CEP (ViaCEP).
2. **Consulta Interna:** Caso o serviço externo esteja indisponível ou o CEP seja específico, o sistema consulta a base de dados interna.
3. **Preenchimento Automático:** Ao encontrar o CEP, o sistema retorna e preenche automaticamente: Estado, Cidade, Bairro, Logradouro e Código IBGE.

### Regras de Validação e Segurança

Para garantir que os dados de entrega e faturamento estejam corretos, o leitor aplica as seguintes regras:

* **Validação de Tamanho:** O sistema bloqueia CEPs que não possuam exatamente 8 dígitos numéricos (exceto em casos configurados como <kbd>EXT</kbd>).
* **Divergência de Cadastro:** Caso o CEP já exista na base interna, mas a prefeitura ou o governo tenham alterado o nome da cidade ou bairro, o sistema identifica a diferença e emite um alerta.
* **Sincronização:** Atualização automática das tabelas de cidades e estados ao localizar um novo CEP via busca externa.

### Tabela de Comportamentos

<table><thead><tr><th width="168">Ação</th><th width="266">Descrição</th><th>Resultado Esperado</th></tr></thead><tbody><tr><td>Digitação</td><td>Entrada de caracteres numéricos brutos.</td><td><p>Aplicação imediata de máscara</p><p><kbd>00000-000</kbd>.</p></td></tr><tr><td>Saída do Campo</td><td>Validação do código digitado.</td><td>Busca automática e preenchimento do endereço.</td></tr><tr><td>Busca (<kbd>F7</kbd>)</td><td>Acionamento da tecla de atalho.</td><td>Abertura de janela de pesquisa por endereço.</td></tr><tr><td>Cadastro (<kbd>F8</kbd>)</td><td>Acionamento para manutenção.</td><td>Acesso à tela de gestão de CEPs (se autorizado).</td></tr></tbody></table>

{% hint style="success" %}
**Dicas de Uso**

**Otimização de Preenchimento:** Digite apenas os 8 dígitos numéricos (sem hífen) e pressione <kbd>Tab</kbd> ou <kbd>Enter</kbd> para que ocorra a busca automática do endereço completo.

**Aviso de Alteração:** Caso ocorra a mensagem "Cidade foi alterada pelo governo", o sistema está comparando a base interna com os dados mais recentes dos correios. Recomenda-se a aceitação de atualizações sugeridas pelo sistema, quando houver divergência com os dados oficiais, garantindo a emissão correta de documentos fiscais.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.consistem.com.br/tecnologia/erp/componentes/funcionalidades/pesquisa-avancada/pesquisa-avancada-de-cep.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
