# Pesquisa Avançada de Cidade

A Pesquisa Avançada de Cidade é um componente de texto que permite o armazenamento da identificação nominal do município para o preenchimento de cadastros de clientes, fornecedores, transportadoras e unidades produtivas. Esta funcionalidade assegura a precisão dos dados para a emissão de documentos fiscais e etiquetas de logística.

### Especificações Técnicas

Para manter a integridade dos dados e a compatibilidade com os leiautes de documentos oficiais (como a NF-e), o campo segue as seguintes diretrizes:

* **Limite de Caracteres:** O campo é configurado para aceitar até 30 caracteres.
* **Tipo de Dado:** Alfanumérico (aceita letras, números e espaços).
* **Padronização Visual:** O tamanho de exibição na tela é sincronizado com o limite de armazenamento, garantindo que o usuário veja exatamente o que será impresso ou exportado.

### Funcionamento e Regras

**Dimensionamento Automático:** O sistema define automaticamente a largura do campo na interface. Ao digitar, o cursor será interrompido ao atingir o 30º caractere. Essa trava evita erros de truncamento (corte de texto) em etapas posteriores do processo, como o envio de dados para a SEFAZ.

**Integração com CEP:** Embora este campo permita a digitação manual em determinados contextos, o preenchimento ocorre de forma automática por meio da consulta de CEP. Caso o retorno da busca exceda o limite de 30 caracteres, o sistema aplica abreviações automáticas para garantir que o nome caiba no espaço disponível sem perder a identificação.

{% hint style="success" %}
**Dica de Preenchimento**

Em cenários de preenchimento manual onde o nome do município ultrapasse o limite estabelecido, recomenda-se a aplicação de abreviações em preposições ou títulos para preservar as palavras principais.

{% hint style="warning" %}
Exemplo:

"S. J. dos Pinhais" em vez de "São José dos Pinhais"
{% endhint %}
{% endhint %}