# 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 %}