> 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.